Module  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

    • 方法摘要

      所有方法  接口方法  抽象方法 
      Modifier and Type 方法 描述
      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字符串值具有语法错误且不可显示，则引发。
        NO_MODIFICATION_ALLOWED_ERR：如果此声明是只读的或属性是只读的，则引发。

      • 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：如果此声明是只读的或属性是只读的，则引发。

      • 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：如果此声明是只读的或属性是只读的，则引发。

      • getLength

        int getLength​()
        在此声明块中已显式设置的属性数。 有效索引的范围为0到length-1。

      • item

        String item​(int index)
        用于检索在此声明块中已显式设置的属性。 使用此方法检索的属性的顺序不一定是设置它们的顺序。 此方法可用于迭代此声明块中的所有属性。
        参数
        index - 要检索的属性名称的索引。
        结果
        在这个顺序位置的财产的名称。 空字符串，如果没有属性存在于此位置。

      • getParentRule

        CSSRule getParentRule​()
        包含此声明块的CSS规则或 null如果此 CSSStyleDeclaration未附加到 CSSRule 。