_theme-background-image.scss 1.0 KB

123456789101112131415161718192021222324252627282930
  1. /*
  2. * Method which inserts a full background-image property for a theme image.
  3. * It checks if the file exists and if it doesn't, it'll throw an error.
  4. * By default it will not include the background-image property if it is not found,
  5. * but this can be changed by changing the default value of $include-missing-images to
  6. * be true.
  7. */
  8. @function theme-background-image($theme-name, $path, $without-url: false, $relative: false) {
  9. $exists_image: theme-image($theme-name, $path, true, false);
  10. @if $exists_image {
  11. $exists: theme_image_exists($exists_image);
  12. @if $exists == true {
  13. @return theme-image($theme-name, $path, $without-url, $relative);
  14. }
  15. @else {
  16. @warn "@theme-background-image: Theme image not found: #{$exists_image}";
  17. @if $include-missing-images {
  18. @return theme-image($theme-name, $path, $without-url, $relative);
  19. }
  20. @return none;
  21. }
  22. }
  23. @else {
  24. @warn "@theme-background-image: No arguments passed";
  25. }
  26. }