reactjs / reactjs/react.dev

Add change vs input event description

Open
#619 1 comment 5 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
JavaScript
Stars
11.8k
Forks
7.9k
Avg merge
1d 11h
Merged PRs (30d)
11

Description

The Synthetic Events docs for form events points to the Forms doc page as a reference for onChange, onInput, onInvalid, and onSubmit, but the Form page does not go into any detail about these events, and more importantly, how React's change and input events differ from the DOM events of the same name.

It appears a small note used to exist in the Form doc, but has been removed.

A short note about the change event exists in the DOM Elements doc. This was not an obvious place to look to for this information to me, and it does not address the input event. At the very least, this should probably be link to in the Synthetic Events doc, if no other changes are made.

I would like to see a more thorough description of the change and input events and when to use them in the Form doc.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the Synthetic Events form-events section, the Forms documentation, and the DOM Elements onChange section linked in the issue. Compare their current coverage with the requested distinction between React's change and input events, and check the referenced pull request for prior wording. Done means the Forms documentation explains both events and when to use them, or clearly links to that explanation.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, react
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.