Difference between revisions of "Template:Float/doc"

From blackwiki
Jump to navigation Jump to search
imported>SD5bot
m (BOT: replacing template(s) per discussion about misleading template name)
imported>Frietjes
Line 1: Line 1:
 
{{documentation subpage}}
 
{{documentation subpage}}
 
<!---PLEASE ADD METADATA TO THE <includeonly> SECTION AT THE BOTTOM OF THIS PAGE--->
 
<!---PLEASE ADD METADATA TO THE <includeonly> SECTION AT THE BOTTOM OF THIS PAGE--->
 +
{{notice|The use of this template is deprecated in navbox templates, due to the fact that the image may float over text, making the text unreadable.  To align centered lists in a navbox with an image, see the [[#Alternatives for navigational boxes|alternatives for navigational boxes]] section below.  For aligning text in general, see {{tl|align}}.  For floating images, boxes, and other elements, see {{tl|stack}}.}}
  
 
Use <code><nowiki>{{float}}</nowiki></code> to position items such as images so they do not affect the alignment or formatting of other items (e.g. text) nearby.
 
Use <code><nowiki>{{float}}</nowiki></code> to position items such as images so they do not affect the alignment or formatting of other items (e.g. text) nearby.
Line 76: Line 77:
 
{{hidden end}}
 
{{hidden end}}
  
; Example 3
+
== Alternatives for navigational boxes ==
 
Same navbox using its image parameter and liststyle with padding-left set to the image width:
 
Same navbox using its image parameter and liststyle with padding-left set to the image width:
 
{{Navbox
 
{{Navbox
Line 92: Line 93:
 
* [[List of weapons of the Japanese Navy|Weapons]]
 
* [[List of weapons of the Japanese Navy|Weapons]]
 
}}
 
}}
{{hidden begin|title=Code for Example 3|toggle = left}}
+
{{hidden begin|title=Code for Example|toggle = left}}
 
<pre>
 
<pre>
 
{{Navbox
 
{{Navbox

Revision as of 17:17, 16 December 2012

Use {{float}} to position items such as images so they do not affect the alignment or formatting of other items (e.g. text) nearby.

{{float|top= |right= |bottom= |left= |item}}, where top and right default to zero.
{{float|item}} with default positioning top:0, right:0 (i.e. item floats on righthand side).

item is the only required parameter. The optional parameters top, right, bottom, left indicate how far from their respective positions the item is to be positioned. The width of the item may also be specified. Any units may be used so long as they are specifiedTemplate:Spaced ndashe.g. {{float|top=2em|left=2em|width=10em|"Blah"}}. Note that if any values other than zero for top and right are required, they need to be specified.

Examples

Note how the links in the second two examples are centered relative to the whole template, unlike in the first example.

Example 1

One-line navbox using its image parameter:

Code for Example 1
{{Navbox
| name  = Float/doc
| state = uncollapsed
| title = [[Imperial Japanese Navy]]
| listclass = hlist
| image = [[File:Naval Ensign of Japan.svg|24px|border|Naval Ensign of Japan]]
| list1 =
* [[Imperial Japanese Navy admirals|Admirals]]
* [[Battles of the Imperial Japanese Navy|Battles]]
* [[List of ships of the Japanese Navy|Ships]]
* [[List of aircraft of the Japanese Navy|Aircraft]]
* [[List of weapons of the Japanese Navy|Weapons]]
}}
Example 2

Same navbox using {{float}} instead of the image parameter:

Code for Example 2
{{Navbox
| name  = Float/doc
| state = uncollapsed
| title = [[Imperial Japanese Navy]]
| listclass = hlist
| list1 = {{float|top=-0.1em|[[File:Naval Ensign of Japan.svg|24px|border|Naval Ensign of Japan]]}}
* [[Imperial Japanese Navy admirals|Admirals]]
* [[Battles of the Imperial Japanese Navy|Battles]]
* [[List of ships of the Japanese Navy|Ships]]
* [[List of aircraft of the Japanese Navy|Aircraft]]
* [[List of weapons of the Japanese Navy|Weapons]]
}}

Alternatives for navigational boxes

Same navbox using its image parameter and liststyle with padding-left set to the image width:

Code for Example
{{Navbox
| name      = Float/doc
| state     = uncollapsed
| title     = [[Imperial Japanese Navy]]
| listclass = hlist
| image     = [[File:Naval Ensign of Japan.svg|24px|border|Naval Ensign of Japan]]
| liststyle = padding-left: 24px
| list1     =
* [[Imperial Japanese Navy admirals|Admirals]]
* [[Battles of the Imperial Japanese Navy|Battles]]
* [[List of ships of the Japanese Navy|Ships]]
* [[List of aircraft of the Japanese Navy|Aircraft]]
* [[List of weapons of the Japanese Navy|Weapons]]
}}