用户界面 (UI) 开发
在 AIUI 中,视图层是把意图变得可见、可操作的那一层。Page 适合完整交互,Widget 适合快速查看与操作;两者都可以使用 WXML、WXSS、基础组件和事件系统。
WXML(Page 与 Widget 结构)
WXML 是一种类似于 HTML 的标记语言,用于描述 Page 或 Widget 的结构。它支持数据绑定、条件渲染、列表渲染以及模板引用。
核心特性
- 数据绑定: 使用 Mustache 语法 (
{{ }}) 将逻辑层的数据绑定到视图层。 - 列表渲染: 使用
ink:for控制属性绑定一个数组,并使用item和index访问当前项。 - 条件渲染: 使用
ink:if、ink:elif、ink:else来根据条件决定是否渲染该代码块。 - 事件绑定: 使用
bindtap等属性绑定用户的交互事件。
示例代码
<!-- index.wxml -->
<view class="container">
<view class="header">
<text class="title">{{title}}</text>
</view>
<view class="list">
<view class="item" ink:for="{{items}}" ink:key="id" bindtap="handleItemClick">
<text>{{index + 1}}. {{item.name}}</text>
<text ink:if="{{item.status === 'active'}}" class="badge">进行中</text>
</view>
</view>
</view>
在 .ink 单文件中,Page 使用 <page> 根节点,Widget 使用 <widget> 根节点。同一个文件不能同时包含两者。
WXSS(Page 与 Widget 样式)
WXSS 是一套样式语言,用于描述 WXML 的组件样式。它扩展了 CSS 的特性,以适应智能体开发的场景,并帮助把意图和状态转化为清晰的视觉反馈。
核心特性
- 尺寸单位: 引入了
rpx(responsive pixel) 单位,可以根据屏幕宽度进行自适应。规定屏幕宽为480rpx。 - 样式导入: 使用
@import语句可以导入外联样式表。 - 内联样式: 支持
style和class属性来控制组件样式。 - 选择器: 支持常用的 CSS 选择器(
.class,#id,element,::after,::before等)。
示例代码
/* index.wxss */
.container {
padding: 20rpx;
background-color: #f8f8f8;
}
.title {
font-size: 36rpx;
font-weight: bold;
color: #333;
}
.item {
display: flex;
justify-content: space-between;
padding: 30rpx;
margin-top: 10rpx;
background-color: #fff;
border-radius: 8rpx;
}
.badge {
color: #40FF5E;
font-size: 24rpx;
}
渲染流程
- 数据驱动: 当逻辑层调用
this.setData时,视图层会根据新数据进行差量更新,让意图变化能够被快速反馈到界面上。 - 共享开发方式: Page 和 Widget 使用相同的数据绑定、组件、事件和样式能力,但拥有各自的入口与生命周期。
Widget 的完整文件示例请参阅 Widget 开发。
适配单色与全彩眼镜
完成基础界面后,可按全彩眼镜适配指南复用同一个智能体,并根据显示能力调整主题、资源和布局。具体设计数值见全彩视觉规范,阅读与交互体验的进一步调整见全彩优化指南。