更新记录

0.1.6(2024-07-24) 下载此版本

  • fix: vue2 app ts需要明确的后缀,所有补全
  • chore: 减少依赖

0.1.5(2024-07-21) 下载此版本

  • feat: 删除 Hooks
  • feat: 兼容uniappx

0.1.4(2023-09-05) 下载此版本

  • feat: 增加 Hooks useIntersectionObserver
  • feat: 增加 floatAdd
  • feat: 因为本人插件兼容 vue2 需要使用 composition-api,故增加vue文件代码插件的条件编译
查看更多

平台兼容性

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

lime-shared 工具库

  • 本人插件的几个公共函数
  • 按需引入

引入

按需引入只会引入相关的方法,不要看着 插件函数列表多 而占空间,只要不引用不会被打包

import {getRect} from '@/uni_modules/lime-shared/getRect'

目录

  • getRect: 获取节点尺寸信息
  • addUnit: 将未带单位的数值添加px,如果有单位则返回原值
  • unitConvert: 将带有rpx|px的字符转成number,若本身是number则直接返回
  • canIUseCanvas2d: 环境是否支持使用 canvas 2d
  • getCurrentPage: 获取当前页
  • base64ToPath: 把base64的图片转成临时路径
  • pathToBase64: 把图片的临时路径转成base64
  • sleep: async 内部程序等待一定时间后再执行
  • throttle: 节流
  • debounce: 防抖
  • random: 返回指定范围的随机数
  • range: 生成区间数组
  • clamp: 夹在min和max之间的数值
  • floatAdd: 返回两个浮点数相加的结果
  • fillZero: 补零,如果传入的是个位数则在前面补0
  • exif: 获取图片exif
  • selectComponent: 获取页面或当前实例的指定组件
  • createAnimation: uni.createAnimation
  • animation: 数值从一个值到另一个值的过渡
  • camelCase: 字符串转换为 camelCase 或 PascalCase 风格的命名约定
  • kebabCase: 将字符串转换为指定连接符的命名约定
  • closest: 在给定数组中找到最接近目标数字的元素
  • isBase64: 判断字符串是否为base64
  • isNumber: 检查一个值是否为数字类型
  • isNumeric: 检查一个值是否为数字类型或表示数字的字符串
  • isString: 检查一个值是否为字符串类型
  • composition-api: 为兼容vue2

Utils

getRect

  • 返回节点尺寸信息
// 组件内需要传入上下文
// 如果是nvue 则需要在节点上加与id或class同名的ref
getRect('#id',{context: this}).then(res => {})
兼容性
uni-app uni-app x

addUnit

  • 将未带单位的数值添加px,如果有单位则返回原值
addUnit(10)
// 10px
兼容性
uni-app uni-app x

unitConvert

  • 将带有rpx|px的字符转成number,若本身是number则直接返回
unitConvert('10rpx') 
// 5 设备不同 返回的值也不同
unitConvert('10px') 
// 10
unitConvert(10) 
// 10
兼容性
uni-app uni-app x

canIUseCanvas2d

  • 环境是否支持使用 canvas 2d
canIUseCanvas2d()
// 若支持返回 true 否则 false
兼容性
uni-app uni-app x

getCurrentPage

  • 获取当前页
const page = getCurrentPage()
兼容性
uni-app uni-app x

base64ToPath

  • 把base64的图片转成临时路径
base64ToPath(`xxxxx`).then(res => {})
兼容性
uni-app uni-app x

pathToBase64

  • 把图片的临时路径转成base64
pathToBase64(`xxxxx/xxx.png`).then(res => {})
兼容性
uni-app uni-app x

sleep

  • 睡眠,让 async 内部程序等待一定时间后再执行
async next () => {
    await sleep(300)
    console.log('limeui');
}
兼容性
uni-app uni-app x

throttle

  • 节流
throttle((nama) => {console.log(nama)}, 200)('limeui');
兼容性
uni-app uni-app x

debounce

  • 防抖
debounce((nama) => {console.log(nama)}, 200)('limeui');
兼容性
uni-app uni-app x

random

  • 返回指定范围的随机数
random(1, 5);
兼容性
uni-app uni-app x

range

  • 生成区间数组
range(0, 5)
// [0,1,2,3,4,5]
兼容性
uni-app uni-app x

clamp

  • 夹在min和max之间的数值,如小于min,返回min, 如大于max,返回max,否侧原值返回
clamp(0, 10, -1)
// 0
clamp(0, 10, 11)
// 10
clamp(0, 10, 9)
// 9
兼容性
uni-app uni-app x

floatAdd

  • 返回两个浮点数相加的结果
floatAdd(0.1, 0.2) // 0.3
兼容性
uni-app uni-app x

fillZero

  • 补零,如果传入的是个位数则在前面补0
fillZero(9);
// 09
兼容性
uni-app uni-app x

exif

  • 获取图片exif
  • 支持临时路径、base64
uni.chooseImage({
    count: 1, //最多可以选择的图片张数
    sizeType: "original",
    success: (res) => {
        exif.getData(res.tempFiles[0], function() {
            let tagj = exif.getTag(this, "GPSLongitude");
            let Orientation = exif.getTag(this, 'Orientation');  
            console.log(tagj, Orientation)
        })
    }
})
兼容性
uni-app uni-app x
x

selectComponent

  • 获取页面或当前实例的指定组件,会在页面或实例向所有的节点查找(包括子组件或子子组件)
  • 仅vue3,vue2没有测试过
// 当前页面
const page = getCurrentPage()
selectComponent('.custom', {context: page}).then(res => {
})
兼容性
uni-app uni-app x
x

createAnimation

  • 创建动画,与uni.createAnimation使用方法一致,只为了抹平nvue
<view ref="ball" :animation="animationData"></view>
const ball = ref(null)
const animation = createAnimation({
  transformOrigin: "50% 50%",
  duration: 1000,
  timingFunction: "ease",
  delay: 0
})

animation.scale(2,2).rotate(45).step()
// nvue 无导出数据,这样写只为了平台一致,
// nvue 需要把 ref 传入,其它平台不需要
const animationData = animation.export(ball.value)
兼容性
uni-app uni-app x
兼容性
uni-app uni-app x

camelCase

  • 将字符串转换为 camelCase 或 PascalCase 风格的命名约定
camelCase("hello world") // helloWorld
camelCase("hello world", true) // HelloWorld
兼容性
uni-app uni-app x

kebabCase

  • 将字符串转换为指定连接符的命名约定
kebabCase("helloWorld") // hello-world
kebabCase("hello world_example") // hello-world-example
kebabCase("helloWorld", "_") // hello_world
兼容性
uni-app uni-app x

closest

  • 在给定数组中找到最接近目标数字的元素
closest([1, 3, 5, 7, 9], 6) // 5
兼容性
uni-app uni-app x

isBase64

  • 判断字符串是否为base64
isBase64('xxxxx')
兼容性
uni-app uni-app x

isNumber

  • 检查一个值是否为数字类型
isNumber('0') // false
isNumber(0) // true
兼容性
uni-app uni-app x

isNumeric

  • 检查一个值是否为数字类型或表示数字的字符串
isNumeric('0') // true
isNumeric(0) // true
兼容性
uni-app uni-app x

isString

  • 检查一个值是否为数字类型或表示数字的字符串
isString('0') // true
isString(0) // false
兼容性
uni-app uni-app x

composition-api

  • 因本人插件需要兼容vue2/vue3,故增加一个vue文件,代替条件编译
  • vue2需要在main.js加上这一段
    // vue2
    import Vue from 'vue'
    import VueCompositionAPI from '@vue/composition-api'
    Vue.use(VueCompositionAPI)
//使用
import {computed, onMounted, watch, reactive} from '@/uni_modules/lime-shared/vue'
兼容性
uni-app uni-app x
x

隐私、权限声明

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

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

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

许可协议

MIT协议

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