aria-api 0.4.7 → 0.6.0

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
+const 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
@@ -84,11 +79,16 @@ exports.roles = {
 			'atomic': true,
 		},
 	},
+	alertdialog: {},
+	application: {},
 	article: {
 		selectors: ['article'],
 	},
 	banner: {
-		selectors: ['header:not(' + scoped + ')'],
+		selectors: [`header:not(main *, ${scoped})`],
+	},
+	blockquote: {
+		selectors: ['blockquote'],
 	},
 	button: {
 		selectors: [
@@ -101,26 +101,32 @@ exports.roles = {
 		],
 		nameFromContents: true,
 	},
+	caption: {
+		selectors: ['caption', 'figcaption'],
+	},
 	cell: {
-		selectors: ['td'],
-		childRoles: ['gridcell', 'rowheader'],
+		selectors: ['td', '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]',
@@ -136,46 +142,131 @@ exports.roles = {
 		},
 	},
 	command: {
+		abstract: true,
 		childRoles: ['button', 'link', 'menuitem'],
 	},
 	complementary: {
-		selectors: ['aside'],
+		selectors: [
+			`aside:not(${scoped})`,
+			'aside[aria-label]',
+			'aside[aria-labelledby]',
+			'aside[title]',
+		],
 	},
 	composite: {
+		abstract: true,
 		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'],
 	},
+	'doc-abstract': {},
+	'doc-acknowledgments': {},
+	'doc-afterword': {},
+	'doc-appendix': {},
 	'doc-backlink': {
 		nameFromContents: true,
 	},
+	'doc-biblioentry': {},
+	'doc-bibliography': {},
 	'doc-biblioref': {
 		nameFromContents: true,
 	},
+	'doc-chapter': {},
+	'doc-colophon': {},
+	'doc-conclusion': {},
+	'doc-cover': {},
+	'doc-credit': {},
+	'doc-credits': {},
+	'doc-dedication': {},
+	'doc-endnote': {},
+	'doc-endnotes': {},
+	'doc-epilogue': {},
+	'doc-epigraph': {},
+	'doc-errata': {},
+	'doc-example': {},
+	'doc-footnote': {},
+	'doc-foreword': {},
+	'doc-glossary': {},
 	'doc-glossref': {
 		nameFromContents: true,
 	},
+	'doc-index': {},
+	'doc-introduction': {},
 	'doc-noteref': {
 		nameFromContents: true,
 	},
+	'doc-notice': {},
+	'doc-pagebreak': {
+		nameFromContents: true,
+	},
+	'doc-pagefooter': {},
+	'doc-pageheader': {},
+	'doc-pagelist': {},
+	'doc-part': {},
+	'doc-preface': {},
+	'doc-prologue': {},
+	'doc-pullquote': {},
+	'doc-qna': {},
+	'doc-subtitle': {
+		nameFromContents: true,
+	},
+	'doc-tip': {},
+	'doc-toc': {},
 	document: {
-		selectors: ['body'],
+		selectors: ['html'],
 		childRoles: ['article', 'graphics-document'],
 	},
+	emphasis: {
+		selectors: ['em'],
+	},
+	feed: {},
 	figure: {
 		selectors: ['figure'],
+		childRoles: ['doc-example'],
 	},
 	form: {
 		selectors: ['form[aria-label]', 'form[aria-labelledby]', 'form[title]'],
 	},
+	generic: {
+		selectors: [
+			'a:not([href])',
+			'area:not([href])',
+			`aside:not(${scoped}):not([aria-label]):not([aria-labelledby]):not([title])`,
+			'b',
+			'bdi',
+			'bdo',
+			'body',
+			'data',
+			'div',
+			// footer scoped
+			// header scoped
+			'i',
+			'li:not(ul > li):not(ol > li)',
+			'pre',
+			'q',
+			'samp',
+			'section:not([aria-label]):not([aria-labelledby]):not([title])',
+			'small',
+			'span',
+			'u',
+		],
+	},
+	'graphics-document': {
+		selectors: ['svg'],
+	},
+	'graphics-object': {},
+	'graphics-symbol': {},
 	grid: {
 		childRoles: ['treegrid'],
 	},
@@ -184,7 +275,14 @@ exports.roles = {
 		nameFromContents: true,
 	},
 	group: {
-		selectors: ['details', 'optgroup'],
+		selectors: [
+			'address',
+			'details',
+			'fieldset',
+			'hgroup',
+			'optgroup',
+			'text',
+		],
 		childRoles: ['row', 'select', 'toolbar', 'graphics-object'],
 	},
 	heading: {
@@ -199,9 +297,22 @@ exports.roles = {
 		childRoles: ['doc-cover'],
 	},
 	input: {
-		childRoles: ['checkbox', 'option', 'radio', 'slider', 'spinbutton', 'textbox'],
+		abstract: true,
+		childRoles: [
+			'checkbox',
+			'combobox',
+			'option',
+			'radio',
+			'slider',
+			'spinbutton',
+			'textbox',
+		],
+	},
+	insertion: {
+		selectors: ['ins'],
 	},
 	landmark: {
+		abstract: true,
 		childRoles: [
 			'banner',
 			'complementary',
@@ -230,16 +341,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'],
-		childRoles: ['directory', 'feed'],
+		selectors: ['dl', 'ol', 'ul', 'menu'],
+		childRoles: ['feed'],
 	},
 	listbox: {
 		selectors: [
+			'datalist',
 			'select[multiple]',
 			'select[size]:not([size="0"]):not([size="1"])',
 		],
@@ -248,7 +360,7 @@ exports.roles = {
 		},
 	},
 	listitem: {
-		selectors: ['dt', 'ul > li', 'ol > li'],
+		selectors: ['ol > li', 'ul > li'],
 		childRoles: ['doc-biblioentry', 'doc-endnote', 'treeitem'],
 	},
 	log: {
@@ -259,11 +371,18 @@ exports.roles = {
 	main: {
 		selectors: ['main'],
 	},
+	marquee: {},
 	math: {
 		selectors: ['math'],
 	},
+	meter: {
+		selectors: ['meter'],
+		defaults: {
+			'valuemin': 0,
+			'valuemax': 100,
+		},
+	},
 	menu: {
-		selectors: ['menu[type="context"]'],
 		childRoles: ['menubar'],
 		defaults: {
 			'orientation': 'vertical',
@@ -275,12 +394,10 @@ exports.roles = {
 		},
 	},
 	menuitem: {
-		selectors: ['menuitem[type="command"]'],
 		childRoles: ['menuitemcheckbox'],
 		nameFromContents: true,
 	},
 	menuitemcheckbox: {
-		selectors: ['menuitem[type="checkbox"]'],
 		childRoles: ['menuitemradio'],
 		nameFromContents: true,
 		defaults: {
@@ -288,7 +405,6 @@ exports.roles = {
 		},
 	},
 	menuitemradio: {
-		selectors: ['menuitem[type="radio"]'],
 		nameFromContents: true,
 		defaults: {
 			'checked': 'false',
@@ -298,6 +414,9 @@ exports.roles = {
 		selectors: ['nav'],
 		childRoles: ['doc-index', 'doc-pagelist', 'doc-toc'],
 	},
+	none: {
+		selectors: ['img[alt=""]'],
+	},
 	note: {
 		childRoles: ['doc-notice', 'doc-tip'],
 	},
@@ -309,11 +428,15 @@ exports.roles = {
 			'selected': 'false',
 		},
 	},
-	presentation: {
-		selectors: ['img[alt=""]'],
+	paragraph: {
+		selectors: ['p'],
 	},
 	progressbar: {
 		selectors: ['progress'],
+		defaults: {
+			'valuemin': 0,
+			'valuemax': 100,
+		},
 	},
 	radio: {
 		selectors: ['input[type="radio"]'],
@@ -323,13 +446,16 @@ exports.roles = {
 			'checked': 'false',
 		},
 	},
+	radiogroup: {},
 	range: {
-		childRoles: ['progressbar', 'scrollbar', 'slider', 'spinbutton'],
+		abstract: true,
+		childRoles: ['meter', 'progressbar', 'scrollbar', 'slider', 'spinbutton'],
 	},
 	region: {
 		selectors: ['section[aria-label]', 'section[aria-labelledby]', 'section[title]'],
 	},
 	roletype: {
+		abstract: true,
 		childRoles: ['structure', 'widget', 'window'],
 	},
 	row: {
@@ -338,10 +464,9 @@ exports.roles = {
 	},
 	rowgroup: {
 		selectors: ['tbody', 'thead', 'tfoot'],
-		nameFromContents: true,
 	},
 	rowheader: {
-		selectors: ['th[scope="row"]'],
+		selectors: ['th[scope="row"]', 'th:not([scope]):not(td ~ th)'],
 		nameFromContents: true,
 	},
 	scrollbar: {
@@ -349,29 +474,39 @@ 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: {
+		abstract: true,
 		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,14 +514,20 @@ exports.roles = {
 			'marquee',
 			'math',
 			'note',
+			'paragraph',
 			'status',
+			'strong',
+			'subscript',
+			'superscript',
 			'table',
 			'tabpanel',
 			'term',
+			'time',
 			'tooltip',
 		],
 	},
 	sectionhead: {
+		abstract: true,
 		childRoles: [
 			'columnheader',
 			'doc-subtitle',
@@ -397,7 +538,8 @@ exports.roles = {
 		nameFromContents: true,
 	},
 	select: {
-		childRoles: ['combobox', 'listbox', 'menu', 'radiogroup', 'tree'],
+		abstract: true,
+		childRoles: ['listbox', 'menu', 'radiogroup', 'tree'],
 	},
 	separator: {
 		// assume not focussable because <hr> is not
@@ -405,6 +547,8 @@ exports.roles = {
 		childRoles: ['doc-pagebreak'],
 		defaults: {
 			'orientation': 'horizontal',
+			'valuemin': 0,
+			'valuemax': 100,
 		},
 	},
 	slider: {
@@ -420,8 +564,7 @@ exports.roles = {
 	spinbutton: {
 		selectors: ['input[type="number"]'],
 		defaults: {
-			// FIXME: no valuemin/valuemax
-			'valuenow': 0,
+			// FIXME: no valuemin/valuemax/valuenow
 		},
 	},
 	status: {
@@ -432,18 +575,30 @@ exports.roles = {
 			'atomic': true,
 		},
 	},
+	strong: {
+		selectors: ['strong'],
+	},
 	structure: {
+		abstract: true,
 		childRoles: [
 			'application',
 			'document',
 			'none',
-			'presentation',
+			'generic',
+			'range',
 			'rowgroup',
 			'section',
 			'sectionhead',
 			'separator',
 		],
 	},
+	suggestion: {},
+	subscript: {
+		selectors: ['sub'],
+	},
+	superscript: {
+		selectors: ['sup'],
+	},
 	switch: {
 		nameFromContents: true,
 		defaults: {
@@ -465,6 +620,7 @@ exports.roles = {
 			'orientation': 'horizontal',
 		},
 	},
+	tabpanel: {},
 	term: {
 		selectors: ['dfn', 'dt'],
 	},
@@ -479,6 +635,14 @@ exports.roles = {
 		],
 		childRoles: ['searchbox'],
 	},
+	time: {
+		selectors: ['time'],
+	},
+	timer: {
+		defaults: {
+			'live': 'off',
+		},
+	},
 	toolbar: {
 		defaults: {
 			'orientation': 'horizontal',
@@ -493,30 +657,35 @@ exports.roles = {
 			'orientation': 'vertical',
 		},
 	},
+	treegrid: {},
 	treeitem: {
 		nameFromContents: true,
 	},
 	widget: {
+		abstract: true,
 		childRoles: [
 			'command',
 			'composite',
 			'gridcell',
 			'input',
-			'range',
+			'progressbar',
 			'row',
+			'scrollbar',
+			'separator',
 			'tab',
 		],
 	},
 	window: {
+		abstract: true,
 		childRoles: ['dialog'],
 	},
 };
 
-var getSubRoles = function(role) {
-	var children = (exports.roles[role] || {}).childRoles || [];
-	var descendents = children.map(getSubRoles);
+const getSubRoles = function(role) {
+	const children = (exports.roles[role]).childRoles || [];
+	const descendents = children.map(getSubRoles);
 
-	var result = [role];
+	const result = [role];
 
 	descendents.forEach(list => {
 		list.forEach(r => {
@@ -531,18 +700,19 @@ var getSubRoles = function(role) {
 
 exports.attrsWithDefaults = [];
 
-for (var role in exports.roles) {
+for (const role in exports.roles) {
 	exports.roles[role].subRoles = getSubRoles(role);
-	for (var key in exports.roles[role].defaults) {
+	for (const key in exports.roles[role].defaults) {
 		if (!exports.attrsWithDefaults.includes(key)) {
 			exports.attrsWithDefaults.push(key);
 		}
 	}
 }
-exports.roles['none'] = exports.roles['none'] || {};
-exports.roles['none'].subRoles = ['none', 'presentation'];
-exports.roles['presentation'] = exports.roles['presentation'] || {};
-exports.roles['presentation'].subRoles = ['presentation', 'none'];
+
+exports.aliases = {
+	'presentation': 'none',
+	'directory': 'list',
+};
 
 exports.nameFromDescendant = {
 	'figure': 'figcaption',