aria-api 0.4.7 → 0.5.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2017 Tobias Bengfort
+Copyright (c) 2017-2023 Tobias Bengfort
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -106,11 +106,11 @@ That said, this is what I think it could also be used for:
 
 # Implemented standards
 
--   [Accessible Rich Internet Applications 1.1](https://www.w3.org/TR/wai-aria-1.1/)
--   [Core Accessibility API Mappings 1.1](https://www.w3.org/TR/core-aam-1.1/)
+-   [Accessible Rich Internet Applications 1.2](https://www.w3.org/TR/wai-aria-1.2/)
 -   [HTML Accessibility API Mappings 1.0](https://www.w3.org/TR/html-aam-1.0/)
+-   [SVG Accessibility API Mappings](https://www.w3.org/TR/svg-aam-1.0/) (very incomplete)
 -   [WAI-ARIA Graphics Module 1.0](https://www.w3.org/TR/graphics-aria-1.0/)
--   [Digital Publishing WAI-ARIA Module 1.0](https://www.w3.org/TR/dpub-aria-1.0/)
+-   [Digital Publishing WAI-ARIA Module 1.1](https://www.w3.org/TR/dpub-aria-1.1/)
 -   [Accessible Name and Description Computation 1.1](https://www.w3.org/TR/accname-1.1/)
 
 I try to update the code whenever a new version of these specs becomes a
@@ -135,7 +135,7 @@ recommendation.
 
 # Related projects
 
--   [Visual ARIA Bookmarklet](http://whatsock.com/training/matrices/visual-aria.htm):
+-   [Visual ARIA Bookmarklet](https://whatsock.github.io/visual-aria/github-bookmarklet/visual-aria.htm):
     Displays role, name, and description in any website. Maintained by one of
     the editors of the [accname]() spec.
 -   [axe-core](https://github.com/dequelabs/axe-core/) and

package/dist/aria.js

@@ -123,22 +123,26 @@ var constants = require('./constants.js');
 // candidates can be passed for performance optimization
 var getRole = function(el, candidates) {
 	if (el.hasAttribute('role')) {
-		var role = el.getAttribute('role');
-		if (!candidates || candidates.includes(role)) {
-			return role;
-		} else {
-			return;
+		var roles = el.getAttribute('role').toLowerCase().split(/\s+/);
+		if (roles.length > 1 && candidates) {
+			return [roles, candidates];
 		}
-	}
-	var roles = candidates ? candidates : Object.keys(constants.roles);
-	for (var role of roles) {
-		var r = constants.roles[role];
-		if (r) {
-			var selector = (r.selectors || []).join(',');
-			if (selector && el.matches(selector)) {
+		for (var role of roles) {
+			if (!candidates || candidates.includes(role)) {
 				return role;
 			}
 		}
+	} else {
+		var roles = candidates ? candidates : Object.keys(constants.roles);
+		for (var role of roles) {
+			var r = constants.roles[role];
+			if (r) {
+				var selector = (r.selectors || []).join(',');
+				if (selector && el.matches(selector)) {
+					return role;
+				}
+			}
+		}
 	}
 };
 
@@ -301,13 +305,8 @@ exports.attributeWeakMapping = {
 	'selected': 'selected',
 };
 
-var scoped = [
-	'main *',
-	// https://www.w3.org/TR/html/dom.html#sectioning-content-2
-	'article *', 'aside *', 'nav *', 'section *',
-	// https://www.w3.org/TR/html/sections.html#sectioning-roots
-	'blockquote *', 'details *', 'dialog *', 'fieldset *', 'figure *', 'td *',
-].join(',');
+// https://www.w3.org/TR/html/dom.html#sectioning-content-2
+var scoped = ['article *', 'aside *', 'nav *', 'section *'].join(',');
 
 // https://www.w3.org/TR/html-aam-1.0/#html-element-role-mappings
 // https://www.w3.org/TR/wai-aria/roles
@@ -323,7 +322,10 @@ exports.roles = {
 		selectors: ['article'],
 	},
 	banner: {
-		selectors: ['header:not(' + scoped + ')'],
+		selectors: [`header:not(main *, ${scoped})`],
+	},
+	blockquote: {
+		selectors: ['blockquote'],
 	},
 	button: {
 		selectors: [
@@ -336,26 +338,32 @@ exports.roles = {
 		],
 		nameFromContents: true,
 	},
+	caption: {
+		selectors: ['caption', 'figcaption'],
+	},
 	cell: {
-		selectors: ['td'],
-		childRoles: ['gridcell', 'rowheader'],
+		selectors: ['td', 'th:not([scope])'],
+		childRoles: ['columnheader', 'gridcell', 'rowheader'],
 		nameFromContents: true,
 	},
 	checkbox: {
 		selectors: ['input[type="checkbox"]'],
-		childRoles: ['menuitemcheckbox', 'switch'],
+		childRoles: ['switch'],
 		nameFromContents: true,
 		defaults: {
 			'checked': 'false',
 		},
 	},
+	code: {
+		selectors: ['code'],
+	},
 	columnheader: {
 		selectors: ['th[scope="col"]'],
 		nameFromContents: true,
 	},
 	combobox: {
 		selectors: [
-		'input:not([type])[list]',
+			'input:not([type])[list]',
 			'input[type="email"][list]',
 			'input[type="search"][list]',
 			'input[type="tel"][list]',
@@ -374,17 +382,25 @@ exports.roles = {
 		childRoles: ['button', 'link', 'menuitem'],
 	},
 	complementary: {
-		selectors: ['aside'],
+		selectors: [
+			`aside:not(${scoped})`,
+			'aside[aria-label]',
+			'aside[aria-labelledby]',
+			'aside[title]',
+		],
 	},
 	composite: {
 		childRoles: ['grid', 'select', 'spinbutton', 'tablist'],
 	},
 	contentinfo: {
-		selectors: ['footer:not(' + scoped + ')'],
+		selectors: [`footer:not(main *, ${scoped})`],
 	},
 	definition: {
 		selectors: ['dd'],
 	},
+	deletion: {
+		selectors: ['del', 's'],
+	},
 	dialog: {
 		selectors: ['dialog'],
 		childRoles: ['alertdialog'],
@@ -401,16 +417,32 @@ exports.roles = {
 	'doc-noteref': {
 		nameFromContents: true,
 	},
+	'doc-pagebreak': {
+		nameFromContents: true,
+	},
+	'doc-subtitle': {
+		nameFromContents: true,
+	},
 	document: {
-		selectors: ['body'],
+		selectors: ['html'],
 		childRoles: ['article', 'graphics-document'],
 	},
+	emphasis: {
+		selectors: ['em'],
+	},
 	figure: {
 		selectors: ['figure'],
+		childRoles: ['doc-example'],
 	},
 	form: {
 		selectors: ['form[aria-label]', 'form[aria-labelledby]', 'form[title]'],
 	},
+	generic: {
+		// too many selectors to list
+	},
+	'graphics-document': {
+		selectors: ['svg'],
+	},
 	grid: {
 		childRoles: ['treegrid'],
 	},
@@ -419,7 +451,14 @@ exports.roles = {
 		nameFromContents: true,
 	},
 	group: {
-		selectors: ['details', 'optgroup'],
+		selectors: [
+			'address',
+			'details',
+			'fieldset',
+			'hgroup',
+			'optgroup',
+			'text',
+		],
 		childRoles: ['row', 'select', 'toolbar', 'graphics-object'],
 	},
 	heading: {
@@ -434,7 +473,18 @@ exports.roles = {
 		childRoles: ['doc-cover'],
 	},
 	input: {
-		childRoles: ['checkbox', 'option', 'radio', 'slider', 'spinbutton', 'textbox'],
+		childRoles: [
+			'checkbox',
+			'combobox',
+			'option',
+			'radio',
+			'slider',
+			'spinbutton',
+			'textbox',
+		],
+	},
+	insertion: {
+		selectors: ['ins'],
 	},
 	landmark: {
 		childRoles: [
@@ -465,16 +515,17 @@ exports.roles = {
 		],
 	},
 	link: {
-		selectors: ['a[href]', 'area[href]', 'link[href]'],
+		selectors: ['a[href]', 'area[href]'],
 		childRoles: ['doc-backlink', 'doc-biblioref', 'doc-glossref', 'doc-noteref'],
 		nameFromContents: true,
 	},
 	list: {
-		selectors: ['dl', 'ol', 'ul'],
+		selectors: ['dl', 'ol', 'ul', 'menu'],
 		childRoles: ['directory', 'feed'],
 	},
 	listbox: {
 		selectors: [
+			'datalist',
 			'select[multiple]',
 			'select[size]:not([size="0"]):not([size="1"])',
 		],
@@ -483,7 +534,7 @@ exports.roles = {
 		},
 	},
 	listitem: {
-		selectors: ['dt', 'ul > li', 'ol > li'],
+		selectors: ['li'],
 		childRoles: ['doc-biblioentry', 'doc-endnote', 'treeitem'],
 	},
 	log: {
@@ -497,8 +548,14 @@ exports.roles = {
 	math: {
 		selectors: ['math'],
 	},
+	meter: {
+		selectors: ['meter'],
+		defaults: {
+			'valuemin': 0,
+			'valuemax': 100,
+		},
+	},
 	menu: {
-		selectors: ['menu[type="context"]'],
 		childRoles: ['menubar'],
 		defaults: {
 			'orientation': 'vertical',
@@ -510,12 +567,10 @@ exports.roles = {
 		},
 	},
 	menuitem: {
-		selectors: ['menuitem[type="command"]'],
 		childRoles: ['menuitemcheckbox'],
 		nameFromContents: true,
 	},
 	menuitemcheckbox: {
-		selectors: ['menuitem[type="checkbox"]'],
 		childRoles: ['menuitemradio'],
 		nameFromContents: true,
 		defaults: {
@@ -523,7 +578,6 @@ exports.roles = {
 		},
 	},
 	menuitemradio: {
-		selectors: ['menuitem[type="radio"]'],
 		nameFromContents: true,
 		defaults: {
 			'checked': 'false',
@@ -544,11 +598,18 @@ exports.roles = {
 			'selected': 'false',
 		},
 	},
+	paragraph: {
+		selectors: ['p'],
+	},
 	presentation: {
 		selectors: ['img[alt=""]'],
 	},
 	progressbar: {
 		selectors: ['progress'],
+		defaults: {
+			'valuemin': 0,
+			'valuemax': 100,
+		},
 	},
 	radio: {
 		selectors: ['input[type="radio"]'],
@@ -559,7 +620,7 @@ exports.roles = {
 		},
 	},
 	range: {
-		childRoles: ['progressbar', 'scrollbar', 'slider', 'spinbutton'],
+		childRoles: ['meter', 'progressbar', 'scrollbar', 'slider', 'spinbutton'],
 	},
 	region: {
 		selectors: ['section[aria-label]', 'section[aria-labelledby]', 'section[title]'],
@@ -573,7 +634,6 @@ exports.roles = {
 	},
 	rowgroup: {
 		selectors: ['tbody', 'thead', 'tfoot'],
-		nameFromContents: true,
 	},
 	rowheader: {
 		selectors: ['th[scope="row"]'],
@@ -584,29 +644,38 @@ exports.roles = {
 			'orientation': 'vertical',
 			'valuemin': 0,
 			'valuemax': 100,
-			// FIXME: halfway between actual valuemin and valuemax
-			'valuenow': 50,
 		},
 	},
+	search: {
+		selectors: ['search'],
+	},
 	searchbox: {
 		selectors: ['input[type="search"]:not([list])'],
 	},
 	section: {
 		childRoles: [
 			'alert',
+			'blockquote',
+			'caption',
 			'cell',
+			'code',
 			'definition',
+			'deletion',
 			'doc-abstract',
 			'doc-colophon',
 			'doc-credit',
 			'doc-dedication',
 			'doc-epigraph',
-			'doc-example',
 			'doc-footnote',
+			'doc-pagefooter',
+			'doc-pageheader',
+			'doc-pullquote',
 			'doc-qna',
+			'emphasis',
 			'figure',
 			'group',
 			'img',
+			'insertion',
 			'landmark',
 			'list',
 			'listitem',
@@ -614,10 +683,15 @@ exports.roles = {
 			'marquee',
 			'math',
 			'note',
+			'paragraph',
 			'status',
+			'strong',
+			'subscript',
+			'superscript',
 			'table',
 			'tabpanel',
 			'term',
+			'time',
 			'tooltip',
 		],
 	},
@@ -632,7 +706,7 @@ exports.roles = {
 		nameFromContents: true,
 	},
 	select: {
-		childRoles: ['combobox', 'listbox', 'menu', 'radiogroup', 'tree'],
+		childRoles: ['listbox', 'menu', 'radiogroup', 'tree'],
 	},
 	separator: {
 		// assume not focussable because <hr> is not
@@ -640,6 +714,8 @@ exports.roles = {
 		childRoles: ['doc-pagebreak'],
 		defaults: {
 			'orientation': 'horizontal',
+			'valuemin': 0,
+			'valuemax': 100,
 		},
 	},
 	slider: {
@@ -655,8 +731,7 @@ exports.roles = {
 	spinbutton: {
 		selectors: ['input[type="number"]'],
 		defaults: {
-			// FIXME: no valuemin/valuemax
-			'valuenow': 0,
+			// FIXME: no valuemin/valuemax/valuenow
 		},
 	},
 	status: {
@@ -667,18 +742,29 @@ exports.roles = {
 			'atomic': true,
 		},
 	},
+	strong: {
+		selectors: ['strong'],
+	},
 	structure: {
 		childRoles: [
 			'application',
 			'document',
 			'none',
+			'generic',
 			'presentation',
+			'range',
 			'rowgroup',
 			'section',
 			'sectionhead',
 			'separator',
 		],
 	},
+	subscript: {
+		selectors: ['sub'],
+	},
+	superscript: {
+		selectors: ['sup'],
+	},
 	switch: {
 		nameFromContents: true,
 		defaults: {
@@ -714,6 +800,14 @@ exports.roles = {
 		],
 		childRoles: ['searchbox'],
 	},
+	time: {
+		selectors: ['time'],
+	},
+	timer: {
+		defaults: {
+			'live': 'off',
+		},
+	},
 	toolbar: {
 		defaults: {
 			'orientation': 'horizontal',
@@ -737,8 +831,10 @@ exports.roles = {
 			'composite',
 			'gridcell',
 			'input',
-			'range',
+			'progressbar',
 			'row',
+			'scrollbar',
+			'separator',
 			'tab',
 		],
 	},
@@ -905,6 +1001,12 @@ var getName = function(el, recursive, visited, directReference) {
 			}
 		}
 	}
+	if (!ret.trim() && el.matches('svg *')) {
+		var svgTitle = el.querySelector('title');
+		if (svgTitle && svgTitle.parentElement === el) {
+			ret = svgTitle.textContent;
+		}
+	}
 
 	// E
 	if (!ret.trim() && (recursive || isInLabelForOtherWidget(el) || query.matches(el, 'button'))) {
@@ -972,10 +1074,15 @@ var getDescription = function(el) {
 			return label ? getName(label, true) : '';
 		});
 		ret = strings.join(' ');
+	} else if (el.matches('[aria-description]')) {
+		ret = el.getAttribute('aria-description');
+	} else if (el.matches('svg *')) {
+		var svgDesc = el.querySelector('desc');
+		if (svgDesc && svgDesc.parentElement === el) {
+			ret = svgDesc.textContent;
+		}
 	} else if (el.title) {
 		ret = el.title;
-	} else if (el.placeholder) {
-		ret = el.placeholder;
 	}
 
 	ret = (ret || '').trim().replace(/\s+/g, ' ');

package/lib/attrs.js

@@ -3,22 +3,26 @@ var constants = require('./constants.js');
 // candidates can be passed for performance optimization
 var getRole = function(el, candidates) {
 	if (el.hasAttribute('role')) {
-		var role = el.getAttribute('role');
-		if (!candidates || candidates.includes(role)) {
-			return role;
-		} else {
-			return;
+		var roles = el.getAttribute('role').toLowerCase().split(/\s+/);
+		if (roles.length > 1 && candidates) {
+			return [roles, candidates];
 		}
-	}
-	var roles = candidates ? candidates : Object.keys(constants.roles);
-	for (var role of roles) {
-		var r = constants.roles[role];
-		if (r) {
-			var selector = (r.selectors || []).join(',');
-			if (selector && el.matches(selector)) {
+		for (var role of roles) {
+			if (!candidates || candidates.includes(role)) {
 				return role;
 			}
 		}
+	} else {
+		var roles = candidates ? candidates : Object.keys(constants.roles);
+		for (var role of roles) {
+			var r = constants.roles[role];
+			if (r) {
+				var selector = (r.selectors || []).join(',');
+				if (selector && el.matches(selector)) {
+					return role;
+				}
+			}
+		}
 	}
 };
 

package/lib/constants.js

@@ -66,13 +66,8 @@ exports.attributeWeakMapping = {
 	'selected': 'selected',
 };
 
-var scoped = [
-	'main *',
-	// https://www.w3.org/TR/html/dom.html#sectioning-content-2
-	'article *', 'aside *', 'nav *', 'section *',
-	// https://www.w3.org/TR/html/sections.html#sectioning-roots
-	'blockquote *', 'details *', 'dialog *', 'fieldset *', 'figure *', 'td *',
-].join(',');
+// https://www.w3.org/TR/html/dom.html#sectioning-content-2
+var scoped = ['article *', 'aside *', 'nav *', 'section *'].join(',');
 
 // https://www.w3.org/TR/html-aam-1.0/#html-element-role-mappings
 // https://www.w3.org/TR/wai-aria/roles
@@ -88,7 +83,10 @@ exports.roles = {
 		selectors: ['article'],
 	},
 	banner: {
-		selectors: ['header:not(' + scoped + ')'],
+		selectors: [`header:not(main *, ${scoped})`],
+	},
+	blockquote: {
+		selectors: ['blockquote'],
 	},
 	button: {
 		selectors: [
@@ -101,26 +99,32 @@ exports.roles = {
 		],
 		nameFromContents: true,
 	},
+	caption: {
+		selectors: ['caption', 'figcaption'],
+	},
 	cell: {
-		selectors: ['td'],
-		childRoles: ['gridcell', 'rowheader'],
+		selectors: ['td', 'th:not([scope])'],
+		childRoles: ['columnheader', 'gridcell', 'rowheader'],
 		nameFromContents: true,
 	},
 	checkbox: {
 		selectors: ['input[type="checkbox"]'],
-		childRoles: ['menuitemcheckbox', 'switch'],
+		childRoles: ['switch'],
 		nameFromContents: true,
 		defaults: {
 			'checked': 'false',
 		},
 	},
+	code: {
+		selectors: ['code'],
+	},
 	columnheader: {
 		selectors: ['th[scope="col"]'],
 		nameFromContents: true,
 	},
 	combobox: {
 		selectors: [
-		'input:not([type])[list]',
+			'input:not([type])[list]',
 			'input[type="email"][list]',
 			'input[type="search"][list]',
 			'input[type="tel"][list]',
@@ -139,17 +143,25 @@ exports.roles = {
 		childRoles: ['button', 'link', 'menuitem'],
 	},
 	complementary: {
-		selectors: ['aside'],
+		selectors: [
+			`aside:not(${scoped})`,
+			'aside[aria-label]',
+			'aside[aria-labelledby]',
+			'aside[title]',
+		],
 	},
 	composite: {
 		childRoles: ['grid', 'select', 'spinbutton', 'tablist'],
 	},
 	contentinfo: {
-		selectors: ['footer:not(' + scoped + ')'],
+		selectors: [`footer:not(main *, ${scoped})`],
 	},
 	definition: {
 		selectors: ['dd'],
 	},
+	deletion: {
+		selectors: ['del', 's'],
+	},
 	dialog: {
 		selectors: ['dialog'],
 		childRoles: ['alertdialog'],
@@ -166,16 +178,32 @@ exports.roles = {
 	'doc-noteref': {
 		nameFromContents: true,
 	},
+	'doc-pagebreak': {
+		nameFromContents: true,
+	},
+	'doc-subtitle': {
+		nameFromContents: true,
+	},
 	document: {
-		selectors: ['body'],
+		selectors: ['html'],
 		childRoles: ['article', 'graphics-document'],
 	},
+	emphasis: {
+		selectors: ['em'],
+	},
 	figure: {
 		selectors: ['figure'],
+		childRoles: ['doc-example'],
 	},
 	form: {
 		selectors: ['form[aria-label]', 'form[aria-labelledby]', 'form[title]'],
 	},
+	generic: {
+		// too many selectors to list
+	},
+	'graphics-document': {
+		selectors: ['svg'],
+	},
 	grid: {
 		childRoles: ['treegrid'],
 	},
@@ -184,7 +212,14 @@ exports.roles = {
 		nameFromContents: true,
 	},
 	group: {
-		selectors: ['details', 'optgroup'],
+		selectors: [
+			'address',
+			'details',
+			'fieldset',
+			'hgroup',
+			'optgroup',
+			'text',
+		],
 		childRoles: ['row', 'select', 'toolbar', 'graphics-object'],
 	},
 	heading: {
@@ -199,7 +234,18 @@ exports.roles = {
 		childRoles: ['doc-cover'],
 	},
 	input: {
-		childRoles: ['checkbox', 'option', 'radio', 'slider', 'spinbutton', 'textbox'],
+		childRoles: [
+			'checkbox',
+			'combobox',
+			'option',
+			'radio',
+			'slider',
+			'spinbutton',
+			'textbox',
+		],
+	},
+	insertion: {
+		selectors: ['ins'],
 	},
 	landmark: {
 		childRoles: [
@@ -230,16 +276,17 @@ exports.roles = {
 		],
 	},
 	link: {
-		selectors: ['a[href]', 'area[href]', 'link[href]'],
+		selectors: ['a[href]', 'area[href]'],
 		childRoles: ['doc-backlink', 'doc-biblioref', 'doc-glossref', 'doc-noteref'],
 		nameFromContents: true,
 	},
 	list: {
-		selectors: ['dl', 'ol', 'ul'],
+		selectors: ['dl', 'ol', 'ul', 'menu'],
 		childRoles: ['directory', 'feed'],
 	},
 	listbox: {
 		selectors: [
+			'datalist',
 			'select[multiple]',
 			'select[size]:not([size="0"]):not([size="1"])',
 		],
@@ -248,7 +295,7 @@ exports.roles = {
 		},
 	},
 	listitem: {
-		selectors: ['dt', 'ul > li', 'ol > li'],
+		selectors: ['li'],
 		childRoles: ['doc-biblioentry', 'doc-endnote', 'treeitem'],
 	},
 	log: {
@@ -262,8 +309,14 @@ exports.roles = {
 	math: {
 		selectors: ['math'],
 	},
+	meter: {
+		selectors: ['meter'],
+		defaults: {
+			'valuemin': 0,
+			'valuemax': 100,
+		},
+	},
 	menu: {
-		selectors: ['menu[type="context"]'],
 		childRoles: ['menubar'],
 		defaults: {
 			'orientation': 'vertical',
@@ -275,12 +328,10 @@ exports.roles = {
 		},
 	},
 	menuitem: {
-		selectors: ['menuitem[type="command"]'],
 		childRoles: ['menuitemcheckbox'],
 		nameFromContents: true,
 	},
 	menuitemcheckbox: {
-		selectors: ['menuitem[type="checkbox"]'],
 		childRoles: ['menuitemradio'],
 		nameFromContents: true,
 		defaults: {
@@ -288,7 +339,6 @@ exports.roles = {
 		},
 	},
 	menuitemradio: {
-		selectors: ['menuitem[type="radio"]'],
 		nameFromContents: true,
 		defaults: {
 			'checked': 'false',
@@ -309,11 +359,18 @@ exports.roles = {
 			'selected': 'false',
 		},
 	},
+	paragraph: {
+		selectors: ['p'],
+	},
 	presentation: {
 		selectors: ['img[alt=""]'],
 	},
 	progressbar: {
 		selectors: ['progress'],
+		defaults: {
+			'valuemin': 0,
+			'valuemax': 100,
+		},
 	},
 	radio: {
 		selectors: ['input[type="radio"]'],
@@ -324,7 +381,7 @@ exports.roles = {
 		},
 	},
 	range: {
-		childRoles: ['progressbar', 'scrollbar', 'slider', 'spinbutton'],
+		childRoles: ['meter', 'progressbar', 'scrollbar', 'slider', 'spinbutton'],
 	},
 	region: {
 		selectors: ['section[aria-label]', 'section[aria-labelledby]', 'section[title]'],
@@ -338,7 +395,6 @@ exports.roles = {
 	},
 	rowgroup: {
 		selectors: ['tbody', 'thead', 'tfoot'],
-		nameFromContents: true,
 	},
 	rowheader: {
 		selectors: ['th[scope="row"]'],
@@ -349,29 +405,38 @@ exports.roles = {
 			'orientation': 'vertical',
 			'valuemin': 0,
 			'valuemax': 100,
-			// FIXME: halfway between actual valuemin and valuemax
-			'valuenow': 50,
 		},
 	},
+	search: {
+		selectors: ['search'],
+	},
 	searchbox: {
 		selectors: ['input[type="search"]:not([list])'],
 	},
 	section: {
 		childRoles: [
 			'alert',
+			'blockquote',
+			'caption',
 			'cell',
+			'code',
 			'definition',
+			'deletion',
 			'doc-abstract',
 			'doc-colophon',
 			'doc-credit',
 			'doc-dedication',
 			'doc-epigraph',
-			'doc-example',
 			'doc-footnote',
+			'doc-pagefooter',
+			'doc-pageheader',
+			'doc-pullquote',
 			'doc-qna',
+			'emphasis',
 			'figure',
 			'group',
 			'img',
+			'insertion',
 			'landmark',
 			'list',
 			'listitem',
@@ -379,10 +444,15 @@ exports.roles = {
 			'marquee',
 			'math',
 			'note',
+			'paragraph',
 			'status',
+			'strong',
+			'subscript',
+			'superscript',
 			'table',
 			'tabpanel',
 			'term',
+			'time',
 			'tooltip',
 		],
 	},
@@ -397,7 +467,7 @@ exports.roles = {
 		nameFromContents: true,
 	},
 	select: {
-		childRoles: ['combobox', 'listbox', 'menu', 'radiogroup', 'tree'],
+		childRoles: ['listbox', 'menu', 'radiogroup', 'tree'],
 	},
 	separator: {
 		// assume not focussable because <hr> is not
@@ -405,6 +475,8 @@ exports.roles = {
 		childRoles: ['doc-pagebreak'],
 		defaults: {
 			'orientation': 'horizontal',
+			'valuemin': 0,
+			'valuemax': 100,
 		},
 	},
 	slider: {
@@ -420,8 +492,7 @@ exports.roles = {
 	spinbutton: {
 		selectors: ['input[type="number"]'],
 		defaults: {
-			// FIXME: no valuemin/valuemax
-			'valuenow': 0,
+			// FIXME: no valuemin/valuemax/valuenow
 		},
 	},
 	status: {
@@ -432,18 +503,29 @@ exports.roles = {
 			'atomic': true,
 		},
 	},
+	strong: {
+		selectors: ['strong'],
+	},
 	structure: {
 		childRoles: [
 			'application',
 			'document',
 			'none',
+			'generic',
 			'presentation',
+			'range',
 			'rowgroup',
 			'section',
 			'sectionhead',
 			'separator',
 		],
 	},
+	subscript: {
+		selectors: ['sub'],
+	},
+	superscript: {
+		selectors: ['sup'],
+	},
 	switch: {
 		nameFromContents: true,
 		defaults: {
@@ -479,6 +561,14 @@ exports.roles = {
 		],
 		childRoles: ['searchbox'],
 	},
+	time: {
+		selectors: ['time'],
+	},
+	timer: {
+		defaults: {
+			'live': 'off',
+		},
+	},
 	toolbar: {
 		defaults: {
 			'orientation': 'horizontal',
@@ -502,8 +592,10 @@ exports.roles = {
 			'composite',
 			'gridcell',
 			'input',
-			'range',
+			'progressbar',
 			'row',
+			'scrollbar',
+			'separator',
 			'tab',
 		],
 	},

package/lib/name.js

@@ -111,6 +111,12 @@ var getName = function(el, recursive, visited, directReference) {
 			}
 		}
 	}
+	if (!ret.trim() && el.matches('svg *')) {
+		var svgTitle = el.querySelector('title');
+		if (svgTitle && svgTitle.parentElement === el) {
+			ret = svgTitle.textContent;
+		}
+	}
 
 	// E
 	if (!ret.trim() && (recursive || isInLabelForOtherWidget(el) || query.matches(el, 'button'))) {
@@ -178,10 +184,15 @@ var getDescription = function(el) {
 			return label ? getName(label, true) : '';
 		});
 		ret = strings.join(' ');
+	} else if (el.matches('[aria-description]')) {
+		ret = el.getAttribute('aria-description');
+	} else if (el.matches('svg *')) {
+		var svgDesc = el.querySelector('desc');
+		if (svgDesc && svgDesc.parentElement === el) {
+			ret = svgDesc.textContent;
+		}
 	} else if (el.title) {
 		ret = el.title;
-	} else if (el.placeholder) {
-		ret = el.placeholder;
 	}
 
 	ret = (ret || '').trim().replace(/\s+/g, ' ');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aria-api",
-  "version": "0.4.7",
+  "version": "0.5.0",
   "description": "Access ARIA information from JavaScript",
   "main": "index.js",
   "keywords": [
@@ -14,8 +14,8 @@
     "brfs": "^2.0.0",
     "browserify": "^17.0.0",
     "expect": "^1.20.2",
-    "mocha": "^9.0.1",
-    "mocha-headless-chrome": "^3.1.0"
+    "mocha": "^10.2.0",
+    "mocha-headless-chrome": "^4.0.0"
   },
   "files": [
     "index.js",