快应用 通用属性

2020-08-06 11:46 更新

通用属性,即所有组件都支持的属性。

开发者可以在所有的组件标签上都使用通用属性

示例代码

<template>
  <div>
      <text id="text1" class="text-normal">line 1</text>
      <text id="text2" class="text-normal red">line 2</text>
  </div>
</template>

常规属性

名称 类型 默认值 描述
id <string> - 唯一标识
style <string> - 样式声明
class <string> - 引用样式表
disabled <boolean> false 表明当前组件是否可用
aria-label <string> - 当前元素的标签描述,接受字符串作为参数
aria-unfocusable <boolean> false 无障碍模式下是否能够获取焦点, 设置 true 时, 该组件 aria-label 属性在无障碍模式下不会生效
forcedark 1070+ <boolean> true 组件级别的夜间模式自动反色开关(仅 Android 10+系统支持),非必填,默认值为 true(开启自动反色)

forcedark 参数注意事项:

1.常规属性的forcedark参数为全小写,与manifest.json的forceDark参数为驼峰命名法不一样。

2.video、camera、map、custommarker组件均不支持设置forcedark参数,也不会响应父元素的forcedark设置

3.span 组件不支持forcedark开关,它只能依赖父元素的forcedark参数值控制开关,并且当父元素为 span 的时候,继续往上找,直至找到父元素为a或text元素截止

渲染属性

名称 类型 默认值 描述
for <array> - 根据数据列表,循环展开当前标签
if <boolean> - 根据数据 boolean 值,添加或移除当前标签
show <boolean> - 根据数据 boolean 值,显示或隐藏当前标签,相当于控制{ display: flex | none }

渲染属性工作方式详见 template 模板

注意:属性和样式不能混用,不能在属性字段中进行样式设置

data 属性

给组件绑定 data 属性,然后运行时通过 dataset 获取,方便进一步判断

示例:

<template>
  <div>
    <div id="elNode1" data-person-name="Jack"></div>
  </div>
</template>

<script>
  export default {
    onReady () {
      const el = this.$element('elNode1')
      const elData = el.dataset.personName
      console.info(`输出data属性: ${elData}`)
    }
  }
</script>


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号