jquery / jquery/api.jquery.com

Add reusable note to blur, focusout, focusin, focus pages

Open
#930 11 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
HTML
Stars
325
Forks
260
PR merge metrics
No merged PRs in 30d

Description

See https://github.com/jquery/jquery/issues/3123

How about something like this?

Note: Use of focus-related events are complicated by several factors. On Internet Explorer, focus and blur are asynchronous and do not occur at the point where the .focus() method is called in your code. The focusout and focusin events are implemented inconsistently across browsers and not implemented at all on Firefox, although jQuery simulates the event. Code should not depend on the order of focusin and focusout events relative to focus and blur because it varies across browsers. On all platforms, focusout on the previously focused element (if any) will always occur before focusin on the new one, and blur occurs before focus.

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 blur, focusout, focusin, and focus API pages in api.jquery.com, and review related issue #3123 for context. Add the reusable focus-event note from this issue to the relevant pages, then verify that the wording and placement are consistent across all four pages.

Written by the indexing model from the issue text.

Assessment

Tech stack
jquery
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
50/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.