Skip to content

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是否显示左侧返回图标按钮Booleantrue | falsefalse
fixed是否悬浮定位在页面最顶部Booleantrue | falsetrue
transparent是否透明导航栏(可用于沉浸式首页封面图)Booleantrue | falsefalse
isPlaceholder固定定位时是否自动撑起页面安全占位高度Booleantrue | falsetrue
safeArea是否自动适配 iOS 刘海/状态栏安全区高度Booleantrue | falsetrue
height导航栏自定义高度 (rpx)String | Number-''
background导航栏背景色String-''
color标题与图标字体颜色String-''

事件说明 (Events)

事件名说明回调参数
back点击左侧返回图标时触发-
clickLeft点击左侧区域时触发-

插槽说明 (Slots)

插槽名说明
title自定义导航栏中间标题区域
left自定义导航栏左侧返回图标区域
right自定义导航栏右侧操作图标或按钮区域

基于 MIT 协议开源发行

H5 模拟器 (navbar)☀️🔄