mask

Базовая поддержка 2023

Недавно стало доступно

С декабря 2023 года эта функция поддерживается на последних устройствах и в последних версиях браузеров. Она может не работать на старых устройствах и в старых браузерах.

Атрибут mask — это атрибут представления, который в основном используется для привязки элемента <mask> к элементу, которому принадлежит этот атрибут.

Примечание: У атрибута представления mask также есть соответствующее свойство CSS: mask. Если заданы оба варианта, приоритет имеет свойство CSS.

Этот атрибут можно использовать со следующими элементами SVG:

Пример

<svg viewBox="0 0 200 100" xmlns="http://www.w3.org/2000/svg">
  <mask id="myMask" maskContentUnits="objectBoundingBox">
    <rect fill="white" x="0" y="0" width="100%" height="100%" />
    <polygon
      fill="black"
      points="0.5,0.2 0.68,0.74 0.21,0.41 0.79,0.41 0.32,0.74" />
  </mask>

  <!--
  Punch a hole in a shape of a star inside the red circle,
  revealing the yellow circle underneath
  -->
  <circle cx="50" cy="50" r="20" fill="yellow" />
  <circle cx="50" cy="50" r="45" fill="red" mask="url(#myMask)" />
</svg>

Начиная с SVG2, атрибут mask определён как свойство CSS и является сокращённой записью для нескольких других свойств: mask-image, mask-mode, mask-repeat, mask-position, mask-clip, mask-origin, mask-size и mask-composite.

Примечания по использованию

Значение	См. свойство CSS `mask`
Значение по умолчанию	`none`
Анимируемый	Да

Спецификации

Спецификация
CSS Masking Module Level 1> # the-mask>

Совместимость с браузерами

	Компьютер					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome для Android	Firefox для Android	Opera для Android	Safari для iOS	Samsung Internet	WebView для Android	WebView для iOS
`mask`	120 1 Префиксное свойство можно использовать с SVG и HTML с немного отличающимся синтаксисом, который позволяет задавать нестандартное свойство `-webkit-mask-attachment`. 1–120 Свойство распознаётся, но заданные для него значения не оказывают никакого эффекта.	120 79 Префиксное свойство можно использовать с SVG и HTML с немного отличающимся синтаксисом, который позволяет задавать нестандартное свойство `-webkit-mask-attachment`. 79–120 Свойство распознаётся, но заданные для него значения не оказывают никакого эффекта. 12–79	53 2–53 Поддерживаются только `mask: url(file.svg#mask_id)` или `mask: url(#mask_id)`, URL которых ссылается на элемент `<mask>` SVG.	106 15 Префиксное свойство можно использовать с SVG и HTML с немного отличающимся синтаксисом, который позволяет задавать нестандартное свойство `-webkit-mask-attachment`. 15–106 Свойство распознаётся, но заданные для него значения не оказывают никакого эффекта.	15.4 3.1 Префиксное свойство можно использовать с SVG и HTML с немного отличающимся синтаксисом, который позволяет задавать нестандартное свойство `-webkit-mask-attachment`. 3.1–15.4 Свойство распознаётся, но заданные для него значения не оказывают никакого эффекта.	120 18 Префиксное свойство можно использовать с SVG и HTML с немного отличающимся синтаксисом, который позволяет задавать нестандартное свойство `-webkit-mask-attachment`. 18–120 Свойство распознаётся, но заданные для него значения не оказывают никакого эффекта.	53 4–53 Поддерживаются только `mask: url(file.svg#mask_id)` или `mask: url(#mask_id)`, URL которых ссылается на элемент `<mask>` SVG.	80 14 Префиксное свойство можно использовать с SVG и HTML с немного отличающимся синтаксисом, который позволяет задавать нестандартное свойство `-webkit-mask-attachment`. 14–80 Свойство распознаётся, но заданные для него значения не оказывают никакого эффекта.	15.4 2 Префиксное свойство можно использовать с SVG и HTML с немного отличающимся синтаксисом, который позволяет задавать нестандартное свойство `-webkit-mask-attachment`. 2–15.4 Свойство распознаётся, но заданные для него значения не оказывают никакого эффекта.	25.0 1.0 Префиксное свойство можно использовать с SVG и HTML с немного отличающимся синтаксисом, который позволяет задавать нестандартное свойство `-webkit-mask-attachment`. 1.0–25.0 Свойство распознаётся, но заданные для него значения не оказывают никакого эффекта.	120 3 Префиксное свойство можно использовать с SVG и HTML с немного отличающимся синтаксисом, который позволяет задавать нестандартное свойство `-webkit-mask-attachment`. 3–120 Свойство распознаётся, но заданные для него значения не оказывают никакого эффекта.	15.4 2 Префиксное свойство можно использовать с SVG и HTML с немного отличающимся синтаксисом, который позволяет задавать нестандартное свойство `-webkit-mask-attachment`. 2–15.4 Свойство распознаётся, но заданные для него значения не оказывают никакого эффекта.

См. также

Свойство CSS mask

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Attribute/mask