JGuang

导航栏

NavBar · Ant Design Mobile

交互预览
npm install antd-mobile@5.43.0

导航栏 NavBar

为页面提供全局性的导航功能。

安装

npm install antd-mobile@5.43.0

antd-mobile 是移动网页组件库,不是 React Native 或小程序组件。React 19 项目需在入口用 unstableSetRender 注册 createRoot,否则 Toast、Dialog 等命令式 API 无法渲染;深色模式通过 <html data-prefers-color-scheme="dark"> 切换。

示例来自 Ant Design Mobile 官方仓库(MIT),固定在 npm 5.43.0 对应的提交;示例中的 DemoBlock 等展示辅助组件由 JGuang 重写,不属于 antd-mobile 的 API。

为页面提供全局性的导航功能。

何时使用

需要显示当前页面内容的标题和操作。

示例

属性

属性说明类型默认值
back返回区域的文字,如果为 null 的话,backIcon 也不会渲染ReactNode | null''
backIcon是否显示返回区域的箭头,也可以传入 ReactNode 进行自定义boolean | ReactNodetrue
children标题ReactNode-
left左侧内容,渲染在返回区域的右侧ReactNode-
onBack点击返回区域后的回调() => void-
right右侧内容ReactNode-

CSS 变量

属性说明默认值
--border-bottom导航栏下边框none
--height导航栏高度45px