Class sap.ui.core.ConfigurationModule: sap/ui/core/Configuration

Applies multiple changes to the configuration at once.

If the changed settings contain localization related settings like language or calendarType, then only a single localizationChanged event will be fired. As the framework has to inform all existing components, elements, models etc. about localization changes, using applySettings can significantly reduce the overhead for multiple changes, esp. when they occur after the UI has been created already.

The mSettings can contain any property xyz for which a setter method setXYZ exists in the API of this class. Similarly, values for the format settings API can be provided in a nested object with name formatSettings.

sap.ui.getCore().getConfiguration().applySettings({
    language: 'de',
    calendarType: sap.ui.core.CalendarType.Gregorian,
    formatSettings: {
        legacyDateFormat: '1',
        legacyTimeFormat: '1',
        legacyNumberFormat: '1'
    }
});

Returns whether the accessibility mode is used or not

Returns whether the animations are globally used

Base URLs to AppCacheBuster Etag-Index files

Object defining the callback hooks for the AppCacheBuster like e.g. handleURL, onIndexLoad or onIndexLoaded.

Experimental API:Since 1.27.0

The loading mode (sync|async|batch) of the AppCacheBuster (sync is default)

Experimental API:Since 1.12.5

Returns whether the framework automatically adds automatically the ARIA role 'application' to the html body or not.

Returns the used compatibility version for the given feature.

Return whether the controller code is deactivated. During design mode the

Experimental API:Since 1.26.4

Returns whether the page runs in debug mode

Return whether the design mode is active or not.

Experimental API:Since 1.13.2

Returns whether the Fiori2Adaptation is on

Returns the format locale string with language and region code. Falls back to language configuration, in case it has not been explicitly defined.

Returns a configuration object that bundles the format settings of UI5.

frameOptions mode (allow/deny/trusted).

Returns whether the UI5 control inspector is displayed Has only an effect when the sap-ui-debug module has been loaded

Returns a string that identifies the current language.

The value returned by this methods in most cases corresponds to the exact value that has been configured by the user or application or that has been determined from the user agent settings. It has not been normalized, but has been validated against a relaxed version of BCP47, allowing underscores ('_') instead of the suggested dashes ('-') and not taking the case of letters into account.

The exceptions mentioned above affect languages that have been specified via the URL parameter sap-language. That parameter by definition represents a SAP logon language code ('ABAP language'). Most but not all of these language codes are valid ISO639 two-letter languages and as such are valid BCP47 language tags. For better BCP47 compliance, the framework maps the following non-BCP47 SAP logon codes to a BCP47 substitute:

   "ZH"  -->  "zh-Hans"         // script 'Hans' added to distinguish it from zh-Hant
   "ZF"  -->  "zh-Hant"         // ZF ist not a valid ISO639 code, use the compliant language + script 'Hant'
		 "    "1Q"  -->  "en-US-x-saptrc"  // special language code for supportability (tracing),
                                   represented as en-US with a priate extension
   "2Q"  -->  "en-US-x-sappsd"  // special language code for supportability (pseudo translation),
                                   represented as en-US with a priate extension

For a normalized BCP47 tag, call getLanguageTag or call getLocale to get a Locale object matching the language.

Returns a BCP47-compliant language tag for the current language.

The return value of this method is especially useful for an HTTP Accept header.

Returns a Locale object for the current language.

The Locale is derived from the language property.

Flag whether a Component should load the manifest first

Returns whether there should be an exception on any duplicate element IDs

Returns whether the text origin information is collected

The name of the root component to start or empty

Experimental API:Since 1.15.1

Returns whether the page uses the RTL text direction.

If no mode has been explicitly set (neither true nor false), the mode is derived from the current language setting.

Returns a SAP logon language for the current language.

Return whether the activation of the controller code is suppressed

Experimental API:Since 1.13.2

Returns the theme name

Prefix to be used for automatically generated control IDs. Default is a double underscore "__".

Returns the version of the framework.

Similar to sap.ui.version.

WEINRE session ID

WEINRE server URL

URL of the whitelist service.

Sets the new calendar type to be used from now on in locale dependent functionalities (for example, formatting, translation texts, etc.).

Sets a new format locale to be used from now on for retrieving locale specific formatters. Modifying this setting does not have an impact on the retrieval of translated texts!

Can either be set to a concrete value (a BCP47 or Java locale compliant language tag) or to null. When set to null (default value) then locale specific formatters are retrieved for the current language.

After changing the format locale, the framework tries to update localization specific parts of the UI. See the documentation of setLanguage for details and restrictions.

Note: When a format locale is set, it has higher priority than a number, date or time format defined with a call to setLegacyNumberFormat, setLegacyDateFormat or setLegacyTimeFormat.

Experimental API:Since 1.11.1 - See documentation of {@link #setLanguage} for restrictions.