Skip to content

Navbar 自定义导航栏

iPhone

该组件一般用于特殊场景情况下,需要自定义导航栏的时候用到,一般建议使用 uni-app 带的导航栏。

平台差异说明

APPH5微信小程序支付宝小程序···
适配中

代码示例

部分功能示例,具体可参考示例程序以及文档API。

基础用法

该组件的高度是根据系统状态栏搞定自动计算的,如果需要自定义高度,可以设置 height 属性。

  • 默认高度为44px,和 uni-app 导航栏高度一致, 此高度为导航栏内容高度,不包含状态栏的高度,组件内部会自动加上状态栏的高度,并填充装提了的占位区域。
  • 左侧返回区域、右侧区域的宽度为 60px ,可以通过 leftWidthrightWidth 属性设置,建议 leftWidthrightWidth 设置一致,以保证视觉效果。
html
<template>
    <view>
        <fu-navbar leftIcon="left" title="FusionsUI"></fu-navbar>
    </view>
</template>

自定义导航栏内容

通过自定义 slot 传入内容

html
<template>
    <fu-navbar>
        <template v-slot:left>
            <view>左侧区域</view>
        </template>
        <template v-slot:title>
            <view>标题区域</view>
        </template>
        <template v-slot:right>
            <view>右侧区域</view>
        </template>
    </fu-navbar>
</template>

自定义导航栏背景颜色

通过 bgColor 属性设置导航栏背景颜色

html
<template>
    <fu-navbar title="" bgColor="#ffffff"></fu-navbar>
</template>

API

属性名说明类型默认值可选值
dark开启黑暗模式Booleanfalsetrue
title标题String--
leftIcon左侧图标Stringleft-
leftText左侧文案String--
rightIcon右侧图标String--
rightText右侧文案String--
color图标和文字颜色String--
bgColor导航栏背景颜色String--
fixed是否固定在顶部Booleanfalsetrue
statusBar是否显示状态栏Booleantruefalse
shadow是否显示阴影Booleanfalsetrue
border是否显示下边框Booleantruefalse
stat是否开启统计标题上报Booleanfalsetrue
height导航栏高度String|Number44-
leftWidth左侧区域宽度String|Number60-
rightWidth右侧区域宽度String|Number60-
paddingTitle导航栏左右内间距String10-
事件名说明回调参数
clickLeft左侧按钮点击时触发() => void
clickRight右侧按钮点击时触发() => void
clickTitle标题区域点击时触发() => void
插槽名说明
default标题
left左侧区域
right右侧区域