Template:Bdi/doc

From MozillaWiki
Jump to: navigation, search
Edit-copy green.svg
This is a documentation subpage for Template:Bdi.
It contains usage information, categories and other content that is not part of the original template page.

Usage

{{bdi}} is a front-end for the HTML element <bdi>, which is used to delimit a span of text that has a text direction which is either unknown, or opposite to that of the main text. It enables the use of, e.g. Arabic script as inline text in an English article (and vice versa).

Mixed text directions often causes text flow problems. Words will become jumbled at line-breaks, and punctuation marks may be displayed on the wrong side of the string, since they get interpreted as part of the inserted text.

Parameters

There is only 1 parameter, which is unnamed and required.

Syntax

The template's syntax is

  • {{bdi|custom text}}

Required parameter

1

Custom text

The text that should be enclosed in <bdi> tags.

Usage
  • {{bdi|1}}


Examples

Correct use

Case What you type What you see
Basic use موزيلا فيرفكس}} موزيلا فيرفكس
In inline text موزيلا فيرفكس}}, is a popular web-browser. Mozilla Firefox, in Arabic موزيلا فيرفكس, is a popular web-browser.

Comparison between <bdi> and <bdo>

The <bdi> tag derives the direction of the text it encloses from the text itself. You don't include any directional information. The <bdo> tag, however, forces the text it encloses to flow in a certain direction, specified through the attribute dir=.

Because of that, {{bdo}} shouldn't be used in cases where the direction of the inserted text is unknown, but it is a good alternative if {{bdi}} should fail to derive the direction.

<bdi>

The <bdi> tag is used in the same way, regardless of the text direction of the inserted string.

Case What you type What you see Comments
<bdi> adapts to
the text direction of
the enclosed string
من اليمين إلى اليسار}} من اليمين إلى اليسار Works for both rtl and ltr input
From left to right}} From left to right

<bdo>

The <bdo> tag may make the text virtually unreadable, if used incorrectly. Mind the dir=.

Correct
Case What you type What you see Comments
<bdo> has a preset
directional output
من اليمين إلى اليسار}} من اليمين إلى اليسار The default direction is rtl
dir=ltr|From left to right}} From left to right ltr must be explicitly specified
Incorrect
Case What you type What you see Comments
Wrong value for
the dir attribute
dir=ltr|من اليمين إلى اليسار}} من اليمين إلى اليسار The text is displayed backwards (<bdo> forces the direction)
From left to right}} From left to right

See also

  • {{bdo}}: inserts <bdo> tags, forcing inline changes in text direction.
  • {{abbr}}: inserts <abbr> tags to include a tooltip explanation of an abbreviation.
  • {{code}}: inserts <code> tags.
  • {{mark}}: inserts <mark> tags, highlighting the enclosed text.
  • {{samp}}: inserts <samp> tags.
  • {{var}}: inserts <var> tags.
  • {{varserif}}: inserts <var> tags with serif font styling.