Difference between revisions of "Template:-/doc"

From blackwiki
Jump to navigation Jump to search
(Blanked the page)
blackwiki>Tegel
m (Reverted edits by 24.9.54.183 (talk) to last version by Gadget850)
Line 1: Line 1:
 +
{{Documentation subpage}}
  
 +
Use {{tl|{{BASEPAGENAME}}}} after any [[float (CSS attribute)|floating element]]s and before elements you do not wish to float together with the first set. This uses a line break, which may introduce an ugly extra blank line. If you want to avoid that, use {{tl|Clear}} instead. Do not use this template to deliberately add whitespace and blank lines between non-floating elements.
 +
 +
== Details ==
 +
{{tl|-}} contains the markup:
 +
<pre>
 +
<br style="clear:both;" />
 +
</pre>
 +
(the correct syntax for the old HTML markup <code><nowiki><br clear=both></nowiki></code>). This causes any previously established float to clear.
 +
 +
Optionally, you can clear only left- or right floating elements by using <code><nowiki>{{-|left}}</nowiki></code> or <code><nowiki>{{-|right}}</nowiki></code>.
 +
 +
The unusual name of this template is a [[mnemonic]] for an imaginary horizontal line, which separates floating elements above from those below. Some editors prefer the mnemonic {{tl|Clr}} ("clear"), which simply redirects here. However, do not confuse {{tl|Clr}} with {{tl|Clear}}, which is a different template that uses <code><nowiki><div></div></nowiki></code> instead of <code><nowiki><br /></nowiki></code> and so does not introduce an extra line break.
 +
 +
== Examples ==
 +
{{sidebar|navbar=off
 +
| title = Example sidebar
 +
| content1 = In these examples, the {{tl|sidebar}} template is used to create a simple right floating table. For better examples check out the links. Please add missing <code><nowiki>{{-}}</nowiki></code> where necessary. This sidebar is only a quick example.
 +
| content2 = {{lorem}}
 +
}}
 +
=== First ===
 +
In the first example <code><nowiki>{{-}}</nowiki></code> on a new line after the word ''browser'' guarantees that the table does not float into the second example. (Placing it directly after the word ''browser'' doesn't work in Google Chrome.)
 +
* Cute, but less funny if it ''overlaps'' the next table or section, causing horizontal scrolling or worse depending on the browser.
 +
{{-}}
 +
{{sidebar|navbar=off
 +
| title = Example sidebar
 +
| content1 = In these examples, the {{tl|sidebar}} template is used to create a simple right floating table. For better examples check out the links. Please add missing <code><nowiki>{{-}}</nowiki></code> where necessary. This sidebar is only a quick example.
 +
| content2 = {{lorem}}
 +
}}
 +
----
 +
=== Second ===
 +
In the second example the position of <code><nowiki>{{-}}</nowiki></code> is after the word ''but''. Note that it does not affect the
 +
left margin of the bullet '''*''' list, because it is used inside of it.
 +
* Cute, but{{-}}less funny if it ''overlaps'' the next table or section, causing horizontal scrolling or worse depending on the browser.
 +
{{sidebar|navbar=off
 +
| title = Example sidebar
 +
| content1 = In these examples, the {{tl|sidebar}} template is used to create a simple right floating table. For better examples check out the links. Please add missing <code><nowiki>{{-}}</nowiki></code> where necessary. This sidebar is only a quick example.
 +
| content2 = {{lorem}}
 +
}}
 +
----
 +
=== Third ===
 +
The third example has a new line after the word ''but'' and <code><nowiki>{{-}}</nowiki></code> after the word ''browser''.
 +
* Cute, but
 +
less funny if it ''overlaps'' the next table or section, causing horizontal scrolling or worse depending on the browser.{{-}}
 +
{{sidebar|navbar=off
 +
| title = Example sidebar
 +
| content1 = In these examples, the {{tl|sidebar}} template is used to create a simple right floating table. For better examples check out the links. Please add missing <code><nowiki>{{-}}</nowiki></code> where necessary. This sidebar is only a quick example.
 +
| content2 = {{lorem}}
 +
}}
 +
----
 +
=== Fourth ===
 +
The fourth example has <code><nowiki>{{-}}</nowiki></code> and a new line after the word ''but''.
 +
* Cute, but{{-}}
 +
less funny if it ''overlaps'' the next table or section, causing horizontal scrolling or worse depending on the browser.
 +
 +
== TemplateData ==
 +
{{TemplateDataHeader}}
 +
<TemplateData>
 +
{
 +
        "description": "This template adds the HTML tag 'clear:both' to the page, which clear any previously defined floats. This template has no parameters",
 +
        "params": {}
 +
}
 +
</TemplateData>
 +
 +
== See also ==
 +
* {{tl|Clear left}}: Delays content until left column is complete.
 +
* {{tl|Clear right}}: Delays content until right column is complete.
 +
* {{tl|Clear}}: Delays content until both columns are complete.
 +
* [[Wikipedia:Line-break handling]]
 +
 +
<includeonly>
 +
<!-- ADD CATEGORIES BELOW THIS LINE -->
 +
[[Category:Line-handling templates]]
 +
</includeonly>

Revision as of 18:39, 15 March 2015

Use {{-}} after any floating elements and before elements you do not wish to float together with the first set. This uses a line break, which may introduce an ugly extra blank line. If you want to avoid that, use {{Clear}} instead. Do not use this template to deliberately add whitespace and blank lines between non-floating elements.

Details

{{-}} contains the markup:

<br style="clear:both;" />

(the correct syntax for the old HTML markup <br clear=both>). This causes any previously established float to clear.

Optionally, you can clear only left- or right floating elements by using {{-|left}} or {{-|right}}.

The unusual name of this template is a mnemonic for an imaginary horizontal line, which separates floating elements above from those below. Some editors prefer the mnemonic {{Clr}} ("clear"), which simply redirects here. However, do not confuse {{Clr}} with {{Clear}}, which is a different template that uses <div></div> instead of <br /> and so does not introduce an extra line break.

Examples

First

In the first example {{-}} on a new line after the word browser guarantees that the table does not float into the second example. (Placing it directly after the word browser doesn't work in Google Chrome.)

  • Cute, but less funny if it overlaps the next table or section, causing horizontal scrolling or worse depending on the browser.

Second

In the second example the position of {{-}} is after the word but. Note that it does not affect the left margin of the bullet * list, because it is used inside of it.

  • Cute, but
    less funny if it overlaps the next table or section, causing horizontal scrolling or worse depending on the browser.

Third

The third example has a new line after the word but and {{-}} after the word browser.

  • Cute, but

less funny if it overlaps the next table or section, causing horizontal scrolling or worse depending on the browser.


Fourth

The fourth example has {{-}} and a new line after the word but.

  • Cute, but

less funny if it overlaps the next table or section, causing horizontal scrolling or worse depending on the browser.

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for -

This template adds the HTML tag 'clear:both' to the page, which clear any previously defined floats. This template has no parameters

Template parameters

ParameterDescriptionTypeStatus
No parameters specified

See also