手册版本 V3.0
Grace.js - 图片函数简化了图片选择、预览等相关 api .
chooseImgs()
函数功能 : 选择图片
对应手册 : https://uniapp.dcloud.io/api/media/image?id=chooseimage
函数参数 :
| 参数名称 | 必填 | 默认值 | 作用 |
| sets | 是 | {count:1,sizeType:['original', 'compressed'],sourceType:['album', 'camera']} | 基础配置对象 |
| success | 是 | 选择图片后执行的函数 | |
| fail | 否 | 客户取消选择后执行的函数 | |
| complete | 否 | 完成选择时执行的函数 |
说明
sets 设置为 {} 代表 sets = {count:1,sizeType:['original', 'compressed'],sourceType:['album', 'camera']}
请根据业务需求具体设置即可， sets 对象介绍 :
| 参数名称 | 作用 |
| count | 最多可以选择的图片张数，默认 1 |
| sizeType | original 原图，compressed 压缩图，默认二者都有 |
| sourceType | album 从相册选图，camera 使用相机，默认二者都有。如需直接开相机或直接选相册，请只使用一个选项 |
演示代码
<template>
<view class="content">
<view class="" @tap="chooseImg">选择图片</view>
</view>
</template>
<script>
var graceJS = require('@/Grace.JS/grace.js');
export default{
methods:{
chooseImg : function () {
graceJS.chooseImgs(
{},
function(e){
console.log(e);
}
);
}
}
}
</script>getImageInfo()
函数功能 : 获取图片信息
对应手册 : https://uniapp.dcloud.io/api/media/image?id=getimageinfo
函数参数 :
| 参数名称 | 必填 | 默认值 | 作用 |
| imgUrl | 是 | 图片的路径，可以是相对路径，临时文件路径，存储文件路径，网络图片路径 | |
| success | 是 | 接口调用成功的回调函数 ( 执行时携带图片信息 ) | |
| fail | 否 | 执行失败时执行的函数 | |
| complete | 否 | 执行完成时执行的函数 |
演示代码 :
var graceJS = require('@/Grace.JS/grace.js');
export default{
onLoad : function(){
graceJS.getImageInfo('https://img-cdn-qiniu.dcloud.net.cn/new-page/logo.png', (info)=>{
console.log(info);
});
}
}previewImage()
函数功能 : 预览图片
对应手册 : https://uniapp.dcloud.io/api/media/image?id=unipreviewimageobject
函数参数 :
| 参数名称 | 必填 | 默认值 | 作用 |
| items | 是 | 数组形式的图片地址列表 | |
| currentImg | 否 | current 为当前显示图片的链接，不填或填写的值无效则为 urls 的第一张 |
演示代码 :
var graceJS = require('@/Grace.JS/grace.js');
export default{
onLoad : function(){
graceJS.previewImage(
[
'https://img-cdn-qiniu.dcloud.net.cn/new-page/logo.png',
'https://img.cdn.aliyun.dcloud.net.cn/uni-app/uniCloud/xinguanlogo.png',
'https://img.cdn.aliyun.dcloud.net.cn/uni-app/doc/uni-app-frame-0310.png'
],
'https://img.cdn.aliyun.dcloud.net.cn/uni-app/uniCloud/xinguanlogo.png'
);
}
}
