Skip to content

Navbar 导航栏

预览
01:38

组件名:rice-navbar

自定义导航栏

平台兼容性

uni-app x

AndroidiOS鸿蒙Next微信小程序h5

基础用法

html
<rice-navbar title="Navbar 导航栏" border></rice-navbar>

左侧文字

html
<rice-navbar title="左侧带文字" :fixed="false" :safe-area-inset-top="false" left-text="返回" :auto-back="false"
left-text-color="#1989fa" left-icon-color='#1989fa' @clickLeft="onLeftClick" @clickRight="onRightClick" />

自定义插槽

html
<rice-navbar :fixed="false"  :safe-area-inset-top="false">
  <template #left>
    <rice-icon name="home" size="22px" color="#1989fa" />
  </template>
  <template #title>
    <text class="title-text">自定义插槽</text>
  </template>
  <template #right>
    <rice-icon name="star" size="22px" color="#1989fa" />
  </template>
</rice-navbar>

API

Props

属性名类型说明默认值
titleString导航栏标题-
title-sizeString|Number标题文字的大小,默认16px-
title-colorString|Number标题文字的颜色-
title-widthString|Number标题栏最大宽度,超出会显示省略号,默认70%-
fixedBoolean是否固定在顶部,默认true-
placeholderBoolean固定在顶部时,是否生成一个等高的元素防止塌陷,默认true-
borderBoolean导航栏底部是否显示下边框,默认true-
left-arrowBoolean是否显示返回箭头,默认true-
left-iconString左侧返回图标的名称,默认 arrow-left-
left-icon-sizeString左侧返回图标的大小-
left-icon-colorString左侧返回图标的颜色-
left-textString左侧文案-
left-text-colorString左侧文案颜色-
right-textString右侧文案-
right-text-colorString右侧文案颜色-
z-indexNumber层级,默认999-
bg-colorString背景色,支持渐变色-
safe-area-inset-topBoolean是否开启顶部安全区适配,默认true-
heightString|Number导航栏高度,不包含状态栏,safeAreaInsetTop为true时内部会自动加上状态栏的高度,默认44px-
auto-backBoolean点击左侧箭头区域,是否自动返回上一页,默认true-
custom-styleObject自定义样式-

Events

事件名说明回调参数
clickLeft点击左侧图标时触发-
clickRight点击右侧图标时触发-
名称说明
left左侧区域
title标题
right右侧区域

类型定义

组件导出如下类型

ts
// 组件类型
const navbarRef = ref<RiceNavbarComponentPublicInstance | null>(null)