editor 组件 |
您所在的位置：网站首页 › uniapp下载图片有限制吗 › editor 组件 |
|
# editor 组件 富文本编辑器，可以对图片、文字格式进行编辑和混排。 在web开发时，可以使用contenteditable来实现内容编辑。但这是一个dom API，在非H5平台无法使用。于是微信小程序和uni-app的App-vue提供了editor组件来实现这个功能，并且在uni-app的H5平台也提供了兼容。从技术本质来讲，这个组件仍然运行在视图层webview中，利用的也是浏览器的contenteditable功能。 编辑器导出内容支持带标签的 html和纯文本的 text，编辑器内部采用 delta 格式进行存储。 通过setContents接口设置内容时，解析插入的 html 可能会由于一些非法标签导致解析错误，建议开发者在应用内使用时通过 delta 进行插入。 富文本组件内部引入了一些基本的样式使得内容可以正确的展示，开发时可以进行覆盖。需要注意的是，在其它组件或环境中使用富文本组件导出的html时，需要额外引入这段样式 ，并维护的结构，参考：使用 editor 组件导出的 html 。 图片控件仅初始化时设置有效。 相关 api：editorContext # 平台差异说明 App H5 微信小程序 支付宝小程序 百度小程序 抖音小程序、飞书小程序 QQ小程序 快应用 360小程序 快手小程序 2.0+，app-vue 2.4.5+ 基础库 2.7.0+ x 需引入动态库引入方式 x x x x x # HarmonyOS 兼容性 HarmonyOS x注意 editor组件目前只有H5、App的vue页面、微信小程序、百度小程序支持，其他端平台自身未提供editor组件，只能使用web-view加载web页面，也可搜索插件市场 获取简单的markdown富文本编辑器 百度平台需引入动态库引入方式 # 属性说明 属性 类型 默认值 必填 说明 read-only boolean false 否 设置编辑器为只读 placeholder string 否 提示信息 show-img-size boolean false 否 点击图片时显示图片大小控件 show-img-toolbar boolean false 否 点击图片时显示工具栏控件 show-img-resize boolean false 否 点击图片时显示修改尺寸控件 @ready eventhandle 否 编辑器初始化完成时触发 @focus eventhandle 否 编辑器聚焦时触发，event.detail = {html, text, delta} @blur eventhandle 否 编辑器失去焦点时触发，detail = {html, text, delta} @input eventhandle 否 编辑器内容改变时触发，detail = {html, text, delta} @statuschange eventhandle 否 通过 Context 方法改变编辑器内样式时触发，返回选区已设置的样式 # HTML 标签和 style 内联样式支持情况编辑器内支持部分 HTML 标签和内联样式，不支持class和id # 支持的标签不满足的标签会被忽略，会被转行为 储存。 类型 节点 平台差异说明 行内元素 其中 百度小程序不支持 块级元素其中仅百度小程序支持、 百度小程序不支持 # 支持的内联样式 内联样式仅能设置在行内元素或块级元素上，不能同时设置。例如 font-size` 归类为行内元素属性，在 p 标签上设置是无效的。 类型 样式 平台差异说明 块级样式 text-align direction margin margin-top margin-left margin-right margin-bottom padding padding-top padding-left padding-right padding-bottom line-height text-indent 百度小程序仅支持text-align、direction 行内样式 font font-size font-style font-variant font-weight font-family letter-spacing text-decoration color background-color 百度小程序仅支持color、background-color # H5 使用最佳实践近期部分用户反馈访问 unpkg 失败，导致 editor 组件初始化异常。这里提供代码块，方便用户修改。 # 方案一：自行托管 CDN 资源分别下载quill.min.js 、image-resize.min.js ，放入 static 目录中。 在 index.html(Vue 3)，或者 public/index.html(Vue2) 中在 head 之间添加 js 这样 editor 组件就可以正常使用了，代码逻辑中检测到有相关 window.Quill 变量，就不会从远程获取资源。 # 方案二：从 npm 中处理资源方案一的解决思路是在 window 上进行挂载，同样，我们可以在项目入口 main.js 或者 App.vue中引用相关依赖即可。 在项目中添加相关依赖： npm i [email protected]在组件页面或者 main.ts 入口逻辑中，使用下面方案，注入依赖： // #ifdef H5 import quill from "quill"; window.Quill = quill; // #endif相比方案一，方案二好处是依赖清晰，引用透明。如果你熟悉 npm 生态和构建流程，推荐方案二。 # 注意事项 插入的 html 中事件绑定会被移除 formats 中的 color 属性会统一以 hex 格式返回 粘贴时仅纯文本内容会被拷贝进编辑器 插入 html 到编辑器内时，编辑器会删除一些不必要的标签，以保证内容的统一。例如xxx 会改写为xxx 编辑器聚焦时页面会被上推，系统行为以保证编辑区可见 H5 端需要动态引入 quill.min.js 、image-resize.min.js 依赖，默认情况下浏览器会从 unpkg.com 加载。如果依赖加载较慢或失败，uni-app 建议使用通过测试的 js 依赖保证效果一致，访问 github.com 或者 gitee.com 选择下载。可以放入 static 目录进行托管，或者使用 CDN 服务商。为了保证服务的稳定性，推荐开发者将所有前端资源使用 uniCloud 前端网页托管 服务进行托管，然后在 自定义模板 的 head 标签内引入相关 js 依赖。 不能直接插入视频或者其他文件，编辑时可以采用视频封面或者文件缩略图占位，并在图片属性中保存视频信息，预览时读取附加信息再还原为视频或者其他文件操作。示例代码 查看演示 Template Script Style 一个完整的内容管理系统 Content Management System 比较复杂，DCloud已提供好了现成的 uni-cms，开源、免费、全端可用、功能完善，包括管理端和用户端。还内置了 AI 生成文章和广告变现功能。详见：https://uniapp.dcloud.net.cn/uniCloud/uni-cms.html |
今日新闻 |
推荐新闻 |
| CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |