แม่แบบ:Sidebar/doc

แม่แบบนี้เกี่ยวกับแม่แบบนำทางแนวตั้ง สำหรับแม่แบบแนวนอน ดูที่ แม่แบบ:Navbox สำหรับแถบข้างซ้ายของอินเทอร์เฟซ ดูที่ บทความในคู่มือมีเดียวิกิ

This template is a metatemplate for the creation of sidebar templates, i.e. boxes that are vertically aligned navigation templates. Sidebars, like infoboxes, are usually positioned on the right-hand side of a page.

{{Sidebar with collapsible lists}} is a version of {{Sidebar}} that adds collapsibility to its sections, i.e. the means to show or hide sections by clicking links beside their headings.

Note that MOS:LEAD discourages the placement of sidebars in the lead section of articles.

การใช้งาน

{{Sidebar
| name = {{subst:PAGENAME}}
| class =            
| wraplinks =        <!-- "true" otherwise (default:) omit -->
| float =
| templatestyles = 
| child templatestyles = 
| grandchild templatestyles = 

| outertitleclass = 
| outertitle = 

| topimageclass = 
| topimage = 
| topcaption = 

| pretitleclass = 
| pretitle = 

| titleclass = 
| title = 

| imageclass = 
| image = 
| caption = 

| headingclass = 
| contentclass = 

| aboveclass = 
| above = 

| heading1 = 
| heading1class = 
| content1 = 
| content1class = 

| heading2 = 
| heading2class = 
| content2 = 
| content2class = 

| heading3 = 
| heading3class = 
| content3 = 
| content3class = 

<!-- (omitting infinite heading/content parameters) -->

| belowclass = 
| below = 
| navbar = 

}}

Note that Wikipedia:Manual of Style/Lead section § Elements discourages the placement of sidebars in the lead section of articles, though they may be included on a case-by-case basis.

Parameters

No parameters are required unless {{navbar}} links ("v·d·e") are to appear at the bottom of the sidebar, in which case the parameter name is needed (see entry in the table immediately below).

Principal

Parameter	Explanation
name	The sidebar's name, i.e. the name following "Template:" in the page's name. Required for the {{navbar}} links at the bottom of the sidebar to function correctly, unless these are omitted (see navbar at the bottom of this table). It is recommended to use {{subst:PAGENAME}} for this field.
outertitle	Use to place a title for the sidebar immediately above the sidebar.
topimage	Use to place an image at the top of the sidebar, i.e. above any title included. Full wikisyntax expected (i.e. [[Image:...]]). To add a caption below the image, use topimagecaption.
pretitle	Use to place a line such as "Part of the X series on" before the title.
title	Use to place a title for the sidebar at the top of the sidebar (immediately below the topimage, if used).
image	Use to place an image between the title (if used) and first section. As with topimage, full wikisyntax expected (i.e. [[Image:...]]). To add a caption below the image, use imagecaption.
headingstyle	Use to alter the default CSS styling set for section headings. To alter the CSS styling for a specific section's heading, use headingNstyle, where N is the number of the section.
contentstyle	Use to alter the default CSS styling set for section content. To alter the CSS styling for a particular section's content, use contentNstyle, where N is the number of the section.
heading1	First section's heading (if needed).
content1	First section's content (required).
heading2	Second section's heading (if needed).
content2	Second section's content (if needed).
heading3	Third section's heading (if needed).
content3	Third section's content (if needed).
...... etc ......
heading35	Currently, the last possible section heading and/or content (if needed).
content35
navbar	Set to "none" (without the quotes) to remove the {{navbar}} links appearing at the bottom of the sidebar.

Other parameters

Parameter	Explanation
above	Corresponds to above parameter offered by {{Navbox}}.
class  (or bodyclass) outertitleclass topimageclass titleclass imageclass	Microformat classes for the corresponding parameters. (class / bodyclass applies to the sidebar as a whole.)
below	Use to e.g. add one or more portal links to the bottom of the template (by default in bold).
style  (or bodystyle) outertitlestyle topimagestyle topcaptionstyle pretitlestyle titlestyle imagestyle captionstyle belowstyle navbarstyle	Use to alter default CSS styling for the corresponding parameters. (style / bodystyle applies to the sidebar as a whole.)
cellspacing	Use to amend the default cellspacing set for the infobox-class table with which the sidebar is built.
cellpadding	Ditto the default cellpadding.
navbaroptions	Use to specify more options for the navbar at the bottom of the sidebar (see {{navbar}} for options available).

Handling long links

{{normalwraplink}} may be used to handle links that should wrap within the sidebar or otherwise need to be made to wrap in order to prevent the sidebar becoming too wide. Use {{normalwraplink|longlinkname}}, where longlinkname is the long link without its square brackets.

Use the wraplinks parameter to turn link wrapping off for the whole template.

การใช้งาน

(omitting sections 4 to penultimate)

{{Sidebar
|name  = {{subst:PAGENAME}}
|class =        <!--or bodyclass-->
|style =        <!--or bodystyle-->
|cellspacing = 
|cellpadding = 
|sectdivider = 

|outertitle = 
|outertitleclass = 
|outertitlestyle = 

|topimage = 
|topimageclass = 
|topimagestyle = 
|topcaption = 
|topcaptionstyle = 

|pretitle =
|pretitlestyle = 

|title = 
|titleclass = 
|titlestyle = 

|image = 
|imageclass = 
|imagestyle = 
|caption = 
|captionstyle = 

|abovestyle = 
|above = 

|headingstyle = 
|contentstyle = 

|heading1style = 
|heading1 = 
|content1style = 
|content1 = 

|heading2style = 
|heading2 = 
|content2style = 
|content2 = 

|heading3style = 
|heading3 = 
|content3style = 
|content3 = 

<!--etc.-->

|heading35style = 
|heading35 = 
|content35style = 
|content35 = 

|belowstyle = 
|below = 

|navbar = 
|navbarstyle = 
|navbaroptions = 

|wraplinks = true/false
}}

หมวดหมู่ติดตาม

• หมวดหมู่:Pages using sidebar with the child parameter (0)
• หมวดหมู่:Sidebars with styles needing conversion (245)

ดูเพิ่ม

• {{Sidebar with collapsible lists}}
• {{กล่องข้อมูล}}
• {{Side box}}