Package com.google.gwt.i18n.shared

Interface Localizable

  • All Known Subinterfaces:
    CellTree.CellTreeMessages, Constants, ConstantsWithLookup, CurrencyCodeMapConstants, DateTimeConstantsImpl, Localizable, LocalizableResource, Messages, NumberConstantsImpl, SimplePager.ImageButtonsConstants, TimeZoneConstants
    public interface Localizable
    A tag interface that serves as the root of a family of types used in static internationalization. Using GWT.create(class) to instantiate a type that directly extends or implements Localizable invites locale-sensitive type substitution.

    Locale-sensitive Type Substitution

    If a type Type directly extends or implements Localizable (as opposed to Constants or Messages) and the following code is used to create an object from Type as follows: 
    Type localized = (Type)GWT.create(Type.class);
    then localized will be assigned an instance of a localized subclass, selected based on the value of the locale client property. The choice of subclass is determined by the following naming pattern:
    If locale is...     The substitute class for Type is...
    unspecified Type itself, or Type_ if Type is an interface
    x Class Type_x if it exists, otherwise treated as if locale were unspecified
    x_Y Class Type_x_Y if it exists, otherwise treated as if locale were x
    where in the table above x is a ISO language code and Y is a two-letter ISO country code.

    Specifying Locale

    The locale of a module is specified using the locale client property, which can be specified using either a meta tag or as part of the query string in the host page's URL. If both are specified, the query string takes precedence.

    To specify the locale client property using a meta tag in the host HTML, use gwt:property as follows: 

    <meta name="gwt:property" content="locale=x_Y">
    For example, the following host HTML page sets the locale to "ja_JP": 
    <html>
  <head>
    <meta name="gwt:module" content="com.google.gwt.examples.i18n.ColorNameLookupExample">
    <meta name="gwt:property" content="locale=ja_JP">
  </head>
  <body>
    <script src="gwt.js"></script>
  </body>
</html>

    To specify the locale client property using a query string, specify a value for the name locale. For example, 

    http://www.example.org/myapp.html?locale=fr_CA

    For More Information

    See the GWT Developer Guide for an introduction to internationalization.
    See Also:
    Constants, ConstantsWithLookup, Messages, Dictionary