NavBar 导航栏
WebH5
移动端顶部导航栏。48px 高,标题居中,左右操作区绝对定位;支持吸顶并自动叠加顶部安全区。
何时使用
移动端页面顶部导航:返回上一级、展示页面标题、放置右侧操作。
何时不使用
桌面端复杂导航(多级菜单、面包屑)不适用;纯标签切换用 TabBar。
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 | MouseEvent | 点击左侧返回区(箭头/文案)时触发 |
right-click | MouseEvent | 点击右侧操作区时触发 |
Slots
| 名称 | 说明 |
|---|---|
title | 自定义标题内容,优先级高于 title prop |
left | 自定义左侧内容,优先级高于返回箭头/文案 |
right | 右侧操作区(图标、文字按钮等) |
示例
基础
示例加载中…
<NavBar title="订单详情" @back="showToast('返回上一页')" />返回文案与右侧操作
示例加载中…
<NavBar title="编辑收货地址" left-text="返回" @back="showToast('返回上一页')">
<template #right>
<Button variant="ghost" size="sm">保存</Button>
</template>
</NavBar>隐藏返回箭头
示例加载中…
<NavBar title="会员中心" :show-back="false">
<template #right>
<Button variant="ghost" size="sm">设置</Button>
</template>
</NavBar>Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 NavBar 文档(含手机预览)。