Skip to content

Commit 1977777

Browse files
author
Jihye Hong
committed
[css-nav-1] Fix and upate the description
Update the description about `spatial-navigation-function`
1 parent d9a9947 commit 1977777

1 file changed

Lines changed: 25 additions & 20 deletions

File tree

css-nav-1/Overview.bs

Lines changed: 25 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1171,7 +1171,7 @@ run the following steps:
11711171
</div>
11721172

11731173
<div algorithm="to find the shortest the distance">
1174-
To <dfn lt="find the shortest distance">find the shortest distance</dfn>
1174+
To <dfn lt="find the shortest distance | finding the shortest distance">find the shortest distance</dfn>
11751175
between a <var>reference</var> and a <var>candidate</var>
11761176
in direction <var>dir</var>,
11771177
find the points <var>P1</var> and <var>P2</var>,
@@ -1504,36 +1504,41 @@ Selecting the navigation algorithm: the 'spatial-navigation-function' property</
15041504
Name: spatial-navigation-function
15051505
Value: normal | grid
15061506
Initial: normal
1507-
Applies to: <a>spatial navigation container</a>
1507+
Applies to: <a>spatial navigation focus container</a>
15081508
Inherited: yes
15091509
</pre>
15101510

1511-
Depending on the layout types, the default algorithm of spatial navigation may need the fine tune.
1511+
The default algorithm of spatial navigation specified in the [[#processing-model]] may need the fine tune depending on the layout types.
1512+
This property allows the author to indicate which navigation algorithm is reasonable for spatial navigation behavior.
1513+
1514+
Its values are defined as follows:
15121515

15131516
<dl dfn-for=spatial-navigation-function dfn-type=value>
15141517
<dt><dfn>normal</dfn>
15151518
<dd>
15161519
Moves the focus with the default focus navigation algorithm defined by UA.
1517-
In general, the focus moves to the closest element from the <a>spatial navigation starting point</a>.
1520+
1521+
In general, the focus moves to the element with the closest distance calculated by <a>finding the shortest distance</a>.
15181522

15191523
<dt><dfn>grid</dfn>
15201524
<dd>
1521-
Moves the focus to the closest element based on 2D rectilinear distance.
1522-
1523-
If there are more than one aligned candidates in the navigation direction,
1524-
Among the aligned candidates, select the best one as a result of the calculation from the distance
1525-
along the axis which corresponds to the navigation direction.
1526-
In case of best candidates more than two, select the best one with the minimum amount of alignment.
1527-
1528-
Else if there isn't any aligned candidate in a given direction,
1529-
Among not aligned)candidates, select the best ones as a result of calculation from the distance
1530-
along the axis which corresponds to the navigation direction.
1531-
In case of best candidates more than two, select the best one with the minimum distance
1532-
along the axis which is orthogonal to the navigation direction.
1525+
Moves the focus to the element which is aligned most in the navigation direction.
1526+
1527+
* If there are more than one aligned candidates in the navigation direction,
1528+
select the element with the closest distance along the axis which corresponds to the navigation direction.
1529+
In case of multiple elements with the same distance,
1530+
select the element with the minimum amount of alignment.
1531+
1532+
* Else if there isn't any aligned candidate in a given direction,
1533+
select the element with the closest distance along the axis which corresponds to the navigation direction.
1534+
In case of multiple elements with the same distance,
1535+
select the element with the minimum distance along the axis which is orthogonal to the navigation direction.
15331536
</dl>
15341537

1538+
NOTE: These values are negotiated with the users' preferences which seems natural spatial navigation behavior for their pages.
1539+
15351540
<div class=example>
1536-
This example shows how the focus moves differently by the value of <code>spatial-navigation-function</code>.
1541+
This example shows how the focus moves differently by the value of <code highlight=css>spatial-navigation-function</code>.
15371542

15381543
<figure>
15391544
<img alt="" src="images/spatnav-function.png" style="width: 500px;"/>
@@ -1542,9 +1547,9 @@ Depending on the layout types, the default algorithm of spatial navigation may n
15421547

15431548
Let the element which contains "A", "B", "C" and "D" is the <a>spatial navigation focus container</a>.
15441549

1545-
If <code>normal</code> value is given to <code>spatial-navigation-function</code> of the element,
1546-
when the user presses the down arrow key, the focus will move to "C".
1547-
Otherwise, <code>grid</code> was specified to the element, the focus will move to "B".
1550+
When the user presses the down arrow key,
1551+
if <code highlight=css>normal</code> value is given to <code highlight=css>spatial-navigation-function</code> of the element, the focus will move to "B".
1552+
Otherwise, <code highlight=css>grid</code> value was specified to the element, the focus will move to "C".
15481553
</div>
15491554

15501555
<h2 class=no-num id=scrolling>Appendix A. Scroll extensions</h2>

0 commit comments

Comments
 (0)