Skip to content

Commit e6e0c88

Browse files
author
Jihye Hong
committed
Add the glossary section
1 parent 57ef8a9 commit e6e0c88

File tree

1 file changed

+31
-25
lines changed

1 file changed

+31
-25
lines changed

css-nav-1/Overview.bs

Lines changed: 31 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -970,6 +970,37 @@ to fully define the behavior.
970970
Issue(w3c/csswg-drafts#3376): The following currently does not account
971971
for <a href="https://github.com/WICG/overscroll-behavior">the proposed overscroll-behavior specification</a>.
972972

973+
<h3 id=grouping>
974+
Glossary</h3>
975+
976+
The following term definitions have been specified to explain the processing model for spatial navigation.
977+
See the links within the definitions for more information.
978+
979+
The <dfn>boundary box</dfn> of an object is defined as follows:
980+
* if the object is a point, the boundary box is that point
981+
* if the object is a [=box=] or [=box fragment=], the boundary box is the <a>border box</a> of that box or fragment
982+
* if the object is a <a>focusable area</a> which is not an element, the boundary box is the axis-aligned the bounding box of that <a>focusable area</a>
983+
984+
The <dfn>inside area</dfn> of an object is defined as follows:
985+
* if the object is a <a>scroll container</a>, its <a>optimal viewing region</a>
986+
* if the object is a <a>document</a>, the viewport of its <a>browsing context</a>
987+
* if the object is a [=box=] or [=box fragment=], its <a>boundary box</a>
988+
* otherwise, the <a>optimal viewing region</a> of its nearest ancestor <a>scroll container</a>
989+
990+
NOTE: If an object is offscreen, the <a>inside area</a> should be the nearest visible ancestor container.
991+
992+
Issue(w3c/csswg-drafts#2324): CSS should have a term for “border box taking into account corner shaping properties like border-radius”.
993+
994+
The <dfn>search origin</dfn> is the origin for searching next target.
995+
996+
The <dfn>spatial navigation starting point</dfn> is the origin for searching next target which is set by the User Agent. It is initially unset and it can be element or point.
997+
998+
Note: For example, the User Agent could set it to the position of the user's click if the user clicks on the document contents,
999+
and unset when the focus is moved (by spatial navigation or any other means).
1000+
1001+
If the User Agent sets both a <a>spatial navigation starting point</a> and a <a>sequential focus navigation starting point</a>,
1002+
they must not be set differently.
1003+
9731004
<h3 id=grouping>
9741005
Groupings of elements</h3>
9751006

@@ -1099,31 +1130,6 @@ which would be bad for users.
10991130
All geometrical operations in this section are defined to work on the result of CSS layout,
11001131
including all graphical transformations, such as <a>relative positioning</a> or [[CSS-TRANSFORMS-1]].
11011132

1102-
The <dfn>boundary box</dfn> of an object is defined as follows:
1103-
* if the object is a point, the boundary box is that point
1104-
* if the object is a [=box=] or [=box fragment=], the boundary box is the <a>border box</a> of that box or fragment
1105-
* if the object is a <a>focusable area</a> which is not an element, the boundary box is the axis-aligned the bounding box of that <a>focusable area</a>
1106-
1107-
The <dfn>inside area</dfn> of an object is defined as follows:
1108-
* if the object is a <a>scroll container</a>, its <a>optimal viewing region</a>
1109-
* if the object is a <a>document</a>, the viewport of its <a>browsing context</a>
1110-
* if the object is a [=box=] or [=box fragment=], its <a>boundary box</a>
1111-
* otherwise, the <a>optimal viewing region</a> of its nearest ancestor <a>scroll container</a>
1112-
1113-
NOTE: If an object is offscreen, the <a>inside area</a> should be the nearest visible ancestor container.
1114-
1115-
Issue(w3c/csswg-drafts#2324): CSS should have a term for “border box taking into account corner shaping properties like border-radius”.
1116-
1117-
The <dfn>search origin</dfn> is the origin for searching next target.
1118-
1119-
The <dfn>spatial navigation starting point</dfn> is the origin for searching next target which is set by the User Agent. It is initially unset and it can be element or point.
1120-
1121-
Note: For example, the User Agent could set it to the position of the user's click if the user clicks on the document contents,
1122-
and unset when the focus is moved (by spatial navigation or any other means).
1123-
1124-
If the User Agent sets both a <a>spatial navigation starting point</a> and a <a>sequential focus navigation starting point</a>,
1125-
they must not be set differently.
1126-
11271133
<div algorithm="to set the search origin">
11281134

11291135
To <dfn lt="set the search origin | setting the search origin">set the <a>search origin</a></dfn>,

0 commit comments

Comments
 (0)