1. Эффекты
  2. mask-image

Эффекты

mask-image

Утилиты для управления маской изображения элемента.

ClassStyles
mask-[<value>]
mask-image: <value>;
mask-(<custom-property>)
mask-image: var(<custom-property>);
mask-none
mask-image: none;
mask-linear-<number>
mask-image: linear-gradient(<number>deg, black var(--tw-mask-linear-from)), transparent var(--tw-mask-linear-to));
-mask-linear-<number>
mask-image: linear-gradient(calc(<number>deg * -1), black var(--tw-mask-linear-from)), transparent var(--tw-mask-linear-to));
mask-linear-from-<number>
mask-image: linear-gradient(var(--tw-mask-linear-position), black calc(var(--spacing * <number>)), transparent var(--tw-mask-linear-to));
mask-linear-from-<percentage>
mask-image: linear-gradient(var(--tw-mask-linear-position), black <percentage>, transparent var(--tw-mask-linear-to));
mask-linear-from-<color>
mask-image: linear-gradient(var(--tw-mask-linear-position), <color> var(--tw-mask-linear-from), transparent var(--tw-mask-linear-to));
mask-linear-from-(<custom-property>)
mask-image: linear-gradient(var(--tw-mask-linear-position), black <custom-property>, transparent var(--tw-mask-linear-to));
mask-linear-from-[<value>]
mask-image: linear-gradient(var(--tw-mask-linear-position), black <value>, transparent var(--tw-mask-linear-to));

Примеры

Использование маски изображения

Используйте синтаксис mask-[<value>] для установки маски изображения элемента:

<div class="mask-[url(/img/scribble.png)] bg-[url(/img/mountains.jpg)] ...">  <!-- ... --></div>

Маскирование краев

Используйте утилиты такие как mask-b-from-<value> и mask-t-to-<value> для добавления линейной градиентной маски к одной стороне элемента:

mask-t-from-50%

mask-r-from-30%

mask-l-from-50% mask-l-to-90%

mask-b-from-20% mask-b-to-80%

<div class="mask-t-from-50% bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-r-from-30% bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-l-from-50% mask-l-to-90% bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-b-from-20% mask-b-to-80% bg-[url(/img/mountains.jpg)] ..."></div>

Кроме того, используйте утилиты такие как mask-x-from-70% и mask-y-to-90% для применения маски к двум сторонам элемента одновременно:

mask-x-from-70% mask-x-to-90%

mask-y-from-70% mask-y-to-90%

<div class="mask-x-from-70% mask-x-to-90% bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-y-from-70% mask-y-to-90% bg-[url(/img/mountains.jpg)] ..."></div>

По умолчанию линейные градиентные маски переходят от черного к прозрачному, но вы можете настроить цвета градиента, используя утилиты mask-<side>-from-<color> и mask-<side>-to-<color>.

Добавление угловой линейной маски

Используйте утилиты такие как mask-linear-<angle>, mask-linear-from-20 и mask-linear-to-40 для добавления пользовательской линейной градиентной маски к элементу:

mask-linear-50

-mask-linear-50

<div class="mask-linear-50 mask-linear-from-60% mask-linear-to-80% bg-[url(/img/mountains.jpg)] ..."></div><div class="-mask-linear-50 mask-linear-from-60% mask-linear-to-80% bg-[url(/img/mountains.jpg)] ..."></div>

Добавление радиальной маски

Используйте утилиты mask-radial-from-<value> и mask-radial-to-<value> для добавления радиальной градиентной маски к элементу:

Скорость

Создано для опытных пользователей

Работайте быстрее чем когда-либо с нашими сочетаниями клавиш

<div class="flex items-center gap-4">  <img class="mask-radial-[100%_100%] mask-radial-from-75% mask-radial-at-left ..." src="/img/keyboard.png" />  <div class="font-medium">    <p class="font-mono text-xs text-blue-500 uppercase dark:text-blue-400">Скорость</p>    <p class="mt-2 text-base text-gray-700 dark:text-gray-300">Создано для опытных пользователей</p>    <p class="mt-1 text-sm leading-relaxed text-balance text-gray-500">      Работайте быстрее чем когда-либо с настраиваемыми сочетаниями клавиш    </p>  </div></div>

По умолчанию радиальные градиентные маски переходят от черного к прозрачному, но вы можете настроить цвета градиента, используя утилиты mask-radial-from-<color> и mask-radial-to-<color>.

Установка радиальной позиции

Используйте утилиты такие как mask-radial-at-bottom-left и mask-radial-at-[35%_35%] для установки позиции центра радиальной градиентной маски:

mask-radial-at-top-left

mask-radial-at-top

mask-radial-at-top-right

mask-radial-at-left

mask-radial-at-center

mask-radial-at-right

mask-radial-at-bottom-left

mask-radial-at-bottom

mask-radial-at-bottom-right

<div class="mask-radial-at-top-left mask-radial-from-100% bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-radial-at-top mask-radial-from-100% bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-radial-at-top-right mask-radial-from-100% bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-radial-at-left mask-radial-from-100% bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-radial-at-center mask-radial-from-100% bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-radial-at-right mask-radial-from-100% bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-radial-at-bottom-left mask-radial-from-100% bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-radial-at-bottom mask-radial-from-100% bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-radial-at-bottom-right mask-radial-from-100% bg-[url(/img/mountains.jpg)] ..."></div>

Это отличается от mask-position, который устанавливает позицию самого изображения маски, а не радиального градиента.

Установка радиального размера

Используйте утилиты такие как mask-radial-closest-corner и mask-radial-farthest-side для установки размера радиальной градиентной маски:

mask-radial-closest-side

mask-radial-closest-corner

mask-radial-farthest-side

mask-radial-farthest-corner

<div class="mask-radial-closest-side mask-radial-from-100% mask-radial-at-[30%_30%] bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-radial-closest-corner mask-radial-from-100% mask-radial-at-[30%_30%] bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-radial-farthest-side mask-radial-from-100% mask-radial-at-[30%_30%] bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-radial-farthest-corner mask-radial-from-100% mask-radial-at-[30%_30%] bg-[url(/img/mountains.jpg)] ..."></div>

При установке пользовательского размера радиального градиента единицы, которые вы можете использовать, зависят от <ending-shape> градиента, который по умолчанию установлен в ellipse.

С mask-circle вы можете использовать только одну фиксированную длину, например mask-radial-[5rem]. В то время как с mask-ellipse, вы можете указать каждую ось как фиксированную длину или процент, например mask-radial-[40%_80%].

Добавление конической маски

Используйте утилиты mask-conic-from-<value>, mask-conic-to-<value> и mask-conic-<angle> для добавления конической градиентной маски к элементу:

Использовано хранилища: 75%

0.48 ГБ из 2 ГБ осталось

<div class="flex items-center gap-5 rounded-xl bg-white p-4 shadow-lg ring-1 ring-black/5 dark:bg-gray-800">  <div class="grid grid-cols-1 grid-rows-1">    <div class="border-4 border-gray-100 dark:border-gray-700 ..."></div>    <div class="border-4 border-amber-500 mask-conic-from-75% mask-conic-to-75% dark:border-amber-400 ..."></div>  </div>  <div class="w-0 flex-1 text-sm text-gray-950 dark:text-white">    <p class="font-mono text-xs text-blue-500 uppercase dark:text-blue-400">Использовано хранилища: 75%</p>    <p class="mt-1 text-gray-500 dark:text-gray-400"><span class="font-medium">0.48 ГБ</span> из 2 ГБ осталось</p>  </div></div>

По умолчанию конические градиентные маски переходят от черного к прозрачному, но вы можете настроить цвета градиента, используя утилиты mask-conic-from-<color> и mask-conic-to-<color>.

Комбинирование масок

Утилиты градиентных масок, такие как mask-radial-from-<value>, mask-conic-to-<value> и mask-l-from-<value>, можно комбинировать для создания более сложных градиентных масок:

<div class="mask-b-from-50% mask-radial-[50%_90%] mask-radial-from-80% bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-r-from-80% mask-b-from-80% mask-radial-from-70% mask-radial-to-85% bg-[url(/img/mountains.jpg)] ..."></div>

Это поведение основано на том факте, что Tailwind устанавливает свойство mask-composite в intersect по умолчанию. Изменение этого свойства повлияет на то, как градиентные маски объединяются.

Удаление масок изображений

Используйте утилиту mask-none для удаления существующей маски изображения с элемента:

<div class="mask-none">  <!-- ... --></div>

Использование пользовательского значения

Используйте такие утилиты, как mask-linear-[<value>] and mask-radial-[<value>], чтобы задать mask image на основе полностью пользовательского значения:

<div class="mask-linear-[70deg,transparent_10%,black,transparent_80%] ...">  <!-- ... --></div>

Для переменных CSS вы также можете использовать синтаксис: mask-linear-(<custom-property>)

<div class="mask-linear-(--my-mask) ...">  <!-- ... --></div>

Это просто сокращение, mask-linear-[var(<custom-property>)] которое автоматически добавляет функцию var().

Адаптивный дизайн

Префикс a mask-image утилита с вариантом контрольной точки, например md:, чтобы применить утилиту только при размерах экрана medium и выше:

<div class="mask-radial-from-70% md:mask-radial-from-50% ...">  <!-- ... --></div>

Подробнее об использовании вариантов читайте в документации по вариантам.

Кастомизация вашей темы

Используйте переменные темы --color-* для настройки утилит color в вашем проекте:

@theme {  --color-regal-blue: #243c5a; }

Теперь утилиты типа mask-radial-from-regal-blue,mask-conic-to-regal-blue, and mask-b-from-regal-blue можно использовать в вашей разметке:

<div class="mask-radial-from-regal-blue">  <!-- ... --></div>

Подробнее о настройке темы читайте в документации темы.

Авторские права © 2025 Tailwind Labs Inc.·Политика в отношении товарных знаков