Skip to content

Commit f714b22

Browse files
committed
[css-text-decor-4] Split out wording on font metrics in auto position/thickness to appropriate sections.
1 parent 8d66399 commit f714b22

File tree

1 file changed

+28
-19
lines changed

1 file changed

+28
-19
lines changed

css-text-decor-4/Overview.bs

Lines changed: 28 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -325,7 +325,11 @@ Text Decoration Line Thickness: the 'text-decoration-thickness' property</h3>
325325
<h4 id="text-decoration-thickness">
326326
Automatic Thickness of Text Decoration Lines</h4>
327327

328-
Issue: Insert L3 text here.
328+
Some font formats (such as OpenType) can offer information
329+
about the appropriate thickness of a line decoration.
330+
The UA should use such font-based information
331+
when choosing ''text-decoration-thickness/auto'' line thicknesses
332+
wherever appropriate.
329333

330334
<h3 id="line-position">
331335
Determining the Position and Thickness of Line Decorations</h3>
@@ -625,6 +629,13 @@ Text Underline Offset: the 'text-underline-offset' property</h3>
625629
so that the offset scales with the font.
626630
</dl>
627631
632+
When the value of the 'text-decoration-line' property is either
633+
''spelling-error'' or ''grammar-error'',
634+
the UA may ignore the value of 'text-underline-position'.
635+
636+
<h4 id="line-offset-zero">
637+
Underline Offset Origin (Zero Position)</h4>
638+
628639
The initial position of the underline depends on the value of 'text-underline-position'
629640
as detailed below.
630641
@@ -660,9 +671,22 @@ Text Underline Offset: the 'text-underline-offset' property</h3>
660671
<span class="issue">Should this be removed?</span>
661672
</ul>
662673
663-
When the value of the 'text-decoration-line' property is either
664-
''spelling-error'' or ''grammar-error'',
665-
the UA may ignore the value of 'text-underline-position'.
674+
<h4 id="line-auto-offset">
675+
Using Font Metrics for Automatic Positioning</h4>
676+
677+
Some font formats (such as OpenType) can offer information
678+
about the appropriate position of a line decoration.
679+
The UA should use such font-based information
680+
in its choice of ''text-underline-offset/auto'' offset
681+
wherever appropriate.
682+
683+
Note: Typically, OpenType font metrics give the position
684+
of an ''text-underline-position/alphabetic'' underline;
685+
in some cases (especially in CJK fonts),
686+
it gives the position of a ''under left'' underline.
687+
(In this case, the font's underline metrics typically
688+
touch the bottom edge of the em box).
689+
The UA may but is not required to correct for incorrect font metrics.
666690
667691
<h3 id="text-line-constancy">
668692
Text Decoration Line Uniformity</h3>
@@ -738,21 +762,6 @@ Text Decoration Line Uniformity</h3>
738762
-->
739763
</div>
740764
741-
Some font formats (such as OpenType) can offer information
742-
about the appropriate position of a line decoration.
743-
The UA should use such information
744-
(such as the underline thickness,
745-
or appropriate alphabetic underline position)
746-
from the font wherever appropriate.
747-
748-
Note: Typically, OpenType font metrics give the position
749-
of an ''text-underline-position/alphabetic'' underline;
750-
in some cases (especially in CJK fonts),
751-
it gives the position of a ''under left'' underline.
752-
(In this case, the font's underline metrics typically
753-
touch the bottom edge of the em box).
754-
The UA may but is not required to correct for incorrect font metrics.
755-
756765
<h3 id="text-decoration-skipping">
757766
Text Decoration Line Continuity</h3>
758767

0 commit comments

Comments
 (0)