@@ -109,7 +109,7 @@ Historically, most browsers have not offered features to let the user move the f
109109Some, such as TV browsers, have enabled the user to move the focus using the arrow keys out of necessity,
110110since no other input mechanism is available on a typical TV remote control.
111111
112- Others, have enabled different key combinations to control spatial navigation,
112+ Others have enabled different key combinations to control spatial navigation,
113113such as pressing the <code class=key> Shift</code> key together with arrow keys.
114114
115115This ability to move around the page directionally is called <dfn lt="spatial navigation | spatialNavigation" export>spatial navigation</dfn> .
@@ -139,8 +139,7 @@ enabling the author to control and override how spatial navigation works.</span>
139139
140140Note: Some aspects of this specification, such as the JavaScript Events and APIs
141141could also be extended to sequential navigation,
142- in order to make sure that keyboard navigation in general
143- has a consistent and well defined model.
142+ in order to make sure that keyboard navigation has a consistent and well defined model in general.
144143
145144Note: As a general principle,
146145keyboard navigation,
@@ -193,7 +192,7 @@ More specifically,
193192the User Agent will first search for visible and focusable items
194193in the direction indicated
195194within the current <a>spatial navigation container</a>
196- (<span class=cssapi> by default </span> the root element, scrollable elements, and iframes<span class=cssapi> ,
195+ (<span class=cssapi> by default, </span> the root element, scrollable elements, and iframes<span class=cssapi> ,
197196but other elements can be made into <a>spatial navigation containers</a>
198197using the 'spatial-navigation-contain' property</span> ).
199198
@@ -366,8 +365,8 @@ the following requirements apply:
366365 the text insertion caret when an editable element is focused,
367366 the arrow keys should by default to moving the caret.
368367 Spatial navigation would only be triggered by the arrow keys
369- when the focused element is not editable,
370- or when it is editable but the caret cannot move any further in the requested direction.
368+ when the focused element is not editable
369+ or when it is editable, but the caret cannot move any further in the requested direction.
371370 </div>
372371
373372 An exception is made for scrolling:
@@ -401,7 +400,7 @@ The {{Window/navigate()}} method enables the author to trigger spatial navigatio
401400as if the user had done so manually
402401(for instance, by pressing the arrow keys in a browser where that is the way to trigger spatial navigation).
403402
404- Note: As this triggers the same processing model as a manual navigation,
403+ Note: As this triggers the same processing model as manual navigation,
405404all the same results should be expected:
406405the same chain of events will be fired and
407406the same element will be scrolled or focused.
@@ -412,7 +411,7 @@ such as mapping to different keys,
412411or triggering spatial navigation from a clickable on-screen directional pad,
413412or in reaction to other events than UI ones.
414413It could also be used when an author wants to interrupt navigation to do some asynchronous operation
415- (e.g. load more content in an infinite scroller) then resume the navigation where they cancelled .
414+ (e.g. load more content in an infinite scroller) then resume the navigation where they canceled .
416415
417416Note: This API is also useful for testing purposes,
418417as there it is difficult to trigger spatial navigation
@@ -536,7 +535,7 @@ the User Agent must run the steps described below:
536535 1. Let <var> direction</var> be the value of <var> dir</var> .
537536 2. Let <var> container</var> be
538537 * if the value of {{SpatialNavigationSearchOptions/container}} attribute of <var> options</var> is not null,
539- * itself, if it is <a>sptial navigation container</a> .
538+ * itself, if it is <a>spatial navigation container</a> .
540539 * its nearest <a>spatial navigation container</a> ancestor, otherwise.
541540 * else the element's nearest <a>spatial navigation container</a> ancestor.
542541 3. Let <var> areas</var> be
@@ -1114,6 +1113,8 @@ If the status of <var>focus target</var> changed not by moving the focus,
111411133. If <var> focus target</var> is completely off-screen,
11151114 then let <var> searchOrigin</var> be the viewport of <var> focus target</var> 's nearest visible <a>spatial navigation container</a> .
11161115
1116+ NOTE: The User Agent should <a>update the search origin</a> , for example,
1117+ when the focused element was scrolled out by mouse scrolling or vanished from the viewport.
11171118</div>
11181119
11191120<div algorithm="to find focusable areas">
@@ -1140,7 +1141,7 @@ run the following steps:
11401141 Except for elements that are in the currently non visible part of a scroller,
11411142 spatial navigation does not automatically exclude
11421143 elements which cannot be clicked on,
1143- for example due to being obscured by some other element.
1144+ for example, due to being obscured by some other element.
11441145 To avoid breaking assumptions in
11451146 the application logic if a user actually focuses and activates such an element,
11461147 and to avoid confusing users by focusing invisible or apparently unreachable elements,
@@ -1292,14 +1293,14 @@ The meaning of each term is as follows:
12921293</dl>
12931294
12941295Note: This general formula was picked from several plausible alternatives,
1295- based on which one most often match intuition
1296+ based on which one most often matches intuition
12961297when used to select the best candidate
12971298in a series of <a href="https://wicg.github.io/spatial-navigation/tests/ux/list.html">UX test cases</a> .
12981299Similarly, the values of <var> alignWeight</var> and <var> orthogonalWeight</var>
12991300were also determined experimentally based on the same test cases.
13001301The resulting formula is somewhat complicated,
13011302but seems to give good answers.
1302- Suggestions on improvements or simplifications are welcome.
1303+ Suggestions for improvements or simplifications are welcome.
13031304
13041305</div>
13051306
@@ -1713,6 +1714,7 @@ The editors of this specification would like to thank the following individuals
17131714* Alice Boxhall
17141715* Brian Kardell
17151716* Elika Etemad
1717+ * Eric Seong
17161718* Hugo Holgersson
17171719* Hyojin Song
17181720* Jeonghee Ahn
0 commit comments