Template:Nowrap/doc
{{#invoke:Message box|mbox}} {{#invoke:High-use|main|1=|2=|system=in MediaWiki:Histlegend}} {{#invoke:Message box|mbox}} {{#invoke:Message box|ombox}} {{#invoke:Shortcut|main|template=yes}}
{{#Invoke:Template link general|main|code=on}} or {{#Invoke:Template link general|main|code=on}} stops wrapping of specific text (which can be inside of a link). Use this template sparingly. It prevents word wraps (line breaks) that might otherwise happen at 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 {{#Invoke:Template link general|main|code=on}}. For more information about wrapping and breaking sentences, see Wikipedia:Line-break handling.
Usage
- <syntaxhighlight lang="wikitext" inline>these words stay together</syntaxhighlight>
- <syntaxhighlight lang="wikitext" inline>a, b, c, or d.</syntaxhighlight>
- <syntaxhighlight lang="wikitext" inline> merry-go-round </syntaxhighlight>
- <syntaxhighlight lang="wikitext" inline> 4-part harmony </syntaxhighlight>
- <syntaxhighlight lang="wikitext" inline> CSS </syntaxhighlight>
- <syntaxhighlight lang="wikitext" inline> Examples section </syntaxhighlight>
Examples
| main|nolink=yes|code=yes|nowrap=yes}} in total."
|
main|nolink=yes|code=yes|nowrap=yes}} in the woods."
|
Controlling line-breaking in infoboxes
This template may be used with {{#Invoke:Template link general|main|code=on}} and {{#Invoke:Template link general|main|code=on}} 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 <syntaxhighlight lang="wikitext" inline>=</syntaxhighlight>, or the <syntaxhighlight lang="wikitext" inline>=</syntaxhighlight> magic word. For example:
- <syntaxhighlight lang="wikitext" inline>2 + 2 = 4</syntaxhighlight>,
<syntaxhighlight lang="wikitext" inline>2 + 2 = 4</syntaxhighlight>, or
<syntaxhighlight lang="wikitext" inline>2 + 2 = 4</syntaxhighlight>
which all render as this:
- 2 + 2 = 4.
For text that includes a vertical bar "|", escape the bar(s) with "<syntaxhighlight lang="wikitext" inline>|</syntaxhighlight>" or "<syntaxhighlight lang="wikitext" inline>|</syntaxhighlight>" or "<syntaxhighlight lang="wikitext" inline>Template:Abs</syntaxhighlight>". For instance, put two bars "|6|" like this:
- <syntaxhighlight lang="wikitext" inline>|6| < 7</syntaxhighlight> or <syntaxhighlight lang="wikitext" inline>|6| < 7</syntaxhighlight> or <syntaxhighlight lang="wikitext" inline>Template:Abs < 7</syntaxhighlight>
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:
- <syntaxhighlight lang="html" class="" style="" inline="1">This text will not wrap</syntaxhighlight>
The class nowrap receives the CSS property <syntaxhighlight lang="css" class="" style="" inline="1">white-space: nowrap;</syntaxhighlight> in MediaWiki:Common.css.
TemplateData
TemplateData for Nowrap
{{#invoke:Check for unknown parameters|check
|unknown= |template=Template:TemplateData header |1 |nolink |noheader
|preview=
}} <templatedata>{
"description": "Prevents word wraps (line breaks) within text or inside a link which contains spaces or hyphens (-).",
"params": {
"1": {
"label": "Text",
"description": "Text or link to be protected.",
"type": "string",
"required": true
}
}
}</templatedata>
See also
{{#invoke:Navbar|navbar}}
- {{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.
- {{word joiner}} prevents wraps for both two adjacent characters.
- {{avoid wrap}} prevents wraps unless the space is too narrow to display the text on one line.
- {{inline block}} does the same and allows further style customization, but does not automatically add the "avoidwrap" CSS class.
- {{spaces}} produces multiple non-breaking spaces (or a single one).
- {{wrap}} can be used to provide a (brief) exception within a no-wrapping area.
- {{normalwraplink}} allows links to wrap when they otherwise would not.
- {{#Invoke:Template link general|main|brace=yes}} and {{#Invoke:Template link general|main|brace=yes}}, spaced and wrap-sensitive interpunct (dot) and bullet.
- Help:Line-break handling, Wikipedia's how-to guide about word wrapping and line breaks.
- In particular, to avoid line wrapping when quoting a passage such as a poem or computer code, see {{SAFESUBST:#invoke:Section link|main}} – e.g. Template:Blockquote with "poem" tag.