通用属性

About 9 min

通用属性

常规属性

常规属性指的是组件普遍支持的用来设置组件基本标识和外观显示特征的属性。

名称

类型

默认值

必填

描述

id

string

-

组件的唯一标识。

style

string

-

组件的样式声明。

class

string

-

组件的样式类,用于引用样式表。

ref

string

-

用来指定指向子元素或子组件的引用信息,该引用将注册到父组件的refs 属性对象上。

disabled

boolean

false

当前组件是否被禁用,在禁用场景下,组件将无法响应用户交互。

focusable

boolean

false

当前组件是否可以获取焦点。 当focusable设置为true时,组件可以响应焦点事件和按键事件。当组件额外设置了按键事件或者点击事件时,框架会设置该属性为true。

data

string

-

给当前组件设置data属性,进行相应的数据存储和读取。JS文件中:

  • 在事件回调中使用 e.target.attr.data 读取数据,e为事件回调函数入参。
  • 使用element或者refs获取DOM元素后,通过attr.data 进行访问。
说明:

从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:跟随系统语言环境。

渲染属性

组件普遍支持的用来设置组件是否渲染的属性。

名称

类型

默认值

描述

for

Array

-

根据设置的数据列表,展开当前元素。

if

boolean

-

根据设置的boolean值,添加或移除当前元素。

show

boolean

-

根据设置的boolean值,显示或隐藏当前元素。

说明: 属性和样式不能混用,不能在属性字段中进行样式设置。