跳到主要内容

NavBar 导航栏 ​

uni-appH5微信小程序App

移动端顶部导航栏,支持返回、标题、右侧操作和固定定位。

何时使用 ​

移动端页面顶部导航:返回上一级、展示页面标题、放置右侧操作。

何时不使用 ​

桌面端复杂导航(多级菜单、面包屑)不适用;纯标签切换用 TabBar。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
NavBar 导航栏 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
titlestring""标题文本(可被 title 插槽覆盖)
leftTextstring""左侧返回文案,与返回箭头一起展示
showBackbooleantrue是否显示左侧 chevron 返回箭头
fixedbooleanfalse吸顶固定,padding-top 自动叠加 --rn-safe-area-top
borderbooleantrue是否显示底部 1px 边框

Events ​

名称载荷说明
backEvent点击左侧返回区(箭头/文案)时触发
right-clickEvent点击右侧操作区时触发

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" />