NavBar 导航栏
uni-appH5微信小程序App
移动端顶部导航栏,支持返回、标题、右侧操作和固定定位。
何时使用
移动端页面顶部导航:返回上一级、展示页面标题、放置右侧操作。
何时不使用
桌面端复杂导航(多级菜单、面包屑)不适用;纯标签切换用 TabBar。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
9:41
NavBar 导航栏 · uni-app H5 实时运行 新窗口打开
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
title | string | "" | 标题文本(可被 title 插槽覆盖) |
leftText | string | "" | 左侧返回文案,与返回箭头一起展示 |
showBack | boolean | true | 是否显示左侧 chevron 返回箭头 |
fixed | boolean | false | 吸顶固定,padding-top 自动叠加 --rn-safe-area-top |
border | boolean | true | 是否显示底部 1px 边框 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
back | Event | 点击左侧返回区(箭头/文案)时触发 |
right-click | Event | 点击右侧操作区时触发 |
Slots
| 名称 | 说明 |
|---|---|
left | 左侧区域 |
title | 标题区域 |
right | 右侧区域 |
示例
基础用法
vue
<NavBar title="订单详情" />左侧文字与右侧插槽
vue
<NavBar title="消息中心" left-text="返回">
<template #right><Icon name="settings" :size="18" /></template>
</NavBar>无边框
vue
<NavBar title="无边框导航" :border="false" />