更新记录

1.0.2(2025-06-06) 下载此版本

添加fontSize属性 增加拖拽实现文本缩放 修复文本换行矩形框问题

1.0.1(2025-06-05) 下载此版本

修改说明文档

1.0.0(2025-06-05) 下载此版本

  • 图片编辑器
查看更多

平台兼容性

uni-app

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- - - - -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 快应用-华为 快应用-联盟
- - - - - - - - - -

uni-app x

Chrome Safari Android iOS 鸿蒙 微信小程序
5.0 12 -

其他

多语言 暗黑模式 宽屏模式
× ×

ImgEditor 图片编辑器

uniapp 图片编辑器

安装

在插件市场导入uni_modules版本的即可,地址:https://ext.dcloud.net.cn/plugin?id=23745

基本用法

<yu-img-editor :data="dataList" :fontList="[]" :bgColor="['#209cff', '#68e0cf']"></yu-img-editor>
  • 初始化数据格式
    <script>
    export default {
        data() {
            return {
                bg:'',
                dataList: [
                    {
                        type: 'text', //元素类型,text 文本 image 图片
                        text: 'Hello world', //文本内容
                        x: 60,      //元素x坐标
                        y: 60,      //元素x坐标
                        width: 90, //元素宽高
                        height: 30, //元素宽高
                        rotation: 45, //元素旋转角度
                        fontSize: 24,   //文本字体大小
                        lineHeight:1.5, //文本字体行高
                        fontStyle:'italic', //文本字体样式 italic/normal
                        fontWeight:'bold', //文本字体大小 bold/bolder/normal
                        fontFamily: 'Arial', //文本字体
                        color: '#fffb6d' //文本颜色
                    },
                    {
                        type: 'image',
                        path: '', //图片路径
                        x: 160,
                        y: 180,
                        width: 90, //元素宽高
                        height: 90, //元素宽高
                        rotation: 0
                    }
                ]
            }
        }
    }
    </script>

功能介绍

  1. 该组件的功能主要是利用canvas画布来实现文本、图片的编辑,最后保存为图片。
  2. 设置画布背景。
    • 可以修改背景颜色,包括纯色、渐变色,组件内部预设。
    • 可以修改背景图片,可通过上传设置,也可以通过 bgImgList 属性进行预设。
  3. 设置文本
    • 可以设置文本内容、文本样式、文本旋转角度、文本字体大小
    • 可以选择不同字体,组件内部预设了常用字体(宋体、仿宋、黑体、楷体、微软雅黑),可通过fontList自定义。
    • 1.0.2版本,考虑到字体包太大,组件内部预设太占空间,改成根据自己需要在项目中定义,通过fontList进行设置
    • 可以设置文本颜色,组件内部预设。
  4. 调整元素位置
    • 图层(置顶、置底,上调一层,下调一层)
    • 位置(左对齐、右对齐、顶对齐、底对齐、水平对齐、垂直对齐),都是相对与画布。
  5. 画布元素
    • 选中 点击默认选中最上层
    • 移动 拖拽移动选中元素
    • 删除 点击删除图标可实现删除元素
    • 编辑 点击编辑图标可再次编辑元素属性
    • 旋转缩放 按住拖拽旋转缩放图标可以实现旋转缩放功能

Props

参数 类型 默认值 说明
data Array<object> [] 画布的初始化数据,具体格式请看基本用法
bgImgList Array [] 背景图设置中的预设图列表
bgUrl String - 初始化的画布背景图片
bgColor String/Array - 初始化的画布背景颜色,当bgUrl不为空时,bgColor无效,类型为 String时,表示纯色,类型为Array时,可展示为渐变色
fontList Array<object> [] 字体设置列表,考虑到字体包太大,占用组件空间,可以自己设置

Events

事件名 说明 返回值
save 生成图片 path

API

方法 类型 参数 说明
insertTextElement Function object 往画布中插入文本元素,参数同基本用法中的参数
updateTextElement Function object 更新画布中的文本元素,参数同基本用法中的参数
insertImageElement Function path 往画布中插入图片元素,传递图片路径path
updateImageElement Function path 更新画布中的图片元素,传递图片路径path

感谢

如果你觉得本插件,解决了你的问题,赠人玫瑰,手留余香。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问