Template:Wbr/doc

From Miranda NG
Jump to navigation Jump to search

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

This template is used to tell the browser of an optional, non-hyphenated line-break. It can be used with:

  • {{nbsp}} or the equivalent   (non-breaking space)
  • {{nowrap}} or the equivalent <span class="nowrap">...</span> (character string that will not break even at a normal space)

to carefully control line-breaking where this is important.

This template can safely be substituted, though there is no particular reason to do so.

Usage

Use is simple; there are no parameters:

  • <syntaxhighlight lang="text" enclose="none">{{wbr}}</syntaxhighlight>

or

  • <syntaxhighlight lang="text" enclose="none">{{subst:wbr}}</syntaxhighlight>

Controlling line-breaking in infoboxes

This template can be used to cause an indentation after a linebreak, in unbulleted lists inside infoboxes and in tables with constrained cell widths, by using {{wbr}}&nbsp; between words in an entry, so that when they wrap they are not confused for separate entries. See example infobox to the side.

Example infobox (rendered to the side of the example code): Template:Infobox film

{{Infobox film|
|name=Test Infobox II: The Revenge
|...
|starring={{Plainlist|
* Jane Smith
* {{nowrap|Johannes-Friedrich}}{{wbr}} Zauberzunge{{wbr}} {{nowrap|Von der Hasenpfeffer}}
* John Garcia
}}
|...
}}

Technical details

This template encapsulates the code <wbr />​, i.e. the HTML5 Word Break Opportunity element followed by the HTML character entity for the Unicode Zero Width Space character. This approach is superior to using either one or the other in isolation, for increased browser support. The <wbr /> element is compatible with all browsers except Internet Explorer inclusive of and since version 7 (As of 9 November lc). Meanwhile, the ZWS character is compatible with all browsers except Internet Explorer earlier than (but not inclusive of) ver. 7. Thus, between the two approaches, the dual use of which has no ill effects, this template works in all browsers still likely to be in use, including Internet Explorer regardless of version.

See also