apex4x
Version:
The Comprehensive ARIA Development Suite
1,438 lines (1,361 loc) • 57.8 kB
JavaScript
/*@license
CalcNames: The AccName Computation Prototype, compute the Name and Description property values for a DOM node
Returns an object with 'name' and 'desc' properties.
Functionality mirrors the steps within the W3C Accessible Name and Description computation algorithm.
https://w3c.github.io/accname/
Author: Bryan Garaventa
https://github.com/whatsock/w3c-alternative-text-computation
Distributed under the terms of the Open Source Initiative OSI - MIT License
*/
(function () {
var nameSpace = window.AccNamePrototypeNameSpace || window;
if (nameSpace && typeof nameSpace === "string" && nameSpace.length) {
window[nameSpace] = {};
nameSpace = window[nameSpace];
}
nameSpace.getAccNameVersion = "2.62";
// AccName Computation Prototype
nameSpace.getAccName = nameSpace.calcNames = function (
node,
fnc,
preventVisualARIASelfCSSRef,
overrides,
) {
overrides = overrides || {};
var docO = overrides.document || document;
var props = { name: "", desc: "", error: "" };
var nameFromPlaceholder = false;
var nameFromUserAgent = false;
try {
if (!node || node.nodeType !== 1) {
return props;
}
var rootNode = node;
var rootRole = trim(node.getAttribute("role") || "");
// Track nodes to prevent duplicate node reference parsing.
// Separating Name and Description to prevent duplicate node references from suppressing one or the other from being fully computed.
var nodes = {
name: [],
desc: [],
};
// Track aria-owns references to prevent duplicate parsing.
var owns = [];
// Recursively process a DOM node to compute an accessible name in accordance with the spec
var walk = function (
refNode,
stop,
skip,
nodesToIgnoreValues,
skipAbort,
ownedBy,
skipTo,
) {
skipTo = skipTo || {};
skipTo.tag = skipTo.tag || false;
skipTo.role = skipTo.role || false;
skipTo.go = skipTo.go || false;
var fullResult = {
name: "",
title: "",
};
var hasLabel = false;
/*
ARIA Role Exception Rule Set 1.1
The following Role Exception Rule Set is based on the following ARIA Working Group discussion involving all relevant browser venders.
https://lists.w3.org/Archives/Public/public-aria/2017Jun/0057.html
Plus roles extended for the Role Parity project.
*/
var isException = function (node, refNode) {
if (
!refNode ||
!node ||
refNode.nodeType !== 1 ||
node.nodeType !== 1
) {
return false;
}
var role = getRole(node);
var tag = node.nodeName.toLowerCase();
var inList = function (node, list) {
return (
(role && list.roles.indexOf(role) >= 0) ||
(!role && list.tags.indexOf(tag) >= 0)
);
};
// The list3 overrides must be checked first.
if (inList(node, list3)) {
if (
node === refNode &&
!(node.id && ownedBy[node.id] && ownedBy[node.id].node)
) {
return !isFocusable(node);
} else {
// Note: the inParent checker needs to be present to allow for embedded roles matching list3 when the referenced parent is referenced using aria-labelledby, aria-describedby, or aria-owns.
return !(
(inParent(node, ownedBy.top) &&
node.nodeName.toLowerCase() !== "select") ||
inList(refNode, list1)
);
}
}
// Otherwise process list2 to identify roles to ignore processing name from content.
else {
return !!(
(inList(node, list2) ||
(node === rootNode && !inList(node, list1))) &&
!(
!role &&
["section"].indexOf(tag) !== -1 &&
!(
node.getAttribute("aria-labelledby") ||
node.getAttribute("aria-label")
)
) &&
!skipTo.go
);
}
};
var inParent = function (node, parent) {
var trackNodes = [];
while (node) {
if (
node.id &&
ownedBy[node.id] &&
ownedBy[node.id].node &&
trackNodes.indexOf(node) === -1
) {
trackNodes.push(node);
node = ownedBy[node.id].node;
} else {
node = node.parentNode;
}
if (node && node === parent) {
return true;
} else if (!node || node === ownedBy.top || node === docO.body) {
return false;
}
}
return false;
};
// Placeholder for storing CSS before and after pseudo element text values for the top level node
var cssOP = {
before: "",
after: "",
};
if (
!skipTo.tag &&
!skipTo.role &&
nodes[!ownedBy.computingDesc ? "name" : "desc"].indexOf(refNode) ===
-1
) {
// Store the before and after pseudo element 'content' values for the top level DOM node
// Note: If the pseudo element includes block level styling, a space will be added, otherwise inline is asumed and no spacing is added.
cssOP = getCSSText(refNode, null);
// Enabled in Visual ARIA to prevent self referencing by Visual ARIA tooltips
if (preventVisualARIASelfCSSRef) {
if (
cssOP.before.indexOf(" [ARIA] ") !== -1 ||
cssOP.before.indexOf(" aria-") !== -1 ||
cssOP.before.indexOf(" accName: ") !== -1
)
cssOP.before = "";
if (
cssOP.after.indexOf(" [ARIA] ") !== -1 ||
cssOP.after.indexOf(" aria-") !== -1 ||
cssOP.after.indexOf(" accDescription: ") !== -1
)
cssOP.after = "";
}
}
// Recursively apply the same naming computation to all nodes within the referenced structure
var walkDOM = function (node, fn, refNode) {
var res = {
name: "",
title: "",
};
if (!node) {
return res;
}
var nodeIsBlock = !!(
node &&
node.nodeType === 1 &&
isBlockLevelElement(node)
);
var currentNode = node;
var fResult = fn(node) || {};
if (fResult.name && fResult.name.length) {
res.name += fResult.name;
}
if (!fResult.skip && !isException(node, ownedBy.top)) {
if (skipTo.go) skipTo.go = false;
node = node.firstChild;
while (node) {
res.name += walkDOM(node, fn, refNode).name;
node = node.nextSibling;
}
}
res.name += fResult.owns || "";
if (
rootNode === currentNode &&
refNode === currentNode &&
!trim(res.name) &&
trim(fResult.title)
) {
res.name = addSpacing(fResult.title);
} else if (
rootNode === currentNode &&
refNode === currentNode &&
trim(fResult.title)
) {
res.title = addSpacing(fResult.title);
}
if (
rootNode === currentNode &&
refNode === currentNode &&
trim(fResult.desc)
) {
res.title = addSpacing(fResult.desc);
}
if (
rootNode === currentNode &&
refNode === currentNode &&
trim(fResult.placeholder) &&
!trim(res.name)
) {
res.name = addSpacing(fResult.placeholder);
nameFromPlaceholder = true;
} else if (
rootNode === currentNode &&
refNode === currentNode &&
trim(fResult.placeholder) &&
!trim(res.title)
) {
res.title = addSpacing(fResult.placeholder);
}
if (nodeIsBlock || fResult.isWidget) {
res.name = addSpacing(res.name);
}
return res;
};
fullResult = walkDOM(
refNode,
function (node) {
var i = 0;
var element = null;
var ids = [];
var parts = [];
var result = {
name: "",
title: "",
owns: "",
skip: false,
};
var isEmbeddedNode = !!(
node &&
node.nodeType === 1 &&
nodesToIgnoreValues &&
nodesToIgnoreValues.length &&
nodesToIgnoreValues.indexOf(node) !== -1 &&
node === rootNode &&
node !== refNode
);
var hLabel = false;
if (
(skip || !node || isHidden(node, ownedBy.top)) &&
!skipAbort &&
!isEmbeddedNode
) {
// Abort if algorithm step is already completed, or if node is a hidden child of refNode, or skip abort if aria-labelledby self references same node.
return result;
}
if (
!skipTo.tag &&
!skipTo.role &&
nodes[!ownedBy.computingDesc ? "name" : "desc"].indexOf(node) ===
-1
) {
nodes[!ownedBy.computingDesc ? "name" : "desc"].push(node);
} else {
// Abort if this node has already been processed.
return result;
}
// Store name for the current node.
var name = "";
// Store name from aria-owns references if detected.
var ariaO = "";
// Placeholder for storing CSS before and after pseudo element text values for the current node container element
var cssO = {
before: "",
after: "",
};
var parent = refNode === node ? node : node.parentNode;
if (
!skipTo.tag &&
!skipTo.role &&
nodes[!ownedBy.computingDesc ? "name" : "desc"].indexOf(
parent,
) === -1
) {
nodes[!ownedBy.computingDesc ? "name" : "desc"].push(parent);
// Store the before and after pseudo element 'content' values for the current node container element
// Note: If the pseudo element includes block level styling, a space will be added, otherwise inline is asumed and no spacing is added.
cssO = getCSSText(parent, refNode);
// Enabled in Visual ARIA to prevent self referencing by Visual ARIA tooltips
if (preventVisualARIASelfCSSRef) {
if (
cssO.before.indexOf(" [ARIA] ") !== -1 ||
cssO.before.indexOf(" aria-") !== -1 ||
cssO.before.indexOf(" accName: ") !== -1
)
cssO.before = "";
if (
cssO.after.indexOf(" [ARIA] ") !== -1 ||
cssO.after.indexOf(" aria-") !== -1 ||
cssO.after.indexOf(" accDescription: ") !== -1
)
cssO.after = "";
}
}
// Process standard DOM element node
if (node.nodeType === 1) {
var nTag = node.nodeName.toLowerCase();
var nRole = getRole(node);
var aLabelledby =
(!skipTo.tag &&
!skipTo.role &&
node.getAttribute("aria-labelledby")) ||
"";
var aDescribedby =
(!skipTo.tag &&
!skipTo.role &&
node.getAttribute("aria-describedby")) ||
"";
var aDescription =
!skipTo.tag &&
!skipTo.role &&
node.getAttribute("aria-description");
var aLabel =
(!skipTo.tag &&
!skipTo.role &&
node.getAttribute("aria-label")) ||
"";
var nTitle =
(!skipTo.tag && !skipTo.role && node.getAttribute("title")) ||
"";
// Added to prevent name on generic elements.
// https://www.w3.org/TR/wai-aria-1.2/#generic
var isGeneric =
node === rootNode &&
!nRole &&
genericElements.indexOf(nTag) !== -1;
if (isGeneric) {
// Abort since an implicitly generic rootNode cannot have a name
return result;
}
// Added to prevent name on roles that do not support a name.
// https://www.w3.org/TR/wai-aria-1.2/#namefromprohibited
var isProhibited =
node === rootNode &&
(nameProhibitedRoles.indexOf(nRole) !== -1 ||
(!nRole && nameProhibitedElements.indexOf(nTag) !== -1));
if (isProhibited) {
return result;
}
var isNativeFormField = nativeFormFields.indexOf(nTag) !== -1;
var isNativeButton = ["input"].indexOf(nTag) !== -1;
var isRangeWidgetRole = rangeWidgetRoles.indexOf(nRole) !== -1;
var isEditWidgetRole = editWidgetRoles.indexOf(nRole) !== -1;
var isSelectWidgetRole = selectWidgetRoles.indexOf(nRole) !== -1;
var isSimulatedFormField =
isRangeWidgetRole ||
isEditWidgetRole ||
isSelectWidgetRole ||
nRole === "combobox";
var isWidgetRole =
(isSimulatedFormField ||
otherWidgetRoles.indexOf(nRole) !== -1) &&
nRole !== "link";
result.isWidget = isNativeFormField || isWidgetRole;
var hasName = false;
var hasDesc = false;
var aOwns = node.getAttribute("aria-owns") || "";
var isSeparatChildFormField = !!(
!skipTo.tag &&
!skipTo.role &&
!isEmbeddedNode &&
((node !== refNode &&
(isNativeFormField || isSimulatedFormField)) ||
(node.id &&
ownedBy[node.id] &&
ownedBy[node.id].target &&
ownedBy[node.id].target === node))
);
// Check for non-empty value of aria-labelledby on current node, follow each ID ref, then stop and process no deeper.
if (!stop && !skipTo.tag && !skipTo.role && aLabelledby) {
ids = aLabelledby.split(/\s+/);
parts = [];
for (i = 0; i < ids.length; i++) {
element = docO.getElementById(ids[i]);
// Also prevent the current form field from having its value included in the naming computation if nested as a child of label
parts.push(
walk(element, true, skip, [node], element === refNode, {
ref: ownedBy,
top: element,
}).name,
);
}
// Check for blank value, since whitespace chars alone are not valid as a name
name = trim(parts.join(" "));
if (trim(name)) {
hasName = true;
hLabel = true;
hasLabel = true;
// Abort further recursion if name is valid.
result.skip = true;
}
}
// Check for non-empty value of aria-describedby/description if current node equals reference node, follow each ID ref, then stop and process no deeper.
if (
!stop &&
node === refNode &&
!skipTo.tag &&
!skipTo.role &&
(aDescribedby || aDescription)
) {
if (aDescribedby) {
var desc;
ids = aDescribedby.split(/\s+/);
parts = [];
for (i = 0; i < ids.length; i++) {
element = docO.getElementById(ids[i]);
// Also prevent the current form field from having its value included in the naming computation if nested as a child of label
parts.push(
walk(element, true, false, [node], false, {
ref: ownedBy,
top: element,
computingDesc: true,
}).name,
);
}
// Check for blank value, since whitespace chars alone are not valid as a name
desc = trim(parts.join(" "));
} else {
desc = trim(aDescription);
}
if (trim(desc)) {
result.desc = desc;
hasDesc = true;
}
}
// Otherwise, if current node has a non-empty aria-label then set as name and process no deeper within the branch.
if (
!skipTo.tag &&
!skipTo.role &&
!hasName &&
trim(aLabel) &&
!isSeparatChildFormField
) {
name = aLabel;
// Check for blank value, since whitespace chars alone are not valid as a name
if (trim(name)) {
hasName = true;
hLabel = true;
if (node === refNode) {
// If name is non-empty and both the current and refObject nodes match, then don't process any deeper within the branch.
skip = true;
hasLabel = true;
}
}
}
var rolePresentation =
!skipTo.tag &&
!skipTo.role &&
!hasName &&
nTag !== "iframe" &&
nRole &&
presentationRoles.indexOf(nRole) !== -1 &&
!isFocusable(node) &&
!hasGlobalAttr(node);
// Otherwise, if the current node is not a nested widget control within the parent ref obj, but is instead a native markup element that includes a host-defined labelling mechanism, then set the name and description accordingly if present.
if (!isSeparatChildFormField) {
// Otherwise, if name is still empty and the current node matches the ref node and is a standard form field with a non-empty associated label element, process label with same naming computation algorithm.
if (
!skipTo.tag &&
!skipTo.role &&
!hasName &&
node === refNode &&
isNativeFormField
) {
// Logic modified to match issue
// https://github.com/WhatSock/w3c-alternative-text-computation/issues/12 */
var labels = docO.querySelectorAll("label");
var lblName = "";
var implicitLabel = getParent(node, "label") || false;
for (i = 0; i < labels.length; i++) {
if (
((labels[i] === implicitLabel &&
typeof implicitLabel.getAttribute("for") !==
"string") ||
labels[i].getAttribute("for") === node.id) &&
!isParentHidden(labels[i], docO.body, true)
) {
lblName += addSpacing(
walk(labels[i], true, skip, [node], false, {
ref: ownedBy,
top: labels[i],
}).name,
);
}
}
name = lblName;
if (trim(name)) {
hasName = true;
}
}
// Process native form field buttons in accordance with the HTML AAM
// https://w3c.github.io/html-aam/#accessible-name-and-description-computation
var btnType =
(!skipTo.tag &&
!skipTo.role &&
isNativeButton &&
(node.getAttribute("type") || "").toLowerCase()) ||
false;
var btnValue =
(!skipTo.tag &&
!skipTo.role &&
btnType &&
trim(node.getAttribute("value"))) ||
false;
var nAlt =
rolePresentation && nTag === "img"
? ""
: trim(node.alt || node.getAttribute("alt"));
// Otherwise, if name is still empty and current node is a standard non-presentational img or image button with a non-empty alt or title attribute, set alt or title attribute value as the accessible name.
if (
!skipTo.tag &&
!skipTo.role &&
!hasName &&
!rolePresentation &&
(nRole === "img" || nTag === "img" || btnType === "image") &&
(nAlt || trim(nTitle))
) {
// Check for blank value, since whitespace chars alone are not valid as a name
name = trim(nAlt) || trim(nTitle);
if (trim(name)) {
hasName = true;
}
}
// Process native HTML area tags to use alt as name when not explicitly set using aria-labelledby or aria-label.
if (
!skipTo.tag &&
!skipTo.role &&
!hasName &&
!rolePresentation &&
nTag === "area" &&
nAlt
) {
// Check for blank value, since whitespace chars alone are not valid as a name
name = trim(nAlt);
if (trim(name)) {
hasName = true;
}
}
// Process native HTML optgroup tags to use label as name when not explicitly set using aria-labelledby or aria-label.
if (nTag === "optgroup") {
if (
!skipTo.tag &&
!skipTo.role &&
!hasName &&
!rolePresentation &&
node.getAttribute("label")
) {
// Check for blank value, since whitespace chars alone are not valid as a name
name = trim(node.getAttribute("label"));
if (trim(name)) {
hasName = true;
}
}
result.skip = true;
}
// Process the accessible names for native HTML buttons
if (
!skipTo.tag &&
!skipTo.role &&
!hasName &&
node === refNode &&
btnType &&
["button", "submit", "reset"].indexOf(btnType) !== -1
) {
if (btnValue) {
name = btnValue;
} else {
switch (btnType) {
case "submit":
name = "submit";
break;
case "reset":
name = "reset";
break;
default:
name = "";
}
}
if (trim(name)) {
hasName = true;
}
}
if (
!skipTo.tag &&
!skipTo.role &&
hasName &&
node === refNode &&
btnType &&
["button", "submit", "reset"].indexOf(btnType) !== -1 &&
btnValue &&
btnValue !== name &&
!result.desc
) {
result.desc = btnValue;
hasDesc = true;
}
// Process the accessible names for native HTML image buttons
if (
!skipTo.tag &&
!skipTo.role &&
!hasName &&
node === refNode &&
btnType &&
btnType === "image"
) {
name = "Submit Query";
hasName = true;
nameFromUserAgent = true;
}
var isFieldset =
!skipTo.tag &&
!skipTo.role &&
!hasName &&
node === rootNode &&
(nRole === "group" ||
nRole === "radiogroup" ||
(!nRole && nTag === "fieldset"));
// Otherwise, if name is still empty and the current node matches the root node and is a standard fieldset element with a non-empty associated legend element as the first child node, process legend with same naming computation algorithm.
// Plus do the same for role="group" and role="radiogroup" with embedded role="legend", or a combination of these.
if (isFieldset) {
var fChild =
firstChild(node, ["legend"], ["legend"]) || false;
if (fChild) {
name = trim(
walk(fChild, stop, false, [], false, {
ref: ownedBy,
top: fChild,
}).name,
);
}
if (trim(name)) {
hasName = true;
}
skip = true;
}
var isTable =
!skipTo.tag &&
!skipTo.role &&
!hasName &&
node === rootNode &&
(nRole === "table" || (!nRole && nTag === "table"));
// Otherwise, if name is still empty and the current node matches the root node and is a standard table element with a non-empty associated caption element as the first child node, process caption with same naming computation algorithm.
// Plus do the same for role="table" with embedded role="caption", or a combination of these.
if (isTable) {
fChild = firstChild(node, ["caption"], ["caption"]) || false;
if (fChild) {
name = trim(
walk(fChild, stop, false, [], false, {
ref: ownedBy,
top: fChild,
}).name,
);
}
if (trim(name)) {
hasName = true;
}
skip = true;
}
// Otherwise, if name is still empty and the root node and the current node are the same and node is an svg element, then parse the content of the title element to set the name and the desc element to set the description.
if (!skipTo.tag && !skipTo.role && nTag === "svg") {
var svgT = node.querySelector("title") || false;
var svgD =
(node === rootNode && node.querySelector("desc")) || false;
if (!hasName && svgT) {
name = trim(
walk(svgT, true, false, [], false, {
ref: ownedBy,
top: svgT,
}).name,
);
}
if (!hasDesc && svgD) {
var dE = trim(
walk(svgD, true, false, [], false, {
ref: ownedBy,
top: svgD,
}).name,
);
if (trim(dE)) {
result.desc = dE;
}
}
result.skip = true;
}
}
// Otherwise, if the current node is a nested widget control within the parent ref obj, then add only its value and process no deeper within the branch.
if (!skipTo.tag && !skipTo.role && isSeparatChildFormField) {
// Prevent the referencing node from having its value included in the case of form control labels that contain the element with focus.
if (
!(
nodesToIgnoreValues &&
nodesToIgnoreValues.length &&
nodesToIgnoreValues.indexOf(node) !== -1
)
) {
if (isRangeWidgetRole) {
// For range widgets, append aria-valuetext if non-empty, or aria-valuenow if non-empty, or node.value if applicable.
name = getObjectValue(nRole, node, true);
} else if (
isEditWidgetRole ||
(nRole === "combobox" && isNativeFormField)
) {
// For simulated edit widgets, append text from content if applicable, or node.value if applicable.
name = getObjectValue(nRole, node, false, true);
} else if (isSelectWidgetRole) {
// For simulated select widgets, append same naming computation algorithm for all child nodes including aria-selected="true" separated by a space when multiple.
// Also filter nodes so that only valid child roles of relevant parent role that include aria-selected="true" are included.
name = getObjectValue(nRole, node, false, false, true);
} else if (
isNativeFormField &&
["input", "textarea"].indexOf(nTag) !== -1 &&
(!isWidgetRole || isEditWidgetRole)
) {
// For native edit fields, append node.value when applicable.
name = getObjectValue(
nRole,
node,
false,
false,
false,
true,
);
} else if (
isNativeFormField &&
nTag === "select" &&
(!isWidgetRole || nRole === "combobox")
) {
// For native select fields, get text from content for all options with selected attribute separated by a space when multiple, but don't process if another widget role is present unless it matches role="combobox".
// Reference: https://github.com/WhatSock/w3c-alternative-text-computation/issues/7
name = getObjectValue(
nRole,
node,
false,
false,
true,
true,
);
}
// Check for blank value, since whitespace chars alone are not valid as a name
name = trim(name);
}
}
// Otherwise, if current node is the same as rootNode and is non-presentational and includes a non-empty title attribute, store title attribute value as the accessible name if name is still empty, or the description if not.
// Processing for this is handled within the walkDOM function.
if (
!skipTo.tag &&
!skipTo.role &&
!rolePresentation &&
trim(nTitle)
) {
if (!(name && aDescription === " ")) {
result.title = trim(nTitle);
}
}
var nType =
isNativeFormField &&
trim(node.getAttribute("type") || "").toLowerCase();
if (!nType) nType = "text";
var placeholder =
!skipTo.tag &&
!skipTo.role &&
node === rootNode &&
node === refNode &&
(isEditWidgetRole ||
(isNativeFormField &&
(nTag === "textarea" ||
(nTag === "input" &&
[
"password",
"search",
"tel",
"text",
"url",
"email",
].indexOf(nType) !== -1)))) &&
trim(
node.getAttribute("placeholder") ||
node.getAttribute("aria-placeholder"),
);
if (placeholder) {
result.placeholder = placeholder;
}
var isSkipTo =
(skipTo.role && skipTo.role === nRole) ||
(!nRole && skipTo.tag && skipTo.tag === nTag);
// Process custom tag and role searches if needed.
if (isSkipTo) {
name = trim(
walk(node, stop, false, [], false, {
ref: ownedBy,
top: node,
}).name,
);
if (trim(name)) {
skip = true;
}
}
// Check for non-empty value of aria-owns, follow each ID ref, then process with same naming computation.
// Also abort aria-owns processing if contained on an element that does not support child elements.
if (
!isSkipTo &&
aOwns &&
["input", "img", "progress"].indexOf(nTag) === -1
) {
ids = aOwns.split(/\s+/);
parts = [];
for (i = 0; i < ids.length; i++) {
element = docO.getElementById(ids[i]);
// Abort processing if the referenced node has already been traversed
if (element && owns.indexOf(ids[i]) === -1) {
owns.push(ids[i]);
var oBy = { ref: ownedBy, top: ownedBy.top };
oBy[ids[i]] = {
refNode: refNode,
node: node,
target: element,
};
if (!isParentHidden(element, docO.body, true)) {
parts.push(
walk(element, true, skip, [], false, oBy).name,
);
}
}
}
// Join without adding whitespace since this is already handled by parsing individual nodes within the algorithm steps.
ariaO = parts.join("");
}
}
// Otherwise, process text node
else if (!skipTo.tag && !skipTo.role && node.nodeType === 3) {
name = node.data;
}
if (!hLabel) {
// Prepend and append the current CSS pseudo element text, plus normalize all whitespace such as newline characters and others into flat spaces.
name = cssO.before + name.replace(/\s+/g, " ") + cssO.after;
}
if (
name.length &&
!hasParentLabelOrHidden(node, ownedBy.top, ownedBy)
) {
result.name = name;
}
result.owns = ariaO;
return result;
},
refNode,
);
if (!hasLabel) {
// Prepend and append the refObj CSS pseudo element text, plus normalize whitespace chars into flat spaces.
fullResult.name =
cssOP.before + fullResult.name.replace(/\s+/g, " ") + cssOP.after;
}
return fullResult;
};
var firstChild = function (e, t, r, s) {
e = e ? e.firstChild : null;
while (e) {
var tr = getRole(e) || false;
if (
e.nodeType === 1 &&
((!t && !r) ||
(tr && r && r.indexOf(tr) !== -1) ||
(!tr && t && t.indexOf(e.nodeName.toLowerCase()) !== -1))
) {
return e;
} else if (!s && e.nodeType === 1 && (t || r)) {
return null;
}
e = e.nextSibling;
}
return e;
};
var lastChild = function (e, t, r, s) {
e = e ? e.lastChild : null;
while (e) {
var tr = getRole(e) || false;
if (
e.nodeType === 1 &&
((!t && !r) ||
(tr && r && r.indexOf(tr) !== -1) ||
(!tr && t && t.indexOf(e.nodeName.toLowerCase()) !== -1))
) {
return e;
} else if (!s && e.nodeType === 1 && (t || r)) {
return null;
}
e = e.previousSibling;
}
return e;
};
var getRole = function (node) {
var role =
node && node.getAttribute
? (node.getAttribute("role") || "").toLowerCase()
: "";
if (!trim(role)) {
return "";
}
var inList = function (list) {
return trim(role).length > 0 && list.roles.indexOf(role) >= 0;
};
var roles = role.split(/\s+/);
for (var i = 0; i < roles.length; i++) {
role = roles[i];
if (
inList(list1) ||
inList(list2) ||
inList(list3) ||
inList(list4) ||
presentationRoles.indexOf(role) !== -1
) {
return role;
}
}
return "";
};
var isFocusable = function (node) {
var nodeName = node.nodeName.toLowerCase();
if (node.getAttribute("tabindex")) {
return true;
}
if (nodeName === "a" && node.getAttribute("href")) {
return true;
}
return (
["button", "input", "select", "textarea"].indexOf(nodeName) !== -1 &&
(node.getAttribute("type") || "").toLowerCase() !== "hidden"
);
};
// ARIA Role Exception Rule Set 1.2
// The following Role Exception Rule Set is based on the following ARIA Working Group discussion involving all relevant browser venders.
// https://lists.w3.org/Archives/Public/public-aria/2017Jun/0057.html
// Always include name from content when the referenced node matches list1, as well as when child nodes match those within list3
// Note: gridcell was added to list1 to account for focusable gridcells that match the ARIA 1.0 paradigm for interactive grids.
// So too was row to match 'name from author' and 'name from content' in accordance with the spec.
var list1 = {
roles: [
"button",
"checkbox",
"link",
"option",
"radio",
"switch",
"tab",
"treeitem",
"menuitem",
"menuitemcheckbox",
"menuitemradio",
"row",
"cell",
"gridcell",
"columnheader",
"rowheader",
"tooltip",
"heading",
],
tags: [
"a",
"button",
"summary",
"input",
"h1",
"h2",
"h3",
"h4",
"h5",
"h6",
"menuitem",
"option",
"tr",
"td",
"th",
],
};
// Never include name from content when current node matches list2
// The rowgroup role was added to prevent 'name from content' in accordance with relevant ARIA 1.1 spec changes.
// The fieldset element and group role was added to account for implicit mappings where name from content is not supported.
var list2 = {
roles: [
"application",
"alert",
"log",
"marquee",
"timer",
"alertdialog",
"dialog",
"banner",
"complementary",
"form",
"main",
"navigation",
"progressbar",
"region",
"search",
"article",
"document",
"feed",
"figure",
"img",
"math",
"toolbar",
"menu",
"menubar",
"grid",
"listbox",
"radiogroup",
"textbox",
"searchbox",
"spinbutton",
"scrollbar",
"slider",
"tablist",
"tabpanel",
"tree",
"treegrid",
"separator",
"rowgroup",
"group",
],
tags: [
"article",
"aside",
"body",
"select",
"datalist",
"optgroup",
"dialog",
"figure",
"footer",
"form",
"header",
"hr",
"iframe",
"img",
"textarea",
"input",
"main",
"math",
"menu",
"nav",
"section",
"thead",
"tbody",
"tfoot",
"fieldset",
"progress",
],
};
// As an override of list2, conditionally include name from content if current node is focusable, or if the current node matches list3 while the referenced parent node (root node) matches list1.
var list3 = {
roles: [
"term",
"definition",
"directory",
"list",
"note",
"status",
"table",
"contentinfo",
],
tags: ["dl", "ul", "ol", "dd", "details", "output", "table"],
};
// Subsequent roles added as part of the Role Parity project for ARIA 1.2.
// Tracks roles that don't specifically belong within the prior process lists.
var list4 = {
roles: [
"legend",
"caption",
"code",
"deletion",
"emphasis",
"generic",
"insertion",
"paragraph",
"strong",
"subscript",
"superscript",
],
tags: [
"legend",
"caption",
"figcaption",
"code",
"del",
"em",
"div",
"span",
"ins",
"p",
"strong",
"sub",
"sup",
],
};
var genericElements = ["div", "span"];
var nameProhibitedRoles = [
"caption",
"code",
"deletion",
"emphasis",
"generic",
"insertion",
"none",
"paragraph",
"presentation",
"strong",
"subscript",
"superscript",
];
var nameProhibitedElements = [
"caption",
"figcaption",
"code",
"del",
"em",
"div",
"span",
"ins",
"p",
"strong",
"sub",
"sup",
];
var nativeFormFields = [
"button",
"input",
"progress",
"select",
"textarea",
];
var rangeWidgetRoles = [
"scrollbar",
"slider",
"spinbutton",
"progressbar",
];
var editWidgetRoles = ["searchbox", "textbox"];
var selectWidgetRoles = [
"grid",
"listbox",
"tablist",
"tree",
"treegrid",
];
var otherWidgetRoles = [
"button",
"checkbox",
"link",
"switch",
"option",
"menu",
"menubar",
"menuitem",
"menuitemcheckbox",
"menuitemradio",
"radio",
"tab",
"treeitem",
"gridcell",
];
var presentationRoles = ["presentation", "none"];
var hasGlobalAttr = function (node) {
var globalPropsAndStates = [
"labelledby",
"label",
"describedby",
"busy",
"controls",
"current",
"details",
"disabled",
"dropeffect",
"errormessage",
"flowto",
"grabbed",
"haspopup",
"invalid",
"keyshortcuts",
"live",
"owns",
"roledescription",
];
for (var i = 0; i < globalPropsAndStates.length; i++) {
var a = trim(node.getAttribute("aria-" + globalPropsAndStates[i]));
if (a) {
return true;
}
}
return false;
};
var isHidden =
overrides.isHidden ||
function (node, refNode) {
var hidden = function (node) {
if (!node || node.nodeType !== 1 || node === refNode) {
return false;
}
if (node.getAttribute("aria-hidden") === "true") {
return true;
}
if (node.getAttribute("hidden")) {
return true;
}
var style = getStyleObject(node);
return (
style["display"] === "none" || style["visibility"] === "hidden"
);
};
return hidden(node);
};
var isParentHidden = function (node, refNode, skipOwned, skipCurrent) {
while (node && node !== refNode) {
if (!skipCurrent && node.nodeType === 1 && isHidden(node, refNode)) {
return true;
} else skipCurrent = false;
node = node.parentNode;
}
return false;
};
var getStyleObject =
overrides.getStyleObject ||
function (node) {
var style = {};
if (docO.defaultView && docO.defaultView.getComputedStyle) {
style = docO.defaultView.getComputedStyle(node, "");
} else if (node.currentStyle) {
style = node.currentStyle;
}
return style;
};
var cleanCSSText = function (node, text) {
var s = text;
if (s.indexOf("attr(") !== -1) {
var m = s.match(/attr\((.|\n|\r\n)*?\)/g);
for (var i = 0; i < m.length; i++) {
var b = m[i].slice(5, -1);
b = node.getAttribute(b) || "";
s = s.replace(m[i], b);
}
}
s = s.replace(/url\((.*?)\)\s+\/|url\((.*?)\)/g, "").replace(/\"/g, "");
return s;
};
var isBlockLevelElement = function (node, cssObj) {
var styleObject = cssObj || getStyleObject(node);
for (var prop in blockStyles) {
var values = blockStyles[prop];
for (var i = 0; i < values.length; i++) {
if (
styleObject[prop] &&
((values[i].indexOf("!") === 0 &&
[values[i].slice(1), "inherit", "initial", "unset"].indexOf(
styleObject[prop],
) === -1) ||
styleObject[prop].indexOf(values[i]) === 0)
) {
return true;
}
}
}
return (
!cssObj &&
node.nodeName &&
blockElements.indexOf(node.nodeName.toLowerCase()) !== -1 &&
!(
styleObject["display"] &&
styleObject["display"].indexOf("inline") === 0 &&
node.nodeName.toLowerCase() !== "br"
)
);
};
// CSS Block Styles indexed from:
// https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Block_formatting_context
var blockStyles = {
display: ["block", "grid", "table", "flow-root", "flex"],
position: ["absolute", "fixed"],
float: ["left", "right", "inline"],
clear: ["left", "right", "both", "inline"],
overflow: ["hidden", "scroll", "auto"],
"column-count": ["!auto"],
"column-width": ["!auto"],
"column-span": ["all"],
contain: ["layout", "content", "strict"],
};
// HTML5 Block Elements indexed from:
// https://github.com/webmodules/block-elements
// Note: 'br' was added to this array because it impacts visual display and should thus add a space .
// Reference issue: https://github.com/w3c/accname/issues/4
// Note: Added in 1.13, td, th, tr, and legend
var blockElements = [
"address",
"article",
"aside",
"blockquote",
"br",
"canvas",
"dd",
"div",
"dl",
"dt",
"fieldset",
"figcaption",
"figure",
"footer",
"form",
"h1",
"h2",
"h3",
"h4",
"h5",
"h6",
"header",
"hgroup",
"hr",
"legend",
"li",
"main",
"nav",
"noscript",
"ol",
"output",
"p",
"pre",
"section",
"table",
"td",
"tfoot",
"th",
"tr",
"ul",
"video",
];
var getObjectValue = function (
role,
node,
isRange,
isEd