XFA Specification
Chapter 16, Config Specification
Config Element Reference
691
The locale element
This option specifies a default locale.
<locale
Properties:
desc="cdata"
>
...pcdata...
</locale>
The locale element is used within the following other elements:
common
Locale determines the currency symbol, the radix symbol, calendar, day and month names, and other
information which is culture- or location-specific. This option supplies an ambient locale, overriding the
ambient locale supplied by the host operating system (if any). Each individual subforms may assert its own
locale, inherit an asserted locale from its parent, or use the ambient locale.
Content
The content must be a two-letter language code or a combined country code and language code as
defined by
IETF RFC 1766
[RFC1766] and
ISO 639
[ISO-639-1] /ISO
3166
[ISO-3166-1] specifications. This is
the same set of locale names used by the
xml:lang
attribute defined in [XML1.0]. Note that three-letter
combined codes are not supported by XFA. Combined codes must consist of a language code, followed by
a hyphen or underscore character, followed by a country code, followed optionally by a modifier.
When this element is omitted or empty the locale supplied by the host operating system is used as the
ambient locale. If the host operating system does not supply a locale then en_us (or equivalently en-us) is
used.
XFA applications are not expected to support all possible locale values, especially as new country codes
are issued from time to time. If the supplied code is anything other than en_us and it is not contained in
the locale set packet, then it is implementation-defined whether the locale is supported or not. All XFA
applications are required to support en_us.
The desc property
An attribute to hold human-readable metadata.