Skip to content

Commit c0c700f

Browse files
committed
[css-ui-3] Bikeshed improvements
Closes w3c#147
1 parent face62a commit c0c700f

2 files changed

Lines changed: 277 additions & 279 deletions

File tree

css-ui/Overview.bs

Lines changed: 124 additions & 151 deletions
Original file line numberDiff line numberDiff line change
@@ -125,20 +125,16 @@ of Cascading Style Sheets, level 2, revision 1 [[CSS21]]
125125

126126
<h3 id="box-sizing">'box-sizing' property</h3>
127127

128-
<table class="propdef"><tbody>
129-
<tr><th>Name:</th><td><dfn>box-sizing</dfn></td></tr>
130-
<tr><th>Value:</th><td>
131-
content-box |
132-
border-box
133-
</td></tr>
134-
<tr><th>Initial:</th><td>content-box</td></tr>
135-
<tr><th>Applies to:</th><td>all elements that accept width or height</td></tr>
136-
<tr><th>Inherited:</th><td>no</td></tr>
137-
<tr><th>Percentages:</th><td>N/A</td></tr>
138-
<tr><th>Media:</th><td>visual</td></tr>
139-
<tr><th>Computed&nbsp;value:</th><td>specified value</td></tr>
140-
<tr><th>Animatable:</th><td>no</td></tr>
141-
</tbody></table>
128+
<pre class="propdef">
129+
Name: box-sizing
130+
Value: content-box | border-box
131+
Initial: content-box
132+
Applies to: all elements that accept width or height
133+
Inherited: no
134+
Percentages: N/A
135+
Media: visual
136+
Computed value: specified value
137+
</pre>
142138

143139
<dl dfn-type=value dfn-for=box-sizing>
144140
<dt><dfn>content-box</dfn></dt>
@@ -278,62 +274,58 @@ The rendering of applying transforms to outlines is left explicitly undefined in
278274

279275
<h3 id="outline">'outline' property</h3>
280276

281-
<table class="propdef"><tbody>
282-
<tr><th>Name:</th><td><dfn>outline</dfn></td></tr>
283-
<tr><th>Value:</th><td>
284-
[ &lt;'outline-color'&gt; || &lt;'outline-style'&gt; ||
285-
&lt;'outline-width'&gt; ]
286-
</td></tr>
287-
<tr><th>Initial:</th><td>see individual properties</td></tr>
288-
<tr><th>Applies to:</th><td>all elements</td></tr>
289-
<tr><th>Inherited:</th><td>no</td></tr>
290-
<tr><th>Percentages:</th><td>N/A</td></tr>
291-
<tr><th>Media:</th><td>visual</td></tr>
292-
<tr><th>Computed&nbsp;value:</th><td>see individual properties</td></tr>
293-
<tr><th>Animatable:</th><td>see individual properties</td></tr>
294-
</tbody></table>
277+
<pre class="propdef">
278+
Name: outline
279+
Value: [ <'outline-color'> || <'outline-style'> || <'outline-width'> ]
280+
Initial: see individual properties
281+
Applies to: all elements
282+
Inherited: no
283+
Percentages: N/A
284+
Media: visual
285+
Computed value: see individual properties
286+
Animation type: see individual properties
287+
</pre>
295288

296289
<h3 id="outline-width">'outline-width' property</h3>
297290

298-
<table class="propdef"><tbody>
299-
<tr><th>Name:</th><td><dfn>outline-width</dfn></td></tr>
300-
<tr><th>Value:</th><td><<'border-width'>></td></tr>
301-
<tr><th>Initial:</th><td>medium</td></tr>
302-
<tr><th>Applies to:</th><td>all elements</td></tr>
303-
<tr><th>Inherited:</th><td>no</td></tr>
304-
<tr><th>Percentages:</th><td>N/A</td></tr>
305-
<tr><th>Media:</th><td>visual</td></tr>
306-
<tr><th>Computed&nbsp;value:</th><td>absolute length; ''0'' if the outline style is ''outline-width/none''.</td></tr>
307-
<tr><th>Animatable:</th><td>as <a href="https://drafts.csswg.org/css3-transitions/#animtype-length">length</a></td></tr>
308-
</tbody></table>
291+
<pre class="propdef">
292+
Name: outline-width
293+
Value: <'border-width'>
294+
Initial: medium
295+
Applies to: all elements
296+
Inherited: no
297+
Percentages: N/A
298+
Media: visual
299+
Computed value: absolute length; ''0'' if the outline style is ''outline-width/none''.
300+
Amination type: <a href="https://drafts.csswg.org/css3-transitions/#animtype-length">length</a>
301+
</pre>
309302

310303
<h3 id="outline-style">'outline-style' property</h3>
311304

312-
<table class="propdef"><tbody>
313-
<tr><th>Name:</th><td><dfn>outline-style</dfn></td></tr>
314-
<tr><th>Value:</th><td>auto | <<'border-style'>></td></tr>
315-
<tr><th>Initial:</th><td>none</td></tr>
316-
<tr><th>Applies to:</th><td>all elements</td></tr>
317-
<tr><th>Inherited:</th><td>no</td></tr>
318-
<tr><th>Percentages:</th><td>N/A</td></tr>
319-
<tr><th>Media:</th><td>visual</td></tr>
320-
<tr><th>Computed&nbsp;value:</th><td>specified value</td></tr>
321-
<tr><th>Animatable:</th><td>no</td></tr>
322-
</tbody></table>
305+
<pre class="propdef">
306+
Name: outline-style
307+
Value: auto | <'border-style'>
308+
Initial: none
309+
Applies to: all elements
310+
Inherited: no
311+
Percentages: N/A
312+
Media: visual
313+
Computed value: as specified
314+
</pre>
323315

324316
<h3 id="outline-color">'outline-color' property</h3>
325317

326-
<table class="propdef"><tbody>
327-
<tr><th>Name:</th><td><dfn>outline-color</dfn></td></tr>
328-
<tr><th>Value:</th><td><<color>> | invert</td></tr>
329-
<tr><th>Initial:</th><td>invert</td></tr>
330-
<tr><th>Applies to:</th><td>all elements</td></tr>
331-
<tr><th>Inherited:</th><td>no</td></tr>
332-
<tr><th>Percentages:</th><td>N/A</td></tr>
333-
<tr><th>Media:</th><td>visual</td></tr>
334-
<tr><th>Computed&nbsp;value:</th><td>The computed value for ''invert'' is ''invert''. For <<color>> values, the computed value is as defined for the [[!CSS3COLOR]] 'color' property.</td></tr>
335-
<tr><th>Animatable:</th><td>as <a href="https://drafts.csswg.org/css3-transitions/#animtype-color">color</a></td></tr>
336-
</tbody></table>
318+
<pre class="propdef">
319+
Name: outline-color
320+
Value: <<color>> | invert
321+
Initial: invert
322+
Applies to: all elements
323+
Inherited: no
324+
Percentages: N/A
325+
Media: visual
326+
Computed value: The computed value for ''invert'' is ''invert''. For <<color>> values, the computed value is as defined for the [[!CSS3COLOR]] 'color' property.
327+
Animation Type: <a href="https://drafts.csswg.org/css3-transitions/#animtype-color">color</a>
328+
</pre>
337329

338330
The outline created with the outline properties is drawn "over" a box,
339331
i.e., the outline is always on top,
@@ -454,17 +446,17 @@ it may well overlap other elements on the page.
454446
By default, the outline is drawn starting just outside the <a>border edge</a>.
455447
However, it is possible to offset the outline and draw it beyond the <a>border edge</a>.
456448

457-
<table class="propdef"><tbody>
458-
<tr><th>Name:</th><td><dfn>outline-offset</dfn></td></tr>
459-
<tr><th>Value:</th><td><<length>></td></tr>
460-
<tr><th>Initial:</th><td>0</td></tr>
461-
<tr><th>Applies to:</th><td>all elements</td></tr>
462-
<tr><th>Inherited:</th><td>no</td></tr>
463-
<tr><th>Percentages:</th><td>N/A</td></tr>
464-
<tr><th>Media:</th><td>visual</td></tr>
465-
<tr><th>Computed&nbsp;value:</th><td><<length>> value in absolute units (px or physical).</td></tr>
466-
<tr><th>Animatable:</th><td>as <a href="https://drafts.csswg.org/css3-transitions/#animtype-length">length</a></td></tr>
467-
</tbody></table>
449+
<pre class="propdef">
450+
Name: outline-offset
451+
Value: <<length>>
452+
Initial: 0
453+
Applies to: all elements
454+
Inherited: no
455+
Percentages: N/A
456+
Media: visual
457+
Computed value: <<length>> value in absolute units (px or physical).
458+
Animation Type: <a href="https://drafts.csswg.org/css3-transitions/#animtype-length">length</a>
459+
</pre>
468460

469461
If the computed value of 'outline-offset'
470462
is anything other than 0,
@@ -511,18 +503,17 @@ The 'resize' property allows the author
511503
to specify whether or not an element is resizable by the user,
512504
and if so, along which axis/axes.
513505

514-
<table class="propdef"><tbody>
515-
<tr><th>Name:</th><td><dfn>resize</dfn></td></tr>
516-
<tr><th>Value: </th><td>none | both | horizontal | vertical</td></tr>
517-
<tr><th>Initial:</th><td>none</td></tr>
518-
<tr><th>Applies to:</th><td>elements with 'overflow' other than visible,
519-
and optionally replaced elements such as images, videos, and iframes</td></tr>
520-
<tr><th>Inherited:</th><td>no</td></tr>
521-
<tr><th>Percentages:</th><td>N/A</td></tr>
522-
<tr><th>Media:</th><td>visual</td></tr>
523-
<tr><th>Computed&nbsp;value:</th><td>specified value.</td></tr>
524-
<tr><th>Animatable:</th><td>no</td></tr>
525-
</tbody></table>
506+
<pre class="propdef">
507+
Name: resize
508+
Value: none | both | horizontal | vertical
509+
Initial: none
510+
Applies to: elements with 'overflow' other than visible,
511+
and optionally replaced elements such as images, videos, and iframes
512+
Inherited: no
513+
Percentages: N/A
514+
Media: visual
515+
Computed value: as specified
516+
</pre>
526517

527518
<dl>
528519
<dt>none</dt>
@@ -638,31 +629,16 @@ too bad we don't have @viewport yet. otherwise this would be cool:
638629
<h3 id="text-overflow">
639630
Overflow Ellipsis: the 'text-overflow' property</h3>
640631

641-
<table class="propdef"><tbody>
642-
<tr><th>Name:</th>
643-
<td><dfn>text-overflow</dfn></td></tr>
644-
<tr><th>Value:</th>
645-
<td> [
646-
clip |
647-
ellipsis |
648-
<<string>>
649-
]{1,2}
650-
</td></tr>
651-
<tr><th>Initial:</th>
652-
<td>clip</td></tr>
653-
<tr><th>Applies to:</th>
654-
<td>block containers</td></tr>
655-
<tr><th>Inherited:</th>
656-
<td>no</td></tr>
657-
<tr><th>Percentages:</th>
658-
<td>N/A</td></tr>
659-
<tr><th>Media:</th>
660-
<td>visual</td></tr>
661-
<tr><th>Computed&nbsp;value:</th>
662-
<td>as specified</td></tr>
663-
<tr><th>Animatable:</th>
664-
<td>no</td></tr>
665-
</tbody></table>
632+
<pre class="propdef">
633+
Name: text-overflow
634+
Value: [ clip | ellipsis | <<string>> ]{1,2}
635+
Initial: clip
636+
Applies to: block containers
637+
Inherited: no
638+
Percentages: N/A
639+
Media: visual
640+
Computed value: as specified
641+
</pre>
666642

667643
This property specifies rendering when inline content overflows
668644
its line box edge
@@ -957,29 +933,26 @@ then only the end ellipsis/string should be rendered.
957933
<h3 id="pointer-interaction">Pointer interaction</h3>
958934

959935
<h4 id="cursor">'cursor' property</h4>
960-
<table class="propdef"><tbody>
961-
<tr><th>Name:</th><td><dfn>cursor</dfn></td></tr>
962-
<tr><th>Value:</th><td>
963-
[ [<<url>> [&lt;x&gt; &lt;y&gt;]?,]* <br>
964-
[ auto | default | none |<br>
936+
<pre class="propdef">
937+
Name: cursor
938+
Value: [ [<<url>> [&lt;x&gt; &lt;y&gt;]?,]* <br>
939+
[ auto | default | none |<br>
965940
context-menu | help | pointer | progress | wait | <br>
966941
cell | crosshair | text | vertical-text | <br>
967942
alias | copy | move | no-drop | not-allowed | grab | grabbing | <br>
968943
e-resize | n-resize | ne-resize | nw-resize | s-resize | se-resize | sw-resize | w-resize |
969944
ew-resize | ns-resize | nesw-resize | nwse-resize |
970945
col-resize | row-resize |
971-
all-scroll
972-
| zoom-in | zoom-out
973-
<br>
974-
] ] </td></tr>
975-
<tr><th>Initial:</th><td>auto</td></tr>
976-
<tr><th>Applies to:</th><td>all elements</td></tr>
977-
<tr><th>Inherited:</th><td>yes</td></tr>
978-
<tr><th>Percentages:</th><td>N/A</td></tr>
979-
<tr><th>Media:</th><td>visual, interactive</td></tr>
980-
<tr><th>Computed&nbsp;value:</th><td>as specified, except with any relative URLs converted to absolute</td></tr>
981-
<tr><th>Animatable:</th><td>no</td></tr>
982-
</tbody></table>
946+
all-scroll |<br>
947+
zoom-in | zoom-out <br>
948+
] ]
949+
Initial: auto
950+
Applies to: all elements
951+
Inherited: yes
952+
Percentages: N/A
953+
Media: visual, interactive
954+
Computed value: as specified, except with any relative URLs converted to absolute
955+
</pre>
983956

984957
This property specifies the type of cursor to be displayed for the pointing device
985958
when the cursor's hotspot is within the element's <a>border edge</a>.
@@ -1268,17 +1241,18 @@ boxes are generated for it and its cursor is used for the canvas.
12681241
<h3 id="insertion-caret">Insertion caret</h3>
12691242

12701243
<h4 id="caret-color">Coloring the insertion caret: caret-color</h4>
1271-
<table class="propdef"><tbody>
1272-
<tr><th>Name: </th><td><dfn>caret-color</dfn></td></tr>
1273-
<tr><th>Value: </th><td>auto | <<color>></td></tr>
1274-
<tr><th>Initial:</th><td>auto</td></tr>
1275-
<tr><th>Applies to:</th><td>elements that accept input</td></tr>
1276-
<tr><th>Inherited:</th><td>yes</td></tr>
1277-
<tr><th>Percentages:</th><td>N/A</td></tr>
1278-
<tr><th>Media:</th><td>interactive</td></tr>
1279-
<tr><th>Computed&nbsp;value:</th><td>The computed value for ''caret-color/auto'' is ''caret-color/auto''. For <<color>> values, the computed value is as defined for the [[!CSS3COLOR]] 'color' property.</td></tr>
1280-
<tr><th>Animatable:</th><td>as <a href="https://drafts.csswg.org/css3-transitions/#animtype-color">color</a></td></tr>
1281-
</tbody></table>
1244+
<pre class="propdef">
1245+
Name: caret-color
1246+
Value: auto | <<color>>
1247+
Initial: auto
1248+
Applies to: elements that accept input
1249+
Inherited: yes
1250+
Percentages: N/A
1251+
Media: interactive
1252+
Computed value: The computed value for ''caret-color/auto'' is ''caret-color/auto''.
1253+
For <<color>> values, the computed value is as defined for the [[!CSS3COLOR]] 'color' property.
1254+
Animation Type: <a href="https://drafts.csswg.org/css3-transitions/#animtype-color">color</a>
1255+
</pre>
12821256

12831257
<dl>
12841258
<dt>auto</dt>
@@ -1310,23 +1284,22 @@ Note: The caret-color property is at risk.
13101284
<h3 id="keyboard">Keyboard control</h3>
13111285

13121286
<h4 id="nav-dir">Directional focus navigation: the 'nav-up', 'nav-right', 'nav-down', 'nav-left' properties</h4>
1313-
<table class="propdef"><tbody>
1314-
<tr><th>Name: </th><td><dfn>nav-up</dfn>, <dfn>nav-right</dfn>, <dfn>nav-down</dfn>, <dfn>nav-left</dfn></td></tr>
1315-
<tr><th>Value: </th><td>auto | &lt;id&gt; [ current | root | &lt;target-name&gt; ]? </td></tr>
1316-
<tr><th>Initial:</th><td>auto</td></tr>
1317-
<tr><th>Applies to:</th><td>all enabled elements</td></tr>
1318-
<tr><th>Inherited:</th><td>no</td></tr>
1319-
<tr><th>Percentages:</th><td>N/A</td></tr>
1320-
<tr><th>Media:</th><td>interactive</td></tr>
1321-
<tr><th>Computed&nbsp;value:</th><td>as specified</td></tr>
1322-
<tr><th>Animatable:</th><td>no</td></tr>
1323-
</tbody></table>
1287+
<pre class="propdef">
1288+
Name: nav-up , nav-right , nav-down , nav-left
1289+
Value: auto | <<id>> [ current | root | <<target-name>> ]?
1290+
Initial: auto
1291+
Applies to: all enabled elements
1292+
Inherited: no
1293+
Percentages: N/A
1294+
Media: interactive
1295+
Computed value: as specified
1296+
</pre>
13241297

13251298
<dl>
13261299
<dt>auto</dt>
13271300
<dd>The user agent automatically determines which element to navigate the focus to in response to directional navigational input.</dd>
1328-
<dt>&lt;id&gt;</dt>
1329-
<dd><p>The &lt;id&gt; value is an ID selector [[SELECT]].
1301+
<dt><dfn noexport><<id>></dfn></dt>
1302+
<dd><p>The <<id>> value is an ID selector [[SELECT]].
13301303
In response to directional navigation input corresponding to the property,
13311304
the focus is navigated to the first element in tree order matching the selector.
13321305

@@ -1347,7 +1320,7 @@ while it is focused as such.
13471320
Note: there were other options under consideration for such "not otherwise focusable" elements, including focus to the next otherwise focusable element in the document tree (including descendants of such a not otherwise focusable element). Input on such other options is welcome and explicitly solicited, especially from implementation experiences and author experience using the directional navigation properties in their content.
13481321

13491322
</dd>
1350-
<dt>&lt;target-name&gt;</dt>
1323+
<dt><dfn noexport><<target-name>></dfn></dt>
13511324
<dd>
13521325
The &lt;target-name&gt; parameter indicates the target frame for the focus navigation.
13531326
It is a <<string>> and it MUST NOT start with the underscore "_" character.

0 commit comments

Comments
 (0)