340 字
2 分钟
页面浏览--访问次数--
YouTube 视频

Shirone 支持嵌入 YouTube 视频,遵循严格的 Facade 占位与预加载控制规范。

语法格式#

使用 ::youtube 指令并配置参数:

::youtube{id="5gIf0_xpFPI" title="YouTube 演示视频" preload="auto"}

渲染效果:

YouTube 演示视频YouTube

属性参数列表#

属性名类型是否必填默认值说明
idstring必填无YouTube 视频链接中的 11 位唯一 ID
titlestring必填无视频标题描述
preloadstring可选"none"预加载策略:"none"(默认)或 "auto"(视口临近预热)

视频 ID 就是观看链接 https://www.youtube.com/watch?v=xxxxxxxxxxx 中 v= 后面的部分,也等同于短链 https://youtu.be/xxxxxxxxxxx 的路径段。

预加载与隐私策略#

  • preload="none":未点击前不下载 YouTube 播放器脚本与第三方 Cookie。
  • preload="auto":临近视口时提前加载容器占位,提高点击后的响应速度。
::youtube{id="5gIf0_xpFPI" title="默认占位模式"}

渲染效果(默认 none):

默认占位模式YouTube

与 Bilibili 嵌入的差异#

对比项::bilibili::youtube
必填标识bvidid
分 P 支持有(p 参数)无
默认预加载nonenone
点击前的外部请求00

两个平台共用同一套 16:9 响应式容器,因此混排时卡片高度完全一致,不会破坏文章节奏。

第 27 篇,共 30 篇本文属于系列

YouTube 视频
https://www.ariels.xyz/posts/media-youtube/
作者
Ariel
发布于
2026-10-13
许可协议
CC BY-NC-ND 4.0

分享文章

生成精美分享图或复制链接,与更多人分享本文。

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取

评论

正在加载评论...