{{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小調「月光」奏鳴曲
}}