com.google.gwt.i18n.shared

Class BidiFormatterBase

java.lang.Object

com.google.gwt.i18n.shared.BidiFormatterBase

Direct Known Subclasses:

BidiFormatter, SafeHtmlBidiFormatter

public abstract class BidiFormatterBase
extends java.lang.Object

Base class for BidiFormatter and SafeHtmlBidiFormatter that contains their common implementation.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	BidiFormatterBase.Factory<T extends BidiFormatterBase> Abstract factory class for BidiFormatterBase.
(package private) static class	BidiFormatterBase.Format A container class for direction-related string constants, e.g.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BidiFormatterBase(HasDirection.Direction contextDir, boolean alwaysSpan)

Method Summary

Modifier and Type	Method and Description
protected java.lang.String	dirAttrBase(java.lang.String str, boolean isHtml)
protected java.lang.String	endEdgeBase()
HasDirection.Direction	estimateDirection(java.lang.String str) Like estimateDirection(String, boolean), but assumes isHtml is false.
HasDirection.Direction	estimateDirection(java.lang.String str, boolean isHtml) Estimates the direction of a string using the best known general-purpose method, i.e.
boolean	getAlwaysSpan() Returns whether the span structure added by the formatter should be stable, i.e., spans added even when the direction does not need to be declared.
HasDirection.Direction	getContextDir() Returns the context direction.
boolean	isRtlContext() Returns whether the context direction is RTL.
protected java.lang.String	knownDirAttrBase(HasDirection.Direction dir)
protected java.lang.String	markAfterBase(java.lang.String str, boolean isHtml)
protected java.lang.String	markBase()
protected java.lang.String	spanWrapBase(java.lang.String str, boolean isHtml, boolean dirReset)
protected java.lang.String	spanWrapWithKnownDirBase(HasDirection.Direction dir, java.lang.String str, boolean isHtml, boolean dirReset)
protected java.lang.String	startEdgeBase()
protected java.lang.String	unicodeWrapBase(java.lang.String str, boolean isHtml, boolean dirReset)
protected java.lang.String	unicodeWrapWithKnownDirBase(HasDirection.Direction dir, java.lang.String str, boolean isHtml, boolean dirReset)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BidiFormatterBase

protected BidiFormatterBase(HasDirection.Direction contextDir,
                            boolean alwaysSpan)

Method Detail

estimateDirection

public HasDirection.Direction estimateDirection(java.lang.String str)

Like estimateDirection(String, boolean), but assumes isHtml is false.

Parameters:

str - String whose direction is to be estimated

Returns:

str's estimated overall direction

estimateDirection

public HasDirection.Direction estimateDirection(java.lang.String str,
                                                boolean isHtml)

Estimates the direction of a string using the best known general-purpose method, i.e. using relative word counts. Direction.DEFAULT return value indicates completely neutral input.

Parameters:

str - String whose direction is to be estimated

isHtml - Whether str is HTML / HTML-escaped

Returns:

str's estimated overall direction

getAlwaysSpan

public boolean getAlwaysSpan()

Returns whether the span structure added by the formatter should be stable, i.e., spans added even when the direction does not need to be declared.

getContextDir

public HasDirection.Direction getContextDir()

Returns the context direction.

isRtlContext

public boolean isRtlContext()

Returns whether the context direction is RTL.

dirAttrBase

protected java.lang.String dirAttrBase(java.lang.String str,
                                       boolean isHtml)

Parameters:

str - String whose direction is to be estimated

isHtml - Whether str is HTML / HTML-escaped

Returns:

"dir=rtl" for RTL text in non-RTL context; "dir=ltr" for LTR text in non-LTR context; else, the empty string.

See Also:

BidiFormatter.dirAttr(String, boolean)

endEdgeBase

protected java.lang.String endEdgeBase()

See Also:

BidiFormatter.endEdge()

knownDirAttrBase

protected java.lang.String knownDirAttrBase(HasDirection.Direction dir)

Parameters:

dir - Given direction

Returns:

"dir=rtl" for RTL text in non-RTL context; "dir=ltr" for LTR text in non-LTR context; else, the empty string.

See Also:

BidiFormatter.knownDirAttr(HasDirection.Direction)

markAfterBase

protected java.lang.String markAfterBase(java.lang.String str,
                                         boolean isHtml)

Parameters:

str - String after which the mark may need to appear

isHtml - Whether str is HTML / HTML-escaped

Returns:

LRM for RTL text in LTR context; RLM for LTR text in RTL context; else, the empty string.

See Also:

BidiFormatter.markAfter(String, boolean)

markBase

protected java.lang.String markBase()

See Also:

BidiFormatter.mark()

spanWrapBase

protected java.lang.String spanWrapBase(java.lang.String str,
                                        boolean isHtml,
                                        boolean dirReset)

Parameters:

str - The input string

isHtml - Whether str is HTML / HTML-escaped

dirReset - Whether to append a trailing unicode bidi mark matching the context direction, when needed, to prevent the possible garbling of whatever may follow str

Returns:

Input string after applying the above processing.

See Also:

BidiFormatter.spanWrap(String, boolean, boolean)

spanWrapWithKnownDirBase

protected java.lang.String spanWrapWithKnownDirBase(HasDirection.Direction dir,
                                                    java.lang.String str,
                                                    boolean isHtml,
                                                    boolean dirReset)

Parameters:

dir - str's direction

str - The input string

isHtml - Whether str is HTML / HTML-escaped

dirReset - Whether to append a trailing unicode bidi mark matching the context direction, when needed, to prevent the possible garbling of whatever may follow str

Returns:

Input string after applying the above processing.

See Also:

BidiFormatter.spanWrapWithKnownDir(HasDirection.Direction, String, boolean, boolean)

startEdgeBase

protected java.lang.String startEdgeBase()

See Also:

BidiFormatter.startEdge()

unicodeWrapBase

protected java.lang.String unicodeWrapBase(java.lang.String str,
                                           boolean isHtml,
                                           boolean dirReset)

Parameters:

str - The input string

isHtml - Whether str is HTML / HTML-escaped

dirReset - Whether to append a trailing unicode bidi mark matching the context direction, when needed, to prevent the possible garbling of whatever may follow str

Returns:

Input string after applying the above processing.

See Also:

BidiFormatter.unicodeWrap(String, boolean, boolean)

unicodeWrapWithKnownDirBase

protected java.lang.String unicodeWrapWithKnownDirBase(HasDirection.Direction dir,
                                                       java.lang.String str,
                                                       boolean isHtml,
                                                       boolean dirReset)

Parameters:

dir - str's direction

str - The input string

isHtml - Whether str is HTML / HTML-escaped

dirReset - Whether to append a trailing unicode bidi mark matching the context direction, when needed, to prevent the possible garbling of whatever may follow str

Returns:

Input string after applying the above processing.

See Also:

BidiFormatter.unicodeWrapWithKnownDir(HasDirection.Direction, String, boolean, boolean)