TianHeJianKang/uni_modules/lime-shared

lime-shared 工具库

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

引入

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

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

目录

• getRect: 获取节点尺寸信息
• addUnit: 将未带单位的数值添加px，如果有单位则返回原值
• unitConvert: 将带有rpx|px的字符转成number,若本身是number则直接返回
• canIUseCanvas2d: 环境是否支持使用 canvas 2d
• getCurrentPage: 环境是否支持使用 canvas 2d
• 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 |