Anchor 锚点
uni-appH5微信小程序App
uni-app 跨端锚点导航。点击滚动定位到目标节点(uni.pageScrollTo + selector),通过页面 onPageScroll 回传 scrollTop 驱动 scroll-spy 自动高亮当前可视区锚点。
何时使用
长页面内的章节跳转与滚动高亮:商品详情页、长表单分区。
何时不使用
跨页面导航(用路由跳转)或 scroll-view 内部滚动场景(本组件按页面滚动设计)。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
items | AnchorItem[] | "[]" | 锚点项:{ name, label, href };href 在 uni-app 端作为 createSelectorQuery/pageScrollTo 的选择器,如 "#section-1" |
offsetTop | number | 0 | 距离视口顶部的偏移量(px),用于 scroll-spy 判定与滚动定位补偿,如存在固定头部时设为头部高度 |
scrollTop | number | 0 | 【uni-app 适配新增】页面当前滚动位置(px),由页面 onPageScroll 传入以驱动 scroll-spy;不传则只有点击高亮 |
duration | number | 300 | 点击锚点滚动时长(ms),0 为立即 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
change | string | 激活锚点变化时触发(点击或滚动高亮),参数为锚点 name |
示例
基础用法
vue
<Anchor :items="anchorItems" />自定义偏移
vue
<Anchor :items="anchorItems" :offset-top="60" />慢速平滑滚动
vue
<Anchor :items="anchorItems" :duration="600" />