模板:Listen/doc

{{listen}} 允许将音讯档案嵌入到条目中。它应该用于与文字分开的音讯文件，例如音乐剪辑或录音。

对于包含发音或口语的音讯文件，应使用 {{audio}}。

简单用例

{{listen|檔案名|檔案描述}}

或：

{{listen|filename=檔案名|description=檔案描述}}

• filename (必填)：媒体档案的名称，不含File:前缀
• description：显示在音讯档案下方的说明

多个档案

在每个参数后附加一个数字，可以将多个档案嵌入到条目中的同一个模板。最多可以包含十个档案。

{{listen
| filename     =
| alt          =
| description  =
| filename2    =
| alt2         =
| description2 =
| filename3    =
| alt3         =
| description3 =
}}

• filename (必填)：媒体档案的名称，不含File:前缀
• alt：为视障读者显示的文件图像的替代文字。对于包含视讯和声音的文件来说，这是必需的。替代文字应仅描述初始静态影像，而不是整个影片或其声音。
• description：音讯档案的描述

样式参数

可用于根据嵌入的音讯内容的类型变更左侧显示的影像。可接受的值为：

• type：用于根据嵌入的音讯内容类型变更左侧显示的影像。可接受的值为：
  • sound
  • speech
  • music (预设)
• style：用于将特定的样式说明传递给模板。将其设为 float:none 将在方便时锚定框。将其设为 float:none; clear:none 将使锚定框能够与另一个浮动框优雅地共存。
• play#：部分媒体档案无法内嵌显示；如果是这种情况，请设定 |play=no 以防止显示损坏的内嵌连结。

用例

基本例子：

{{listen|Accordion chords-01.ogg|手風琴和弦}}

显示影片的例子：

{{listen
| filename    = Barack Obama inaugural address.ogv
| alt         = 一名身穿黑色外套的黑人男子在講台上做著手勢並講話，周圍都是提詞器。在他身後的背景中，大約有十幾個穿著溫暖的圍觀者。
| description = 2009年1月20日，巴拉克‧歐巴馬發表就職演說。<br/>（長度：21分21秒）
| type        = sound
}}

有header的例子：

{{listen|Phrase de Neil Armstrong.oga|「一個人的一小步……」，這是在[[月球]]上說出的第一句話。|type=speech}}

多个档案：

{{listen
| filename     = Accordion chords-01.ogg
| description  = 手風琴上演奏的和弦
| type         = music
| filename2    = Moonlight.ogg
| description2 = [[貝多芬]]升C小調「月光」奏鳴曲
}}