---
title: "external_video_tag"

doc_type: static
doc_category: static
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/sline/tag/external-video-tag'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/sline/tag/external-video-tag.md'
---

# external_video_tag


    生成指定外部视频的播放器 `<iframe>` 标签。外部视频指在 SHOPLINE 之外的平台上托管的视频。

    目前仅支持 YouTube 的视频链接。



```sline
{{#external_video_tag videoUrl attribute=any /}}
```





    
## 必选参数

        
             `videoUrl` `string`：外部视频 URL。
        
    



    
## 可选参数

        
             `attribute` `any`：语法中的 `attribute=any` 为占位符，支持传入任意原生 HTML 属性（如 `class="my-video"`、`id="player"`、`style="..."` 等），这些属性会直接绑定到生成的 `<iframe>` 标签上。
        
    



    
## 例子

        
            ### 渲染视频播放器

            结合 [external_video_url](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/external-video-url.md) filter，使用该 tag 渲染 YouTube 视频播放器。

            
```sline
{{#external_video_tag media | external_video_url() /}}
```
            

            
<SlineExample path={'/products/earring-ab001'} objects={ 
    ["product"] 
}>
```sline
{{#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}}
```
</SlineExample>
            
        
            ### 添加 HTML 属性

            传入标准的 [HTML iframe 属性](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/iframe#%E5%B1%9E%E6%80%A7)，例如：`class`、`frameborder` 等。

            
```sline
{{#external_video_tag media | external_video_url() attribute=any /}}
```
            

            
<SlineExample path={'/products/earring-ab001'} objects={ 
    ["product"] 
}>
```sline
{{#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}}
```
</SlineExample>