الگو:چندستون/توضیحات

`{{چندستون\|[overall width]\|[gutter width]}}`	`{{چندستون\|[overall width]\|[gutter width]}}`
……	……
`{{چندستون-شکست}}`	`{{چندستون-شکست}}`
……	……
`{{چندستون-شکست}}`	`{{چندستون-شکست}}`
……	……
(و غیره)	(و غیره)
`{{چندستون-پایان}}`	`{{چندستون-پایان}}`

استفاده

{{چندستون}} or {{چندستون}} is used to start a multi-columned section of a page. Between each column's contents, insert {{چندستون-شکست}} or {{چندستون-شکست}} and close the last column with {{چندستون-پایان}} or {{چندستون-پایان}}. For example:

<div style="background:lavender;">
{{چندستون}}              [or {{چندستون}}]
First column's contents.
{{چندستون-شکست}}        [or {{چندستون-شکست}}]
Second column's contents.
{{چندستون-شکست}}
Third column's contents.
{{چندستون-پایان}}          [or {{چندستون-پایان}}]
</div>

…produces:

First column's contents.

Second column's contents.

Third column's contents.

Most pages use only two columns, but you can have any number of columns. Each column will be the same width, equally dividing the available horizontal space. Each column has a small right margin (20 pixels), creating a "gutter" that prevents text in one column from touching text in the column to its right. See franl's user page for examples of how this template can be used.

While it is technically possible to have many columns, please consider the width of the items and avoid having more than about three or four columns for most pages because it is important to maintain legibility for the millions of readers who have smaller computer screens or are using smartphones to read articles. Similarly, if the list is short (perhaps about five items), please avoid using columns at all.

نمونه‌ها

To create a three-column section, with four-pixel righthand gutters, that extends across 50% of the available width:

{{چندستون|50% |4px}}
First column's contents.
{{چندستون-شکست|4px}}
Second column's contents.
{{چندستون-شکست|4px}}
Third column's contents.
{{چندستون-پایان}}

Result:

First column's contents.

Second column's contents.

Third column's contents.

A {{Multicol}}umned region is left-aligned with regard to the area of the page (the "block") it occupies. This may be switched to a centered or righthand alignment thus:

Centered

 <div style="text-align:center;">
 {{startcenter}}
 {{Start multicol (...) }}
 ......
 {{چندستون-پایان}}
 {{endcenter}}
 </div>

Righthand side

 <div style="text-align:right;">
 {{Start multicol (...) }}
 ......
 {{چندستون-پایان}}
 </div>

Parameters

This template has two optional parameters: the overall width of the set of columns and the width of the gutter. The overall width of the set of columns can be an absolute value (e.g., 40em) or a percentage of the available page width (e.g., 50%). This parameter defaults to 100%. The second parameter is the "gutter" for the whole column set, which defaults to 20px.

The {{چندستون-شکست}} also takes an optional parameter for the gutter to its right, also defaulting to 20px.

For example, to create a 3-column section that is only 50% the width of the page, with 2-pixel right margins:

{{چندستون|50%|2px}}
This text appears in the first column.
{{چندستون-شکست|2px}}
This text appears in the second column.
{{چندستون-شکست|2px}}
This text appears in the third column.
{{چندستون-پایان}}

Provides this format:

This text appears in the first column.

This text appears in the second column.

This text appears in the third column.

The multi-column region is always positioned on the left side of the containing block. To change this, place the above Wikitext in a DIV block that has the CSS attribute text-align set to either center or right, like this:

<div style="text-align:center;">{{center|
{{چندستون|50%|2px}}
...
{{چندستون-پایان}}
}}</div>

Related templates

The templates {{Col-begin}} and friends do something similar to this template and its friends, but this template may be easier to use. Each of the following examples produce the same result (a 3-column table in which all columns have equal width):

{{چندستون}}
Column 1
{{چندستون-شکست}}
Column 2
{{چندستون-شکست}}
Column 3
{{چندستون-پایان}}

{{Col-begin}}
{{Col-3}}
Column 1
{{Col-3}}
Column 2
{{Col-3}}
Column 3
{{Col-end}}

It's simpler to add more columns to the {{چندستون}} example than to the {{Col-begin}} example, because in the latter case, all occurrences of {{Col-3}} would need to be changed to {{Col-4}}.

These templates groups are not interchangeable. If you start with {{چندستون}}, but end with the plain {{col-end}} templates, then you'll have an unclosed <div> tag that can harm the formatting of the rest of the page. The problems created by mixing these templates is not easily visible for all users, so please don't assume that it's working properly just because it looks right for you. If you start with {{چندستون}}, then you must use (ترکمنی) and {{چندستون-پایان}}, not (ترکمنی) and {{col-end}} (and vice versa).

TemplateData

این توضیحاتِ داده‌های الگو این الگو است که توسط ویرایشگر دیداری و دیگر ابزارها استفاده می‌شود.

چندستون

Starts a multi-column section. Subsequent columns are started by {{چندستون-شکست}} and the section is ended with {{چندستون-پایان}}

پارامترهای الگو[ویرایش داده‌های الگو]
پارامتر		توضیحات	نوع	وضعیت
Table width	`1`	Width of table, a CSS width e.g. '50%'. پیش‌فرض 100%	رشته	اختیاری
Column width	`2`	Width of the first column. پیش‌فرض 20px	رشته	اختیاری

این توضیحاتِ داده‌های الگو این الگو است که توسط ویرایشگر دیداری و دیگر ابزارها استفاده می‌شود.

چندستون-شکست

Starts another column in a table started by {{چندستون}}.

پارامترهای الگو[ویرایش داده‌های الگو]
پارامتر		توضیحات	نوع	وضعیت
Column width	`1`	Width of the column. پیش‌فرض 20px	رشته	اختیاری

این توضیحاتِ داده‌های الگو این الگو است که توسط ویرایشگر دیداری و دیگر ابزارها استفاده می‌شود.

چندستون-پایان

Ends a multi-column list started by {{چندستون}}. The template takes no parameters.

پارامترهای الگو[ویرایش داده‌های الگو]
پارامتر		توضیحات	نوع	وضعیت
هیچ پارامتری مشخص نشده‌است

استفاده

نمونه‌ها

Parameters

Related templates

TemplateData

See also