reactjs / reactjs/react.dev

Synthetic Events: Document deviations from spec

Open
#938 1 comment 1 reaction 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

On the Synthetic Events page, I think there should be a Note whenever the React behavior deviates from the spec.

For example, onBlur bubbles. And, if I remember correctly from when I was studying rich-text editing, the onSelect event is also different from the selectDOM event?

Also, would it be overkill to put them in three-column tables, like this?

Synthetic Event DOM Event Notes
onBlur blur In contrast to the DOM event specification, onBlur will bubble.

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 at the Synthetic Events page linked in the issue and compare the mentioned onBlur and onSelect behavior with the corresponding DOM events and specifications. Update the page with Notes describing confirmed deviations, using the proposed three-column layout if it fits; done means the documented examples are accurate and the page clearly distinguishes React behavior from DOM behavior.

Written by the indexing model from the issue text.

Assessment

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.