微信小程序自定义封装顶部导航栏

news/2024/5/18 13:25:40 标签: 微信小程序, 自定义导航栏, 组件封装

微信小程序自定义封装顶部导航栏(自定义返回界面、动态设置标题)

微信小程序官方的navigationBar只能设置颜色,字体大小,但是实际开发中多层页面嵌套则需要我们有返回上一级页面或者返回指定页面的功能,这个时候官方提供的就不能满足我们的需求了,但是官方也为我们提供了解决的方法

Navigation
Navigation是小程序的顶部导航组件,当页面配置navigationStyle设置为custom的时候可以使用此组件替代原生导航栏。

截图
navigationStyle
1、首先需要在app.json中将navigationStyle设置为custom:
app.json

2、在项目中一旦使用自定义导航栏,那么每个页面都需要进行配置,将其封装成为一个组件,在每个页面中使用起来也就更加方便。
组件目录:
软件目录
navbar.wxml文件

<cover-view class='nav-wrap' style='height: {{(height*2 + 25)*2}}rpx;'>
  <!-- 导航栏 中间的标题 -->
  <cover-view class='nav-title' style='line-height: {{(height*2 + 35)*2}}rpx;'>
    {{navbarData.title}}
  </cover-view> 
  <!-- 导航栏  左上角的返回按钮 -->
  <!-- 其中wx:if='{{navbarData.showCapsule}}' 是控制左上角按钮的显示隐藏,首页不显示 -->
  <cover-view class='nav-capsule'  wx:if='{{navbarData.showCapsule}}'>
    <!-- 左上角的返回按钮,wx:if='{{!share}}'空制返回按钮显示 -->
    <!-- 从分享进入小程序时 返回上一级按钮不应该存在 -->
    <cover-view bindtap='_navback' wx:if='{{!share}}'>
      <cover-image src='../../img/left.png' mode='aspectFit' class='back-pre'></cover-image>
    </cover-view>
    <!-- <cover-view class='navbar-v-line' wx:if='{{share}}'></cover-view> -->
  </cover-view>
</cover-view>

navbar.wxss文件

/* component/navbar/navbar.wxss */
/* 顶部要固定定位   标题要居中   自定义按钮和标题要和右边微信原生的胶囊上下对齐 */
.nav-wrap {
  position: fixed;
  width: 100%;
  top: 0;
  background: #fda851;
  color: #fff;
  z-index: 9999999;
  display: flex;
  align-items: center;
  box-sizing: border-box;
}
/* 标题要居中 */
.nav-title {
  position: absolute;
  text-align: center;
  max-width: 350rpx;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
  top: 0;
  left: 0;
  right: 0;
  bottom: 0;
  margin: auto;
  font-size: 42rpx;
  color: #fff;
  font-weight: 500;
}

.nav-capsule {
  display: flex;
  align-items: center;
  margin-left: 30rpx;
  width: 200rpx;
  justify-content: space-between;
  height: 100%;
}

.navbar-v-line {
  width: 1px;
  height: 32rpx;
  background-color: #e5e5e5;
}

.back-pre {
  width: 36rpx;
  height: 36rpx;
  margin-top: 18rpx;
  padding: 10rpx;
}

navbar.json文件

{
  "component": true,
  "usingComponents": {}
}

navbar.js文件

const app = getApp()
Component({
  properties: {
    navbarData: {   //navbarData   由父页面传递的数据,变量名字自命名
      type: Object,
      value: {},
      observer: function (newVal, oldVal) {}
    }
  },
  data: {
    height: '',
    //默认值  默认显示左上角
    navbarData: {
      showCapsule: 1
    }
  },
  attached: function () {
    // 获取是否是通过分享进入的小程序
    this.setData({
      share: app.globalData.share
    })
    // 定义导航栏的高度   方便对齐
    this.setData({
      height: app.globalData.height
    })
  },
  methods: {
    // 返回上一页面
    _navback(event) {
      // 当前页面为“成长记录”时,对返回按钮进行劫持,直接跳转到首页
      if(this.data.navbarData.title === '成长记录'){
        console.log(this.data.navbarData.title);
        wx.switchTab({
          url: `../index`,
          success: function (e) { 
            var page = getCurrentPages().pop(); 
            if (page == undefined || page == null) return; 
            page.onLoad(); 
          }
        })
        return ;
      }
      wx.navigateBack()
    },
  }
})

app.js文件

//app.js
App({
  onLaunch: function (options) {
    // 判断是否由分享进入小程序
    if (options.scene == 1007 || options.scene == 1008) {
      this.globalData.share = true
    } else {
      this.globalData.share = false
    };
    //获取设备顶部窗口的高度(不同设备窗口高度不一样,根据这个来设置自定义导航栏的高度)
    wx.getSystemInfo({
      success: (res) => {
        this.globalData.height = res.statusBarHeight
      }
    })
  },

  globalData: {
    share: false,  // 分享默认为false
    height: 0,
  }
})

3、在页面中使用
pages文件夹中的页面
pages
login.wxml文件

<!-- pages/index/login/login.wxml -->
// 'navbar-data'中navbar是自定义导航栏标题
<nav-bar navbar-data='{{nvabarData}}'></nav-bar>
<view class="login" style='margin-top: {{height}}px'>
 
</view>

login.js文件

 const app = getApp()
  Page({
    /**
     * 页面的初始数据
     */
    data: {
      // 组件所需的参数
      nvabarData: {
        showCapsule: 0, //是否显示左上角图标   1表示显示    0表示不显示
        title: '奉贤区早教', //导航栏 中间的标题
      },
      height: app.globalData.height * 2 + 20 , // 此页面 页面内容距最顶部的距离
   }
 })

login.json文件

{
  "usingComponents": {
    "nav-bar": "../../../component/navbar/navbar"
  }
}

补充

组件中view和image标签使用cover-view 、cover-image代替,是要保证导航栏在使用时,层级保持最高,因为在之前开发过程中其中一个页面使用到了Echarts,当页面过长向上滚动时,会出现图表覆盖在导航栏上面,使用cover-view 、cover-image标签可以解决这个问题。

总结

对于小程序开发本人也在摸索阶段,上面代码若有错误之处还望大家能够多多指正。
更多文章__> >> 码砖猿的技术博客


http://www.niftyadmin.cn/n/875709.html

相关文章

Vue项目导出功能、带token导出Excel

在vue后台管理项目中&#xff0c;目前我常用的就两种导出方式 一种是不需要携带token的&#xff0c;直接调用后台的接口&#xff0c;携带需要传递参数就行&#xff0c;具体实现代码如下&#xff1a; 在main.js封装指令 let baseDownloadUrl http://xxxxxxx:8080 // 域名 co…

Vue a标签实现点击下载,下载图片、txt文件,不是直接打开的方式

前段时间在项目中遇到文件需要下载&#xff0c;直接拿出了之前封装的下载指令&#xff0c;在用的时候发现在下载jpg、txt文件时&#xff0c;并不会直接下载&#xff0c;而是会在浏览器中打开文件&#xff0c;即使给a标签添加了download 属性&#xff0c;也无济于事。 我先把之前…

uni-app实现列表的上拉加载,下拉刷新、回到顶部功能

在使用uni-app做app和小程序时&#xff0c;经常会遇到一些列表&#xff0c;这个时候就需要列表能够实现上拉加载更多、下拉刷新的功能&#xff0c;具体效果如下&#xff1a; 此功能比较简单&#xff0c;就不过多介绍了直上代码&#xff1a; HTML部分 // 活动列表<view c…

nodejs+nginx获取真实ip,解决获取ip为127.0.0.1的问题

nodejsnginx获取真实ip,解决获取ip为127.0.0.1的问题 访问互联网上的服务时&#xff0c;大多数时&#xff0c;客户端并不是直接访问到服务端的&#xff0c;而是客户端首先请求到反向代理&#xff0c;反向代理再转发到服务端实现服务访问&#xff0c;通过反向代理实现路由/负载…

react监听页面滚动事件:window.addEventListener的scroll无效

react监听页面滚动事件&#xff1a;window.addEventListener的scroll无效 在react项目中需要通过监听页面滚动高度&#xff0c;控制页面样式动态展示&#xff0c;所以在网上找了以后其他案例发现监听无效&#xff0c;代码如下&#xff1a; //在componentDidMount&#xff0c;…

基于vue的图片剪裁工具vue-croppe

基于vue的图片剪裁工具vue-croppe 安装 // npm安装 npm install --save vue-croppa // yarn 安装 yarn add vue-croppa使用 引入插件 两种引用方式 // 全局注册 main.js import VueCropper from vue-cropper Vue.use(VueCropper)// 组件内单独使用 userAvatar.vue import { …

vue实现一键复制

在个人项目中为了更好的完善体验&#xff0c;需要有一个一键复制的功能复制&#xff0c;主要的实现方法有以下几个&#xff1a; 不使用插件 使用input配合document.execComman方法可以实现&#xff1b; 这个特性已经过时了&#xff0c;它在一些浏览器中仍然可以工作&#xff…

基于element封装table、分页

在利用element-ui Table编写项目时,会存在表格展示的数据存在分页的情况,基本每个页面都要配置&#xff0c;很影响开发效率&#xff0c;也不利于后期维护&#xff0c;所以统一封装一下&#xff0c;便于开发使用。 How to Use: 在src/components目录中创建base-table&#xff0…