CSSPrimitiveValue: метод setFloatValue()

Устаревший: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут её всё ещё поддерживать, она, возможно, уже удалена из соответствующих веб-стандартов, может быть в процессе удаления или поддерживается только для совместимости. Избегайте её использования и, если возможно, обновите существующий код; см. таблицу совместимости внизу этой страницы для принятия решения. Имейте в виду, что эта функция может перестать работать в любое время.

Метод setFloatValue() интерфейса CSSPrimitiveValue используется для установки значения с плавающей запятой. Если свойство, связанное с этим значением, не может принять указанную единицу или значение с плавающей запятой, значение останется неизменным, и будет вызвано исключение DOMException.

Примечание: Этот метод был частью попытки создания типизированной модели объектов CSS. Эта попытка была прекращена, и большинство браузеров не реализуют её.

Для достижения вашей цели вы можете использовать:

нетипизированную модель объектов CSS, широко поддерживаемую, или
современный API типизированной модели объектов CSS, менее поддерживаемый и рассматриваемый как экспериментальный.

Синтаксис

setFloatValue(unitType, floatValue)

Параметры

unitType

Значение unsigned short, представляющее код типа единицы, в котором должно быть возвращено значение. Допустимые значения:

Константа	Описание
`CSS_CM`	Значение является `<length>` в сантиметрах.
`CSS_DEG`	Значение является `<angle>` в градусах.
`CSS_DIMENSION`	Значение является `<number>` с неизвестной размерностью.
`CSS_EMS`	Значение является `<length>` в единицах em.
`CSS_EXS`	Значение является `<length>` в единицах ex.
`CSS_GRAD`	Значение является `<angle>` в градах.
`CSS_HZ`	Значение является `<frequency>` в Герцах. Значение можно получить, используя метод getFloatValue.
`CSS_IN`	Значение является `<length>` в дюймах.
`CSS_KHZ`	Значение является `<frequency>` в Килогерцах.
`CSS_MM`	Значение является `<length>` в миллиметрах.
`CSS_MS`	Значение является `<time>` в миллисекундах.
`CSS_NUMBER`	Значение является простым `<number>`.
`CSS_PC`	Значение является `<length>` в пиках.
`CSS_PERCENTAGE`	Значение является `<percentage>`.
`CSS_PT`	Значение является `<length>` в пунктах.
`CSS_PX`	Значение является `<length>` в пикселях.
`CSS_RAD`	Значение является `<angle>` в радианах.
`CSS_S`	Значение является `<time>` в секундах.

floatValue

Значение float, представляющее новое значение с плавающей запятой.

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

Ничего (undefined).

Исключения

Тип Описание

DOMException Возникает исключение INVALID_ACCESS_ERR если значение CSS не содержит числового значения с плавающей запятой или если строковое значение не может быть преобразовано в указанную единицу.
Возникает исключение NO_MODIFICATION_ALLOWED_ERR, если это свойство является только для чтения.

Тип	Описание
`DOMException`	Возникает исключение `INVALID_ACCESS_ERR` если значение CSS не содержит числового значения с плавающей запятой или если строковое значение не может быть преобразовано в указанную единицу. Возникает исключение NO_MODIFICATION_ALLOWED_ERR, если это свойство является только для чтения.

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

Эта функция первоначально была определена в спецификации DOM Style Level 2, но с тех пор была исключена из любых стандартизирующих усилий.

Она была заменена современной, но несовместимой, API типизированной модели объектов CSS, которая сейчас соответствует стандарту.

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

	Рабочие столы					Мобильные телефоны
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`setFloatValue`	1–40	Нет	20–62	15–27	3	18–40	20–62	14–27	1	1.0–4.0	4.4–40

© 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/CSSPrimitiveValue/setFloatValue