更新记录

2.0.5(2021-05-12)

  1. 支持uni_modules

2.0.4(2020-10-21)

  1. 修改在nvue环境,无法定位

2.0.3(2020-06-29)

修改背景颜色显示bug

查看更多

平台兼容性

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

zhouWei-navBar 适用于 uni-app 项目的头部导航组件,支持V3编译、nvue编译

导航栏组件,主要用于头部导航,组件名:zhouWei-navBar

本组件目前兼容微信小程序、H5、5+APP。其他平台没试过

本组件支持模式:

  1. 普通固定顶部导航
  2. 透明导航
  3. 透明固定顶部导航
  4. 不固定普通导航
  5. 颜色渐变导航

本组件内置特殊功能:

  1. fontColor字体颜色为白色的时候手机状态栏会自动显示白色,否则显示灰色
  2. 页面为第一个页面时左上角自动显示返回主页的图标(具体看组件:zhouWei-navBar/index.vue =>页面script)
  3. nvue页面必须在当前页面引入本组件才可以使用
QQ交流群(607391225) 微信交流群(加我好友备注"进群")
QQ交流群 微信交流群
QQ群号:607391225 微信号:zhou0612wei

点击跳转-5年的web前端开源的uni-app快速开发模板-下载看文档

本组件全局配置(位置:zhouWei-navBar/index.vue =>页面script)

  1. 主页页面的页面路径
  2. 首页页面路径
// 主页页面的页面路径
// 关联功能:打开的页面只有一个的时候右上角自动显示返回首页按钮,下面这个数组是排除显示返回首页的页面。
// 主页使用场景:小程序分享出去的页面,用户点击开是分享页面,很多情况下是没有返回首页按钮的
const mainPagePath = ["pages/navList"];
//返回首页的地址
const homePath = "/pages/navList";

在main.js引入组件,并注册全局组件

import zhouWeiNavBar from "@/components/zhouWei-navBar";
Vue.component("nav-bar", zhouWeiNavBar);

或者在页面script中引入组件,并注册组件(nvue页面必须是这样引入)

import navBar from "@/components/zhouWei-navBar";
export default {
    components: {navBar}
}

案例一

默认特性:左上角有返回箭头,nav-bar导航固定在顶部、标题居中

<nav-bar>我的</nav-bar>

案例二

特性:无返回箭头、字体色为白色、标题左对齐、nav-bar导航透明并不固定在顶部、右边插槽有按钮

<nav-bar backState="2000" fontColor="#FFF" :titleCenter="false" type="transparent" title="我的">
    <view class="icon_setUp" slot="right">设置</view>
</nav-bar>

案例三:颜色渐变导航

特性:颜色渐变导航

<nav-bar home :bgColor="['#f37402','#0f0']" bgColorAngle="90" fontColor="#FFF" title="颜色渐变导航"></nav-bar>

案例四:颜色渐变导航

特性:颜色渐变导航

<nav-bar :bgColor="bgColorList" bgColorAngle="45" fontColor="#FFF" title="颜色渐变导航"></nav-bar>
<!-- bgColor值 -->
bgColorList:[
    {color:"#f37402",scale:"0%"},
    {color:"#0f0",scale:"20%"},
    {color:"#f00",scale:"80%"},
    {color:"#00f",scale:"100%"}
]

案例五:滑动透明导航

特性:有返回箭头、nav-bar导航透明并固定在顶部、透明状态字体为白色、页面想下滑动nav-bar导航条逐渐变白色、右边插槽有按钮

<nav-bar ref="navBar" :scrollTop="scrollTop" transparentFixedFontColor="#FFF" type="transparentFixed" title="我的简历">
    <view class="transparent_fixed_preview" slot="transparentFixedRight" @click="onPreview">预览</view> //透明状态下的按钮
    <view class="preview" slot="right" @click="onPreview">预览</view> //不状态下的按钮
</nav-bar>
//设置滚动值方法一:
data() {
    return {
        scrollTop:0
    }
},
onPageScroll(e) {
    this.scrollTop = e.scrollTop;
}
//设置滚动值方法二:
onPageScroll (e) {
    this.$refs.navBar.pageScroll(e);
}

案例六:搜索框|地区选择

特性:无返回箭头、nav-bar导航固定在顶部、地区选择、搜索框

<nav-bar backState="2000">
    <view slot="left" class="address_select">深圳市</view>
    <view slot="right" class="search_box" @click="onPageJump('/pages/home/search')">
        <text class="icon_search"></text>
        <text class="tips">搜索目的地/职位等</text>
    </view>
</nav-bar>

属性

名称 类型 默认值 描述
backState String 1000 返回上一页面按钮,1000 显示返回按钮,2000 不显示返回按钮,3000自定义返回按钮方法,点击返回箭头后会发送一个backClick事件
home Boolean true 返回首页按钮(首页地址在源文件里配置)
bgColor String,Array #FFF 导航背景颜色,值为数组的时候显示渐变颜色,bgColor="themeBgColor"的时候会调用全局class="themeBgColor"的样式
bgColorAngle String,Number 90 导航背景颜色渐变角度(bgColor为数组生效)
fontColor String #000 导航字体颜色,(当颜色为白色的时候导航状态栏和图片为白色的)
titleCenter Boolean true 标题title居中
title String -- 标题title
transparentFixedFontColor String #000 导航type类型为transparentFixed时透明状态下的字体颜色
type String fixed 导航类型,可选:1.fixed固定导航 2.ordinary不固定导航 3.transparent透明不固定导航 4.transparentFixed透明固定导航
scrollTop Number 0 导航type类型为transparentFixed时页面滚动值(具体看上面的案例五
shadow Boolean true 是否显示底边阴影

bgColor数组值为JSON的参数

名称 类型 默认值 描述
color String -- 渐变颜色值
scale String -- 渐变比例(百分比%)

插槽

名称 描述
left 左插槽
default 中间标题插槽(type类型为transparentFixed时插槽只会穿透到实色背景下)
right 右插槽
transparentFixed 导航type类型为transparentFixed时透明状态下中间插槽
transparentFixedRight 导航type类型为transparentFixed时透明状态下右插槽
transparentFixedRight 导航type类型为transparentFixed时透明状态下右插槽

事件(type类型为transparentFixed时可用)

名称 参数 描述
backClick 返回上一页按钮方法 backState=3000时生效

隐私、权限声明

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

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

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

许可协议

MIT协议

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