模板: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 超級馬力歐主題曲
基本信息
作曲	近藤浩治
編曲	近藤浩治
年代	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}}
==新章节==