Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
uni-app
提交
21ae3e2a
U
uni-app
项目概览
DCloud
/
uni-app
6 个月 前同步成功
通知
750
Star
38709
Fork
3642
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
8
列表
看板
标记
里程碑
合并请求
1
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
uni-app
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
8
Issue
8
列表
看板
标记
里程碑
合并请求
1
合并请求
1
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
未验证
提交
21ae3e2a
编写于
8月 19, 2019
作者:
W
wanganxp
提交者:
GitHub
8月 19, 2019
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Update image.md
上级
2ba8e01c
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
80 addition
and
76 deletion
+80
-76
docs/api/media/image.md
docs/api/media/image.md
+80
-76
未找到文件。
docs/api/media/image.md
浏览文件 @
21ae3e2a
### uni.chooseImage(OBJECT)
从本地相册选择图片或使用相机拍照。另外选择和上传非图像、视频文件参考:
[
https://ask.dcloud.net.cn/article/35547
](
https://ask.dcloud.net.cn/article/35547
)
。
从本地相册选择图片或使用相机拍照。
另外选择和上传非图像、视频文件参考:
[
https://ask.dcloud.net.cn/article/35547
](
https://ask.dcloud.net.cn/article/35547
)
。
App端如需要更丰富的相机拍照API(如直接调用前置摄像头),参考
[
plus.camera
](
https://www.html5plus.org/doc/zh_cn/camera.html
)
**OBJECT 参数说明**
...
...
@@ -55,7 +59,7 @@ uni.chooseImage({
|current|String/Number|详见下方说明|详见下方说明||
|urls|Array
<
String
>
|是|需要预览的图片链接列表||
|indicator|String|否|图片指示器样式,可取值:"default" - 底部圆点指示器; "number" - 顶部数字指示器; "none" - 不显示指示器。|5+App|
|loop|Boolean|否|是否可循环预览,默认值为 false|5+App|
|loop|Boolean|否|是否可循环预览,默认值为 false|5+App|
|longPressActions|Object|否|长按图片显示操作菜单,如不填默认为
**保存相册**
,1.9.5 起支持。|5+App|
|success|Function|否|接口调用成功的回调函数||
|fail|Function|否|接口调用失败的回调函数||
...
...
@@ -78,47 +82,47 @@ current 为当前显示图片的链接/索引值,不填或填写的值无效
-
传 B2 的链接,预览的结果是 B1,前一张是 A,下一张是 C。
-
传 B2 的索引值 3,预览的结果是 B2,前一张是 C,下一张是 D。此时在微信/百度/头条小程序平台,最终传入的 urls 是
`[A, C, B2, D]`
,过滤掉了与 B2 重复的 B1。
**longPressActions 参数说明**
|参数|类型|必填|说明|
|:-|:-|:-|:-|
|itemList|Array
<
String
>
|是|按钮的文字数组|
|itemColor|String|否|按钮的文字颜色,字符串格式,默认为"#000000"|
|success|Function|否|接口调用成功的回调函数,详见返回参数说明|
|fail|Function|否|接口调用失败的回调函数|
|complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)|
**longPressActions 参数说明**
|参数|类型|必填|说明|
|:-|:-|:-|:-|
|itemList|Array
<
String
>
|是|按钮的文字数组|
|itemColor|String|否|按钮的文字颜色,字符串格式,默认为"#000000"|
|success|Function|否|接口调用成功的回调函数,详见返回参数说明|
|fail|Function|否|接口调用失败的回调函数|
|complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)|
**success 返回参数说明**
|参数|类型|说明|
|:-|:-|:-|
|:-|:-|:-|
|index|Number|用户长按图片的索引值|
|tapIndex|Number|用户点击按钮列表的索引值|
|tapIndex|Number|用户点击按钮列表的索引值|
**示例**
```
javascript
// 从相册选择6张图
uni
.
chooseImage
({
count
:
6
,
sizeType
:
[
'
original
'
,
'
compressed
'
],
sourceType
:
[
'
album
'
],
success
:
function
(
res
)
{
// 预览图片
uni
.
previewImage
({
urls
:
res
.
tempFilePaths
,
longPressActions
:
{
itemList
:
[
'
发送给朋友
'
,
'
保存图片
'
,
'
收藏
'
],
success
:
function
(
data
)
{
console
.
log
(
'
选中了第
'
+
(
data
.
tapIndex
+
1
)
+
'
个按钮,第
'
+
(
data
.
index
+
1
)
+
'
张图片
'
);
},
fail
:
function
(
err
)
{
console
.
log
(
err
.
errMsg
);
}
}
});
}
uni
.
chooseImage
({
count
:
6
,
sizeType
:
[
'
original
'
,
'
compressed
'
],
sourceType
:
[
'
album
'
],
success
:
function
(
res
)
{
// 预览图片
uni
.
previewImage
({
urls
:
res
.
tempFilePaths
,
longPressActions
:
{
itemList
:
[
'
发送给朋友
'
,
'
保存图片
'
,
'
收藏
'
],
success
:
function
(
data
)
{
console
.
log
(
'
选中了第
'
+
(
data
.
tapIndex
+
1
)
+
'
个按钮,第
'
+
(
data
.
index
+
1
)
+
'
张图片
'
);
},
fail
:
function
(
err
)
{
console
.
log
(
err
.
errMsg
);
}
}
});
}
});
```
...
...
@@ -221,54 +225,54 @@ uni.chooseImage({
});
}
});
```
# uni.compressImage(OBJECT)
压缩图片接口,可选压缩质量
```
# uni.compressImage(OBJECT)
压缩图片接口,可选压缩质量
**平台差异说明**
|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序
|:-:|:-:|:-:|:-:|:-:|:-:|
|1.9.7+
[
自定义组件编译模式
](
https://ask.dcloud.net.cn/article/35843
)
|x|√|√|x|x|
**OBJECT 参数说明**
| 属性 | 类型 | 默认值 | 必填 | 说明 |
| :- | :- | :- | :- | :- |
| src | String | | 是 | 图片路径,图片的路径,可以是相对路径、临时文件路径、存储文件路径 |
| quality | Number | 80 | 否 | 压缩质量,范围0~100,数值越小,质量越低,压缩率越高(仅对jpg有效) |
| success | Function | | 否 | 接口调用成功的回调函数 |
| fail | Function | | 否 | 接口调用失败的回调函数 |
| complete | Function | | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
**success 返回参数说明**
| 属性 | 类型 | 说明 |
| :- | :- | :- |
| tempFilePath | String | 压缩后图片的临时文件路径 |
**示例代码:**
```
js
|1.9.7+
[
自定义组件编译模式
](
https://ask.dcloud.net.cn/article/35843
)
|x|√|√|x|x|
**OBJECT 参数说明**
| 属性 | 类型 | 默认值 | 必填 | 说明 |
| :- | :- | :- | :- | :- |
| src | String | | 是 | 图片路径,图片的路径,可以是相对路径、临时文件路径、存储文件路径 |
| quality | Number | 80 | 否 | 压缩质量,范围0~100,数值越小,质量越低,压缩率越高(仅对jpg有效) |
| success | Function | | 否 | 接口调用成功的回调函数 |
| fail | Function | | 否 | 接口调用失败的回调函数 |
| complete | Function | | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
**success 返回参数说明**
| 属性 | 类型 | 说明 |
| :- | :- | :- |
| tempFilePath | String | 压缩后图片的临时文件路径 |
**示例代码:**
```
js
uni
.
compressImage
({
src
:
'
/static/logo.jpg
'
,
quality
:
80
,
success
:
res
=>
{
console
.
log
(
res
.
tempFilePath
)
}
})
```
# wx.chooseMessageFile(OBJECT)
从客户端会话选择文件。
**平台差异说明**
|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|
|:-:|:-:|:-:|:-:|:-:|:-:|
|x|x|√|x|x|x|
})
```
# wx.chooseMessageFile(OBJECT)
从客户端会话选择文件。
**平台差异说明**
|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|
|:-:|:-:|:-:|:-:|:-:|:-:|
|x|x|√|x|x|x|
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录