-
public interface CSSStyleDeclaration
CSSStyleDeclaration
接口表示单个CSS声明块。 此接口可用于确定当前在块中设置的样式属性,或在块中显式设置样式属性。虽然实现可能无法识别CSS声明块中的所有CSS属性,但是期望通过
CSSStyleDeclaration
接口提供对样式表中所有指定属性的访问。 此外,支持特定CSS级别的实现应该正确处理该级别的CSS速记属性。 有关速记属性的进一步讨论,请参见CSS2Properties
界面。此接口还用于提供对元素计算值的只读访问。 另请参见
ViewCSS
接口。 CSS对象模型不提供对CSS级联的指定值或实际值的访问。- 从以下版本开始:
- 1.4,DOM Level 2
-
-
方法摘要
所有方法 实例方法 抽象方法 变量和类型 方法 描述 String
getCssText()
声明块的可解析文本表示(不包括周围的花括号)。int
getLength()
已在此声明块中显式设置的属性数。CSSRule
getParentRule()
包含该声明块或CSS规则null
如果CSSStyleDeclaration
没有连接到CSSRule
。CSSValue
getPropertyCSSValue(String propertyName)
用于检索CSS属性值的对象表示(如果已在此声明块中显式设置)。String
getPropertyPriority(String propertyName)
如果已在此声明块中明确设置优先级,则用于检索CSS属性的优先级(例如,"important"
限定符)。String
getPropertyValue(String propertyName)
用于检索CSS属性的值(如果已在此声明块中显式设置)。String
item(int index)
用于检索已在此声明块中显式设置的属性。String
removeProperty(String propertyName)
用于删除CSS属性(如果已在此声明块中显式设置)。void
setCssText(String cssText)
声明块的可解析文本表示(不包括周围的花括号)。void
setProperty(String propertyName, String value, String priority)
用于在此声明块中设置属性值和优先级。
-
-
-
方法详细信息
-
getCssText
String getCssText()
声明块的可解析文本表示(不包括周围的花括号)。 设置此属性将导致解析新值并重置声明块中的所有属性,包括删除或添加属性。
-
setCssText
void setCssText(String cssText) throws DOMException
声明块的可解析文本表示(不包括周围的花括号)。 设置此属性将导致解析新值并重置声明块中的所有属性,包括删除或添加属性。- 异常
-
DOMException
- SYNTAX_ERR:如果指定的CSS字符串值具有语法错误且不可DOMException
此异常。
NO_MODIFICATION_ALLOWED_ERR:如果此声明是readonly或属性是readonly,则引发。
-
getPropertyValue
String getPropertyValue(String propertyName)
用于检索CSS属性的值(如果已在此声明块中显式设置)。- 参数
-
propertyName
- CSS属性的名称。 请参阅CSS属性索引。 - 结果
- 如果已为此声明块显式设置,则返回该属性的值。 如果尚未设置属性,则返回空字符串。
-
getPropertyCSSValue
CSSValue getPropertyCSSValue(String propertyName)
用于检索CSS属性值的对象表示(如果已在此声明块中显式设置)。 如果属性是速记属性,则此方法返回null
。 只能使用getPropertyValue
和setProperty
方法访问和修改速记属性值作为字符串。- 参数
-
propertyName
- CSS属性的名称。 请参阅CSS属性索引。 - 结果
-
如果已为此声明块显式设置,则返回该属性的值。
如果尚未设置属性,则返回
null
。
-
removeProperty
String removeProperty(String propertyName) throws DOMException
用于删除CSS属性(如果已在此声明块中显式设置)。- 参数
-
propertyName
- CSS属性的名称。 请参阅CSS属性索引。 - 结果
- 如果已为此声明块显式设置,则返回该属性的值。 如果尚未设置属性或属性名称与已知CSS属性不对应,则返回空字符串。
- 异常
-
DOMException
- NO_MODIFICATION_ALLOWED_ERR:如果此声明是readonly或属性是readonly,则引发此异常。
-
getPropertyPriority
String getPropertyPriority(String propertyName)
如果已在此声明块中明确设置优先级,则用于检索CSS属性的优先级(例如,"important"
限定符)。- 参数
-
propertyName
- CSS属性的名称。 请参阅CSS属性索引。 - 结果
-
表示优先级的字符串(例如
"important"
),如果已在此声明块中显式设置了属性并且指定了优先级。 否则为空字符串。
-
setProperty
void setProperty(String propertyName, String value, String priority) throws DOMException
用于在此声明块中设置属性值和优先级。setProperty
允许修改属性或在声明块中添加新属性。 对此方法的任何调用都可能会修改item
方法中的属性顺序。- 参数
-
propertyName
- CSS属性的名称。 请参阅CSS属性索引。 -
value
- 该属性的新值。 -
priority
- 属性的新优先级(例如"important"
)或空字符串(如果没有)。 - 异常
-
DOMException
- SYNTAX_ERR:如果指定的值具有语法错误且不可DOMException
此异常。
NO_MODIFICATION_ALLOWED_ERR:如果此声明是readonly或属性是readonly,则引发。
-
getLength
int getLength()
已在此声明块中显式设置的属性数。 有效索引的范围是0到length-1(包括0和length-1)。
-
item
String item(int index)
用于检索已在此声明块中显式设置的属性。 使用此方法检索的属性的顺序不必是它们的设置顺序。 此方法可用于迭代此声明块中的所有属性。- 参数
-
index
- 要检索的属性名称的索引。 - 结果
- 此序号位置的属性名称。 如果此位置不存在属性,则为空字符串。
-
getParentRule
CSSRule getParentRule()
包含该声明块或CSS规则null
如果CSSStyleDeclaration
没有连接到CSSRule
。
-
-