aria-api 0.2.7 → 0.4.2

package/index.js

@@ -1,5 +1,6 @@
 var query = require('./lib/query.js');
 var name = require('./lib/name.js');
+var atree = require('./lib/atree.js');
 
 module.exports = {
 	getRole: query.getRole,
@@ -11,4 +12,7 @@ module.exports = {
 	querySelector: query.querySelector,
 	querySelectorAll: query.querySelectorAll,
 	closest: query.closest,
+
+	getParentNode: atree.getParentNode,
+	getChildNodes: atree.getChildNodes,
 };

package/lib/atree.js

@@ -0,0 +1,90 @@
+var attrs = require('./attrs');
+
+var _getOwner = function(node) {
+	if (node.nodeType === node.ELEMENT_NODE && node.id) {
+		var owner = document.querySelector('[aria-owns~="' + CSS.escape(node.id) + '"]');
+		if (owner) {
+			return owner;
+		}
+	}
+};
+
+var _getParentNode = function(node) {
+	return _getOwner(node) || node.parentNode;
+};
+
+var detectLoop = function(node) {
+	var tmp = _getParentNode(node);
+	while (tmp) {
+		if (tmp === node) {
+			return true;
+		}
+		tmp = _getParentNode(tmp);
+	}
+};
+
+var getOwner = function(node) {
+	if (node.nodeType === node.ELEMENT_NODE && node.id) {
+		var owner = document.querySelector('[aria-owns~="' + CSS.escape(node.id) + '"]');
+		if (owner && !detectLoop(node)) {
+			return owner;
+		}
+	}
+};
+
+var getParentNode = function(node) {
+	return getOwner(node) || node.parentNode;
+};
+
+var isHidden = function(node) {
+	return node.nodeType === node.ELEMENT_NODE && attrs.getAttribute(node, 'hidden');
+};
+
+var getChildNodes = function(node) {
+	var childNodes = [];
+
+	for (var i = 0; i < node.childNodes.length; i++) {
+		var child = node.childNodes[i];
+		if (!getOwner(child) && !isHidden(child)) {
+			childNodes.push(child);
+		}
+	}
+
+	if (node.nodeType === node.ELEMENT_NODE) {
+		var owns = attrs.getAttribute(node, 'owns') || [];
+		for (var i = 0; i < owns.length; i++) {
+			var child = document.getElementById(owns[i]);
+			// double check with getOwner for consistency
+			if (child && getOwner(child) === node && !isHidden(child)) {
+				childNodes.push(child);
+			}
+		}
+	}
+
+	return childNodes;
+};
+
+var walk = function(root, fn) {
+	fn(root);
+	getChildNodes(root).forEach(function(child) {
+		walk(child, fn);
+	});
+};
+
+var searchUp = function(node, test) {
+	var candidate = getParentNode(node);
+	if (candidate) {
+		if (test(candidate)) {
+			return candidate;
+		} else {
+			return searchUp(candidate, test);
+		}
+	}
+};
+
+module.exports = {
+	'getParentNode': getParentNode,
+	'getChildNodes': getChildNodes,
+	'walk': walk,
+	'searchUp': searchUp,
+};

package/lib/attrs.js

@@ -0,0 +1,115 @@
+var constants = require('./constants.js');
+
+// candidates can be passed for performance optimization
+var getRole = function(el, candidates) {
+	if (el.hasAttribute('role')) {
+		return el.getAttribute('role');
+	}
+	for (var role in constants.roles) {
+		var selector = (constants.roles[role].selectors || []).join(',');
+		if (selector && (!candidates || candidates.includes(role)) && el.matches(selector)) {
+			return role;
+		}
+	}
+
+	if (!candidates ||
+			candidates.includes('banner') ||
+			candidates.includes('contentinfo')) {
+		if (!el.matches(constants.scoped)) {
+			if (el.matches('header')) {
+				return 'banner';
+			}
+			if (el.matches('footer')) {
+				return 'contentinfo';
+			}
+		}
+	}
+};
+
+var hasRole = function(el, roles) {
+	var candidates = [].concat.apply([], roles.map(function(role) {
+		return (constants.roles[role] || {}).subRoles || [role];
+	}));
+	var actual = getRole(el, candidates);
+	return candidates.includes(actual);
+};
+
+var getAttribute = function(el, key) {
+	if (constants.attributeStrongMapping.hasOwnProperty(key)) {
+		var value = el[constants.attributeStrongMapping[key]];
+		if (value) {
+			return value;
+		}
+	}
+	if (key === 'readonly' && el.contentEditable) {
+		return false;
+	} else if (key === 'invalid' && el.checkValidity) {
+		return !el.checkValidity();
+	} else if (key === 'hidden') {
+		// workaround for chromium
+		if (el.matches('noscript')) {
+			return true;
+		}
+		var style = window.getComputedStyle(el);
+		if (style.display === 'none' || style.visibility === 'hidden') {
+			return true;
+		}
+	}
+
+	var type = constants.attributes[key];
+	var raw = el.getAttribute('aria-' + key);
+
+	if (raw) {
+		if (type === 'bool') {
+			return raw === 'true';
+		} else if (type === 'tristate') {
+			return raw === 'true' ? true : raw === 'false' ? false : 'mixed';
+		} else if (type === 'bool-undefined') {
+			return raw === 'true' ? true : raw === 'false' ? false : undefined;
+		} else if (type === 'id-list') {
+			return raw.split(/\s+/);
+		} else if (type === 'integer') {
+			return parseInt(raw, 10);
+		} else if (type === 'number') {
+			return parseFloat(raw);
+		} else if (type === 'token-list') {
+			return raw.split(/\s+/);
+		} else {
+			return raw;
+		}
+	}
+
+	// TODO
+	// autocomplete
+	// contextmenu -> aria-haspopup
+	// indeterminate -> aria-checked="mixed"
+	// list -> aria-controls
+
+	if (key === 'level') {
+		for (var i = 1; i <= 6; i++) {
+			if (el.tagName.toLowerCase() === 'h' + i) {
+				return i;
+			}
+		}
+	} else if (constants.attributeWeakMapping.hasOwnProperty(key)) {
+		return el[constants.attributeWeakMapping[key]];
+	}
+
+	if (key in constants.attrsWithDefaults) {
+		var role = getRole(el);
+		var defaults = (constants.roles[role] || {}).defaults;
+		if (defaults && defaults.hasOwnProperty(key)) {
+			return defaults[key];
+		}
+	}
+
+	if (type === 'bool' || type === 'tristate') {
+		return false;
+	}
+};
+
+module.exports = {
+	getRole: getRole,
+	hasRole: hasRole,
+	getAttribute: getAttribute,
+};