CSSPrimitiveValue: метод setStringValue()

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

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

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

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

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

Синтаксис

setStringValue(stringType, stringValue)

Параметры

stringType

Тип значения, представленный unsigned short. Возможные значения:

Константа	Описание
`CSS_ATTR`	Значение является функцией `attr()`.
`CSS_IDENT`	Значение является идентификатором.
`CSS_STRING`	Значение является `<string>`.
`CSS_URI`	Значение является `<url>`.

stringValue

Строка, представляющая новое строковое значение.

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

Ничего (undefined).

Исключения

InvalidAccessError DOMException: Выбрасывается, если значение CSS не содержит строковое значение или если строковое значение не может быть преобразовано в указанную единицу.
`NoModificationAllowedError' DOMException: Выбрасывается, если свойство является только для чтения.

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

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

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

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

	Рабочие столы					Мобильные
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`setStringValue`	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/setStringValue