跳到主要内容

NavBar 导航栏 ​

WebH5

移动端顶部导航栏。48px 高,标题居中,左右操作区绝对定位;支持吸顶并自动叠加顶部安全区。

何时使用 ​

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

何时不使用 ​

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

Props ​

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

Events ​

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

Slots ​

名称说明
title自定义标题内容,优先级高于 title prop
left自定义左侧内容,优先级高于返回箭头/文案
right右侧操作区(图标、文字按钮等)

示例 ​

基础 ​

示例加载中…

返回文案与右侧操作 ​

示例加载中…

隐藏返回箭头 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 NavBar 文档(含手机预览)。