更新记录

0.0.2(2024-10-27) 下载此版本

  • feat: 兼容vue2

0.0.1(2024-10-27) 下载此版本

  • init

平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 4.31 app-vue app-uvue × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × ×

lime-navbar 导航栏

  • 为页面提供导航功能,常用于页面顶部,兼容uniapp/uniappx
  • 插件依赖lime-stylelime-shared,lime-icon,不喜勿下

安装

插件市场导入即可,首次安装可能需要重新编译

代码演示

基础使用

通过 title 属性设置导航栏标题。fixed属性设置导航栏固定在顶部默认为true

<l-navbar title="标题文字" :fixed="false"></l-navbar>

返回上级

通过 title 属性设置导航栏标题。left-arrow设置显示返回箭头图标,通过click-left接收点击事件,delta设置后退按钮后退层数

<l-navbar title="标题文字" :left-arrow="true" @click-left="onClickLeft"></l-navbar>
const onClickLeft = () => {
    console.log('点击')
}

标题文字超出

通过 title-max-length 属性标题文字最大长度

<l-navbar title="标题文字超出" :title-max-length="5" :fixed="false"></l-navbar>

自定义胶囊样式

通过 capsule 插槽自定义胶囊样式

<l-navbar title="标题文字" :fixed="false">
    <template #capsule>
      <view class="custom-capsule">
        <l-icon name="chevron-left" size="20px" class="custom-capsule__icon" />
        <view style="width: 1px;height: 20px; background-color: #ddd; margin: 0 10px;"></view>
        <l-icon name="home" size="20px" class="custom-capsule__icon" />
      </view>
    </template>
    <template #right>
      <l-icon name="ellipsis" size="24px" />
    </template>
</l-navbar>
.custom-capsule {
  width: 100%;
  display: flex;
  align-items: center;
  justify-content: center;
  flex-direction: row;
}

.custom-capsule__icon {
  position: relative;
  margin: 0;
}

带搜索导航栏

通过 left 插槽自定义左侧内容,通过 right 插槽自定义右侧内容

<l-navbar title="标题文字" :fixed="false">
   <template #left>
        <view style="width: 80%;">
            <l-search placeholder="搜索预设文案?" shape="round"/>
        </view>
    </template>
    <template #right>
        <l-icon name="home" size="24px" />
        <view style="width: 10px;"></view>
        <l-icon name="ellipsis" size="24px" />
    </template>
</l-navbar>

自定义样式

通过 bg-color 设置背景色,color设置文本颜色

<l-navbar title="标题文字" :fixed="false" :leftArrow="true" bg-color="#3283ff" color="white"></l-navbar>

查看示例

  • 导入后直接使用这个标签查看演示效果
<!-- // 代码位于 uni_modules/lime-navbar/compoents/lime-navbar -->
<lime-navbar />

插件标签

  • 默认 l-navbar 为 component
  • 默认 lime-navbar 为 demo

关于vue2的使用方式

  • 插件使用了composition-api, 如果你希望在vue2中使用请按官方的教程vue-composition-api配置
  • 关键代码是: 在main.js中 在vue2部分加上这一段即可
    // vue2
    import Vue from 'vue'
    import VueCompositionAPI from '@vue/composition-api'
    Vue.use(VueCompositionAPI)

API

Props

参数 说明 类型 默认值
placeholder 固定在顶部时,是否在标签位置生成一个等高的占位元素 boolean false
safeAreaInsetTop 是否开启顶部安全区适配 boolean false
fixed 是否固定在顶部 boolean true
leftArrow 是否展示左侧箭头 boolean false
delta 后退按钮后退层数 number 1
title 页面标题 string -
titleMaxLength 标题文字最大长度,超出的范围使用 ... 表示 number -
z-index z-index 层级 number -
bgColor 背景色 string ``
color 文本色 string ``

Events

事件名 说明 回调参数
back 返回触发 -
click-left 点击左侧图标触发 -

Slots

名称 说明
capsule 左侧胶囊区域
left 左侧区域
right 右侧区域
title 标题区域

主题定制

样式变量

组件提供了下列 CSS 变量,可用于自定义样式,uvue app无效。

名称 默认值 描述
--l-navbar-color $text-color-1 -
--l-navbar-bg-color $bg-color-container -
--l-navbar-height 48px -
--l-navbar-z-index 5001 -
--l-navbar-right 12px -
--l-navbar-left 12px -
--l-navbar-padding-top 0px -
--l-navbar-title-font-size 18px -
--l-navbar-left-arrow-size 24px -
--l-navbar-capsule-border-color $border-color-1 -
--l-navbar-capsule-border-radius 16px -
--l-navbar-capsule-width 88px -
--l-navbar-capsule-height 32px -

常见问题

插件包含一下lime-svg为收费插件。如果你不需要svg,可以在lime-icon里注释掉,lime-svg为APP原生插件,收费为1元,源码为5元。如果你需要svg,可以考虑一下购买。

// lime-icon/components/l-icon.uvue 第4行 注释掉即可。
<!-- <l-svg class="l-icon" :class="classes" :style="styles" :color="color" :src="iconUrl" v-else :web="web" @error="imageError" @load="imageload" @click="$emit('click')"></l-svg> -->

打赏

如果你觉得本插件,解决了你的问题,赠人玫瑰,手留余香。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问