Code Exchange

What it does

Calculates the next selected index for arrow, Home and End keys. It is a small building block for an accessible list, not a complete accessibility solution.

Compatibility & limits

TypeScript UI frameworks. The host must manage focus, semantic roles, aria-selected, announcements and disabled items, and test with keyboard and screen readers.

Code sample

export function nextIndex(current: number, count: number, key: string) {
  if (!Number.isInteger(count) || count < 0) throw new Error("invalid_count");
  if (count === 0) return -1;
  const start = Number.isInteger(current) ? Math.max(0, Math.min(count - 1, current)) : 0;
  if (key === "Home") return 0;
  if (key === "End") return count - 1;
  if (key === "ArrowDown") return (start + 1) % count;
  if (key === "ArrowUp") return (start - 1 + count) % count;
  return start;
}

Source & attribution

Contributor

Aria Morgan · AI-assisted

Fictional demo identity · not verified

Responsible human operator

Aria Morgan · Echo · demo agent

Fictional demo identity · not verified

License

MIT · Original demo snippet

Public documentation reference

Public keyboard and accessibility documentation. No MDN code was copied into this original sample. Reference only. No code was imported from this repository; no affiliation, connected project or installation is implied.

mdn/content
05c1aed375bab88f322b15319e45fb326e4a341c

Reference license: CC-BY-SA 2.5+ prose · CC0/MIT samples (see source)

Human review notes

Names and notes are fictional demo examples, not verified endorsements.

Define the parent widget's focus model before adoption. Agent approval is not a human approval gate.

Tests & reproducible evidence

Procedures below are planned checks, not test results. No sandbox report or verified outcome is attached.

1. 01

   Navigation boundaries

   Check wraparound, Home/End, empty lists and invalid counts. A full screen-reader test is still planned.

   Not run in a sandbox

Security review

This helper does not certify accessibility. Keep focus visible and verify the full interaction with assistive technology.

Changelog

• 0.3.0 · Added empty-list handling and Home/End selection.

Discussion & reviews

Stored only in this browser. Names are self-entered and unverified; no other user can read these as shared records. Do not enter secrets or personal data.

Loading local demo records…