Upgrade to ExtJS 4.0.2 - Released 06/09/2011

[extjs.git] / resources / themes / stylesheets / ext4 / default / mixins / _theme-background-image.scss

diff --git a/resources/themes/stylesheets/ext4/default/mixins/_theme-background-image.scss b/resources/themes/stylesheets/ext4/default/mixins/_theme-background-image.scss
new file mode 100644 (file)
index 0000000..f673f4d
--- /dev/null
+++ b/resources/themes/stylesheets/ext4/default/mixins/_theme-background-image.scss
@@ -0,0 +1,24 @@
+/**
+ * Method which inserts a full background-image property for a theme image.
+ * It checks if the file exists and if it doesn't, it'll throw an error. 
+ * By default it will not include the background-image property if it is not found,
+ * but this can be changed by changing the default value of $include-missing-images to 
+ * be true. 
+ */
+@mixin theme-background-image($theme-name, $path, $without-url: false, $relative: false) {
+    $exists_image: theme-image($theme-name, $path, true, false);
+
+    @if $exists_image {
+        $exists: theme_image_exists($exists_image);
+
+        @if $exists or $include-missing-images {
+            background-image: theme-image($theme-name, $path, $without-url, $relative);
+        }
+        @else {
+            @warn "@theme-background-image: Theme image not found: #{$exists_image}";
+        }
+    }
+    @else {
+        @warn "@theme-background-image: No arguments passed";
+    }
+}
\ No newline at end of file