Predefinição:Stack documentation
This template serves as the shared documentation for {{Stack}}, {{Stack begin}}, {{Stack mid}}, and {{Stack end}}. |
This template can be used to stack images and other floating content such as infobox templates without causing problems with spacing and floating. Enter a string of images/templates as the first parameter to have them stack without generating floating errors or spacing errors. You can stack many objects from the top of a section and not force further subsections to space out.
Basic usage
[editar código-fonte]Using {{stack}}
,
{{stack|<objects>}}
or, alternatively, using {{stack begin}}
/{{stack end}}
{{stack begin}} <object> {{stack mid}} <object> ... {{stack end}}
Previous usage suggests {{stack mid}} is not always needed. Thus, <object>
may simply be a string of wiki code for many images / templates.
Optional parameters
[editar código-fonte]{{stack| <objects> | float=left/right | clear=true/false}}
or
{{stack begin | float=left/right | clear=true/false}}
where
float=
left or right (default is right)- This option can be used to float the stack to the left or right of the page
clear=
true or false (default is false)- This option can be used to force the stack to the far left or right (e.g., near an infobox).
You can also explicily list multiple arguments, which is then identical to the {{stack begin}}, {{stack mid}} and {{stack end}} version.
{{stack| float=left/right | clear=true/false
- |1=<object(s)>
- |2=<object(s)>
- |3=<object(s)>, etc. up to 9 parameters in the current version
}}
- NB This multiple argument version does include extra vertical whitespace between each (set of) <object(s)>.
Basic examples
[editar código-fonte]To illustrate the utility of the stack templates, consider the following situation. We would like to have two right floating images at the top of the first section of our article (here, the "Lipsum" section), and one left floating image at the top of the second section (here, the Lorem section). To achieve this layout, without using a stack template, we could try the following code
=====Lipsum===== [[File:Example.png|thumb|right|Example 1a]] [[File:Example.png|thumb|right|Example 1b]] ... text ... =====Lorem===== [[File:Example.png|thumb|left |Example 1c]] ... text ... =====Ipsum===== ... text ...
The result of this is shown in the without stack section below. Notice how the left floating image (Example 1c) is prevented from floating above the last right floating image (Example 1b). You may need to resize the width of your browser to fully appreciate the issue. To fix this problem, we can stack the two right floating images together, using the following code
=====Lipsum===== {{stack| [[File:Example.png|thumb|right|Example 2a]] [[File:Example.png|thumb|right|Example 2b]] }} ... text ... =====Lorem===== [[File:Example.png|thumb|left |Example 2c]] ... text ... =====Ipsum===== ... text ...
The result of this is show in the with stack section below. Notice how by adding this stack template, the left floating image (Example 2c) can now float higher and is not blocked from floating higher than the top of the last right floating image (Example 2b).
Without stack
[editar código-fonte]Lipsum
[editar código-fonte]Lorem
[editar código-fonte]Ipsum
[editar código-fonte]With stack
[editar código-fonte]Lipsum
[editar código-fonte]Lorem
[editar código-fonte]Ipsum
[editar código-fonte]With stack begin
[editar código-fonte]Lipsum with second table wider
[editar código-fonte]
|
Lorem
[editar código-fonte]Sample table 3 |
---|
Example 3a |
Ipsum
[editar código-fonte]Lipsum with first table wider
[editar código-fonte]
|
Lorem
[editar código-fonte]Sample table 3 |
---|
Example 3a |
Ipsum
[editar código-fonte]With stack begin and mid
[editar código-fonte]Lipsum with second table wider
[editar código-fonte]
|
Lorem
[editar código-fonte]Sample table 3 |
---|
Example 3a |
Ipsum
[editar código-fonte]Lipsum with first table wider
[editar código-fonte]
|
Lorem
[editar código-fonte]Sample table 3 |
---|
Example 3a |
Ipsum
[editar código-fonte]Obviously these current examples don't show any difference between with and without mid except for probably unwanted vertical space.
In fact, the reason for creating {{stack mid}}, at least in one example, was resolved by removing table style align=right
from tables between {{stack begin}} and {{stack end}}.
However {{stack mid}} may still be useful for tables that would otherwise prefer to use the multiple argument Predefinição:Tl3 option, which should be identical to using {{stack begin}}, {{stack mid}} and {{stack end}} where the latter easily allows the {| ... |} table syntax (which must begin on the start of the line).
More examples
[editar código-fonte]Stack can also be used to float 1 or more images across a page.
{{stack|[[File:Example.png|50px]]}} {{stack|[[File:Example.png|50px]]}}
It might take some experience to learn how the box area floats, in combination with various images or WP:Wikitables on a page. The operation of Template:stack is very quick, using the <table> feature of the HTML markup language.
Float portal boxes
[editar código-fonte]Because auto-floating of portal boxes could cause a loss of margin control, the Template:stack can be used, as needed in some articles, when floating a portal box would look better alongside an infobox (or right-side image).
Infobox
|
A wikitable here, as a typical left-side table. The overlap on left-side tables had been a frequent problem with allowing other boxes to "float:right" on a page. So this is a test of how well a floating portal-box would avoid overlapping onto a left-side table. |
The example here uses {{stack}}
to float 2 portal boxes (for Animals & Cats), as follows:
- {{stack |{{portal|Animals}}{{portal|Cats}} }}
The 2 portal-boxes are stacked together, and floated together as a stack, by both being listed in parameter 1 to {{stack}}
. Although the 2 portal-boxes were specified below the Mona Lisa image, because the infobox+image were also stacked together, then the {{stack}}
moved the 2 portal-boxes, even higher, alongside the infobox.
Normally, a portal-box would be stuck below the Mona Lisa image, causing this entire text section to format further below, and causing a large text-gap of empty whitespace to appear near the infobox. There is no limit to the number of portalboxes (or Commonscat boxes) which can be listed within a {{stack}}
call, such as in a stub or an article with many stacked images near the bottom. Using {{stack}}
is extremely efficient, due to being a short template which uses builtin tag <table> to float the boxes.
Stack templates
[editar código-fonte]- {{Stack}}
- {{Stack begin}}
- {{Stack mid}}
- {{Stack end}}
See also
[editar código-fonte]- {{Double image}} places images side by side horizontally
- {{Multiple image}} allows both vertical and horizontal layouts
- {{Superimpose}}—places one image over another
- {{Superimpose2}}—places up to 50 image layers over one another