视图导航 nav-views

链接视图容器做多视图切换。

• 类型串：nav-views　默认尺寸：[360, 44]　分类：控件

实时预览

下面渲染的是真实组件（与编辑器 / 运行时同源）。修改右侧「样式参数」，左侧预览实时更新；点击底部「全页面查看」可放大。

属性

下表为本组件特有的属性；position / size / opacity / background / border / 联动选中 / 筛选等通用参数见组件手册总览。

basic

属性	名称	类型	默认	说明
link-section	链接视图容器	element(types=layout-section)	[]
nav-style	导航样式	select	tabs	可选：tabs / symbol / arrows / slider
tab-variant	选项卡变体	select(radioGroup)	default	可选：default / underline / pill
orientation	排列方向	select(radioGroup)	horizontal	可选：horizontal / vertical
item-gap	项间距	number(unit=px,min=0)	6
item-align	对齐	select(radioGroup)	center	可选：flex-start / center / flex-end
views-mode	视图范围	select(radioGroup)	auto	可选：auto / custom
views-subset	视图子集	string	—

itemStyle

属性	名称	类型	默认	说明
nav-font-size	字号	number(unit=px,min=0)	14
nav-color	默认文字色	color	#a7adba
nav-active-color	选中文字色	color	#ffffff
nav-hover-color	悬浮文字色	color	#ffffff
nav-bg	默认背景	color	transparent
nav-active-bg	选中背景	color	rgba(47,123,255,0.18)
nav-hover-bg	悬浮背景	color	rgba(47,123,255,0.10)
nav-radius	圆角	number(unit=px,min=0)	4
underline-width	下划线厚度	number(unit=px,min=1)	2
nav-border-color	边框颜色	color	rgba(255,255,255,0.16)
nav-disabled-color	禁用文字色	color	rgba(167,173,186,0.35)

symbol

属性	名称	类型	默认	说明
symbol-shape	形状	select(radioGroup)	dot	可选：dot / square / diamond
symbol-size	大小	number(unit=px,min=4)	10
symbol-color	默认色	color	rgba(255,255,255,0.35)
symbol-active-color	选中色	color	#2f7bff
symbol-tooltip	悬停显示视图名	boolean	true

arrowsNav

属性	名称	类型	默认	说明
prev-text	上一个文本	string	上一个
next-text	下一个文本	string	下一个
show-page-no	显示页码	boolean	true
arrows-loop	循环切换	boolean	false

slider

属性	名称	类型	默认	说明
slider-thumb	显示拇指	boolean	true
slider-active-color	已完成段	color	#2f7bff
slider-track-color	轨道颜色	color	rgba(255,255,255,0.18)

数据绑定

无组件特有数据绑定字段（纯样式 / 布局 / 装饰）。

事件

触发器

触发器在预览 / 播放态生效（编辑态点击 = 选中组件）。写在本组件 options.interactions 的 groups[].trigger 里。

触发器	名称	触发时机	payload（供动作公式 {:字段} 取值）
viewChanged	视图切换	链接的视图容器切换时触发（双向同步）	{index, label}
itemClicked	点击某项	点击导航项时触发	该项类目维度，如 {城市:"北京"}（仅类目，不含数值）
click	点击	点击本组件时触发	无
mouseEnter	鼠标移入	指针移入组件时触发	无
mouseLeave	鼠标移出	指针移出组件时触发	无
appear	入场	组件出现时触发（配合进场动画）	无
disappear	离场	组件消失时触发（配合退场动画）	无
receiveBehaviorEvent	接收行为事件	收到 sendBehaviorEvent 动作或宿主 ctx.emit 投递的事件时触发（按 eventName 匹配）	发送方携带的 data

动作

触发器命中后执行的动作。本组件既可发起动作（配在自己的交互里），也可作为其它组件动作的目标。

动作	名称	说明
changeOption	修改设置	把本组件（或其它组件）的某个属性改为静态值 / 公式动态值
switchState	切换状态	切到多状态里的某个状态（state:"" 回默认态）
appear / disappear	进 / 退场动画	对目标 opacity 做 0↔100 插值的显隐动画

完整动作清单（switchScreen / switchWindow / openUrl / sendBehaviorEvent / transfer / executeScript / requestApi 等）与持久化写法见事件交互。

示例

{
  "type": "nav-views",
  "uid": "w_nav_views",
  "options": {
    "position": [40, 40],
    "size": [360, 44]
  }
}

延伸阅读：组件手册总览 · 数据系统 · 事件交互。