Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Add "user attention" definition to top-level traversable. #8466

Merged
merged 4 commits into from
Apr 28, 2023
Merged

Add "user attention" definition to top-level traversable. #8466

Changes from 2 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
12731e8
Add "user attention" definition to top-level traversable.
jan-ivar Nov 2, 2022
dc525e7
Export the user attention algorithm on Document instead.
jan-ivar Feb 28, 2023
808e93c
Use node navigable, s/URL/location/ bar, add comment, remove unused id.
jan-ivar Apr 4, 2023
6877e6e
wrapping
annevk Apr 28, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 12 additions & 2 deletions source
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -76045,8 +76045,18 @@ partial interface <span id="NavigatorUserActivation-partial">Navigator</span> {
system, possibly targeted at one of its <span data-x="nav-document">active document</span>'s
<span>descendant navigables</span>.</p>

<p class="note">System focus is lost when a browser window loses focus, but might also be lost to
other system widgets in the browser window such as a URL bar.</p>
<p id="tlbc-user-attention">A <span>top-level traversable</span> has <dfn for="top-level
jan-ivar marked this conversation as resolved.
Show resolved Hide resolved
jan-ivar marked this conversation as resolved.
Show resolved Hide resolved
traversable">user attention</dfn> when its <span>system visibility state</span> is
"<code data-x="">visible</code>", and it either has <span>system focus</span> or user agent
widgets directly related to it can receive keyboard input channeled from the operating system.</p>
jan-ivar marked this conversation as resolved.
Show resolved Hide resolved

<p class="note">User attention is lost when a browser window loses focus, whereas system focus might
Copy link

Choose a reason for hiding this comment

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

What does it mean by browser window losing focus?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

It means the browser window lost keyboard focus, which seems consistent with existing language in notes:

image

The note in this PR attempts to clarify the difference between user attention and system focus which both operate on that (the ability to "receive keyboard input channeled from the operating system").

also be lost to other system widgets in the browser window such as a URL bar.</p>
jan-ivar marked this conversation as resolved.
Show resolved Hide resolved

<p>A <code>Document</code> <var>d</var> is a <dfn export for="Document">fully active descendant of a
top-level traversible with user attention</dfn> when <var>d</var> is <span>fully active</span> and
<var>d</var>'s <span>relevant global object</span>'s <span data-x="window navigable">navigable</span>'s
jan-ivar marked this conversation as resolved.
Show resolved Hide resolved
<span data-x="nav-top">top-level traversable</span> has <span>user attention</span>.</p>

<p>The term <dfn>focusable area</dfn> is used to refer to regions of the interface that can further become
the target of such keyboard input. Focusable areas can be elements, parts of elements, or other regions
Expand Down