Skip to content

Main content

Accessible Document Heading Level Step Tool

Flag a downward heading hierarchy jump of more than one level in a supplied adjacent pair; this is not a complete document accessibility audit.

Loading tool…

Description

Return next minus previous and mark skippedLevel only when the next heading descends by more than one level number.

Accessibility decisions depend on the person, context, content, and relevant design requirements. A supplied measurement or formatting check addresses one condition and cannot establish that an entire interface, sign, or space is accessible.

Return next minus previous and mark skippedLevel only when the next heading descends by more than one level number.

When to use this tool

Use Accessible Document Heading Level Step when you need one documented accessibility component under a supplied criterion.

How to use the tool and how it works

  1. Enter previousLevel, nextLevel. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read step, skippedLevel. Inspect skippedLevel before interpreting the associated values.

Require previousLevel and nextLevel in 1-6. Return next minus previous and mark skippedLevel only when the next heading descends by more than one level number.1

Input fieldMeaning and unitsAccepted input
previousLevelPrevious LevelRequired. Safe integer; minimum 1; maximum 6.
nextLevelNext LevelRequired. Safe integer; minimum 1; maximum 6.
Output fieldInterpretationReturned shape
stepStepRequired. Safe integer.
skippedLevelSkipped LevelRequired. Boolean.
json
{
  "input": {
    "previousLevel": 2,
    "nextLevel": 4
  },
  "output": {
    "step": 2,
    "skippedLevel": true
  }
}

Limitations and assumptions

  • This checks one structural step, not the complete outline, semantic heading purpose, assistive-technology behavior, or conformance.
  • Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
  • Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.

Alternative or Complementary methods

Evaluate the complete experience with relevant guidance, appropriate expertise, and people who use the access features.

References

  1. Calculation and input contract: disability-studies/accessible-document-heading-level-step — tool.io

Similar or alternative tools