- swan.chooseImage
- 方法参数
- object 参数说明
- success 返回参数说明
- tempFiles 对象结构如下
- 示例
- 图片示例
- 代码示例 1:tempFilePaths
- 代码示例 2:tempFiles
- Bug & Tip
- 错误码
- Android
- iOS
- 方法参数
swan.chooseImage
解释:从本地相册选择图片或使用相机拍照。上传图片界面设计可直接使用 Smart UI 组件,详见 image-uploader 图片上传器。
方法参数
Object object
object 参数说明
| 属性名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
|
count |
Number |
否 |
9 |
最多可以选择的图片张数 |
|
sizeType |
Array.<string> |
否 |
original 原图,compressed 压缩图,默认二者都有 |
|
|
sourceType |
Array.<string> |
否 |
album 从相册选图,camera 使用相机,默认二者都有 |
|
|
success |
Function |
否 |
成功则返回图片的本地文件路径列表 tempFilePaths |
|
|
fail |
Function |
否 |
接口调用失败的回调函数 |
|
|
complete |
Function |
否 |
接口调用结束的回调函数(调用成功、失败都会执行) |
success 返回参数说明
| 参数 | 类型 | 说明 | Web 态说明 |
|---|---|---|---|
|
tempFilePaths |
Array.<string> |
图片的本地文件路径列表 |
Web 态值为浏览器所支持的 blob URL 数组,形如 |
|
tempFiles |
Array.<object> |
图片的本地文件列表,每一项是一个 File 对象 |
– |
tempFiles 对象结构如下
| 字段 | 类型 | 说明 | Web 态说明 |
|---|---|---|---|
|
path |
String |
本地文件路径 |
Web 态值为浏览器所支持的 blob URL 数组,示例 |
|
size |
Number |
本地文件大小(单位:B) |
– |
示例
扫码体验
代码示例
请使用百度APP扫码
图片示例
代码示例 1:tempFilePaths
在开发者工具中打开
在开发者工具中打开
在 WEB IDE 中打开
- SWAN
- JS
<view class="wrap"><view class="card-area"><view s-if="{{imageList.length > 0}}" style="height: {{imageList.length > 6 ? '3.54' : '2.55'}}rem;"><image s-for="image in imageList" class="image-items" style="height: {{imageList.length > 6 ? '32' : '49'}}%;" src="https://www.idc.net/help/186588/{{image}}" mode="scaleToFill" data-src="https://www.idc.net/help/186588/{{image}}" bindtap="previewImage"></image></view><view s-else class="display-area">图片显示区</view><view class="middle-area border-top"><view class="list-area border-bottom" hover-class="option-active"><text class="list-item-key-4">图片来源</text><picker class="list-item-value" mode="selector" value="{{sourceIndex}}" range="{{sourceArray}}" bind:change="sourceChange"><view hover-class="hover">{{sourceArray[sourceIndex]}}</view></picker></view><view class="list-area border-bottom" hover-class="option-active"><text class="list-item-key-4">图片质量</text><picker class="list-item-value" mode="selector" value="{{sizeIndex}}" range="{{sizeArray}}" bind:change="sizeChange"><view hover-class="hover">{{sizeArray[sizeIndex]}}</view></picker></view><view class="list-area border-bottom" hover-class="option-active"><text class="list-item-key-4">图片数量</text><picker class="list-item-value" mode="selector" value="{{countIndex}}" range="{{countArray}}" bind:change="countChange"><view hover-class="hover">{{countArray[countIndex]}}</view></picker></view></view><view class="button-group"><button type="primary" bindtap="selectImage">添加图片</button><button type="default" bindtap="clearImage">清空图片</button></view></view></view>
代码示例 2:tempFiles
在开发者工具中打开
在开发者工具中打开
在 WEB IDE 中打开
- SWAN
- JS
<view class="wrap"><view class="card-area"><view s-if="{{imageList.length > 0}}" style="height: {{imageList.length > 6 ? '3.54' : '2.55'}}rem;"><image s-for="image in imageList" class="image-items" style="height: {{imageList.length > 6 ? '32' : '49'}}%;" src="https://www.idc.net/help/186588/{{image}}" mode="scaleToFill" data-src="https://www.idc.net/help/186588/{{image}}" bindtap="previewImage"></image></view><view s-else class="display-area">图片显示区</view><view class="middle-area border-top"><view class="list-area border-bottom" hover-class="option-active"><text class="list-item-key-4">图片来源</text><picker class="list-item-value" mode="selector" value="{{sourceIndex}}" range="{{sourceArray}}" bind:change="sourceChange"><view hover-class="hover">{{sourceArray[sourceIndex]}}</view></picker></view><view class="list-area border-bottom" hover-class="option-active"><text class="list-item-key-4">图片质量</text><picker class="list-item-value" mode="selector" value="{{sizeIndex}}" range="{{sizeArray}}" bind:change="sizeChange"><view hover-class="hover">{{sizeArray[sizeIndex]}}</view></picker></view><view class="list-area border-bottom" hover-class="option-active"><text class="list-item-key-4">图片数量</text><picker class="list-item-value" mode="selector" value="{{countIndex}}" range="{{countArray}}" bind:change="countChange"><view hover-class="hover">{{countArray[countIndex]}}</view></picker></view></view><view class="button-group"><button type="primary" bindtap="selectImage">添加图片</button><button type="default" bindtap="clearImage">清空图片</button></view></view></view>
Bug & Tip
- Tip:文件的临时路径,在智能小程序本次启动期间可以正常使用,如需持久保存,需在主动调用 swan.saveFile ,在智能小程序下次启动时才能访问得到。
- Tip:在 Web 态内,文件的临时路径仅在浏览器关闭前有效。受浏览器限制,在 Web 态无法使用 swan.saveFile 在本地持久保存文件。
- Tip:在 Web 态内,调用 chooseImage 方法,然后取消选择或者手动返回上一个页面,并不会触发 fail 回调函数。
错误码
Android
| 错误码 | 说明 |
|---|---|
|
202 |
解析失败,请检查参数是否正确 |
|
1002 |
用户取消操作错误码 |
iOS
| 错误码 | 说明 |
|---|---|
|
202 |
解析失败,请检查参数是否正确 |
|
1002 |
用户取消操作错误码 |
|
1003 |
用户没有授权百度使用相册 |


![晴川云Minecraft Wiki教程:初始资源[ ],晴川云](https://baike.qcidc.com/wp-content/uploads/2025/09/20250919082337106-u_3899592610_3033192250fm_253fmt_autoapp_138f_PNG.png)







暂无评论内容