Target
target 用于描述页面当前被宿主承载到哪一种展示容器中。对于同一个页面来说,target 主要影响其展示形态、可用空间和交互层级。
Target 有哪些
当前公开文档主要介绍两种常见 target:
_current:保持在当前上下文中承载,例如对话流中的卡片容器或其他内联展示位_blank:切换到独立承载空间,例如全屏页面或更完整的沉浸式展示容器
不同设备中的 target 映射
不同宿主设备会基于各自的容器模型来承载页面。因此,target 的语义是稳定的,但它在具体设备上会落到哪一种宿主容器,取决于设备和宿主实现。当前公开文档先以 Rokid Glasses 为例说明:
Rokid Glasses
_current:对应对话流内的卡片容器。页面会以内联卡片的形式出现在当前对话上下文中,不离开消息流。_blank:对应从对话流中双击进入的全屏容器。页面会从卡片态切换到独立的全屏承载空间,以支持更完整的展示和交互。
如何使用 CSS 配置不同 target 的样式
如果同一个页面会在不同承载位复用,可以直接基于 target 做响应式样式分支:
.panel {
padding: 16rpx;
}
@media (target: _current) {
.panel {
max-height: 320rpx;
}
}
@media (target: _blank) {
.panel {
max-width: 100%;
padding: 24rpx;
}
}
推荐把 target 主要用于处理:
- 信息密度差异
- 布局尺寸差异
- 是否展示辅助操作区
- 卡片态与展开态之间的样式切换
如何在 App 和 Page 监听 target 变化的事件
如果你希望在逻辑层根据承载位切换布局或数据策略,可以在 App 和 Page 上实现 onTargetChanged(target, previousTarget)。
export default {
onTargetChanged(target, previousTarget) {
console.log('app target changed:', previousTarget, '->', target);
}
}
export default {
data: {
hostTarget: '_current'
},
onTargetChanged(target, previousTarget) {
console.log('page target changed:', previousTarget, '->', target);
this.setData({ hostTarget: target });
}
}
常见用法包括:
- 在
_current中只展示摘要内容 - 切到
_blank后展开完整操作流
设计边界
target 主要表达的是“承载位置语义”,不建议把它当作以下概念的替代品:
- 当前视口的精确尺寸
- 当前是否处于某个具体业务状态
更合适的方式是:
- 用
target描述页面被放在哪里 - 用页面数据描述业务流程的具体阶段
推荐阅读
- 页面概览
- 事件
- 焦点系统