模块  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 只能使用getPropertyValuesetProperty方法访问和修改速记属性值作为字符串。
        参数
        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