diff --git a/zh-cn/application-dev/reference/arkui-js/js-components-common-attributes.md b/zh-cn/application-dev/reference/arkui-js/js-components-common-attributes.md index bb3542a30dcbe465fe29cde00d44cd7eff8c71f3..53a8a0b57443ea39df3a2d5bc0a714c81c2d0d43 100644 --- a/zh-cn/application-dev/reference/arkui-js/js-components-common-attributes.md +++ b/zh-cn/application-dev/reference/arkui-js/js-components-common-attributes.md @@ -5,7 +5,7 @@ ## 常规属性 -常规属性指的是组件普遍支持的用来设置组件基本标识和外观显示特征的属性。 +常规属性是指组件普遍支持的用来设置组件基本标识和外观显示特征的属性。 | 名称 | 类型 | 默认值 | 必填 | 描述 | | -------- | -------- | -------- | -------- | -------- | @@ -14,15 +14,15 @@ | class | string | - | 否 | 组件的样式类,用于引用样式表。 | | ref | string | - | 否 | 用来指定指向子元素或子组件的引用信息,该引用将注册到父组件的$refs 属性对象上。 | | disabled | boolean | false | 否 | 当前组件是否被禁用,在禁用场景下,组件将无法响应用户交互。 | -| data | string | - | 否 | 给当前组件设置data属性,进行相应的数据存储和读取。JS文件中:
- 在事件回调中使用 e.target.attr.data 读取数据,e为事件回调函数入参。
- 使用$element或者$refs获取DOM元素后,通过attr.data 进行访问。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 从API Version 6 开始,建议使用data-\*。 | -| data-\*6+ | string | - | 否 | 给当前组件设置data-\*属性,进行相应的数据存储和读取。大小写不敏感,如data-A和data-a默认相同。JS文件中:
- 在事件回调中使用 e.target.dataSet.a读取数据,e为事件回调函数入参。
- 使用$element或者$refs获取DOM元素后,通过dataSet.a进行访问。 | +| data | string | - | 否 | 给当前组件设置data属性,进行相应的数据存储和读取。JS文件中:
- 在事件回调中使用 e.target.attr.data 读取数据,e为事件回调函数入参。
- 使用`$element`或者`$refs`获取DOM元素后,通过attr.data 进行访问。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 从API Version 6 开始,建议使用data-\*。 | +| data-\*6+ | string | - | 否 | 给当前组件设置data-\*属性,进行相应的数据存储和读取。大小写不敏感,如data-A和data-a默认相同。JS文件中:
- 在事件回调中使用 e.target.dataSet.a读取数据,e为事件回调函数入参。
- 使用`$element`或者`$refs`获取DOM元素后,通过dataSet.a进行访问。 | | click-effect5+ | string | - | 否 | 通过这个属性可以设置组件的弹性点击效果,当前支持如下三种效果:
- spring-small:建议小面积组件设置,缩放(90%)。
- spring-medium:建议中面积组件设置,缩放(95%)。
- spring-large:建议大面积组件设置,缩放(95%)。 | | dir6+ | string | auto | 否 | 设置元素布局模式,支持设置rtl、ltr和auto三种属性值:
- rtl:使用从右往左布局模式。
- ltr:使用从左往右布局模式。
- auto:跟随系统语言环境。 | ## 渲染属性 -组件普遍支持的用来设置组件是否渲染的属性。 +渲染属性是指组件普遍支持的用来设置组件是否渲染的属性。 | 名称 | 类型 | 默认值 | 描述 | | -------- | -------- | -------- | -------- |