CSSPrimitiveValue: метод getFloatValue()

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

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

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

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

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

Синтаксис

getFloatValue(unit)

Параметры

unit

Значение 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>` в секундах.

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

Значение с плавающей запятой в указанных единицах.

Исключения

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

Примеры

const cs = window.getComputedStyle(document.body);
const cssValue = cs.getPropertyCSSValue("margin-top");
console.log(cssValue.getFloatValue(CSSPrimitiveValue.CSS_CM));

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

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

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

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`getFloatValue`	1–40	Нет	20–62	≤12.1–27	3	18–40	20–62	≤12.1–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/getFloatValue