mirror of
https://ghproxy.net/https://github.com/elementor/one-click-accessibility.git
synced 2026-07-22 12:27:13 +08:00
102 lines
2.2 KiB
JavaScript
102 lines
2.2 KiB
JavaScript
/**
|
|
* Missing H1 Check Rule
|
|
*
|
|
* This rule ensures that a page contains at least one h1 tag.
|
|
* Missing h1 tags can make it difficult for screen readers to understand the page structure.
|
|
*
|
|
* Compatible with ACE (accessibility-checker-engine)
|
|
*/
|
|
|
|
const missingH1Check = {
|
|
id: 'missing_h1_check',
|
|
context: 'dom:html',
|
|
dependencies: [],
|
|
help: {
|
|
'en-US': {
|
|
group: 'Heading Structure',
|
|
pass: 'Page contains an h1 tag',
|
|
fail_no_h1:
|
|
'No h1 tag found on the page. Each page should have a main heading (h1) to establish proper document structure and help users understand the page content.',
|
|
},
|
|
},
|
|
messages: {
|
|
'en-US': {
|
|
group: 'Heading Structure',
|
|
pass: 'Page contains an h1 tag',
|
|
fail_no_h1:
|
|
'No h1 tag found. Add a main heading (h1) to establish the page structure.',
|
|
},
|
|
},
|
|
rulesets: [
|
|
{
|
|
id: ['IBM_Accessibility'],
|
|
num: '1.3.1',
|
|
level: 'violation',
|
|
toolkitLevel: 'LEVEL_ONE',
|
|
},
|
|
],
|
|
run: (context) => {
|
|
const document = context.dom.node;
|
|
const firstLevelHeadings = document.querySelectorAll(
|
|
'h1, [role="heading"][aria-level="1"]',
|
|
);
|
|
|
|
if (firstLevelHeadings.length === 0) {
|
|
const headings = document.querySelectorAll(
|
|
'h1, h2, h3, h4, h5, h6, [role="heading"]',
|
|
);
|
|
|
|
return {
|
|
ruleId: 'missing_h1_check',
|
|
reasonId: 'fail_no_h1',
|
|
value: ['VIOLATION', 'FAIL'],
|
|
path: {
|
|
dom: '/html[1]',
|
|
aria: '/document[1]',
|
|
},
|
|
node: headings[0],
|
|
ruleTime: 0,
|
|
message:
|
|
'No h1 tag found. Add a main heading (h1) to establish the page structure.',
|
|
messageArgs: [],
|
|
apiArgs: [],
|
|
bounds: {
|
|
left: 0,
|
|
top: 0,
|
|
height: 0,
|
|
width: 0,
|
|
},
|
|
snippet: '<html>',
|
|
category: 'Accessibility',
|
|
ignored: false,
|
|
level: 'violation',
|
|
};
|
|
}
|
|
|
|
return {
|
|
ruleId: 'missing_h1_check',
|
|
reasonId: 'pass',
|
|
value: ['VIOLATION', 'PASS'],
|
|
path: {
|
|
dom: '/html[1]',
|
|
aria: '/document[1]',
|
|
},
|
|
ruleTime: 0,
|
|
message: 'Page contains an h1 tag',
|
|
messageArgs: [],
|
|
apiArgs: [],
|
|
bounds: {
|
|
left: 0,
|
|
top: 0,
|
|
height: 0,
|
|
width: 0,
|
|
},
|
|
snippet: firstLevelHeadings[0].outerHTML,
|
|
category: 'Accessibility',
|
|
ignored: false,
|
|
level: 'pass',
|
|
};
|
|
},
|
|
};
|
|
|
|
export default missingH1Check;
|
