Xem mã nguồn của Bản mẫu:Collapse/doc

{{Trang con tài liệu}}
{{shortcut|Template:Cot|Template:Cob}}

Bản mẫu Collapse được sử dụng để đặt các hộp thu gọn xung quanh các nội dung ngắn và các đoạn thảo luận (bảng, mẫu mã dài, v.v.). Đối với toàn bộ nội dung, hãy sử dụng {{tl|Collapse top}} và {{tl|Collapse bottom}}.

== Sử dụng ==

{{Tlx|Collapse|1&#61;<var>Discussion text to be put into box.</var>|2&#61;<var>Optional custom heading</var>}}

Để chắc chắn an toàn nhất, nên sử dụng {{Thông số|1}} và {{Thông số|2}} , vì nếu không thì bản mẫu có thể bị phá vỡ nếu có bất kỳ ký tự "=" nào.

=== Tham số bg ===

Tham số bg là tùy chọn. Nó thay đổi màu nền, sử dụng các giá trị màu web (ví dụ:#F0F2F5).

;Ví dụ:

<nowiki>{{Collapse|1=</nowiki><var>Discussion text to be put into box.</var><nowiki>|bg=#F0F2F5}} tạo ra:</nowiki>

{{Collapse|1=Discussion text to be put into box.|bg=#F0F2F5}}

=== Tham số padding ===
Tham số padding điều chỉnh độ rộng ô nội dung (mặc định là 8px):

<nowiki>{{Collapse|1=</nowiki><var>Discussion text to be put into box.</var><nowiki>|padding=20px}} tạo ra:</nowiki>

{{Collapse|1=Discussion text to be put into box.|padding=20px}}

=== Xung quanh văn bản tiêu đề ===
Khi được sử dụng với một phần văn bản, hãy bao gồm tiêu đề phần đó trong phần văn bản được thu gọn. Ví dụ, cho:

{{Divbox|green|Văn bản ví dụ|&#x3d;&#x3d; [[Wikipedia:Cẩm nang biên soạn#Sections_and_headings|Heading]] &#x3d;&#x3d;<br />{{Lorem ipsum}}}}

Thay bằng:

{{Divbox|tt|Thay bằng|{{Tlsp|Collapse|1&#61;{{Lorem ipsum}}|2&#61;[[Wikipedia:Cẩm nang biên soạn#Sections_and_headings|Heading]]}}}}

=== Tham số expand ===
Thêm <code>|expand=yes</code> để hộp hiển thị ở dạng mở rộng với liên kết "ẩn", thay vì ở dạng thu gọn với liên kết "hiện". Dùng <code>|expand=</code> có giá trị trống hoặc không dùng tham số expand sẽ để hộp hiển thị ở dạng thu gọn.

=== Tham số <code>float</code> ===
Thsm số <code>float</code> cho phép nội dung thu gọn nổi sang trái, phải hoặc giữa trang (mặc định là <code>none</code> với <code>width = 100%</code>):

<code><nowiki>{{</nowiki>Collapse|1=<var>Discussion text to be put into box.</var>|float=center<nowiki>}}</nowiki></code> tạo ra:

{{Collapse|1=Discussion text to be put into box.|float=center}}

<code><nowiki>{{</nowiki>Collapse|1=<var>Discussion text to be put into box.</var>|float=center|width=30em<nowiki>}}</nowiki></code> tạo ra:

{{Collapse|1=Discussion text to be put into box.|float=center|width=30em}}

<code><nowiki>{{</nowiki>Collapse|1=<var>Discussion text to be put into box.</var>|float=left|width=30em<nowiki>}}</nowiki></code> tạo ra:

{{Collapse|1=Discussion text to be put into box.|float=left|width=30em}}
{{clear}}
<code><nowiki>{{</nowiki>Collapse|1=<var>Discussion text to be put into box.</var>|float=right|width=30em<nowiki>}}</nowiki></code> tạo ra:

{{Collapse|1=Discussion text to be put into box.|float=right|width=30em}}
{{clear}}
<code><nowiki>{{</nowiki>Collapse|1=<var>Discussion text to be put into box.</var>|float=none|width=30em<nowiki>}}</nowiki></code> tạo ra:

{{Collapse|1=Discussion text to be put into box.|float=none|width=30em}}

===Tham số <code>clear</code>===
Trong một số trường hợp, bạn có thể không muốn áp dụng giá trị CSS mặc định <code>clear: both;</code>, điều này sẽ đặt hộp thu gọn bên dưới bất kỳ nội dung nổi bên trái hoặc bên phải nào trong cùng một khối HTML. Trong trường hợp này, bạn có thể sử dụng {{Thông số|clear|none}}, {{Thông số|clear|right}}, or {{Thông số|clear|left}}, as needed.

===Khi nội dung bao gồm các bảng===
Bản mẫu này thường bị hỏng khi được sử dụng xung quanh nội dung bao gồm hoặc bao gồm wikitable. Nội dung như vậy có thể được thu gọn bằng cách sử dụng {{tlx|collapse top}} và {{tlx|collapse bottom}} thay vì dùng {{tlx|collapse}}. 

==TemplateData==
{{TemplateData header}}
<templatedata>
{
	"description": "Creates a collapsible box that allows its content to be hidden or revealed on user's command. It is used to reduce clutter.",
	"params": {
		"1": {
			"label": "Contents",
			"description": "Contents of the box",
			"type": "content",
			"required": true,
			"aliases": [
				"content",
				"text"
			]
		},
		"2": {
			"label": "Title",
			"description": "Text of title bar. Defaults to \"Extended contents\".",
			"type": "string",
			"suggested": true,
			"aliases": [
				"title",
				"heading",
				"header",
				"reason",
				"result"
			],
			"default": "Extended content"
		},
		"expand": {
			"label": "Expanded by default?",
			"description": "Setting to \"yes\" (or \"y\", \"expand\", \"expanded\", \"uncollapse\", or \"uncollapsed\") will cause the box to show its contents by default. Any other value (and omitting this parameter) causes the box to be expanded by default.  If not set or set to another value (e.g. \"no\") the box will be collapsed by default (its contents hidden).",
			"type": "string",
			"default": "no"
		},
		"border": {
			"label": "Border width",
			"description": "Width of the outermost border. Accepts a number (e.g. 2) followed immediately with a CSS-compatible unit of measurement. (e.g. \"px\") Example: 2px.",
			"type": "string",
			"default": "1px"
		},
		"bg": {
			"label": "Title bar's color",
			"description": "Color of the title bar. Can be set any valid CSS color value but please take care that text would remain black.",
			"type": "string",
			"aliases": [
				"background"
			],
			"default": "#F0F2F5"
		},
		"padding": {
			"label": "Padding",
			"description": "Width of the padding, the empty space between border and the contents. Accepts a number (e.g. 2) followed immediately with a CSS-compatible unit of measurement. (e.g. \"px\") Example: 2px.",
			"default": "8px"
		},
		"bg1": {
			"label": "Outer background",
			"description": "Color of the space between the inner and outer border. Can be set to any valid CSS color.",
			"type": "string",
			"default": "transparent"
		},
		"b-color": {
			"label": "Outer border color",
			"description": "Color of the outer border. Can be any valid CSS color.",
			"type": "string",
			"default": "silver"
		},
		"width": {
			"label": "Collapse box width",
			"description": "The width of the entire collapsed box.",
			"type": "string",
			"default": "100%"
		},
		"center": {
			"label": "Center-align title",
			"description": "If set to any value, the title will be centered.",
			"type": "boolean"
		},
		"fc": {
			"label": "Font color",
			"description": "Font color for the title. Also sets the color of the [show]/[hide] link. Can be any valid CSS color",
			"type": "string"
		},
		"class": {
			"label": "CSS class",
			"description": "Additional CSS class to add",
			"type": "string"
		},
		"float": {
			"label": "CSS float",
			"description": "CSS float, one of \"left\", \"right\", \"none\", \"center\"/\"centre\", or blank.",
			"type": "string"
		},
		"clear": {
			"label": "CSS clear",
			"description": "CSS clear value.  The default depends on the selected float.  Usually one of \"none\", \"left\", \"right\", or \"both\"",
			"type": "string"
		},
		"left": {
			"label": "Left-align title",
			"description": "Left-aligns the title.  Takes precedence over center.",
			"type": "boolean"
		},
		"border2": {
			"label": "Content border",
			"description": "CSS border styling to add to the content.",
			"type": "string",
			"default": "1px silver"
		},
		"bg2": {
			"label": "Content background color",
			"description": "Background color to use for expanded content.",
			"type": "string",
			"default": "white"
		}
	}
}
</templatedata>

<!-- == Re-using at other wikis ==
This template depends upon having rules for the three classes (collapsible, uncollapsed, and collapsed) in the appropriate CSS files, and some related JavaScript installed. This template transcludes {{tl|main other}} and {{tl|lorem ipsum}}, which should also be imported at the same time.

For MediaWiki versions ≥ 1.18, this template can simply be exported and then imported into another MediaWiki installation. Some changes to the source code will need to be made in order for this template to become usable on the Main/Article (ns:0) [[mw:Help:Namespaces|namespace]].

The toggle text can be edited at external Wiki's [[MediaWiki:Collapsible-expand]] and [[MediaWiki:Collapsible-collapse]] pages. Further information at [[mw:ResourceLoader/Modules#jquery.makeCollapsible|jquery.makeCollapsible module]].
 -->

== Xem thêm ==
* {{Tl|collapse top}}
* {{Tl|collapse bottom}}
* {{tl|discussion top}}
* {{tl|archive top}}
* {{tl|hidden}}
* {{tl|hidden archive top}}

<includeonly>{{Sandbox other||
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Thể loại:Bản mẫu lưu trữ]]
[[Thể loại:Bản mẫu Collapse]]
}}
</includeonly>