gradientUnits

Атрибут gradientUnits задаёт систему координат, используемую для атрибутов, указанных в элементах градиента.

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

• <linearGradient>
• <radialGradient>

linearGradient

Для <linearGradient> атрибут gradientUnits задаёт систему координат, используемую для атрибутов x1, y1, x2 и y2.

userSpaceOnUse

Это значение указывает, что атрибуты задают значения в системе координат, полученной в результате использования текущей пользовательской системы координат, действующей в момент обращения к элементу градиента (то есть пользовательской системы координат элемента, который ссылается на элемент градиента с помощью свойства fill или stroke), с последующим применением преобразования, заданного атрибутом gradientTransform. Проценты обозначают значения относительно текущей области просмотра SVG.

objectBoundingBox

Это значение указывает, что пользовательская система координат для атрибутов создаётся на основе ограничивающей рамки элемента, к которому применяется градиент, а затем к ней применяется преобразование, заданное атрибутом gradientTransform.

Проценты обозначают значения относительно ограничивающей рамки объекта.

При этом значении и gradientTransform, являющейся единичной матрицей, нормаль линейного градиента перпендикулярна вектору градиента в пространстве ограничивающей рамки объекта (то есть в абстрактной системе координат, где точка (0,0) находится вверху слева ограничивающей рамки объекта, а точка (1,1) — внизу справа). Если ограничивающая рамка объекта не квадратная, нормаль градиента, изначально перпендикулярная вектору градиента в пространстве ограничивающей рамки объекта, при отображении может оказаться неперпендикулярной вектору градиента в пользовательском пространстве. Если вектор градиента параллелен одной из осей ограничивающей рамки, нормаль градиента останется перпендикулярной. Такое преобразование обусловлено применением неравномерного масштабирования при переходе из пространства ограничивающей рамки в пользовательское пространство.

radialGradient

Для <radialGradient> атрибут gradientUnits задаёт систему координат, используемую для атрибутов cx, cy, r, fx, fy и fr.

userSpaceOnUse

cx, cy, r, fx, fy и fr задают значения в системе координат, полученной в результате использования текущей пользовательской системы координат, действующей в момент обращения к элементу градиента (то есть пользовательской системы координат элемента, который ссылается на элемент градиента с помощью свойства fill или stroke), с последующим применением преобразования, заданного атрибутом gradientTransform.

objectBoundingBox

Для <radialGradient>: пользовательская система координат для атрибутов cx, cy, r, fx, fy и fr создаётся на основе ограничивающей рамки элемента, к которому применяется градиент (см. раздел «Единицы измерения ограничивающей рамки объекта»), а затем к ней применяется преобразование, заданное атрибутом gradientTransform. При этом значении и gradientTransform, являющейся единичной матрицей, окружности радиального градиента являются круглыми относительно пространства ограничивающей рамки объекта (то есть абстрактной системы координат, где точка (0,0) находится вверху слева ограничивающей рамки объекта, а точка (1,1) — внизу справа). Если ограничивающая рамка объекта не квадратная, окружности, концептуально являющиеся круглыми в пространстве ограничивающей рамки объекта, при отображении станут эллиптическими из-за применения неравномерного масштабирования при переходе из пространства ограничивающей рамки в пользовательское пространство.

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

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

svg.elements.linearGradient.gradientUnits

svg.elements.radialGradient.gradientUnits