模板:Listen/doc

简介

本模板允许用户将音频及视频文件嵌入萌百的页面中。

重定向页

• {{听}}
• {{试听}}
• {{聆听}}

简单用法

{{Listen
| filename    =
| title       =
| description =
| pos         =
}}

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

多文件

{{Listen
| filename     =
| title        =
| alt          =
| description  =
| filename2    =
| title2       =
| alt2         =
| description2 =
| filename3    =
| title3       =
| alt3         =
| description3 =
}}

• filename：文件名，支持Ogg文件（.ogx，.ogg，.ogm，.ogv，.oga，.spx，.opus）及MP3文件，但对MP3的兼容性如何尚不清晰。
• title：文件标题，不要使用引言标记，可能会导致运行错误。
• description：影音的简介。
• alt：文件的Alt属性，详见：万维网联盟学校的介绍。

Style参数

该模板拥有多个style参数，它们可以左右模板的外观等属性。

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

举例

最简单的用法

{{listen
|  filename=Super Mario Bros Ground Theme.ogg
|title=超级马力欧主题曲
|description=超级马力欧主题曲：Ground Theme}}

MP3文件

仅支持可以不依赖Flashmp3直接播放的文件，请在萌娘共享中查看该MP3文件的状态，确认其是否能直接播放。

{{listen
|  filename=二羽鹤.mp3
|title=二羽鹤
|description=鹤姐妹的主题歌。}}

设置类型（左图标）及抬头

{{Listen
| header      = 窗边优的语音试听：
| type        = speech
| filename    = こんにちは！窓辺ゆうですっ.ogg
| title       = “你好！我是窗边优。”
| description = Windows 8[[窗边优]]版主题音效。
}}

播放视频及自定义左图标

{{Listen
|image=[[File:Film with a play icon.svg|50px]]
| filename    =YMO - Rydeen Music Cilp.ogv
| title       =《雷电》MV
| description = 拍摄于1983年。
}}

嵌入模板中

{{Infobox 
|class =infobox
|title-color =#26ca9b
|text-color =#FFFFFF
|left-column-color =#E0FFFF
|under-column-color=#62bca9
|Title = Ground Theme<br />超级马力欧主题曲
|image =Mario(SMB) Jump.svg
|size =250px
|caption =
|tabs =  {{{tabs|}}}
|Row titlestyle = width = 80px
|Row x1=基本信息
|Row x1 style=colspan=2 bgcolor=#E0FFFF
|Row 1 title =作曲
|Row 1 info = 近藤浩治
|Row 2 title =编曲 
|Row 2 info =近藤浩治 
|Row 3 title =年代 
|Row 3 info =1985年
|Row 4 title =流派 
|Row 4 info ={{link|芯片音乐}}  
|Row h1 title =试听
|Row h1 infostyle= style="text-align:left"
|Row h1 info={{Listen
| filename    = Super Mario Bros Ground Theme.ogg
| title       = 超级马力欧主题曲
| embed    = yes
}}
}}

Ground Theme 超级马力欧主题曲
250px
基本信息
作曲	近藤浩治
编曲	近藤浩治
年代	1985年
流派	芯片音乐
试听

最小化（Plain）

{{Listen
| filename = Super Mario Bros Ground Theme.ogg
| title    = 超级马力欧主题曲
| plain    = yes
| style    = float:left;clear:left
}}

多个文件

{{Listen
| type         =music
| filename     =Battle_Hymn_of_the_Republic,_Frank_C._Stanley,_Elise_Stevenson.ogg
| title        =1908年的一个版本的录音
| alt          =1908年的一个版本的录音
| description  =该版本由弗兰克·C·斯坦利与埃莉斯·斯蒂芬孙合唱。
| filename2    =Battle Hymn of the Republic (USAFB).ogg
| title2       =美国空军乐团Airmen of Note奏唱版（2007）
| alt2         =美国空军爵士乐团Airmen of Note奏唱版（2007）
| description2 =艾瑞克·理查兹编曲的爵士乐版。由美国空军军乐队爵士乐团The Airmen of Note奏唱。该曲收录于乐队2007年发行的专辑《这些勇敢的国家卫士》（Such Brave Defenders）中。
}}

整理

主页面：Template:clear

由于CSS的原因，该模板与图片及{{infobox}}一样，需要{{clear}}模板进行整理，才能不跨标题显示。

举例

没有使用Clear模板时

==试听==
{{listen|filename=Super Mario Bros Ground Theme.ogg|title=超级马力欧主题曲|description=超级马力欧主题曲：Ground Theme}}
==新章节==

新章节

使用Clear模板时

==试听==
{{listen|filename=Super Mario Bros Ground Theme.ogg|title=超级马力欧主题曲|description=超级马力欧主题曲：Ground Theme}}
{{clear}}
==新章节==