当前位置：首页 > news >正文

小程序的工具库-miniprogram-licia

news 2025/9/25 16:03:19

1. miniprogram-licia简介

miniprogram-licia是一个基于Licia的工具库，专为微信小程序设计，提供了一系列实用的函数和模块，如防抖、节流、MD5加密等。Licia是一个零依赖的实用工具库，包含超过400个微模块，用于处理各种开发问题。

2. 安装和使用

安装

在项目根目录下运行以下命令安装miniprogram-licia：

npm i miniprogram-licia --save

构建npm

在微信开发者工具中，点击“工具”菜单，选择“构建npm”。这一步会将node_modules中的代码转换为小程序可以使用的格式，并生成miniprogram_npm文件夹。

引入使用

在代码中直接引入并使用miniprogram-licia：

const licia = require('miniprogram-licia');// 示例：使用MD5加密
console.log(licia.md5('licia')); // 输出：e59f337d85e9a467f1783fab282a41d0// 示例：安全获取嵌套对象属性
console.log(licia.safeGet({a: {b: 1}}, 'a.b')); // 输出：1

3. 生成定制化`util.js`

使用miniprogram-licia时，如果不想引入整个库（可能会增加约100KB的体积），可以使用在线工具生成定制化的util.js文件：

访问 Licia在线定制工具。
输入需要的模块名，点击生成并下载util.js。

将生成的util.js文件拷贝到小程序项目的任意目录下，并在代码中引入使用：

const util = require('../lib/util');// 示例：使用MD5加密
console.log(util.md5('licia')); // 输出：e59f337d85e9a467f1783fab282a41d0// 示例：安全获取嵌套对象属性
console.log(util.safeGet({a: {b: 1}}, 'a.b')); // 输出：1

4. 优势

零依赖：miniprogram-licia不依赖任何其他库。
多功能：提供超过400个微模块，涵盖DOM操作、日期格式化、事件发射器、Promise等。
定制化：通过在线工具生成定制化的util.js，减少代码体积。

5. 示例：防抖和节流

miniprogram-licia提供了防抖和节流功能，这对于处理频繁触发的事件（如滚动、输入等）非常有用：

const { debounce, throttle } = require('miniprogram-licia');// 防抖示例
const debouncedFn = debounce(() => {console.log('防抖函数被调用');
}, 300);// 节流示例
const throttledFn = throttle(() => {console.log('节流函数被调用');
}, 300);