L10n.setAttributes

Non-standard
This feature is not on a current W3C standards track, but it is supported on the Firefox OS platform. Although implementations may change in the future and it is not supported widely across browsers, it is suitable for use in code dedicated to Firefox OS apps.

The setAttributes method may be used to set the data-l10n-id and data-l10n-args attributes on DOM elements.

The L10n API makes use of mutation observers to detect changes to data-l10n-* attributes and translate the affected elements asynchronously.  The L10n.setAttributes method is a convenience method which allows to translate DOM elements declaratively. Under the hood, L10n's mutation observer uses the same semantics as the L10n.get method.

Syntax

JavaScript
navigator.mozL10n.setAttributes(element, identifier[, data]);

Parameters

element
The element to be translated.
identifier
The string identifier of the translation to be used for translation.
data
An object with variables to be interpolated into the translation. All members' values must be strings or numbers.

Example

dialer.en-US.properties:
JavaScript
from-contact = Missed call from {{ contact }}
dialer.js:
JavaScript
var banner = document.getElementById('banner');
navigator.mozL10n.setAttributes(banner, 'from-contact', {contact: primaryInfo.toString()});

L10n.setAttributes is a convenience method which uses the standard Element.setAttribute API.  Therefore, the above is equivalent to:

JavaScript
var banner = document.getElementById('banner');
banner.setAttribute('data-l10n-id', 'from-contact');
banner.setAttribtue('data-l10n-args', JSON.stringify({contact: primaryInfo.toString()}));

Specification

Not part of any specification.

See also

License

© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/l10n.setattributes

API Firefox OS l10n Localization Method Reference Référence