Class: LocaleWidget

Extends

• module:settings/js/widget.Widget

Members

className

CSS classes for the widget.

Default Value:

• Widget#className + ' form-horizontal'

Source:

• widgets/locale-widget.js, line 47

controlGroupClass

Class applied to control groups. Set to 'form-group' if using Bootstrap 3

Inherited From:

• module:settings/js/widget.Widget#controlGroupClass

Default Value:

• control-group

Source:

• widget.js, line 54

errorClass

Class used to indicate failed validation. Set to 'has-error' if using Bootstrap 3

Inherited From:

• module:settings/js/widget.Widget#errorClass

Default Value:

• error

Source:

• widget.js, line 72

formControlClass

Class applied to form controls. Set to 'form-control' if using Bootstrap 3

Inherited From:

• module:settings/js/widget.Widget#formControlClass

Default Value:

• ''

Source:

• widget.js, line 60

localeTemplate :module:settings/js/widgets/locale-widget.LocaleWidget~LocaleWidgetTemplate

Template for the widget. Override if using Bootstrap 3

Type:

• module:settings/js/widgets/locale-widget.LocaleWidget~LocaleWidgetTemplate

Source:

• widgets/locale-widget.js, line 41

successClass

Class used to indicate successful validation. Set to 'has-success' if using Bootstrap 3

Inherited From:

• module:settings/js/widget.Widget#successClass

Default Value:

• success

Source:

• widget.js, line 66

widgetTemplate :module:settings/js/widget.Widget~WidgetTemplate

Base template for the widget. Override if using Bootstrap 3

Type:

• module:settings/js/widget.Widget~WidgetTemplate

Inherited From:

• module:settings/js/widget.Widget#widgetTemplate

Source:

• widget.js, line 90

Methods

getConfig() → {string}

Returns the current config for the widget

Source:

• widgets/locale-widget.js, line 67

Returns:

The ISO code of the currently selected locale

Type

string

getName() → {string}

Gets the name for the widget

Inherited From:

• module:settings/js/widget.Widget#getName

Deprecated:

• Users of this class do not need to call this

Source:

• widget.js, line 131

Returns:

this.serverName, or this.configItem if serverName is undefined

Type

string

handleInputChange()

Handler for change events on any inputs in the widget. Calls hideValidationInfo and
setValidationFormatting

Inherited From:

• module:settings/js/widget.Widget#handleInputChange

Source:

• widget.js, line 139

<abstract> handleValidation(config, response) → {boolean}

Handles the results of server side validation (several widgets have a Test Connection button to do
this). Override this method if your widget needs server side validation

Parameters:

Name	Type	Description
config	object	The configuration object for the widget
response	ValidationResponse	The validation response from the server

Inherited From:

• module:settings/js/widget.Widget#handleValidation

Source:

• widget.js, line 158

Returns:

True if the widget is valid; false otherwise

Type

boolean

hideValidationInfo()

Hides any validation information (elements with the settings-client-validation class)

Inherited From:

• module:settings/js/widget.Widget#hideValidationInfo

Source:

• widget.js, line 163

render()

Renders the widget

Source:

• widgets/locale-widget.js, line 57

setValidationFormatting(state)

Removes this.successClass and this.errorClass from elements in the widget with this.controlGroupClass.

If state === 'clear', remove successClass and errorClass from this.$el. Otherwise adds the given class
and removes the other class

Parameters:

Name	Type	Description
state	string	clear to remove classes, otherwise this.successClass or this.errorClass to add that class and remove the other class

Inherited From:

• module:settings/js/widget.Widget#setValidationFormatting

Source:

• widget.js, line 174

<abstract> shouldValidate() → {boolean}

Returns false by default; override it to return true if your widget needs client side validation

Inherited From:

• module:settings/js/widget.Widget#shouldValidate

Source:

• widget.js, line 190

Returns:

True if the widget should validate; false otherwise

Type

boolean

updateConfig(config)

Updates the widget with the given config

Parameters:

Name	Type	Description
config	string	The new ISO code for the locale

Source:

• widgets/locale-widget.js, line 75

<protected> updateInputValidation($input, isValid)

Updates the formatting of the given input

If isValid is true, removes errorClass from the input and hides elements with the class
settings-client-validation

If isValid is false, adds errorClass to the input and shows elements with the class
settings-client-validation

Parameters:

Name	Type	Description
$input	jQuery	The input to apply the classes to
isValid	boolean	True if the input is valid; false otherwise

Inherited From:

• module:settings/js/widget.Widget#updateInputValidation

Source:

• widget.js, line 214

<abstract> validateInputs() → {boolean}

Validates the inputs in the widget. Default implementation just returns true - override if you need
validation. This method should perform any formatting required to display the validation failure.

Inherited From:

• module:settings/js/widget.Widget#validateInputs

Source:

• widget.js, line 233

Returns:

True if the widget is valid; false otherwise

Type

boolean

Type Definitions

LocaleWidgetTemplate(parameters)

Parameters:

Name	Type	Description
parameters	LocaleWidgetOptions	Parameters for the widget

Source:

• widgets/locale-widget.js, line 33