查看“模板:Listen/doc”的源代码

==简介==
本模板允许用户将音频及视频文件嵌入萌百的页面中。
==重定向页==
*{{tl|听}}
*{{tl|试听}}
*{{tl|聆听}}

==简单用法==
<pre><nowiki>{{Listen
| filename    =
| title       =
| description =
| pos         =
}}</nowiki></pre>
*'''filename'''：文件名，'''支持Ogg文件（.ogx，.ogg，.ogm，.ogv，.oga，.spx，.opus）及MP3文件，但对MP3的兼容性如何尚不清晰，有部分可以直接播放的MP3文件，例如[[:File:二羽鹤.mp3]]便可使用该模板'''。
*'''title'''：文件标题，不要使用[[Template:Cquote|引言标记]]，可能会导致运行错误。
*'''description'''：影音的简介。
*'''Pos'''：模板的浮动位置，“left”或者“左”为左，“right”或者“右”为右，“Center”或者“居中”为居中。不填时默认为右。

==多文件==
<pre><nowiki>{{Listen
| filename     =
| title        =
| alt          =
| description  =
| filename2    =
| title2       =
| alt2         =
| description2 =
| filename3    =
| title3       =
| alt3         =
| description3 =
}}</nowiki></pre>
*'''filename'''：文件名，'''支持Ogg文件（.ogx，.ogg，.ogm，.ogv，.oga，.spx，.opus）及MP3文件，但对MP3的兼容性如何尚不清晰'''。	
*'''title'''：文件标题，不要使用[[Template:Cquote|引言标记]]，可能会导致运行错误。
*'''description'''：影音的简介。
*'''alt'''：文件的Alt属性，详见：[https://www.w3school.com.cn/tags/att_img_alt.asp 万维网联盟学校的介绍]。

==Style参数==
该模板拥有多个style参数，它们可以左右模板的外观等属性。
*'''type'''：该参数可以改变该模板左边的图标。可用参数为''speech''，''sound（默认值）''及''music''。
*'''header'''：可以为该模板添加一个抬头。
*'''help'''：如果将help设置为''no''，模板底部的帮助信息就不再显示。
*'''pos'''：模板的浮动位置，“left”或者“左”为左，“right”或者“右”为右，“Center”或者“居中”为居中。不填时默认为右。
*'''image'''：自定义的模板左部的图标。比如''<nowiki>|image=[[File:Emoji 1202.png|50px]]</nowiki>''。你同样可以使用''|image=none''参数关闭左图。
*'''style'''：设置用户自定义的style参数，比如设置''<nowiki>|style=float:none</nowiki>''可以删除float参数。设置''<nowiki>|style=float:none; clear:none</nowiki>''则可以将clear参数与float参数全部清空。
*'''play'''：当遇到不能播放的内链文件（也就是来自[[Cm:mainpage|萌百共享]]的文件）时，使用''<nowiki>|play=no</nowiki>''参数可以阻止对该文件的播放器的加载。
*'''plain'''：当设置''<nowiki>|plain=yes</nowiki>''时，模板会将大部分元素屏蔽掉（边框，左部图片及帮助链接），从而生成一个最小化的界面。同样的，它也会移除浮动（float）参数。但用户仍然可以通过''style''参数手动设置（比如''<nowiki>|style=float:right</nowiki>'')。
*'''embed'''： 使用''<nowiki>|embed=yes</nowiki>''参数可以删去边框和padding。这个参数用在模块被嵌入另外的<nowiki>{{</nowiki>[[Template:infobox|infobox]]<nowiki>}}</nowiki>当中时。



<includeonly>[[Category:音频模板]][[Category:视频模板]]</includeonly>
<noinclude>[[Category:模板文档]]</noinclude>