uni-app 开发技巧集合

布局 · 样式

消除图片的空白占用空间

在 uni-app 或者 小程序前端布局过程中,我们经常会使用一个 view 包裹一个图片组件,您会发现图片底部会产生一小块空白,如下代码 :
<template><view style="background:#F97D7C;"><image style="width:100%;"src="https://img0.baidu.com/it/u=1239913398,4122473254&fm=253&fmt=auto&app=138&f=JPEG?w=500&h=312" mode="widthFix"		>image>view>template>
运行效果 :

解决方案

在 view 上添加样式 font-size:0; 即可。

uni-app 设置页面背景颜色

nvue 模式

nvue 可以通过 page.json 来设置页面背景颜色

{"pages": [		{		    "path" : "pages/test/test",		    "style" :                                                                                    		    {		        "navigationBarTitleText": "页标题",// 设置页面背景色"app-plus" : {"background":"#FF0000"				}			}		},		......	]}

vue 模式

在页面 style 中修改 page 背景样式即可,注意不能使用 scoped,其他页面样式使用2个独立的 style 标签来实现。

如 : index.vue

.red{color: red;}

uni-app 图标扩展

在开发过程中我们需要根据项目的实际需求来扩展一套图标库,uni-app 图标扩展步骤如下 :

1. 选取图标并下载

1.1 选择图标并添加到项目

以阿里图标库 ( https://iconfont.cn/ ) 为例 :

图片
通过搜索找到图标 > 加入到购物车 > 添加到具体的项目,如 : test
图片

1.2 配置项目

点击 项目配置 按钮打开配置界面 :

图片

除 FontClass 前缀,修改 Font Family 为自己的字体名称,如 test。

1.3 下载字体

点击 下载至本地 按钮,下载图标文件。

2. 在 uni-app 中部署并配置字体

2.1 复制字体文件

将下载获得的字体文件 iconfont.ttf 文件 重命名为自己的字体文件,如 test.ttf ,然后复制此文件到 uni-app 项目的 static 目录。

2.2 编写图标配置

在 app.vue 的 style 内或者 自己创建一个 css 文件,编写一下代码 :

/* 自定义图标 *//* #ifndef APP-NVUE */@font-face{font-family : "my-icons";font-weight : normal;font-style  : normal; src         : url('@/static/test.ttf') format('truetype');}.my-icons{font-family:"my-icons"; font-style:normal;}/* #endif */

注意

1. 字体名称对应 .my-icons 内的 font-family 属性。

2. 利用条件编译解决多平台兼容问题( 此处定义非 nvue 平台 )。

3. 使用图标

通过上面的配置您就可以在项目中直接使用图标, 语法如下 :

图标 unicode
示例 :

4. nvue 平台图标扩展

4.1 复制图标文件

将下载获得的字体文件 iconfont.ttf 文件 重命名为自己的字体文件,如 test.ttf ,然后复制此文件到 uni-app 项目的 static 目录。

4.2 加载字体

在 app.vue 内利用条件编译加载字体 :

4.3 使用图标

语法 : 图标 unicode

示例 :

uni-app 实现动态图标 ( 图标编码变量模式 )

在 uni-app 中利用 rich-text 组件可以实现图标的动态化,

演示代码 :

.gui-card-item{margin-right:20rpx;}

通过上面的代码我们就可以实现图标的动态展示与切换,核心工作是对 rich-text 组件的动态赋值。

rich-text 组件官网

https://uniapp.dcloud.io/component/rich-text


当 switch 组件在 v-for 循环中时,识别取当前变化的 switch

背景

当 switch 组件在 v-for 循环中, 某个具体 switch 发生变化时会触发 switch 组件的 @change 事件,我们可以利用 dataset 属性标注组件索引,在事件对应的逻辑中利用 dataset 属性获取到组件的索引,从而更精准的控制他们。

举一反三 : 其他组件也可以使用此处方法进行识别。

设置 dataset 语法

<组件>获取 dataset 语法
e.currentTarget.dataset.属性名称

示例代码

  • API · Javascript 相关

复制指定内容到剪切板

核心 api uni.setClipboardData

官方手册 :

https://uniapp.dcloud.io/api/system/clipboard?id=setclipboarddata

this 作用域保持


在日常的开发过程中,我们经常会编写函数来完成各类功能,同时也经常遇到 this 关键字作用域失效的问题,下面的代码会演示 this 关键字丢失的现象及保持方法。

this 作用域丢失示例

解决方案 1 : 使用箭头函数保持 this

解决方案 2 : 使用全局变量 _this

时间戳转换为刚刚、几分钟前 ...

JavaScript 将时间戳转换为刚刚、几分钟前、几小时前、几天前 ... 代码分享 :

相关函数

fromTime

将时间戳转换为刚刚、几分钟前、几小时前、几天前

toDate

将时间戳转换为日期时间

完整代码

javascript 遍历对象的几种方法

分享几种 javascript 遍历对象的方法

1. for(let key in obj) 形式

2. Object.keys() 形式

3. Object.getOwnPropertyNames() 形式

javascript 从数组中删除重复项

在 JavaScript 中,Set 是一个集合,它允许你仅存储唯一值。这意味着删除任何重复的值。 因此,要从数组中删除重复项,你可以将其转换为集合,然后再转换回数组。

演示代码

const numbers = [1, 1, 20, 3, 3, 3, 9, 9];const uniqueNumbers = [...new Set(numbers)]; // -> [1, 20, 3, 9]

原理说明

1) new Set(numbers)从数字列表中创建一个集合。创建集合会自动删除所有重复值。

2) 展开运算符...将任何可迭代对象转换为数组。这意味着将集合转换回数组。[...new Set(numbers)]


后端数据格式与前端组件要求格式不匹配的解决方案

在日常应用开发过程中,经常遇到后端 api 接口输出的数据格式与前端组件要求的数据格式不一样的情况,我们可以通过数据转换来解决这个问题,详解下面的代码 :

示例代码 :

  • 进阶技巧

常用工具封装与全局挂载

背景介绍

我们可以将一些常用的功能以对象形式封装为一个 js 文件,然后在 main.js 中利用 uni.工具对象的方式进行全局挂载。这样我们就可以在每个页面内放本地使用自己封装的工具。

实现步骤

1. 封装自己的工具

如 : 项目根目录下创建 /tools/ 文件夹并在此文件夹下创建 myTools.js,

示例代码 :

module.exports = {// 如 : 基于 uni-app uni.showToast api 封装一个 msg 方法	msg : function(msg){		uni.showToast({title:msg, icon:"none"});	},// 如 : 基于 uni-app uni.showLoading api 封装一个 showLoading 方法	showLoading : function (title) {		uni.showLoading({  title:title , mask:true });	}}

2. 在 main.js 中全局挂载工具包

import Vue from 'vue'import App from './App'
Vue.config.productionTip = falseApp.mpType = 'app'
import myTool from './tools/myTool.js';uni.myTool = myTool;
const app = new Vue({    ...App})app.$mount()

3. 在页面中直接使用封装的工具

是不是非常简单并好用呢~ 注意全局挂载基于 uni 对象,不要过大封装或者封装一些影响 uni 性能的代码。

微信小程序隐私授权教程

微信小程序隐私授权要求

微信小程序 在 2023年9月15日之后涉及处理用户个人信息的小程序开发者,需通过弹窗等明显方式提示用户阅读隐私政策等收集使用规则。我们在使用小程序与用户隐私相关接口( 如 : 获取用户信息、相册使用等 )时需要用户授权才能正常调用。

官方说明

https://developers.weixin.qq.com/miniprogram/dev/framework/user-privacy/PrivacyAuthorize.html

微信小程序隐私授权接入流程

1. 配置《小程序用户隐私保护指引》

开发者需在「小程序管理后台」配置《小程序用户隐私保护指引》,详细指引可见:用户隐私保护指引填写说明。

需要注意的是,仅有在指引中声明所处理的用户信息,才可以调用平台提供的对应接口或组件。若未声明,对应接口或组件将直接禁用。隐私接口与对应的处理的信息关系可见:小程序用户隐私保护指引内容介绍。

图片

此步骤需要填写 《用户隐私保护指引设置》,填写完成后等待微信官方审核。

2. 主动查询隐私授权同步状态以及展示隐私协议

从基础库 2.32.3 开始支持

开发者可通过 wx.getPrivacySetting 接口,查询微信侧记录的用户是否有待同意的隐私政策信息。该信息可通过返回结果 res 中的 needAuthorization 字段获取。uni-app 示例代码 :

同时,wx.getPrivacySetting 接口会返回开发者在小程序管理后台配置的《小程序用户隐私保护指引》名称信息,开发者可以调用 wx.openPrivacyContract 接口打开该页面。

3. 弹窗提醒用户授权

如果存在有待用户同意的隐私政策信息,开发者需要主动提示用户阅读隐私政策等收集使用规则,对于提示方式,小程序开发者可自行设计,同时需要在相关界面中使用 .modal-btns{line-height:88rpx; font-size:26rpx; text-align:center; width:200rpx;}

提示

点击 微信开发者工具 清缓存 > 清除全部缓存 可以重置授权,进行测试。

  • 节流与防抖

防抖的概念及实现

什么是防抖?

防抖是指在频繁触发某一个事件时,一段时间内或者一定条件下不再触发该事件对应调用的函数。

示例 : 防止按钮多次连续点击

上面的代码实现了 :

对按钮点击触发函数的防抖控制 : 按钮事件执行未完成时不多次重复执行对应按钮的业务逻辑。

节流的概念及实现

节流的概念

在事件持续触发的前提下,保证一定时间段内只调用一次事件处理函数,就是函数节流;

1. 利用延时器实现节流

利用可以延时器实现节流,原理是连续触发时只执行最后一次事件。

如下面的例子:

页面滚动(连续事件),我们利用 setTimeout() 函数只执行识别最后一次。

2. 利用计时器实现节流

利用计时器可以实现在指定的间隔时间内只执行一次逻辑,从而控制逻辑执行次数,达到节流的目的。

示例代码 :