Open main menu

Template:Nowrap/doc

< Template:Nowrap
Revision as of 01:02, 2 November 2018 by en>Zyxw (allow template to round and format usage count)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

{{Nowrap}} or {{nowrap}} stops wrapping of specific text. Use this template sparingly. It prevents word wraps (line breaks) within text or inside a link which contains spaces, hyphens ("-"), or, in some browsers, parentheses. The size of the nowrapped text becomes the minimum width of that paragraph and that can negatively influence the ability of the page to adapt to smaller screens, or alternate representations of the content.

To achieve the opposite effect of {{nowrap}}, you can use {{wbr}}. For more information about wrapping and breaking sentences, see Wikipedia:Line-break handling.

Usage

{{Nowrap|these words stay together}}
{{Nowrap|a, b, c, or d.}}
{{Nowrap| merry-go-round }}
{{Nowrap| [[4-part harmony]] }}
{{Nowrap| [[Cascading Style Sheets|CSS]] }}
{{Nowrap| [[#Examples|Examples section]] }}

The template names {{Nobr}} and {{Nobreak}} are redirects that may be used instead of "{{Nowrap|…}}".

Examples

"They held {{Nowrap|10 kg (22 lb)}} in total."


May render like this:

They held 10 kg (22 lb)
in total.


Or like this:

They held
10 kg (22 lb) in total.


But not render like this:

They held 10 kg (22
lb) in total.
"He encountered {{Nowrap|a tiger}} in the woods."


May render like this:

He encountered a tiger
in the woods.


Or like this:

He encountered
a tiger in the woods.


But not like this:

He encountered a
tiger in the woods.

Controlling line-breaking in infoboxes

This template may be used with {{Wbr}} and {{Spaces}} to control line-breaking in bulletless lists in infoboxes, to prevent wrapped long entries from being confused with multiple entries. See Template:Wbr/doc#Controlling line-breaking in infoboxes for details.

Handling equal-sign or bar

Templates have problems with parameter data that contains equal-signs "=" or vertical bars "|" (pipes). Note that this does not apply if the equal-sign "=" or vertical bar "|" is inside a wikilink or another template. In the case that there is a bare equal-sign "=" or vertical bar "|", consider using {{Nowrap begin}} + {{Nowrap end}} instead. However, there are also other workarounds:

For text that includes an equal-sign "=", precede the text with 1=, use a triple-brace unnamed parameter {{{|=}}}, or the {{=}} template. For example:

{{Nowrap|1=2 + 2 = 4}},
{{Nowrap|2 + 2 {{{|=}}} 4}}, or
{{Nowrap|2 + 2 {{=}} 4}}

which all render as this:

2 + 2 = 4.

For text that includes a vertical bar "|", escape the bar(s) with "&#124;" or "{{pipe}}" or "{{abs}}". For instance, put two bars "|6|" like this:

{{Nowrap|&#124;6&#124; < 7}}  or  {{Nowrap|{{pipe}}6{{pipe}} < 7}}  or  {{Nowrap|{{abs|6}} < 7}}

Which renders this:

|6| < 7

Technical details

The actual code that does the job is this HTML span tag that applies a class to the text inside the template:

<span class="nowrap">This text will not wrap</span>

The class nowrap receives the CSS property white-space: nowrap; in MediaWiki:Common.css.

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 {{nobr}} and {{nobreak}} redirect here.

TemplateData

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

TemplateData for Nowrap

Prevents word wraps (line breaks) within text or inside a link which contains spaces or hyphens (-).

Template parameters

ParameterDescriptionTypeStatus
Text1

Text or link to be protected.

Stringrequired

See also

  • {{nowrap}} prevents wrapping within a single template (i.e. not suitable for relatively complex or lengthy content).
  • {{Nowraplinks}}...{{Nowraplinks end}} prevents wraps inside links while allowing wraps between links and in normal text. Very useful for link lists and easy to use.
  • {{Nowrap begin}}...{{Nowrap end}} prevents wraps in both text and links. For the trickier wrapping cases when you need full control, for instance in very complex link lists.
  • {{Spaces}} to produce multiple non-breaking spaces (or a single one).
  • {{Inline block}} affects, but does not entirely prevent, line wrapping.
  • {{Allow wrap}} can be used to provide a (brief) exception within a no-wrapping area.
    • {{Normalwraplink}} allows links to wrap when they otherwise would not.
  • {{·}} and {{•}}, spaced and wrap-sensitive interpunct (dot) and bullet.
  • Wikipedia:Line-break handling, the how-to guide about word/line-wrapping/breaks at Wikipedia.
    • In particular, to avoid line wrapping when quoting a passage such as a poem or computer code, see {{Quote#Line breaks}} - e.g. Template:Blockquote with "poem" tag.