Template:Nowrap/doc

This is a documentation subpage for Template:Nowrap (see that page for the template itself).
It contains usage information, categories and other content that is not part of the original template page.

{{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.

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]] }}

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.

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. There are 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 "|" or "{{pipe}}" or "{{abs}}". For instance, put two bars "|6|" like this:

{{nowrap||6| < 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+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.

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools.

Nowrap

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

Template parameters
Parameter		Description	Type	Status
Text	`1`	Text or link to be protected.	String	required