编辑“︁Template:Listen/doc”︁

{{Documentation subpage}}
{{lua|模組:Listen}}
{{Uses TemplateStyles|Module:Listen/styles.css}}
本模板連結至「'''位於中文維基百科或[[維基共享資源]]'''」的音訊檔案。在文章中使用本模板，可讓讀者聆聽輔助文章內容的音訊檔案。要使用本模板，請參閱以下說明：
*重定向：{{tl|聽}} = {{tl|Listen}} = {{tl|試聽}} = {{tl|聆聽}}。

==用法==
<pre style="overflow: auto">-{}-{{Listen
|filename    = 檔案名稱.副檔名
|title       = 檔案標題
|description = 檔案的描述
|pos         = 填入left或right控制左右
|image       = 填入[[File:Example.jpg|50px]]
|style       = 模板的樣式
|play        = 填入yes啟用另一種顯示方式
|plain       = 填入yes或no決定是否帶邊框
|embed       = 填入yes或no決定是否嵌入資訊框
}}</pre>
其中<code>|filename=</code>參數的檔案格式必須是[[commons:Commons:File types#Sound|音訊]]檔案。

===多重檔案===
<pre style="overflow: auto">-{}-
{{Listen
|filename     = 
|title        = 
|alt          = 
|description  = 
|filename2    = 
|title2       = 
|alt2         = 
|description2 = 
|filename3    = 
|title3       = 
|alt3         = 
|description3 = 
}}</pre>

==範例==
:<code><nowiki>{{Listen|filename=Accordion chords-01.ogg|title=手風琴和絃|description=用手風琴彈奏的和絃|pos=left}}
</nowiki></code>
{{Listen|left|filename=Accordion chords-01.ogg|title=手風琴和絃|description=用手風琴彈奏的和絃|pos=left}}
{{-}}
== 模板数据 ==
{{collapse top|title=模板数据}}
{{TemplateData header}}
<templatedata>
{
	"description": "Allows audio and video files to be embedded in articles.",
	"format": "{{_\n| ____________ = _\n}}\n",
	"params": {
		"header": {
			"label": "Header",
			"description": "Text or other content to go above all the files in the template (but within the template boundary). Allows markup.",
			"type": "content"
		},
		"type": {
			"label": "Music or speech icon",
			"description": "Enter \"music\" or \"speech\" here to change the template icon to a speaker with music notes or a microphone.",
			"type": "line",
			"example": "music",
			"default": "sound",
			"suggestedvalues": [
				"sound",
				"music",
				"speech"
			]
		},
		"image": {
			"label": "Custom icon",
			"description": "Custom image to replace the speaker icon in the template. Alternatively, enter \"none\" here to hide the icon entirely.",
			"type": "wiki-file-name",
			"example": "[[File:Example.jpg|50px]], none"
		},
		"filename": {
			"label": "Filename",
			"description": "The filename of the file. Filename2, filename3, etc. can be used for subsequent files.",
			"type": "wiki-file-name",
			"required": true
		},
		"title": {
			"label": "Title",
			"description": "The title to display for the file. Title2, title3, etc. can be used for subsequent files.",
			"type": "string",
			"required": true
		},
		"description": {
			"label": "Description",
			"description": "A description of the file. Description2, description3, etc. can be used for subsequent files.",
			"type": "string",
			"suggested": true
		},
		"start": {
			"label": "Start time",
			"description": "Timestamp at which the first file should start playing (start2, start3, etc. can be used for subsequent files)",
			"type": "line",
			"example": "0:20"
		},
		"length": {
			"label": "Hide duration?",
			"description": "Enter \"hide\" here to hide the duration of the first file (length2, length3, etc. can be used for subsequent files).",
			"type": "line",
			"example": "hide"
		},
		"play": {
			"label": "Hide player?",
			"description": "Enter \"no\" here to hide the file player for the first file (play2, play3, etc. can be used for subsequent files). To be used for some media files that cannot be displayed inline, to prevent a broken inline link from showing.",
			"type": "line",
			"example": "no"
		},
		"help": {
			"label": "Hide help text?",
			"description": "Enter \"no\" here to hide the \"Problems playing this file? See media help.\" text at the bottom of the template. Must not be done on the first instance of the template; optional on subsequent instances of the template.",
			"type": "line",
			"example": "no"
		},
		"pos": {
			"label": "Position",
			"description": "Enter \"left\" or \"center\" here to change the default position of the template from on the right.",
			"type": "line",
			"example": "left",
			"default": "right",
			"suggestedvalues": [
				"left",
				"center",
				"right"
			]
		},
		"plain": {
			"label": "Plain style?",
			"description": "Enter \"yes\" here to remove most of the ornamentation (border, background, icon and help text) and the float/positioning of the template to give a minimalist version, allowing the user to use the custom CSS (\"style\") parameter to style and position the template.",
			"type": "line",
			"example": "yes"
		},
		"embed": {
			"label": "Optimise for embedding?",
			"description": "Enter any text here to remove the left, right and bottom border, the background, the icon, the help text and the padding of the template for use in an infobox.",
			"type": "line",
			"example": "y"
		},
		"style": {
			"label": "Custom CSS",
			"description": "Custom CSS for the template",
			"type": "content",
			"example": "float:none; clear:none"
		}
	},
	"paramOrder": [
		"header",
		"type",
		"image",
		"filename",
		"title",
		"description",
		"start",
		"length",
		"play",
		"help",
		"pos",
		"plain",
		"embed",
		"style"
	]
}
</templatedata>
{{collapse bottom}}

== 參見 ==
* {{tl|Listen interwiki}}，與本模板類似，適用於位於其他語言版本維基百科上的音訊檔案。
* {{tl|Audio}}，與本模板功能類似的另一個模板，主要以直接將音訊檔案插入文字行中。
* {{tl|Pronunciation}}，與本模板功能類似的另一個模板，用於發音說明等用途。

{{Film and Television related infobox templates}}

<includeonly>{{Sandbox other||
[[Category:音訊模板]]
}}
</includeonly>