## CSSStyleDeclaration CSSStyleDeclaration表示一个CSS 声明块对象,它是一个 CSS 属性键值对的集合,暴露样式信息和各种与样式相关的方法和属性。 ### 方法 #### setProperty(name: string \| string.cssPropertyString, value?: string): void @setproperty 对CSS指定样式设置一个新值,如有此样式已存在则更新。 ##### setProperty 兼容性 Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: 4.51; iOS: 4.51; HarmonyOS: 4.61 ##### 参数 | 名称 | 类型 | 必填 | 默认值 | 描述 | | :- | :- | :- | :- | :- | | name | string ([string.cssPropertyString](/uts/data-type.md#ide-string)) | 是 | | CSS样式名称 | | value | string | 否 | "" | 要设置的新CSS样式值 默认值空字符串 | #### ~~setProperty(name: string \| string.cssPropertyString, value: any): void~~ @setproperty_1 对CSS指定样式设置一个新值,如有此样式已存在则更新。 **已废弃,仅为了向下兼容保留** ##### setProperty 兼容性 Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 ##### 参数 | 名称 | 类型 | 必填 | 描述 | | :- | :- | :- | :- | | name | string ([string.cssPropertyString](/uts/data-type.md#ide-string)) | 是 | CSS样式名称 | | value | any | 否 | 要设置的新CSS样式值 | #### getPropertyValue(property: string \| string.cssPropertyString): string @getpropertyvalue 获取CSS指定的样式值,如果指定的样式不存在则返回空字符串。 ##### getPropertyValue 兼容性 Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: 4.51; iOS: 4.51; HarmonyOS: 4.61 ##### 参数 | 名称 | 类型 | 必填 | 描述 | | :- | :- | :- | :- | | property | string ([string.cssPropertyString](/uts/data-type.md#ide-string)) | 是 | 要获取的CSS样式名称 | ##### 返回值 | 类型 | | :- | | string | #### App平台 > HBuilderX4.51版本调整 `getPropertyValue` 返回值类型为 string App平台获取样式值与Web平台存在部分差异: - 组件通过 class 设置的 CSS 样式,App平台可通过 `getPropertyValue` 获取生效的样式值,Web平台不可获取(返回空字符串)。 如下示例,在class中设置background-color样式,App平台可通过 getPropertyValue 获取: ```vue ``` 注意:App平台在 class 中设置部分的css样式会做转换,规则如下 + named-color 会转换为十六进制颜色六值语法(即 #RRGGBB 格式),如在class中设置 background-color 为 blue,获取的值为 #0000FF - 组件通过 class 和 style 同时设置的 CSS 样式,App平台通过 `getPropertyValue` 获取的是合并计算后生效的样式,Web平台获取的是 style 属性设置的样式。 如下示例,在class中设置的border-top-style样式覆盖了style中设置的border-top-style样式,App平台可通过 getPropertyValue 获取计算后生效的样式值: ```vue ``` - 组件通过 style 设置的 CSS 简写样式,App平台会拆解(Expansion)部分简写样式,拆解(Expansion)的样式通过 `getPropertyValue` 只能获取拆解后的样式,获取拆解前的简写样式返回空字符串。 拆解的简写样式包括: + border + border-bottom + border-left + border-right + border-top + border-color + border-raidus + border-style + broder-width + margin + padding 如下示例,在style中设置简写样式border-color,App平台通过 getPropertyValue 获取拆解前样式 border-color 返回空字符串,获取拆解后样式 border-top-color 返回"#FFFF00": ```vue ``` 注意:通过 class 设置的 CSS 简写样式,App平台获取的也是拆解(Expansion)后的样式 - 通过 `setProperty` 设置的 CSS 简写样式,App平台通过 `getPropertyValue` 只能获取简写样式,获取拆解(Expansion)后的样式返回空字符串。 如下示例,通过 setProperty 设置 border-style 简写样式为 "dotted",App平台通过 getPropertyValue 获取 border-style 会返回设置的值"dotted",获取 border-top-style 返回空字符串: ```vue ``` 注意:通过 `setProperty` 设置的 CSS 所有样式,App平台不会做转换处理,获取时原样返回 **蒸汽模式(Vapor)** 蒸汽模式(Vapor)为了提升 CSS 的性能,App平台将所有样式数据在编译器和运行期都做了类型化转换,丢失了原始字符串数据(即获取值与设置值不完全一致),与 VDOM 模式存在以下差异: - 没有设置的样式,App平台蒸汽模式(Vapor)下通过 `getPropertyValue` 获取将返回默认值,VDOM 模式返回空字符串。 如下示例,没有设置 flex-direction 样式,App平台在蒸汽模式(Vapor)下通过 getPropertyValue 获取 flex-direction 返回 "column",非蒸汽模式下返回空字符串: ```vue ``` - CSS 简写样式,App平台蒸汽模式(Vapor)下通过 `getPropertyValue` 获取将返回完整的拆解值。 如下示例,设置 flex 为 "1",getPropertyValue 获取 flex 返回 "1 1 0%": ```vue ``` 注意:这里 flex 简写样式在 VDOM 模式不会拆解 - 通过 `getPropertyValue` 获取的颜色值(如background-color、color、border-color、border-*-color)格式为十六进制颜色八值语法“#RRGGBBAA”,其中 RR、GG、BB、AA分别对应红色、绿色、蓝色、透明值,使用大写字符。 如下示例,设置 background-color 为 "blue",App平台在蒸汽模式(Vapor)下通过getPropertyValue 获取 background-color 返回 "#0000FFFF": ```vue ``` 特殊值对应的颜色 + transparent: 对应十六进制颜色八值语法为 #00000000 - 通过 `setProperty` 设置布局相关的 CSS 样式,不能立即通过 `getPropertyValue` 同步获取设置的样式,此时返回的是设置前的样式,需要在 `nextTick` 异步回调中通过 `getPropertyValue` 才能获取到设置的值 ```vue ``` 注意:与排版无关的CSS样式(如 background-color、color、font-size等)可通过 `getPropertyValue` 同步获取设置的样式值 - 5.08之前版本蒸汽模式(Vapor)通过 `getPropertyValue` 不支持获取[自定义css变量](../../css/common/function.md) #### removeProperty(property: string \| string.cssPropertyString): string @removeproperty 删除CSS指定的样式值 ##### removeProperty 兼容性 Web: 4.0; Android: 4.51; iOS: 4.51; HarmonyOS(VDOM): 4.61; HarmonyOS(Vapor): x ##### 参数 | 名称 | 类型 | 必填 | 描述 | | :- | :- | :- | :- | | property | string ([string.cssPropertyString](/uts/data-type.md#ide-string)) | 是 | 要删除的CSS样式名称 | ##### 返回值 | 类型 | | :- | | string | ## 示例 ```html ```