Function traverseHtml

Extension/gulpfile.js:98–124

(contents, nodeCallback, attributeCallback, isFragment)

// nodeCallback(locId, locHint, node) is invoked for nodes
// attributeCallback(locId, locHint, attribute) is invoked for attributes
const traverseHtml = (contents, nodeCallback, attributeCallback, isFragment) => {
    const htmlTree = isFragment ? parse5.parseFragment(contents) : parse5.parse(contents);
    traverse(htmlTree, {
        pre(node, parent) {
            if (node.attrs) {
                // Check if content text should be localized based on presense of data-loc-id attribute
                let locId = node.attrs.find(attribute => attribute.name.toLowerCase() == dataLocIdAttribute);
                if (locId) {
                    let locHint = node.attrs.find(attribute => attribute.name.toLowerCase() == dataLocHintAttribute);
                    nodeCallback(locId.value, locHint?.value, node);
                }
                // Check if an attribute should be localized based on presense of data-loc-id-<attribute_name> attribute
                node.attrs.forEach(attribute => {
                    if (attribute.name.startsWith(`${dataLocIdAttribute}-`)) {
                        let targetAttributeName = attribute.name.substring(dataLocIdAttribute.length + 1);
                        let targetAttribute = node.attrs.find(a => a.name == targetAttributeName);
                        if (targetAttribute) {
                            let hint = node.attrs.find(a => a.name.toLowerCase() == `${dataLocHintAttribute}-${targetAttributeName}`);
                            attributeCallback(attribute.value, hint?.value, targetAttribute);
                        }
                    }
                });
            }
        }
    });
    return htmlTree;
};

// Traverses the HTML document looking for node and attributes containing data-loc-id, to localize
// Outputs *.nls.json files containing strings to localize.