Difference between revisions of "Template:Columns/doc"

From blackwiki
Jump to navigation Jump to search
imported>Sardanaphalus
(→‎See also: template name update)
imported>Jdaloner
m ("{{bigger|" --> "{{larger|}}")
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
 
<!-- EDIT TEMPLATE DOCUMENTATION AFTER THIS LINE -->
 
<!-- EDIT TEMPLATE DOCUMENTATION AFTER THIS LINE -->
 +
 
{{tl|Columns}} may be used to create up to ten columns across a page.
 
{{tl|Columns}} may be used to create up to ten columns across a page.
  
 
== Syntax ==
 
== Syntax ==
 
 
Values for ''col1'' and ''col2'', i.e. the contents of the first and second columns, are expected.
 
Values for ''col1'' and ''col2'', i.e. the contents of the first and second columns, are expected.
  
Line 28: Line 28:
  
 
== Examples ==
 
== Examples ==
 
+
; {{larger|Code}}
; {{bigger|Code}}
 
 
<pre>
 
<pre>
 
{{Columns
 
{{Columns
Line 37: Line 36:
 
</pre>
 
</pre>
  
; {{bigger|Result}}
+
; {{larger|Result}}
 
{{Columns{{#ifeq:{{SUBPAGENAME}}|sandbox |/sandbox}}
 
{{Columns{{#ifeq:{{SUBPAGENAME}}|sandbox |/sandbox}}
 
| col1 = This is a simple application of the columns template, demonstrating the default column widths
 
| col1 = This is a simple application of the columns template, demonstrating the default column widths
Line 43: Line 42:
 
}}
 
}}
  
<br/>
+
<br />
 
<hr/>
 
<hr/>
  
; {{bigger|Code}}
+
; {{larger|Code}}
 
<pre>
 
<pre>
 
{{Columns |background=beige |colwidth=8.5em |gap<!--between-->=3.25em
 
{{Columns |background=beige |colwidth=8.5em |gap<!--between-->=3.25em
Line 58: Line 57:
  
 
| col2 =
 
| col2 =
The<br/>background<br/>is<br/>beige
+
The<br />background<br />is<br />beige
  
 
| col3 =
 
| col3 =
Line 80: Line 79:
 
</pre>
 
</pre>
  
; {{bigger|Result}}
+
; {{larger|Result}}
 
{{Columns{{#ifeq:{{SUBPAGENAME}}|sandbox |/sandbox}}
 
{{Columns{{#ifeq:{{SUBPAGENAME}}|sandbox |/sandbox}}
 
|background=beige |colwidth=8.5em |gap<!--between-->=3.25em
 
|background=beige |colwidth=8.5em |gap<!--between-->=3.25em
Line 92: Line 91:
  
 
| col2 =
 
| col2 =
The<br/>background<br/>is<br/>beige
+
The<br />background<br />is<br />beige
  
 
| col3 =
 
| col3 =
Line 115: Line 114:
 
== See also ==
 
== See also ==
 
{{Column-generating template families}}
 
{{Column-generating template families}}
 +
  
 
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox |
 
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox |

Revision as of 03:15, 17 December 2014

{{Columns}} may be used to create up to ten columns across a page.

Syntax

Values for col1 and col2, i.e. the contents of the first and second columns, are expected.

{{Columns
| background =   <!-- Background (default is none) -->
| style =        <!-- Use to add extra overall CSS styling -->
| colwidth =     <!-- Width of each column (default 15.0em) -->
| gapbetween =   <!-- Gap (gutter) between each column (default 1.25em) -->
| col1width =    <!-- Use to set a custom width for col1 -->
| col1 =         <!-- (REQUIRED) First column's contents -->
| col2width =    <!-- Use to set a custom width for col2 (and so on) -->
| col2 =         <!-- (REQUIRED) Second column's contents -->
| col3width = 
| col3 = 
...
| col10width = 
| col10 = 
}}

The parameters  colstyle  and  col1style  to  col10style  may also be used to tailor all and/or individual columns' CSS styling.

Examples

Code
{{Columns
| col1 = This is a simple application of the columns template, demonstrating the default column widths
| col2 = and gaps between columns. See the next example for a more customized use of the template.
}}
Result



Code
{{Columns |background=beige |colwidth=8.5em |gap<!--between-->=3.25em

| col1 =
* These
* columns
* are
* more
* complex

| col2 =
The<br />background<br />is<br />beige

| col3 =
; Each : column
; is   : 8.5 [[Em (typography)|''em'']]
; wide

| col4 =
{{{!}}
!colspan="2"{{!}} and
{{!-}}
{{!}} the {{!!}} gap
{{!-}}
{{!}}colspan="2"{{!}} between
{{!-}}
{{!}} each {{!!}} is
{{!-}}
!colspan="2" align="center"{{!}} 3.25 ''em''
{{!}}}
}}
Result

See also

Column-generating template families

<section begin="table" />

Family Type
Handles wiki
 table code?Script error: No such module "If empty".
Responsive/
Mobile suited
Start template Column divider End template
"Col" Table Yes Yes {{Col-begin}},
{{Col-begin-fixed}} or
{{Col-begin-small}}
{{Col-break}} or
{{Col-2}} .. {{Col-5}}
{{Col-end}}
"Col-float" CSS float Yes Yes {{Col-float}} {{Col-float-break}} {{Col-float-end}}
"Columns" Table No Yes {{Columns}}
"Columns-list" CSS columns Yes Yes {{Columns-list}} (wrapper)
"Columns-start" CSS float Yes Yes {{Columns-start}} {{Column}} {{Columns-end}}
"Flex columns" CSS flexbox Yes Yes {{Flex columns}}
"Div col" CSS columns Yes Yes {{Div col}} {{Div col end}}

Script error: No such module "If empty". I.e., can the columns handle the wiki markup {| | || |- |} used to create tables? If not, templates that produce these elements (such as {{(!}}, {{!}}, {{!!}}, {{!-}}, {{!)}}) or HTML tags (<table>...</table>, <tr>...</tr>, etc.) will need to be used instead.<section end="table" />