Nwuan a̱tyin ka a li Ta‌̱mpi‌̱let:Horizontal TOC/doc

{{Documentation subpage}}
{{High-use}}
<!-- Categories and interwikis go at the bottom of this page. -->
{{Uses TemplateStyles|Template:TOC limit/styles.css|Template:Horizontal TOC/styles.css|Template:Horizontal TOC/horizontal-toc-no-parentheses.css|noprotcat=yes}}
{{Template display|vector2022}}

This template lays out the table of contents in a [[WP:HLIST|horizontal list]] rather than a vertical one.

== Usage ==

<syntaxhighlight lang="wikitext">
{{horizontal TOC}}
</syntaxhighlight>
There is no need to specify <code><nowiki>__NOTOC__</nowiki></code>: this template handles that automatically.
*[https://en.wikipedia.org/w/index.php?title=Template:Horizontal_TOC/doc&oldid=653960465&useskin=vector See example]

To hide the generated heading numbers, use:

<syntaxhighlight lang="wikitext">
{{horizontal TOC|nonum=yes}}
</syntaxhighlight>
*[https://en.wikipedia.org/w/index.php?title=Template:Horizontal_TOC/doc&oldid=653960502&useskin=vector See example]

To suppress the parentheses around subsection lists, use:

<syntaxhighlight lang="wikitext">
{{horizontal TOC|noparens=yes}}
</syntaxhighlight>

To limit the depth of the generated headings to the first headings only, use:

<syntaxhighlight lang="wikitext">
{{horizontal TOC|limit=2}}
</syntaxhighlight>
*[https://en.wikipedia.org/w/index.php?title=Template:Horizontal_TOC/doc&oldid=653960535&useskin=vector See example]

To float the table of contents to the center of the page, use:

<syntaxhighlight lang="wikitext">
{{horizontal TOC|align=center}}
</syntaxhighlight>
*[https://en.wikipedia.org/w/index.php?title=Template:Horizontal_TOC/doc&oldid=653960585&useskin=vector See example]

For country and state lists with flag icons, see these examples: [[Legality of cannabis by country]]. And: [[Legality of cannabis by U.S. jurisdiction]].

==Limitations==
Since the [[Wikipedia:Vector 2022|Vector 2022]] skin forces the table of contents into a sidebar or a pop-up menu, this template does not control the placement of the TOC in that skin.

== See also ==
*[[Help:Table of contents]]
* {{tl|Compact TOC}}
* {{tl|List TOC letters}}
* {{tl|Nonumtoc}}
* {{t|flatlist}} - see [[List of temples in the United States (LDS Church)#Contents|example]] in the map caption. This method will also work with '''id=''' as described here: [[Help:Tables and locations#Section link or map link to a row anchor]].

<templatedata>
{
	"params": {
		"nonum": {
			"label": "No numbers",
			"description": "Hide the generated heading numbers",
			"example": "yes",
			"type": "string"
		},
		"limit": {
			"label": "Limit",
			"description": "Limits the depth of subheadings shown. For instance using limit=4 will hide the fourth level and deeper subheadings in the hierarchy. And limit=2 will hide all subheadings leaving only the main headings. This works by hiding the lower levels with CSS",
			"type": "number"
		},
		"no_parenthesis": {
			"label": "No parenthesis",
			"description": "Separates entries by bullets, regardless of sub-sections.",
			"example": "yes",
			"type": "string",
			"aliases": [
				"noparens"
			]
		},
		"align": {
			"label": "Align",
			"description": "Which side of the page to align the ToC to. Allowed values are left, right, center",
			"example": "align=left",
			"type": "string",
			"suggestedvalues": [
				"left",
				"center",
				"right"
			]
		},
		"clear": {
			"label": "Clear",
			"description": "Align underneath floating images and tables or not. Allowed values are left, right, both, none",
			"example": "clear:both",
			"type": "string",
			"suggestedvalues": [
				"left",
				"right",
				"both",
				"none"
			]
		},
		"links": {
			"label": "Links",
			"description": "Specify a list of links for the table of contents instead of the section links automatically generated by the TOC magic word",
			"example": "* [[#Season 1|1]]",
			"type": "string"
		}
	},
	"description": "This template lays out the table of contents in a horizontal list rather than a vertical one.",
	"format": "inline"
}
</templatedata>

<includeonly>{{Sandbox other||
<!-- Categories go here -->
[[Category:Wikipedia table of contents templates]]
}}</includeonly>