![]()
Directionality enum.
Constants:
|
Code » | ||||||
![]()
Unicode formatting characters and directionality string constants.
Constants:
|
Code » |
Check the directionality of a piece of text, return true if the piece of
text should be laid out in RTL direction.
|
code » | |||
Check if the exit directionality a piece of text is LTR, i.e. if the last
strongly-directional character in the string is LTR.
|
code » | |||
Check if the exit directionality a piece of text is RTL, i.e. if the last
strongly-directional character in the string is RTL.
|
code » | |||
Enforce the html snippet in RTL directionality regardless overall context.
If the html piece was enclosed by tag, dir will be applied to existing
tag, otherwise a span tag will be added as wrapper. For this reason, if
html snippet start with with tag, this tag must enclose the whole piece. If
the tag already has a dir specified, this new one will override existing
one in behavior (tested on FF and IE).
|
code » | |||
Enforce LTR on both end of the given text piece using unicode BiDi formatting
characters LRE and PDF.
|
code » | |||
Enforce the html snippet in RTL directionality regardless overall context.
If the html piece was enclosed by tag, dir will be applied to existing
tag, otherwise a span tag will be added as wrapper. For this reason, if
html snippet start with with tag, this tag must enclose the whole piece. If
the tag already has a dir specified, this new one will override existing
one in behavior (tested on FF and IE).
|
code » | |||
Enforce RTL on both end of the given text piece using unicode BiDi formatting
characters RLE and PDF.
|
code » | |||
![]()
Estimates the directionality of a string based on relative word counts.
If the number of RTL words is above a certain percentage of the total number
of strongly directional words, returns RTL.
Otherwise, if any words are strongly or weakly LTR, returns LTR.
Otherwise, returns UNKNOWN, which is used to mean "neutral".
Numbers are counted as weakly LTR.
Arguments:
Returns: goog.i18n.bidi.Dir
Estimated overall directionality of
str .
|
code » | |||
Apply bracket guard using html span tag. This is to address the problem of
messy bracket display frequently happens in RTL layout.
|
code » | |||
Apply bracket guard using LRM and RLM. This is to address the problem of
messy bracket display frequently happens in RTL layout.
This version works for both plain text and html. But it does not work as
good as guardBracketInHtml in some cases.
|
code » | |||
Test whether the given string has any LTR characters in it.
|
code » | |||
Test whether the given string has any RTL characters in it.
|
code » | |||
Use hasAnyRtl.
Test whether the given string has any RTL characters in it.
|
code » | |||
Check if the first character in the string is LTR or not.
|
code » | |||
Use endsWithLtr.
Check if the exit directionality a piece of text is LTR, i.e. if the last
strongly-directional character in the string is LTR.
|
code » | |||
Use startsWithLtr.
Check whether the first strongly directional character (if any) is LTR.
|
code » | |||
Check if the first character in the string is neutral or not.
|
code » | |||
Check whether the input string either contains no strongly directional
characters or looks like a url.
|
code » | |||
Check if the first character in the string is RTL or not.
|
code » | |||
Use endsWithRtl.
Check if the exit directionality a piece of text is RTL, i.e. if the last
strongly-directional character in the string is RTL.
|
code » | |||
Check if a BCP 47 / III language code indicates an RTL language, i.e. either:
- a language code explicitly specifying one of the right-to-left scripts,
e.g. "az-Arab", or
- a language code specifying one of the languages normally written in a right-to-left script, e.g. "fa" (Farsi), except ones explicitly specifying Latin or Cyrillic script (which are the usual LTR alternatives). The list of right-to-left scripts appears in the 100-199 range in http://www.unicode.org/iso15924/iso15924-num.html, of which Arabic and Hebrew are by far the most widely used. We also recognize Thaana, N'Ko, and Tifinagh, which also have significant modern usage. The rest (Syriac, Samaritan, Mandaic, etc.) seem to have extremely limited or no modern usage and are not recognized to save on code size. The languages usually written in a right-to-left script are taken as those with Suppress-Script: Hebr|Arab|Thaa|Nkoo|Tfng in http://www.iana.org/assignments/language-subtag-registry, as well as Central (or Sorani) Kurdish (ckb), Sindhi (sd) and Uyghur (ug). Other subtags of the language code, e.g. regions like EG (Egypt), are ignored. |
code » | |||
Use startsWithRtl.
Check whether the first strongly directional character (if any) is RTL.
|
code » | |||
Swap location parameters and 'left'/'right' in CSS specification. The
processed string will be suited for RTL layout. Though this function can
cover most cases, there are always exceptions. It is suggested to put
those exceptions in separate group of CSS string.
|
code » | |||
Replace the double and single quote directly after a Hebrew character with
GERESH and GERSHAYIM. In such case, most likely that's user intention.
|
code » | |||
![]()
Sets text input element's directionality and text alignment based on a
given directionality. Does nothing if the given directionality is unknown or
neutral.
Arguments:
|
code » | |||
Check whether the first strongly directional character (if any) is LTR.
|
code » | |||
Check whether the first strongly directional character (if any) is RTL.
|
code » | |||
Returns the input text with spaces instead of HTML tags or HTML escapes, if
opt_isStripNeeded is true. Else returns the input as is.
Useful for text directionality estimation.
Note: the function should not be used in other contexts; it is not 100%
correct, but rather a good-enough implementation for directionality
estimation purposes.
|
code » | |||
![]()
Convert a directionality given in various formats to a goog.i18n.bidi.Dir
constant. Useful for interaction with different standards of directionality
representation.
Arguments:
Returns: ?goog.i18n.bidi.Dir
A goog.i18n.bidi.Dir constant matching the
given directionality. If given null, returns null (i.e. unknown).
|
code » |
![]()
No description.
|
Code » | |
![]()
'right' if locale is RTL, 'left' if not.
|
Code » | |
![]()
'left' if locale is RTL, 'right' if not.
|
Code » | |
![]()
Constant that defines whether or not the current locale is a RTL locale.
If
goog.i18n.bidi.FORCE_RTL is not true, this constant will default
to check that goog.LOCALE is one of a few major RTL locales.
This is designed to be a maximally efficient compile-time constant. For example, for the default goog.LOCALE, compiling "if (goog.i18n.bidi.IS_RTL) alert('rtl') else {}" should produce no code. It is this design consideration that limits the implementation to only supporting a few major RTL locales, as opposed to the broader repertoire of something like goog.i18n.bidi.isRtlLanguage. Since this constant refers to the directionality of the locale, it is up to the caller to determine if this constant should also be used for the direction of the UI. |
Code » | |
![]()
'left' string constant.
|
Code » | |
![]()
'right' string constant.
|
Code » | |
![]()
Regular expression for bracket guard replacement in html.
|
Code » | |
![]()
Regular expression for bracket guard replacement in text.
|
Code » | |
![]()
Regular expression to find dimensions such as "padding: .3 0.4ex 5px 6;"
|
Code » | |
![]()
Regular expression for hebrew double quote substitution, finding quote
directly after hebrew characters.
|
Code » | |
![]()
Regular expression to check if a string contains any numerals. Used to
differentiate between completely neutral strings and those containing
numbers, which are weakly LTR.
|
Code » | |
![]()
Simplified regular expression for an HTML tag (opening or closing) or an HTML
escape. We might want to skip over such expressions when estimating the text
directionality.
|
Code » | |
![]()
Regular expression to check if a string looks like something that must
always be LTR even in RTL text, e.g. a URL. When estimating the
directionality of text containing these, we treat these as weakly LTR,
like numbers.
|
Code » | |
![]()
Regular expression for left.
|
Code » | |
![]()
Regular expression to check for LTR characters.
|
Code » | |
![]()
A practical pattern to identify strong LTR characters. This pattern is not
theoretically correct according to the Unicode standard. It is simplified for
performance and small code size.
|
Code » | |
![]()
Regular expressions to check if a piece of text is of LTR directionality
on first character with strong directionality.
|
Code » | |
![]()
Regular expressions to check if the last strongly-directional character in a
piece of text is LTR.
|
Code » | |
![]()
Regular expression pattern to check if the first character in the string
is LTR.
|
Code » | |
![]()
Regular expression for right.
|
Code » | |
![]()
Regular expression to check for RTL characters.
|
Code » | |
![]()
A practical pattern to identify strong RTL character. This pattern is not
theoretically correct according to the Unicode standard. It is simplified
for performance and small code size.
|
Code » | |
![]()
This constant controls threshold of RTL directionality.
|
Code » | |
![]()
Regular expressions to check if a piece of text is of RTL directionality
on first character with strong directionality.
|
Code » | |
![]()
Regular expressions to check if the last strongly-directional character in a
piece of text is RTL.
|
Code » | |
![]()
A regular expression for matching right-to-left language codes.
See
#isRtlLanguage for the design.
|
Code » | |
![]()
Regular expression pattern to check if the first character in the string
is RTL.
|
Code » | |
![]()
Regular expression for hebrew single quote substitution, finding quote
directly after hebrew characters.
|
Code » | |
![]()
Placeholder regular expression for swapping.
|
Code » | |
![]()
Regular expression to split a string into "words" for directionality
estimation based on relative word counts.
|
Code » |