Template:Nowrap/doc: Difference between revisions
(clarified, noting hyphens, plus "inside a link" to avoid confusion with verb "links"; noted redirects named "j" (join) & "nobr" & "nobreak"; new section "Examples" showing 3 cases in a table, etc.) |
(noted triple-brace unnamed parameter {{{|=}}} to get "=" and changed two-bars example to use |6| & 7, to avoid so many examples with numeral "2") |
||
Line 42: | Line 42: | ||
[[Help:Template|Templates]] have problems to handle parameter data that contains [[equal-sign]]s "<code>=</code>" or vertical bars "<code>|</code>" (pipes). In such cases, consider using {{tl|nowrap begin}} + {{tl|nowrap end}} instead. But there are also workarounds: | [[Help:Template|Templates]] have problems to handle parameter data that contains [[equal-sign]]s "<code>=</code>" or vertical bars "<code>|</code>" (pipes). In such cases, consider using {{tl|nowrap begin}} + {{tl|nowrap end}} instead. But there are also workarounds: | ||
For text that includes an equal-sign "=", precede the text with <code>1=</code>. For example: | For text that includes an equal-sign "=", precede the text with <code>1=</code> or use a triple-brace unnamed parameter: <nowiki>{{{|=}}}</nowiki>. For example: | ||
:<code><nowiki>{{nowrap|</nowiki>1=2 + 2 = 4}}</code> | :<code><nowiki>{{nowrap|</nowiki>1=2 + 2 = 4}}</code>, or <br /><code><nowiki>{{nowrap|2 + 2 {{{|=}}} 4}}</nowiki></code> | ||
which both render as this: | |||
:{{nowrap|1=2 + 2 = 4}} | :{{nowrap|1=2 + 2 = 4}}. | ||
For text that includes a vertical bar "|", escape the bar(s) with "<code><nowiki>&#124;</nowiki></code>" or "<code><nowiki>{{!}}</nowiki></code>". For instance put two bars "| | For text that includes a vertical bar "|", escape the bar(s) with "<code><nowiki>&#124;</nowiki></code>" or "<code><nowiki>{{!}}</nowiki></code>". For instance, put two bars "|6|" like this: | ||
:<code><nowiki>{{nowrap|</nowiki>&#124; | :<code><nowiki>{{nowrap|</nowiki>&#124;6&#124; < 7}}</code> or <code><nowiki>{{nowrap|{{!}}6{{!}} < 7}}</nowiki></code> | ||
Which renders this: | Which renders this: | ||
:{{nowrap|| | :{{nowrap||6| < 7}} | ||
=== Technical details === | === Technical details === |
Revision as of 05:03, 24 February 2011
The Template:nowrap stops wrapping of specific text. It prevents word wraps (line breaks) within text or inside a link which contains spaces or hyphens ("-"). The size of the nowrapped text becomes the minimum width of that paragraph.
Before you use this template you might want to read up on Wikipedia:Line break handling.
- Usage: {{nowrap|these words stay together}}
- {{nowrap|a, b, c, or d.}}
- {{nowrap| merry-go-round }}
- {{nowrap| [[4-part harmony]]}}
- Usage: {{nowrap|these words stay together}}
For simplicity, the template names {{j}} (join) or {{nobr}} or {{nobreak}} can be used, instead of "nowrap", as quick redirects to {{nowrap}}.
Examples
"They held {{nowrap|10 kg (22 lb)}} in total."
|
"He encountered {{nowrap|a tiger}} in the woods."
|
We saw {{j |1 [[black rhino]]}} but {{j|800 [[zebra]]s}}.
|
Handling equal-sign or bar
Templates have problems to handle parameter data that contains equal-signs "=
" or vertical bars "|
" (pipes). In such cases, consider using {{nowrap begin}} + {{nowrap end}} instead. But there are also workarounds:
For text that includes an equal-sign "=", precede the text with 1=
or use a triple-brace unnamed parameter: {{{|=}}}. For example:
{{nowrap|1=2 + 2 = 4}}
, or{{nowrap|2 + 2 {{{|=}}} 4}}
which both render as this:
- 2 + 2 = 4.
For text that includes a vertical bar "|", escape the bar(s) with "|
" or "{{!}}
". For instance, put two bars "|6|" like this:
{{nowrap||6| < 7}}
or{{nowrap|{{!}}6{{!}} < 7}}
Which renders this:
- |6| < 7
Technical details
The actual code that does the job is this HTML+CSS code:
<span style="white-space:nowrap">This text will not wrap</span>
Spaces at the beginning or end of the text will fall outside the no-wrap tag in the rendered text due to Wikimedia rendering mechanisms.
The templates {{j}}, {{nobr}} and {{nobreak}} redirect here.
See also
- {{nowraplinks}} – Prevents wraps inside links and only allows wraps between the links and in normal text. Very useful for link lists and easy to use.
- {{nowrap begin}} – Prevents wraps in both text and links. For the trickier wrapping cases when you need full control, for instance in very complex link lists.
- Wikipedia:Line break handling – The how-to guide detailing how to handle word wraps (line breaks) on Wikipedia.