SVGAngle: метод newValueSpecifiedUnits()

Базовая линия Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с января 2020 года.

Метод newValueSpecifiedUnits() интерфейса SVGAngle устанавливает значение в число с ассоциированным unitType, тем самым заменяя значения всех атрибутов объекта.

Синтаксис

svgAngle.newValueSpecifiedUnits(unitType, valueInSpecifiedUnits)

Параметры

unitType

Константа, представляющая тип единицы, в которую должно быть преобразовано значение угла. Она должна быть одним из значений констант, определенных для свойства unitType, за исключением SVG_ANGLETYPE_UNKNOWN.

SVGAngle.SVG_ANGLETYPE_DEG: преобразование в градусы
SVGAngle.SVG_ANGLETYPE_RAD: преобразование в радианы
SVGAngle.SVG_ANGLETYPE_GRAD: преобразование в градианты
SVGAngle.SVG_ANGLETYPE_UNSPECIFIED: преобразование в безразмерное число, интерпретируемое как градусы

valueInSpecifiedUnits

Числовое значение для значения угла, выраженное в указанном типе единиц.

Возвращаемое значение

Ничего (undefined).

Исключения

Этот метод может вызывать DOMException одного из следующих типов:

NotSupportedError DOMException: Выбрасывается, если unitType равно SVG_ANGLETYPE_UNKNOWN или не является допустимой константой типа единицы.
NoModificationAllowedError DOMException: Выбрасывается, если SVGAngle соответствует атрибуту только для чтения или когда сам объект является только для чтения.

Примеры

Установка угла в градусах

// Get an SVGAngle object
const svg = document.querySelector("svg");
const angle = svg.createSVGAngle();

// Set the angle's value in degrees using newValueSpecifiedUnits()
angle.newValueSpecifiedUnits(SVGAngle.SVG_ANGLETYPE_DEG, 45);

// Retrieve the angle's value in degrees
console.log(angle.value); // Output: 45
console.log(angle.unitType); // Output: 2 (SVG_ANGLETYPE_DEG)

Установка угла в радианах

// Get an SVGAngle object
const svg = document.querySelector("svg");
const angle = svg.createSVGAngle();

// Set the angle's value in radians using newValueSpecifiedUnits()
angle.newValueSpecifiedUnits(SVGAngle.SVG_ANGLETYPE_RAD, Math.PI / 2);

// Retrieve the angle's value
console.log(angle.value); // Output: 90
console.log(angle.unitType); // Output: 3 (SVG_ANGLETYPE_RAD)

Установка угла в градиантах

// Get an SVGAngle object
const svg = document.querySelector("svg");
const angle = svg.createSVGAngle();

// Set the angle's value in gradians using newValueSpecifiedUnits()
angle.newValueSpecifiedUnits(SVGAngle.SVG_ANGLETYPE_GRAD, 100);

// Retrieve the angle's value in gradians
console.log(angle.value); // Output: 90
console.log(angle.unitType); // Output: 4 (SVG_ANGLETYPE_GRAD)

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

Спецификация
Scalable Vector Graphics (SVG) 2 # __svg__SVGAngle__newValueSpecifiedUnits

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`newValueSpecifiedUnits`	1	12	1.5	≤12.1	3	18	4	≤12.1	1	1.0	≤37

См. также

SVGAnimatedAngle

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/SVGAngle/newValueSpecifiedUnits