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

adamwathan · neupauer · adamwathan · commit f34214ecccc7 · 2021-05-07T13:56:13.000-04:00
* Add mix-blend-mode utilities

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

Co-Authored-By: Peter Neupauer &lt;peter@neupauer.sk&gt;

* Add `background-blend-mode` utilities

Co-Authored-By: Peter Neupauer &lt;peter@neupauer.sk&gt;

Co-authored-by: Peter Neupauer &lt;peter@neupauer.sk&gt;
diff --git a/__tests__/fixtures/tailwind-output-flagged.css b/__tests__/fixtures/tailwind-output-flagged.css
diff --git a/__tests__/fixtures/tailwind-output-important.css b/__tests__/fixtures/tailwind-output-important.css
diff --git a/__tests__/fixtures/tailwind-output-no-color-opacity.css b/__tests__/fixtures/tailwind-output-no-color-opacity.css
diff --git a/__tests__/fixtures/tailwind-output.css b/__tests__/fixtures/tailwind-output.css
diff --git a/jit/corePlugins/backgroundBlendMode.js b/jit/corePlugins/backgroundBlendMode.js
@@ -0,0 +1 @@
+module.exports = require('../../lib/plugins/backgroundBlendMode').default()
diff --git a/jit/corePlugins/index.js b/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'),
diff --git a/jit/corePlugins/mixBlendMode.js b/jit/corePlugins/mixBlendMode.js
@@ -0,0 +1 @@
+module.exports = require('../../lib/plugins/mixBlendMode').default()
diff --git a/jit/tests/basic-usage.test.css b/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),
diff --git a/jit/tests/basic-usage.test.html b/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>
diff --git a/src/corePluginList.js b/src/corePluginList.js
@@ -120,4 +120,6 @@ export const corePluginList = [
   'transitionDuration',
   'transitionDelay',
   'animation',
+  'mixBlendMode',
+  'backgroundBlendMode',
 ]
diff --git a/src/plugins/backgroundBlendMode.js b/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')
+    )
+  }
+}
diff --git a/src/plugins/index.js b/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'
diff --git a/src/plugins/mixBlendMode.js b/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')
+    )
+  }
+}
diff --git a/stubs/defaultConfig.stub.js b/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'],

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+module.exports = require('../../lib/plugins/backgroundBlendMode').default()`
Original file line number	Diff line number	Diff line change
`@@ -120,4 +120,6 @@ export const corePluginList = [`
`120`	`120`	`'transitionDuration',`
`121`	`121`	`'transitionDelay',`
`122`	`122`	`'animation',`
	`123`	`+ 'mixBlendMode',`
	`124`	`+ 'backgroundBlendMode',`
`123`	`125`	`]`