Navbar 顶部导航
用于页面最顶部沉浸式导航栏控件,支持自动安全区避让、返回键逻辑、标题插槽与右侧操作按键扩展。
代码示例
1. 基础返回导航 (Basic Navbar)
vue
<template>
<mu-navbar title="个人资料" is-back />
</template>2. 右侧操作区与搜索框插槽 (Right & Search Slot)
vue
<template>
<!-- 右侧按键插槽 -->
<mu-navbar title="消息中心" is-back>
<template #right>
<mu-icon name="edit" :size="20" color="#171717" @click="onEdit" />
</template>
</mu-navbar>
<!-- 嵌入搜索框插槽 -->
<mu-navbar is-back>
<template #title>
<mu-search placeholder="搜索商品" shape="round" />
</template>
</mu-navbar>
</template>API 属性说明 (Props)
| 参数名 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| title | 导航栏标题文字 | String | - | '' |
| isBack / is-back | 是否显示左侧返回图标按钮 | Boolean | true | false | false |
| fixed | 是否悬浮定位在页面最顶部 | Boolean | true | false | true |
| transparent | 是否透明导航栏(可用于沉浸式首页封面图) | Boolean | true | false | false |
| isPlaceholder | 固定定位时是否自动撑起页面安全占位高度 | Boolean | true | false | true |
| safeArea | 是否自动适配 iOS 刘海/状态栏安全区高度 | Boolean | true | false | true |
| height | 导航栏自定义高度 (rpx) | String | Number | - | '' |
| background | 导航栏背景色 | String | - | '' |
| color | 标题与图标字体颜色 | String | - | '' |
事件说明 (Events)
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| back | 点击左侧返回图标时触发 | - |
| clickLeft | 点击左侧区域时触发 | - |
插槽说明 (Slots)
| 插槽名 | 说明 |
|---|---|
| title | 自定义导航栏中间标题区域 |
| left | 自定义导航栏左侧返回图标区域 |
| right | 自定义导航栏右侧操作图标或按钮区域 |