copy from template/template talk
 
Xeverything11 (talk | contribs)
m 203 revisions imported from mhdev:Template:Clear/doc
 
(202 intermediate revisions by more than 100 users not shown)
Line 1: Line 1:
<includeonly>:''This template documentation is [[Wikipedia:Template doc page pattern|transcluded]] from [[{{FULLPAGENAME}}/doc]]'' [<span class="plainlinks">[{{fullurl:{{FULLPAGENAMEE}}/doc|action=edit}} edit]</span>]</includeonly>
{{Documentation subpage}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
This template adds <tt>&lt;div style="clear: both"&gt;&lt;/div&gt;</tt>;
for technical XHTML details see [[Template talk:{{PAGENAME}}]].


== Documentation ==
== Description ==
This template makes content wait until existing content is completed in all columns. It is often used to prevent text from flowing next to unrelated images.


{{tl|clear}}: Makes content wait until existing content is completed in all columns.  Often used to stop text from flowing next to unrelated images.
== Usage ==
* {{tlx|clear}} — adds <code>&lt;div style="clear:both;"&gt;&lt;/div&gt;</code>
* {{tlx|clear|left}} — adds <code>&lt;div style="clear:left;"&gt;&lt;/div&gt;</code>
* {{tlx|clear|right}} — adds <code>&lt;div style="clear:right;"&gt;&lt;/div&gt;</code>


=== Usage ===
== Examples ==


<nowiki>{{subst:Clear}}</nowiki>
<div style="border: 1px solid black; background: #fde; padding: 1em; margin: 2em;">
=== Example without {{tl|clear}} ===
[[File:HeidelbergTun.jpg|200px|left]]
Lorem ipsum dolor sit amet


The template may also be transcluded, but as the  
==== New section without template ====
markup provided is unlikely to change or improve,
Without {{tl|clear}}, this section starts at the right of the image.
there is little justification for transclusion
{{clear}}
overhead.
</div>
<div style="border: 1px solid black; background: #fde; padding: 1em; margin: 2em;">


== Example without the {clear} template==
=== Example that uses {{tl|clear}} ===
[[File:HeidelbergTun.jpg|200px|left]]
Lorem ipsum dolor sit amet<br/>
'''{{tl|clear}}'''
{{clear}}


[[Image:HeidelbergTun.jpg|200px|left]]
==== New section with template ====
{{lorem}}
{{tl|clear}} placed before this section, so it appears below the image.
==New section==
</div>
See how this section starts at the right of the image, with the line actually overlapping the image


<div style="clear: both"></div> <!-- a genuine use of the template! -->
== TemplateData ==
== Example with the {clear} template==
<templatedata>{
 
"description": "Makes content wait until existing content is completed in all columns. Often used to stop text from flowing next to unrelated images, so text will appear on a full width line under the image.",
[[Image:HeidelbergTun.jpg|200px|left]]
"params": {
{{lorem}}
"1": {
'''<nowiki>{{clear}}</nowiki>'''
"label": "Side",
<div style="clear: both"></div>
"description": "Can be 'right' or 'left' so content is delayed until just the right or left column is complete. The default clears both columns.",
==New section==
"type": "line",
See how this looks much better?
"required": false,
 
"suggestedvalues": [
==How it works==
"right",
This is what {{Tl|clear}} actually does, ignore the <tt>&lt;noinclude&gt;</tt> stuff shown by <nowiki>{{msgnw:clear}}</nowiki>:
"left",
 
"both"
<tt>{{msgnw:clear}}</tt>
]
 
}
=== See also ===
},
* {{Lts|clear}}
"format": "inline"
* {{Lts|clearleft}}: Delays content until left column is complete.
}</templatedata>
* {{Lts|clearright}}: Delays content until right column is complete.
<includeonly>[[Category:Templates]]</includeonly>
* {{Lts|-}} is similar but technically different
 
== Discussion ==
 
''The fine points of {{Tl|clear}} vs. {{Tl|-}} are discussed in [[Template talk:-#-_versus_clear|Template talk:-]].''
 
<includeonly>
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Category:Wikipedia special effects templates|{{PAGENAME}}]]
 
<!-- ADD INTERWIKIS BELOW THIS LINE -->
[[vi:Tiêu bản:Clear]]
</includeonly>

Latest revision as of 07:34, 8 April 2025

Template:Documentation subpage

Description

This template makes content wait until existing content is completed in all columns. It is often used to prevent text from flowing next to unrelated images.

Usage

  • {{clear}} — adds <div style="clear:both;"></div>
  • {{clear|left}} — adds <div style="clear:left;"></div>
  • {{clear|right}} — adds <div style="clear:right;"></div>

Examples

Example without {{clear}}

Lorem ipsum dolor sit amet

New section without template

Without {{clear}}, this section starts at the right of the image.

Example that uses {{clear}}

Lorem ipsum dolor sit amet
{{clear}}

New section with template

{{clear}} placed before this section, so it appears below the image.

TemplateData

Makes content wait until existing content is completed in all columns. Often used to stop text from flowing next to unrelated images, so text will appear on a full width line under the image.

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Side1

Can be 'right' or 'left' so content is delayed until just the right or left column is complete. The default clears both columns.

Suggested values
right left both
Lineoptional