Skip to content

[Interactive Graph] Improve graph instruction and add repeat shortcut - #3745

Closed
ivyolamit wants to merge 3 commits into
mainfrom
LEMS-4120-instructions-shortcut
Closed

[Interactive Graph] Improve graph instruction and add repeat shortcut#3745
ivyolamit wants to merge 3 commits into
mainfrom
LEMS-4120-instructions-shortcut

Conversation

@ivyolamit

@ivyolamit ivyolamit commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Summary:

Reworks the screen reader-only interactive-graph instructions to lead with a focus-mode warning and end with an on-demand repeat hint, and adds the Insert + I shortcut that repeats the instructions while the graph is focused.

Screenshot 2026-06-12 at 2 31 51 PM

Issue: LEMS-4120

Test plan:

@ivyolamit ivyolamit self-assigned this Jun 8, 2026
@github-actions

github-actions Bot commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Size Change: +353 B (+0.07%)

Total Size: 508 kB

📦 View Changed
Filename Size Change
packages/perseus/dist/es/index.js 200 kB +173 B (+0.09%)
packages/perseus/dist/es/strings.js 8.78 kB +180 B (+2.09%)
ℹ️ View Unchanged
Filename Size
packages/kas/dist/es/index.js 20.6 kB
packages/keypad-context/dist/es/index.js 1 kB
packages/kmath/dist/es/index.js 6.32 kB
packages/math-input/dist/es/index.js 98.5 kB
packages/math-input/dist/es/strings.js 1.61 kB
packages/perseus-core/dist/es/index.item-splitting.js 12 kB
packages/perseus-core/dist/es/index.js 26.3 kB
packages/perseus-editor/dist/es/index.js 105 kB
packages/perseus-linter/dist/es/index.js 9.8 kB
packages/perseus-score/dist/es/index.js 10.2 kB
packages/perseus-utils/dist/es/index.js 403 B
packages/pure-markdown/dist/es/index.js 1.39 kB
packages/simple-markdown/dist/es/index.js 6.71 kB

compressed-size-action

@github-actions

github-actions Bot commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

npm Snapshot: Published

Good news!! We've packaged up the latest commit from this PR (571246e) and published it to npm. You
can install it using the tag PR3745.

Example:

pnpm add @khanacademy/perseus@PR3745

If you are working in Khan Academy's frontend, you can run the below command.

./dev/tools/bump_perseus_version.ts -t PR3745

If you are working in Khan Academy's webapp, you can run the below command.

./dev/tools/bump_perseus_version.js -t PR3745

@ivyolamit
ivyolamit force-pushed the LEMS-4120-instructions-shortcut branch from b8362f9 to 571246e Compare June 12, 2026 21:32
@ivyolamit
ivyolamit marked this pull request as ready for review June 12, 2026 21:41
@catandthemachines

Copy link
Copy Markdown
Member

Just adding a note that this short cut isn't even working in Windows + NVDA. We'll need to investigate and troubleshoot this a bit more to ensure we have a version that works.

- DOM reorder so the instructions `<View>` is the first sr-only child inside the graph wrapper (LEMS-4121; OQ4).
- Bounded vs. unlimited instruction-string split (LEMS-4120; OQ2a decision B), including the leading mode-toggle warning (OQ2b decision A) and the on-demand-shortcut sentence (OQ2c decision A).
- Insert + I (Windows) / Fn + Enter + I (macOS) keyboard shortcut to repeat the instruction string on demand (LEMS-4120; OQ2c decision A). Platform-detected dual binding.
- Insert + I keyboard shortcut to repeat the instruction string on demand (LEMS-4120; OQ2c). **Windows-only** — the originally-planned Fn + Enter + I macOS binding was dropped during implementation: Macs have no Insert key (Fn + Return reports as `key: "Enter"`, never "Insert") and macOS VoiceOver doesn't use Insert as a modifier, so the chord can't fire on a Mac. Mac SR users re-focus the graph to re-hear the instructions. No platform detection needed.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we really be doing something that's only supported on Windows and not Mac?

Are we identifying if the user is on Windows/Mac to conditionally change the instructions? (I didn't see that when doing a rough pass over the PR)

How does this affect development and QE? Adding a feature that many people won't be able to test because we don't have Windows?

I would recommend not adding a feature that's only available to one OS, but if we still decide to, this should probably be a bigger conversation in LEMS.

@ivyolamit

Copy link
Copy Markdown
Contributor Author

Based on team discussion we will hold off implementation for future work.

@ivyolamit ivyolamit closed this Jun 17, 2026
@ivyolamit
ivyolamit deleted the LEMS-4120-instructions-shortcut branch June 17, 2026 18:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants