Add mix-blend-mode and background-blend-mode utilities (#3920)

* Add mix-blend-mode utilities

* Rename mix-blend-mode utilities to `mix-blend-*`

Co-Authored-By: Peter Neupauer <peter@neupauer.sk>

* Add `background-blend-mode` utilities

Co-Authored-By: Peter Neupauer <peter@neupauer.sk>

Co-authored-by: Peter Neupauer <peter@neupauer.sk>

jit/corePlugins/backgroundBlendMode.js

@@ -0,0 +1 @@
+module.exports = require('../../lib/plugins/backgroundBlendMode').default()

jit/corePlugins/index.js

@@ -282,6 +282,8 @@ module.exports = {
   placeholderOpacity: require('./placeholderOpacity'),
 
   opacity: require('./opacity'),
+  backgroundBlendMode: require('./backgroundBlendMode'),
+  mixBlendMode: require('./mixBlendMode'),
   boxShadow: require('./boxShadow'),
   outline: require('./outline'),
   ringWidth: require('./ringWidth'),

jit/corePlugins/mixBlendMode.js

@@ -0,0 +1 @@
+module.exports = require('../../lib/plugins/mixBlendMode').default()

jit/tests/basic-usage.test.css

@@ -576,6 +576,18 @@
 .opacity-90 {
   opacity: 0.9;
 }
+.bg-blend-darken {
+  background-blend-mode: darken;
+}
+.bg-blend-difference {
+  background-blend-mode: difference;
+}
+.mix-blend-multiply {
+  mix-blend-mode: multiply;
+}
+.mix-blend-saturation {
+  mix-blend-mode: saturation;
+}
 .shadow-md {
   --tw-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
   box-shadow: var(--tw-ring-offset-shadow, 0 0 #0000), var(--tw-ring-shadow, 0 0 #0000),

jit/tests/basic-usage.test.html

@@ -88,6 +88,8 @@
     <div class="object-cover"></div>
     <div class="object-bottom"></div>
     <div class="opacity-90"></div>
+    <div class="bg-blend-darken bg-blend-difference"></div>
+    <div class="mix-blend-multiply mix-blend-saturation"></div>
     <div class="order-last order-2"></div>
     <div class="outline-none outline-black"></div>
     <div class="overflow-hidden"></div>

src/corePluginList.js

@@ -120,4 +120,6 @@ export const corePluginList = [
   'transitionDuration',
   'transitionDelay',
   'animation',
+  'mixBlendMode',
+  'backgroundBlendMode',
 ]

src/plugins/backgroundBlendMode.js

@@ -0,0 +1,25 @@
+export default function () {
+  return function ({ addUtilities, variants }) {
+    addUtilities(
+      {
+        '.bg-blend-normal': { 'background-blend-mode': 'normal' },
+        '.bg-blend-multiply': { 'background-blend-mode': 'multiply' },
+        '.bg-blend-screen': { 'background-blend-mode': 'screen' },
+        '.bg-blend-overlay': { 'background-blend-mode': 'overlay' },
+        '.bg-blend-darken': { 'background-blend-mode': 'darken' },
+        '.bg-blend-lighten': { 'background-blend-mode': 'lighten' },
+        '.bg-blend-color-dodge': { 'background-blend-mode': 'color-dodge' },
+        '.bg-blend-color-burn': { 'background-blend-mode': 'color-burn' },
+        '.bg-blend-hard-light': { 'background-blend-mode': 'hard-light' },
+        '.bg-blend-soft-light': { 'background-blend-mode': 'soft-light' },
+        '.bg-blend-difference': { 'background-blend-mode': 'difference' },
+        '.bg-blend-exclusion': { 'background-blend-mode': 'exclusion' },
+        '.bg-blend-hue': { 'background-blend-mode': 'hue' },
+        '.bg-blend-saturation': { 'background-blend-mode': 'saturation' },
+        '.bg-blend-color': { 'background-blend-mode': 'color' },
+        '.bg-blend-luminosity': { 'background-blend-mode': 'luminosity' },
+      },
+      variants('backgroundBlendMode')
+    )
+  }
+}

src/plugins/index.js

@@ -5,6 +5,7 @@ export { default as alignSelf } from './alignSelf'
 export { default as animation } from './animation'
 export { default as appearance } from './appearance'
 export { default as backgroundAttachment } from './backgroundAttachment'
+export { default as backgroundBlendMode } from './backgroundBlendMode'
 export { default as backgroundClip } from './backgroundClip'
 export { default as backgroundColor } from './backgroundColor'
 export { default as backgroundImage } from './backgroundImage'
@@ -70,6 +71,7 @@ export { default as maxHeight } from './maxHeight'
 export { default as maxWidth } from './maxWidth'
 export { default as minHeight } from './minHeight'
 export { default as minWidth } from './minWidth'
+export { default as mixBlendMode } from './mixBlendMode'
 export { default as objectFit } from './objectFit'
 export { default as objectPosition } from './objectPosition'
 export { default as opacity } from './opacity'

src/plugins/mixBlendMode.js

@@ -0,0 +1,25 @@
+export default function () {
+  return function ({ addUtilities, variants }) {
+    addUtilities(
+      {
+        '.mix-blend-normal': { 'mix-blend-mode': 'normal' },
+        '.mix-blend-multiply': { 'mix-blend-mode': 'multiply' },
+        '.mix-blend-screen': { 'mix-blend-mode': 'screen' },
+        '.mix-blend-overlay': { 'mix-blend-mode': 'overlay' },
+        '.mix-blend-darken': { 'mix-blend-mode': 'darken' },
+        '.mix-blend-lighten': { 'mix-blend-mode': 'lighten' },
+        '.mix-blend-color-dodge': { 'mix-blend-mode': 'color-dodge' },
+        '.mix-blend-color-burn': { 'mix-blend-mode': 'color-burn' },
+        '.mix-blend-hard-light': { 'mix-blend-mode': 'hard-light' },
+        '.mix-blend-soft-light': { 'mix-blend-mode': 'soft-light' },
+        '.mix-blend-difference': { 'mix-blend-mode': 'difference' },
+        '.mix-blend-exclusion': { 'mix-blend-mode': 'exclusion' },
+        '.mix-blend-hue': { 'mix-blend-mode': 'hue' },
+        '.mix-blend-saturation': { 'mix-blend-mode': 'saturation' },
+        '.mix-blend-color': { 'mix-blend-mode': 'color' },
+        '.mix-blend-luminosity': { 'mix-blend-mode': 'luminosity' },
+      },
+      variants('mixBlendMode')
+    )
+  }
+}

stubs/defaultConfig.stub.js

@@ -741,6 +741,7 @@ module.exports = {
     animation: ['responsive'],
     appearance: ['responsive'],
     backgroundAttachment: ['responsive'],
+    backgroundBlendMode: ['responsive'],
     backgroundClip: ['responsive'],
     backgroundColor: ['responsive', 'dark', 'group-hover', 'focus-within', 'hover', 'focus'],
     backgroundImage: ['responsive'],
@@ -806,6 +807,7 @@ module.exports = {
     maxWidth: ['responsive'],
     minHeight: ['responsive'],
     minWidth: ['responsive'],
+    mixBlendMode: ['responsive'],
     objectFit: ['responsive'],
     objectPosition: ['responsive'],
     opacity: ['responsive', 'group-hover', 'focus-within', 'hover', 'focus'],