Utilities for controlling the box shadow of an element.
Use the shadow-sm
, shadow
, shadow-md
, shadow-lg
, shadow-xl
, or shadow-2xl
utilities to apply different sized outer box shadows to an element.
<div class="shadow-sm ..."></div>
<div class="shadow ..."></div>
<div class="shadow-md ..."></div>
<div class="shadow-lg ..."></div>
<div class="shadow-xl ..."></div>
<div class="shadow-2xl ..."></div>
Use the shadow-inner
utility to apply a subtle inset box shadow to an element. This can be useful for things like form controls or wells.
<div class="shadow-inner ..."></div>
Use shadow-none
to remove an existing box shadow from an element. This is most commonly used to remove a shadow that was applied at a smaller breakpoint.
<div class="shadow-none ..."></div>
To control the shadow of an element at a specific breakpoint, add a {screen}:
prefix to any existing shadow utility. For example, use md:shadow-lg
to apply the shadow-lg
utility at only medium screen sizes and above.
<div class="shadow md:shadow-lg ...">
<!-- ... -->
</div>
For more information about Tailwind’s responsive design features, check out the Responsive Design documentation.
By default, Tailwind provides six drop shadow utilities, one inner shadow utility, and a utility for removing existing shadows. You can change, add, or remove these by editing the theme.boxShadow
section of your Tailwind config.
If a DEFAULT
shadow is provided, it will be used for the non-suffixed shadow
utility. Any other keys will be used as suffixes, for example the key '2'
will create a corresponding shadow-2
utility.
// tailwind.config.js
module.exports = {
theme: {
boxShadow: {
sm: '0 1px 2px 0 rgba(0, 0, 0, 0.05)',
DEFAULT: '0 1px 3px 0 rgba(0, 0, 0, 0.1), 0 1px 2px 0 rgba(0, 0, 0, 0.06)',
md: '0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06)',
lg: '0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05)',
xl: '0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04)',
'2xl': '0 25px 50px -12px rgba(0, 0, 0, 0.25)',
+ '3xl': '0 35px 60px -15px rgba(0, 0, 0, 0.3)',
inner: 'inset 0 2px 4px 0 rgba(0, 0, 0, 0.06)',
none: 'none',
}
}
}
默認情況下, 只有 響應式、group-hover、focus-within、hover 和 focus 的 box shadow 變化模式 (variants) 會產生。
在 tailwind.config.js
的 variants
區塊中變更 boxShadow
屬性來決定有哪些變化模式會生成。
舉個例子來說,這個設定將會生成 響應式 和 active 的變化模式。
// tailwind.config.js
module.exports = {
variants: {
extend: {
// ...
+ boxShadow: ['responsive', 'active'],
}
}
}
如果你不打算在專案中使用 box shadow 功能,可以在你的設定檔裡的 corePlugins
屬性中將 boxShadow
設定為 false
來停用功能:
// tailwind.config.js
module.exports = {
corePlugins: {
// ...
+ boxShadow: false,
}
}