external_video_tag
生成指定外部视频的播放器 <iframe> 标签。外部视频指在 SHOPLINE 之外的平台上托管的视频。
目前仅支持 YouTube 的视频链接。
{{#external_video_tag videoUrl attribute=any /}}
必选参数
videoUrl string：外部视频 URL。
可选参数
attribute any：语法中的 attribute=any 为占位符，支持传入任意原生 HTML 属性（如 class="my-video"、id="player"、style="..." 等），这些属性会直接绑定到生成的 <iframe> 标签上。
例子
渲染视频播放器
结合 external_video_url filter，使用该 tag 渲染 YouTube 视频播放器。
{{#external_video_tag media | external_video_url() /}}
{{#for media in product.media}}
{{#switch media.media_type}}
{{#case "external_video" /}}
{{#if media.host == "youtube"}}
{{#external_video_tag media | external_video_url(autoplay=true, loop=false) /}}
{{/if}}
{{/switch}}
{{/for}}
添加 HTML 属性
传入标准的 HTML iframe 属性，例如：class、frameborder 等。
{{#external_video_tag media | external_video_url() attribute=any /}}
{{#for media in product.media}}
{{#switch media.media_type}}
{{#case "external_video" /}}
{{#if media.host == "youtube"}}
{{#external_video_tag media | external_video_url(autoplay=true, loop=false) class="video-media-youtube" frameborder="0" /}}
{{/if}}
{{/switch}}
{{/for}}
这篇文章对你有帮助吗？
SHOPLINE
'%3e%3crect%20x='6'%20y='7.13049'%20width='13'%20height='10'%20rx='1'%20fill='black'/%3e%3cpath%20d='M12.4998%2012.936L-3.65042%200.604835L28.65%200.604838L12.4998%2012.936Z'%20stroke='white'%20stroke-linejoin='round'/%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_716_14611'%3e%3crect%20x='6'%20y='7.13049'%20width='13'%20height='10'%20rx='1'%20fill='white'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e)
'%3e%3crect%20x='5.63086'%20y='7.26086'%20width='13'%20height='10'%20rx='1'%20fill='white'/%3e%3cpath%20d='M12.1306%2013.0664L-4.01956%200.735206L28.2809%200.735209L12.1306%2013.0664Z'%20stroke='%231A2C42'%20stroke-linejoin='round'/%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_716_14599'%3e%3crect%20x='5.63086'%20y='7.26086'%20width='13'%20height='10'%20rx='1'%20fill='white'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e)
© Copyright 2013-2026 SHOPLINE Limited.