CSSPrimitiveValue:setStringValue() 方法

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

CSSPrimitiveValue 介面的 setStringValue() 方法用於設定字串值。如果此值關聯的屬性無法接受指定的單位或字串值,則該值將保持不變,並會丟擲 DOMException

注意:此方法是建立型別化 CSS 物件模型(Typed CSS Object Model)嘗試的一部分。該嘗試已被放棄,大多數瀏覽器並未實現它。

要實現您的目的,您可以使用

語法

js
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 型別化物件模型 API 所取代,該 API 現在已處於標準軌道。

瀏覽器相容性