Ciara le codesc dla funtana por Template:Avoid wrap/doc

{{Documentation subpage}}
<!-- Categories go where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[Wikipedia:Wikidata]]) -->
{{COinS safe|n}}

<code><nowiki>{{Avoid wrap}}</nowiki></code>, <code><nowiki>{{avoidwrap}}</nowiki></code> or <code><nowiki>{{awrap}}</nowiki></code> avoids wrapping of specific text.

To achieve the opposite effect of <code>&#123;&#123;Avoid wrap&#125;&#125;</code>, you can use {{tlx|wbr}}. For more information about wrapping and breaking sentences, see [[Wikipedia:Line-break handling]].

== Usage ==
:: <code><nowiki>{{Avoid wrap|these words stay together}}</nowiki></code>
:: <code><nowiki>{{Avoid wrap|a, b, c, or d.}}</nowiki></code>
:: <code><nowiki>{{Avoid wrap| merry-go-round }}</nowiki></code>
:: <code><nowiki>{{Avoid wrap| [[4-part harmony]] }}</nowiki></code>
:: <code><nowiki>{{Avoid wrap| [[Cascading Style Sheets|CSS]] }}</nowiki></code>
:: <code><nowiki>{{Avoid wrap| [[#Examples|Examples section]] }}</nowiki></code>

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

=== Examples ===
{| class=wikitable
|"<code>They held <nowiki>{{Avoid wrap|10 kg (22 lb)}}</nowiki> in total.</code>"
<br/> May render like this:
:They held {{Avoid wrap|10 kg (22 lb)}} <br/>in total.
<br/> Or like this:
:They held <br/>10 kg (22 lb) in total.
<br/> But ''not'' render like this:
:They held 10 kg (22 <br/>lb) in total.

| "<code>He encountered <nowiki>{{Avoid wrap|a tiger}}</nowiki> in the woods.</code>"
<br/> May render like this:
:He encountered a tiger <br/>in the woods.
<br/> Or like this:
:He encountered <br/>a tiger in the woods.
<br/> But ''not'' like this:
:He encountered a <br/>tiger in the woods.
|}

=== Controlling line-breaking in infoboxes ===
This template may be used with {{tlx|Wbr}} and {{tlx|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 ===
[[Help:Template|Templates]] have problems with parameter data that contains [[equal-sign]]s "<code>=</code>" or vertical bars "<code>|</code>" (pipes). Note that this does not apply if the equal-sign "<code>=</code>" or vertical bar "<code>|</code>" is inside a wikilink or another template.  In the case that there is a bare equal-sign "<code>=</code>" or vertical bar "<code>|</code>", consider using {{tl|Avoid wrap begin}} + {{tl|Avoid wrap end}} instead. However, there are also other workarounds:

For text that includes an equal-sign "=", precede the text with <code>1=</code>, use a triple-brace unnamed parameter <code><nowiki>{{{|=}}}</nowiki></code>, or the <code><nowiki>{{=}}</nowiki></code> template. For example:
:<code><nowiki>{{Avoid wrap|</nowiki>1=2 + 2 = 4}}</code>, <br /><code><nowiki>{{Avoid wrap|2 + 2 {{{|=}}} 4}}</nowiki></code>, or <br /><code><nowiki>{{Avoid wrap|2 + 2 {{=}} 4}}</nowiki></code>

which all render as this:
:{{Avoid wrap|1=2 + 2 = 4}}.

For text that includes a vertical bar "|", escape the bar(s) with "<code><nowiki>&amp;#124;</nowiki></code>" or "<code><nowiki>{{pipe}}</nowiki></code>" or "<code><nowiki>{{abs}}</nowiki></code>". For instance, put two bars "|6|" like this:
:<code><nowiki>{{Avoid wrap|</nowiki>&amp;#124;6&amp;#124; < 7}}</code> &nbsp;or&nbsp; <code><nowiki>{{Avoid wrap|{{pipe}}6{{pipe}} < 7}}</nowiki></code> &nbsp;or&nbsp; <code><nowiki>{{avoid wrap|{{abs|6}} < 7}}</nowiki></code>

Which renders this: 
:{{avoid wrap|&#124;6&#124; < 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:

:{{code|lang=html|1=<span class="avoidwrap" style="display:inline-block;">This text will not wrap</span>}}

When there is not enough remaining space on a line to fit the contents of such as block, it will be pushed to the next line in its entirety. However when the block in itself doesn't fit on a single line, line breaking still applies to the 'internal' text block. This is especially advantageous for mobile rendering where the available line width might be much smaller than on desktops and might require line breaks to make longer words or sections fit.

== TemplateData ==
{{TemplateData header}}
<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 ==
{{List of nowrap-like templates}}

<includeonly>{{Sandbox other||
<!-- Categories go below this line, please; interwikis go to Wikidata, thank you! -->
[[Category:Line-handling templates]]

}}</includeonly>