组件
组件用于封装可复用的状态、视图结构和事件逻辑,适合把复杂页面拆分为独立模块,提升复用性与可维护性。
当前 AIUI 已支持组件局部 data、properties、setData()、triggerEvent()、生命周期、嵌套组件以及组件样式隔离等能力。
注册与使用
页面或组件可以通过 usingComponents 引入组件。常见写法是在 AIUI 的 .ink 文件中通过 <script def> 声明:
<script def>
{
"usingComponents": {
"demo-card": "components/demo-card"
}
}
</script>
如果当前文件本身也是一个组件,则需要同时声明 "component": true:
<script def>
{
"component": true,
"usingComponents": {
"demo-badge": "components/demo-badge"
}
}
</script>
注册后即可像内置标签一样使用:
<demo-card title="{{title}}" bindchange="onCardChange" />
推荐写法
AIUI 推荐使用 .ink 单文件组件,将组件声明、模板、样式和逻辑放在同一个文件中:
<script def>
{
"component": true
}
</script>
<template>
<view class="card">
<text>{{title}}</text>
</view>
</template>
<style>
.card {
display: flex;
padding: 12px;
}
</style>
<script setup>
export default {
properties: {
title: {
type: String,
value: 'Untitled'
}
}
}
</script>
其中:
<script def>用于声明组件元信息,例如"component": true和usingComponents<template>用于定义组件结构<style>用于定义组件内部样式<script setup>用于导出组件逻辑
组件实例能力
组件实例目前支持以下核心能力:
properties:父级传入的只读属性data:组件内部状态methods:组件方法,调用时直接使用this.xxx()this.setData(patch):更新组件内部状态this.triggerEvent(name, detail):向父级派发自定义事件
示例:
export default {
data: {
count: 0
},
properties: {
title: {
type: String,
value: 'Untitled'
}
},
methods: {
emitChange() {
const nextCount = this.data.count + 1;
this.setData({ count: nextCount });
this.triggerEvent('change', {
value: `${this.properties.title}:${nextCount}`
});
}
}
}
让使用者传入内容
如果组件需要保留一块由使用者决定的内容,可以在组件模板中使用 <slot>。下面的卡片提供默认内容区域和名为 actions 的操作区域:
<template>
<view class="card">
<slot></slot>
<view class="actions">
<slot name="actions"></slot>
</view>
</view>
</template>
使用组件时,不带 slot 属性的内容会进入默认区域;slot="actions" 的内容会进入同名区域:
<demo-card>
<text>设备运行正常</text>
<button slot="actions" bindtap="openDetails">查看详情</button>
</demo-card>
组件逻辑可以通过 this.hasSlot('actions') 判断使用者是否传入了操作内容,也可以通过 this.$slots.actions 查看这一组内容的只读快照。具名插槽的实例接口参见 Component。
生命周期
当前支持的组件生命周期包括:
createdattachedreadymoveddetached
可以在 lifetimes 中声明:
export default {
lifetimes: {
created() {},
attached() {},
ready() {},
moved() {},
detached() {}
}
}
补充说明
- 组件可以继续引用其他组件,适合构建嵌套组件树
- 组件样式默认只作用于组件内部,不会泄漏到页面其他区域
- 组件内部可以通过事件转发,将子组件事件继续向外层传递
<slot>只能在自定义组件模板中作为内容放置位置使用;普通页面不需要直接使用它
路径与首次可见帧
usingComponents 指定具体文件路径。/components/card/card 可以对应 card.ink,但目录路径 /components/card 不会自动查找 index.ink;使用 index 入口时写成 /components/card/index。缺失或错误路径会导致加载失败,应检查入口、脚本及配置文件。
lifetimes.ready() 在包含该组件的首帧实际呈现后每个实例触发一次。后续动态挂载的新组件也等待自身内容呈现;setData() 更新不会重复触发。详见 Component API。