Skip to content

Navbar 导航栏

自定义顶部导航栏,适配 H5 安全区域和小程序状态栏高度。

基础用法

vue
<template>
  <lk-navbar title="页面标题" />
</template>

带返回按钮

vue
<template>
  <lk-navbar title="订单详情" back @back="handleBack" />
</template>

<script setup lang="ts">
function handleBack() {
  uni.navigateBack()
}
</script>

自定义左侧 / 中间 / 右侧

vue
<template>
  <lk-navbar>
    <template #left>
      <lk-button variant="text" size="sm" @click="goHome">
        <lk-icon name="house" :size="20" />
      </lk-button>
    </template>
    <template #center>
      <view style="flex:1; text-align:center;">
        <text class="lk-navbar__title">自定义标题</text>
      </view>
    </template>
    <template #right>
      <view style="display:flex; gap:16rpx">
        <lk-icon name="search" :size="22" @click="openSearch" />
        <lk-icon name="person-circle" :size="22" @click="goProfile" />
      </view>
    </template>
  </lk-navbar>
</template>

透明导航栏

vue
<template>
  <!-- 适合有封面大图的页面 -->
  <lk-navbar title="详情" transparent dark back />

  <view class="cover-image" style="height:500rpx; background:#7c3aed" />
</template>

API

Props

参数说明类型默认值
title标题文字string''
back是否显示返回按钮booleanfalse
transparent是否透明背景booleanfalse
dark暗色文字(配合透明)booleanfalse
fixed是否固定在顶部booleantrue
border是否显示底部边框booleantrue
zIndex层级number100

Events

事件名说明回调参数
back点击返回按钮()
click-left点击左侧区域时触发()
click-right点击右侧区域时触发()

Slots

插槽名说明
default标题区域自定义内容
left左侧区域自定义
center中间区域自定义(在屏幕中心显示,优先于 title)
right右侧区域自定义

基于 MIT 协议开源 · 粤ICP备2022114240号-3

Navbar 导航栏

正在连接预览服务...

请先运行 pnpm run dev:h5