home *** CD-ROM | disk | FTP | other *** search
- // Copyright (c) 2012 The Chromium Authors. All rights reserved.
- // Use of this source code is governed by a BSD-style license that can be
- // found in the LICENSE file.
-
- // Copyright (c) 2012 The Chromium Authors. All rights reserved.
- // Use of this source code is governed by a BSD-style license that can be
- // found in the LICENSE file.
-
- /**
- * @fileoverview This is a simple template engine inspired by JsTemplates
- * optimized for i18n.
- *
- * It currently supports three handlers:
- *
- * * i18n-content which sets the textContent of the element.
- *
- * <span i18n-content="myContent"></span>
- *
- * * i18n-options which generates <option> elements for a <select>.
- *
- * <select i18n-options="myOptionList"></select>
- *
- * * i18n-values is a list of attribute-value or property-value pairs.
- * Properties are prefixed with a '.' and can contain nested properties.
- *
- * <span i18n-values="title:myTitle;.style.fontSize:fontSize"></span>
- *
- * This file is a copy of i18n_template.js, with minor tweaks to support using
- * load_time_data.js. It should replace i18n_template.js eventually.
- */
-
- var i18nTemplate = (function() {
- /**
- * This provides the handlers for the templating engine. The key is used as
- * the attribute name and the value is the function that gets called for every
- * single node that has this attribute.
- * @type {Object}
- */
- var handlers = {
- /**
- * This handler sets the textContent of the element.
- * @param {HTMLElement} element The node to modify.
- * @param {string} key The name of the value in the dictionary.
- * @param {LoadTimeData} dictionary The dictionary of strings to draw from.
- */
- 'i18n-content': function(element, key, dictionary) {
- element.textContent = dictionary.getString(key);
- },
-
- /**
- * This handler adds options to a <select> element.
- * @param {HTMLElement} select The node to modify.
- * @param {string} key The name of the value in the dictionary. It should
- * identify an array of values to initialize an <option>. Each value,
- * if a pair, represents [content, value]. Otherwise, it should be a
- * content string with no value.
- * @param {LoadTimeData} dictionary The dictionary of strings to draw from.
- */
- 'i18n-options': function(select, key, dictionary) {
- var options = dictionary.getValue(key);
- options.forEach(function(optionData) {
- var option = typeof optionData == 'string' ?
- new Option(optionData) :
- new Option(optionData[1], optionData[0]);
- select.appendChild(option);
- });
- },
-
- /**
- * This is used to set HTML attributes and DOM properties. The syntax is:
- * attributename:key;
- * .domProperty:key;
- * .nested.dom.property:key
- * @param {HTMLElement} element The node to modify.
- * @param {string} attributeAndKeys The path of the attribute to modify
- * followed by a colon, and the name of the value in the dictionary.
- * Multiple attribute/key pairs may be separated by semicolons.
- * @param {LoadTimeData} dictionary The dictionary of strings to draw from.
- */
- 'i18n-values': function(element, attributeAndKeys, dictionary) {
- var parts = attributeAndKeys.replace(/\s/g, '').split(/;/);
- parts.forEach(function(part) {
- if (!part)
- return;
-
- var attributeAndKeyPair = part.match(/^([^:]+):(.+)$/);
- if (!attributeAndKeyPair)
- throw new Error('malformed i18n-values: ' + attributeAndKeys);
-
- var propName = attributeAndKeyPair[1];
- var propExpr = attributeAndKeyPair[2];
-
- var value = dictionary.getValue(propExpr);
-
- // Allow a property of the form '.foo.bar' to assign a value into
- // element.foo.bar.
- if (propName[0] == '.') {
- var path = propName.slice(1).split('.');
- var targetObject = element;
- while (targetObject && path.length > 1) {
- targetObject = targetObject[path.shift()];
- }
- if (targetObject) {
- targetObject[path] = value;
- // In case we set innerHTML (ignoring others) we need to
- // recursively check the content.
- if (path == 'innerHTML')
- process(element, dictionary);
- }
- } else {
- element.setAttribute(propName, value);
- }
- });
- }
- };
-
- var attributeNames = Object.keys(handlers);
- var selector = '[' + attributeNames.join('],[') + ']';
-
- /**
- * Processes a DOM tree with the {@code dictionary} map.
- * @param {HTMLElement} node The root of the DOM tree to process.
- * @param {LoadTimeData} dictionary The dictionary to draw from.
- */
- function process(node, dictionary) {
- var elements = node.querySelectorAll(selector);
- for (var element, i = 0; element = elements[i]; i++) {
- for (var j = 0; j < attributeNames.length; j++) {
- var name = attributeNames[j];
- var attribute = element.getAttribute(name);
- if (attribute != null)
- handlers[name](element, attribute, dictionary);
- }
- }
- }
-
- return {
- process: process
- };
- }());
-
-
- i18nTemplate.process(document, loadTimeData);
-