嵌入内容
为 YouTube、Vimeo、Twitter、Bluesky、Mastodon 等富媒体来源添加嵌入区块。
插件
嵌入内容
为 YouTube、Vimeo、Twitter、Bluesky、Mastodon 等富媒体来源添加嵌入区块。
产品详情
- 分类
- 发布
- 状态
- 可用
- 版本
- 测试版内置
Embeds 为常见媒体与社交平台提供原生区块支持,扩展富文本内容。EmDash 存储的是结构化内容而非一团不透明 HTML;本插件在保持该模型的同时,为 YouTube、Vimeo、Twitter、Bluesky、Mastodon 等提供便捷的嵌入区块(各版本权威列表见 packages/plugins/embeds)。
安装
- 在 EmDash 管理后台启用 Embeds,或在本地开发时从 monorepo 添加。
- 若环境需要从磁盘重新加载插件注册,请重新构建或重启开发服务器。
- 在编辑器中打开文章或页面,确认主题暴露的区块选择器或字段界面中出现嵌入区块。
配置
视版本而定,可配置:
- 允许的提供商 — 仅限品牌与法务认可的服务。
- 默认尺寸或宽高比 — 尤其适用于响应式布局中的视频。
- 注重隐私的行为 — 例如支持时的懒加载或占位模式。
示例(概念): 文档站可为教程允许 YouTube 与 Vimeo,在受监管版块禁用社交网络嵌入,并在提供商支持时使用 nocookie 等隐私增强参数。
使用场景
- 教程与发布公告 — 无需手贴 iframe 即可插入演示与演讲。
- 同步到网页的邮件通讯 — 若邮件流水线对齐,可在站点与邮件间保持一致的呈现。
- 社区动态 — 在长文旁嵌入 Bluesky 或 Mastodon 帖子。
运维提示
- 第三方嵌入可能改变标记或 CSP 要求;在主要提供商 API 变更后请复测。
- 简短的内部样式指南:何时嵌入与何时外链,以及如何撰写替代文本或周边说明以兼顾无障碍。