@@ -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>
11751175between a <var> reference</var> and a <var> candidate</var>
11761176in direction <var> dir</var> ,
11771177find the points <var> P1</var> and <var> P2</var> ,
@@ -1504,36 +1504,41 @@ Selecting the navigation algorithm: the 'spatial-navigation-function' property</
15041504Name : spatial-navigation-function
15051505Value : normal | grid
15061506Initial : normal
1507- Applies to : <a>spatial navigation container</a>
1507+ Applies to : <a>spatial navigation focus container</a>
15081508Inherited : 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