Skip to content

Commit 3fb0de2

Browse files
author
Jihye Hong
committed
[css-nav-1] Modify Overview section
1 parent 49fa68b commit 3fb0de2

1 file changed

Lines changed: 14 additions & 17 deletions

File tree

css-nav-1/Overview.bs

Lines changed: 14 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -117,16 +117,16 @@ This ability to move around the page directionally is called <dfn lt="spatial na
117117
<a>Spatial navigation</a> can be useful for a web page built using a grid-like layout,
118118
or other predominantly non linear layouts.
119119
The figure below represents a photo gallery arranged in a grid layout.
120-
If the user presses the <code class=key>Tab</code> key to move focus around the images,
120+
If the user presses the <code class=key>Tab</code> key to move focus around the images,
121121
they need to press the key many times to reach the desired image element.
122122

123123
<figure>
124124
<img alt="When elements are laid out in a grid pattern, spatial navigation makes it much easier to predict and control where focus should move to." src="images/gallery-app.png" style="width: 500px;"/>
125125
<figcaption>Photo gallery application example using a grid layout</figcaption>
126126
</figure>
127127

128-
Also, <a>spatial navigation</a> moves the focus to the predictable element for users
129-
because it moves the focus among focusable elements depending on their position.
128+
Also, <a>spatial navigation</a> moves the focus to the predictable element for users
129+
because it moves the focus among focusable elements depending on their position.
130130
Sometimes elements on the page aren’t arranged independently of their source order.
131131
Therefore unlike <a>spatial navigation</a>, sequential navigation using the <code class=key>Tab</code> key makes focus navigation unpredictable.
132132

@@ -219,9 +219,7 @@ the elements that are reachable by sequential navigation
219219
and by spatial navigation are almost the same.
220220
Elements that are currently outside of the viewport of a scrollable element
221221
can only be reached by spatial navigation once they have been scrolled into view.
222-
Therefore, elements that cannot be scrolled into view
223-
(for example because they are placed at a negative offset)
224-
cannot be reached by spatial navigation.
222+
Therefore, elements that cannot be scrolled into view by default.
225223

226224
<div class=api>
227225
At key points during this search for the appropriate response to the spatial navigation request,
@@ -321,10 +319,9 @@ This intentionally left for User Agents to decide.
321319
will use spatial navigation as their primary or exclusive navigation mechanism.
322320
</div>
323321

324-
Although it is possible for User Agents
325-
to implement the processing model and APIs defined by the specification
326-
without giving any direct means to the user to trigger spatial navigation themselves,
327-
this specification recommends not to do so:
322+
Although User Agents can implement the processing model and APIs
323+
defined by the specification,
324+
this specification recommends that
328325
User Agents should offer a means for users to trigger spatial navigation directly,
329326
without having to use the APIs.
330327

@@ -623,10 +620,10 @@ This event occurs when there is a valid result of <a>selecting the best candidat
623620

624621
The User Agent <dfn lt="dispatches navbeforefocus event | dispatching navbeforefocus event">dispatches <a event>navbeforefocus</a> event</dfn>
625622
before spatial navigation moves the focus.
626-
The <a>event target</a> is the element which has focus and
623+
The <a>event target</a> is the element which has focus and
627624
the {{NavigationEvent/relatedTarget}} is the element which is about to receive focus.
628625

629-
If <a>navigation-override</a> is disabled in the [=node document=] of <var>eventTarget</var> for
626+
If <a>navigation-override</a> is disabled in the [=node document=] of <var>eventTarget</var> for
630627
the <a spec=html for="/">origin</a> of the [=active document=] of the [=top-level browsing context=], this event won't be dispatched.
631628

632629
<div class='example'>
@@ -733,10 +730,10 @@ when it cannot be scrolled further.
733730
</table>
734731

735732
The User Agent <dfn lt="dispatches navnotarget event | dispatching navnotarget event">dispatches <a event>navnotarget</a> event</dfn>
736-
with initializing the <a>event target</a> as the element which has focus and
733+
with initializing the <a>event target</a> as the element which has focus and
737734
the {{NavigationEvent/relatedTarget}} as <a>spatial navigation container</a> of the <a>event target</a>.
738735

739-
If <a>navigation-override</a> is disabled in the [=node document=] of <var>eventTarget</var> for
736+
If <a>navigation-override</a> is disabled in the [=node document=] of <var>eventTarget</var> for
740737
the <a spec=html for="/">origin</a> of the [=active document=] of the [=top-level browsing context=], this event won't be dispatched.
741738

742739
<div class='example'>
@@ -1024,9 +1021,9 @@ To run the <dfn>spatial navigation steps</dfn> in <var>direction</var>, do the f
10241021
<span class=cssapi>if computed value of the 'spatial-navigation-action' property on <var>eventTarget</var>
10251022
is ''spatial-navigation-action/focus'' or to <code>true</code> otherwise.
10261023
</span>
1027-
2.
1024+
2.
10281025
<ul>
1029-
<span class=cssapi><li>If
1026+
<span class=cssapi><li>If
10301027
the computed value of the 'spatial-navigation-action' property on <var>eventTarget</var> is not ''spatial-navigation-action/focus''
10311028
and <var>eventTarget</var> <a>can be manually scrolled</a>,
10321029
then <a>directionally scroll the element</a> <var>eventTarget</var> in <var>direction</var> and return.</li></span>
@@ -1204,7 +1201,7 @@ run the following steps:
12041201
* bottom edge is above the bottom edge of <var>searchOrigin</var>'s <a>boundary box</a> if <var>dir</var> is {{SpatialNavigationDirection/up}}
12051202
* right edge is left of the right edge of <var>searchOrigin</var>'s <a>boundary box</a> if <var>dir</var> is {{SpatialNavigationDirection/left}}
12061203
* left edge is right of the left edge of <var>searchOrigin</var>'s <a>boundary box</a> if <var>dir</var> is {{SpatialNavigationDirection/right}}
1207-
1204+
12081205
NOTE: More detail condition about how the element is overlapped with the search origin affects the sequence of focus movement.
12091206
The sequence of focus movement is related to UX, so it depends on the UA-defined mechanism.
12101207

0 commit comments

Comments
 (0)