模块  jdk.xml.dom
软件包  org.w3c.dom.css

Interface CSSStyleDeclaration

  • public interface CSSStyleDeclaration
    CSSStyleDeclaration接口表示单个CSS声明块。 此接口可用于确定当前在块中设置的样式属性，或在块中显式设置样式属性。

    虽然实现可能无法识别CSS声明块中的所有CSS属性，但是期望通过CSSStyleDeclaration接口提供对样式表中所有指定属性的访问。 此外，支持特定CSS级别的实现应该正确处理该级别的CSS速记属性。 有关速记属性的进一步讨论，请参见CSS2Properties界面。

    此接口还用于提供对元素计算值的只读访问。 另请参见ViewCSS接口。 CSS对象模型不提供对CSS级联的指定值或实际值的访问。

    另见Document Object Model (DOM) Level 2 Style Specification 。

    从以下版本开始：
    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 。