_theme-background-image.scss 1.1 KB

1234567891011121314151617181920212223242526272829303132
  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. // @todo this needs to be smarter
  17. // @warn "@theme-background-image: Theme image not found: #{$exists_image}";
  18. @if $include-missing-images {
  19. @return theme-image($theme-name, $path, $without-url, $relative);
  20. }
  21. @return none;
  22. }
  23. }
  24. @else {
  25. // @todo this needs to be smarter...
  26. // @warn "@theme-background-image: No arguments passed";
  27. }
  28. }