* test: verify IME retrieval and Enter shortcut example * test: verify IME retrieval and Enter shortcut example * docs: explain IME-safe Enter shortcuts and verification * test: verify IME retrieval and Enter shortcut example * chore: update UX guideline count in .claude/skills/ui-ux-pro-max/SKILL.md * chore: update UX guideline count in .claude/skills/ui-ux-pro-max/data/catalog-summary.json * feat: add IME composition Enter guidance * chore: refresh runtime fingerprint for IME guidance * chore: update UX guideline count in README.ko.md * chore: update UX guideline count in README.md * chore: update UX guideline count in README.zh.md * chore: update UX guideline count in cli/assets/data/catalog-summary.json * feat: add IME composition Enter guidance * chore: refresh runtime fingerprint for IME guidance * chore: update UX guideline count in cli/assets/templates/platforms/agent.json * chore: update UX guideline count in cli/assets/templates/platforms/amazonq.json * chore: update UX guideline count in cli/assets/templates/platforms/augment.json * chore: update UX guideline count in cli/assets/templates/platforms/autoclaw.json * chore: update UX guideline count in cli/assets/templates/platforms/claude.json * chore: update UX guideline count in cli/assets/templates/platforms/codebuddy.json * chore: update UX guideline count in cli/assets/templates/platforms/codewhale.json * chore: update UX guideline count in cli/assets/templates/platforms/codex.json * chore: update UX guideline count in cli/assets/templates/platforms/continue.json * chore: update UX guideline count in cli/assets/templates/platforms/copilot.json * chore: update UX guideline count in cli/assets/templates/platforms/cursor.json * chore: update UX guideline count in cli/assets/templates/platforms/droid.json * chore: update UX guideline count in cli/assets/templates/platforms/gemini.json * chore: update UX guideline count in cli/assets/templates/platforms/kilocode.json * chore: update UX guideline count in cli/assets/templates/platforms/kimi.json * chore: update UX guideline count in cli/assets/templates/platforms/kiro.json * chore: update UX guideline count in cli/assets/templates/platforms/openclaw.json * chore: update UX guideline count in cli/assets/templates/platforms/opencode.json * chore: update UX guideline count in cli/assets/templates/platforms/qoder.json * chore: update UX guideline count in cli/assets/templates/platforms/roocode.json * chore: update UX guideline count in cli/assets/templates/platforms/trae.json * chore: update UX guideline count in cli/assets/templates/platforms/universal.json * chore: update UX guideline count in cli/assets/templates/platforms/warp.json * chore: update UX guideline count in cli/assets/templates/platforms/windsurf.json * chore: update UX guideline count in cli/assets/templates/platforms/zcode.json * chore: update UX guideline count in src/ui-ux-pro-max/data/catalog-summary.json * feat: add IME composition Enter guidance * chore: refresh runtime fingerprint for IME guidance * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/agent.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/amazonq.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/augment.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/autoclaw.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/claude.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/codebuddy.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/codewhale.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/codex.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/continue.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/copilot.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/cursor.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/droid.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/gemini.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/kilocode.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/kimi.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/kiro.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/openclaw.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/opencode.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/qoder.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/roocode.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/trae.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/universal.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/warp.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/windsurf.json * chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/zcode.json * docs: record official sources for IME guidance * feat: add IME composition Enter guidance * chore: refresh runtime fingerprint for IME guidance * test: verify IME retrieval and Enter shortcut example * chore: update UX guideline count in README.az.md * chore: update UX guideline count in README.id.md * chore: update UX guideline count in README.ja.md * chore: update UX guideline count in README.vi.md * docs: record official sources for IME guidance * feat: add IME composition Enter guidance * chore: refresh runtime fingerprint for IME guidance * test: verify IME retrieval and Enter shortcut example * test: align platform query contract with UX count * docs: explain IME-safe Enter shortcuts and verification * chore: update UX guideline count in skill.json * docs: record official sources for IME guidance * feat: add IME composition Enter guidance * chore: refresh runtime fingerprint for IME guidance * test: verify IME retrieval and Enter shortcut example * chore: update UX guideline count in stack/README.md * chore: update UX guideline count in stack/docs/STACK.md * feat: add IME composition Enter guidance * docs: include IME Enter guidance in quick reference * chore: refresh runtime fingerprint for IME guidance * test: verify IME retrieval and Enter shortcut example * feat: add IME composition Enter guidance * chore: refresh runtime fingerprint for IME guidance * test: verify IME retrieval and Enter shortcut example * docs: include IME Enter guidance in quick reference * test: align platform query contract with UX count * docs: explain IME-safe Enter shortcuts and verification * feat: add IME composition Enter guidance * chore: refresh runtime fingerprint for IME guidance * test: verify IME retrieval and Enter shortcut example * docs: include IME Enter guidance in quick reference
5.1 KiB
IME-safe Enter shortcuts
Custom Enter-to-send or Enter-to-search handlers must distinguish an IME confirmation from a submission. Korean, Japanese and Chinese input methods can use Enter while composing text; sending at that point can publish unfinished text. This guidance covers web keyboard handlers, not a new native input implementation.
Plain DOM example
Use this shortcut on a labelled textarea with a separate submit button. Leave Shift+Enter available for newlines. This example handles only unmodified Enter; Ctrl, Meta and Alt shortcuts remain the application's separate policy. Route submission through the form so native validation and the submit handler still run.
<form id="message-form">
<label for="message">Message</label>
<textarea id="message" name="message" required></textarea>
<button type="submit">Send</button>
</form>
const textarea = document.querySelector('#message');
const form = document.querySelector('#message-form');
textarea.addEventListener('keydown', e => {
if (e.key !== 'Enter' || e.shiftKey || e.ctrlKey || e.metaKey || e.altKey) return;
// Suppress newline/implicit submit before deciding whether to send.
e.preventDefault();
if (e.isComposing || e.keyCode === 229) return;
if (!e.repeat) form.requestSubmit();
});
isComposing is the primary check. The deprecated keyCode === 229 check is a
narrow compatibility fallback for IME-handled keys on affected browsers, including
Safari configurations that deliver the confirming keydown after compositionend.
It is not a replacement for event.key or a general keyboard API recommendation.
A WebKit event-ordering fix was subsequently reverted (see issues 311717 and
317127). Do not assume the issue is confined to older Safari releases or remove
the fallback based only on the resolved status of issue 165004. Verify the exact
released browser/OS/input-method combinations you support.
The handled Enter path cancels its default action before checking composition, following Chrome's guidance, so returning from the 229 path does not leave a newline or implicit form submission behind. Actual IME confirmation behavior still needs the manual checks below.
In React, read isComposing from event.nativeEvent in an
onKeyDown handler. A compositionstart/compositionend flag alone does not cover
the Safari ordering described above. Do not submit from compositionend:
finishing text composition is not consent to send it.
The keyCode fallback can also be read from that native event; React also exposes
keyCode on its keyboard event. This guide's executable example is plain DOM,
not a mounted React component.
Virtual keyboards can report Unidentified or Process rather than Enter.
Do not interpret every 229 event as a submit request. Keep the explicit Send button
available so mobile users can submit without a hardware keyboard shortcut.
An ordinary single-line input inside a form, with no custom Enter handler, should keep native form submission. Do not add this handler to every input. For a custom single-line search shortcut, adapt the newline policy and apply the same IME guard.
This example requires HTMLFormElement.requestSubmit() support. If your target
browser lacks it, retain native form submission or use a separately tested submit
button path; do not assume this example supports every legacy Safari version.
Verification
Automated sample checks execute both the CSV and this document's JavaScript example. They cover handler branches, not an operating system IME. Before claiming browser/IME compatibility, manually check the supported browser, OS and input-method combinations and record their versions:
- Compose Korean text such as
한글and press Enter while composition is active. The composition-confirming key must not send, search or clear the field. - After composition has ended, press a separate Enter. Submit once; holding it must not cause repeated submissions. Check the intended modifier-key policy.
- Check Japanese conversion and Chinese candidate confirmation independently; Korean-only testing does not establish support for every CJK input method.
- Keep Shift+Enter newlines, normal typing, paste and the explicit Send button usable. Confirm that an empty required field still fails native validation.
- On affected Safari versions, inspect an IME-confirming keydown with isComposing false and keyCode 229; it must not activate the custom shortcut.
- On supported mobile keyboards, confirm that the visible Send button works even when the keyboard does not emit an identifiable Enter keydown.