cordova-plugin-imagepicker 图片选择插件

一款功能强大的 Cordova 图片选择插件，支持从设备相册中批量选择图片、预览图片、限制选择数量及尺寸筛选等功能，适配 Android 、 iOS和 OHOS 三平台，为混合式移动应用提供高效的图片选择解决方案。

功能特性

• 批量选择：支持一次性选择多张图片，可自定义最大选择数量

• 图片预览：选择前可预览图片缩略图及原图，提升用户体验

• 尺寸筛选：可根据图片宽度、高度筛选符合要求的图片

• 格式支持：兼容 JPG、PNG 等主流图片格式，适配不同拍摄场景

• 权限管理：自动处理相册访问权限申请，提供权限拒绝回调

• 返回信息丰富：返回图片路径、尺寸、大小等完整元数据

安装方法

确保已创建 Cordova 项目（若未创建，执行 cordova create imagePickerDemo com.example.imagepicker ImagePickerDemo 创建），然后通过以下方式安装插件：

1. 基础安装（从 npm 仓库）

# 安装hcordova
npm install -g hcordova

# 安装稳定版插件
hcordova plugin add cordova-plugin-telerik-imagepicker

2. 安装指定版本

# 安装 1.0.0 版本
hcordova plugin add [email protected] --platform ohos

3. 从 GitCode 安装开发版

hcordova plugin add https://gitcode.com/OpenHamrony-Cordova/cordova-plugin-telerik-imagepicker.git --platform ohos

卸载方法

进入项目根目录，执行以下命令卸载插件：

# 全平台卸载
hcordova plugin remove cordova-plugin-telerik-imagepicker

#指定OHOS卸载
hcordova plugin remove cordova-plugin-telerik-imagepicker --platform ohos

平台配置

插件安装后需根据目标平台进行必要配置，以确保权限申请和功能正常运行。

核心 API

插件通过全局对象 window.imagePicker 暴露所有接口，所有方法均为异步执行，通过成功回调和错误回调处理结果。

选择多张照片

检查应用是否已获取相册访问权限。

 window.imagePicker.getPictures(
    function (results) {
        if (results.length <= 0) {
            return;
        }
        var src = "";
        for (var i = 0; i < results.length; i++) {
            src += "<img src='https://localhost" + results[i] + "' width='100%' />"
        }
        document.getElementById("imgInfo").innerHTML = src;
    }, function (error) {
        console.log('Error: ' + error);
    }, {
        maximumImagesCount: 9,
        width: 800
    }
);

许可证

本插件采用 Apache License 2.0 开源许可证。

参考资源

• android和iOS：cordova-plugin-telerik-imagepicker 官方指南

• GitCode 仓库：OpenHarmony-Cordova/cordova-plugin-telerik-imagepicker