A user who is disturbed by or has adverse reactions to blinking or flashing visuals
- may want to make all carets static and non-blinking,
+ may want to make all [=carets=] static and non-blinking,
regardless of platform defaults or author settings.
This can be accomplished with the following rule in the user stylesheet.
@@ -1198,14 +1217,14 @@ Animation of the insertion caret: 'caret-animation'
should provide a setting to disable
- and animated carets.
+ and animated [=carets=].
UAs that do have an editable user stylesheet may want to provide this setting as well.
See [[WCAG]]
- Typically, the caret blinks on and off.
+ Typically, the [=caret=] blinks on and off.
This makes it alternate between 2 colors.
textarea {
@@ -1242,7 +1261,7 @@ Animation of the insertion caret: 'caret-animation'
- If a user agent is unwilling to yield control of caret animations
+ If a user agent is unwilling to yield control of [=caret=] animations
to page authors and would not honor ''caret-animation: manual'',
it must not implement the property at all.
@@ -1260,7 +1279,7 @@ Shape of the insertion caret: 'caret-shape'
Name: caret-shape
Value: auto | bar | block | underscore
Initial: auto
- Applies to: elements that accept input
+ Applies to: elements that [=accept input=]
Inherited: yes
Percentages: N/A
Computed value: specified keyword
@@ -1268,7 +1287,7 @@ Shape of the insertion caret: 'caret-shape'
This property allows authors to specify
- the desired shape of the text insertion caret.
+ the desired shape of the [=insertion caret=].
Within the context of this definition,
character is
to be understood as
extended grapheme cluster,
@@ -1278,17 +1297,17 @@ Shape of the insertion caret: 'caret-shape'
- auto
-
- The UA determines the shape of the caret.
+ The UA determines the shape of the [=caret=].
It should match platform conventions,
and may be adjusted based on context.
For example, if a UA switches between insert mode and overtype mode when the
user presses the insert key on their keyboard,
- it may show a ''caret-shape/bar'' caret in insert mode,
- and a ''caret-shape/block'' caret in overtype mode.
+ it may show a ''caret-shape/bar'' [=caret=] in insert mode,
+ and a ''caret-shape/block'' [=caret=] in overtype mode.
- bar
-
- The UA must render the text insertion caret
+ The UA must render the [=insertion caret=]
as a thin bar placed at the insertion point.
This means it is between, before, or after characters, not over them.
It should be perpendicular to the inline progression direction,
@@ -1296,7 +1315,7 @@ Shape of the insertion caret: 'caret-shape'
- block
-
- The UA must render the text insertion caret
+ The UA must render the [=insertion caret=]
as a rectangle overlapping the next visible character following the insertion point.
If there is no visible character after the insertion point,
the UA must render the caret after the last visible character.
@@ -1304,45 +1323,45 @@ Shape of the insertion caret: 'caret-shape'
- underscore
-
- The UA must render the text insertion caret
+ The UA must render the [=insertion caret=]
as a thin line under (as defined in [[!CSS-WRITING-MODES-3]]
the next visible character following the insertion point.
If there is no visible character after the insertion point,
the UA must render the caret after the last visible character.
- The width of the ''caret-shape/block'' and ''caret-shape/underscore'' carets
+ The width of the ''caret-shape/block'' and ''caret-shape/underscore'' [=carets=]
should be the advance measure of the next
visible character after the insertion point,
or ''1ch'' if there is no next
visible character
or if this information is impractical to determine.
- When determining the orientation and appearance of the caret,
+ When determining the orientation and appearance of the [=caret=],
UAs must take into account the
writing mode [[!CSS-WRITING-MODES-3]]
and must apply transformations [[!CSS-TRANSFORMS-1]].
If the edited text is laid out on a path,
for instance by using the SVG <{textPath}> element,
UAs should also account for this.
- The thickness of ''caret-shape/bar'' and ''caret-shape/underscore'' carets--
- as well as that of ''caret-shape/auto'' carets with a similar rendering--
+ The thickness of ''caret-shape/bar'' and ''caret-shape/underscore'' [=carets=]--
+ as well as that of ''caret-shape/auto'' [=carets=] with a similar rendering--
is determined by the user agent.
When practical, the user agent should choose a thickness that ensures
- the caret remains visible even if it has been scaled down
+ the [=caret=] remains visible even if it has been scaled down
via means such as transformations [[CSS-TRANSFORMS-1]].
- The stacking position of the caret is left undefined within the following constraints:
+ The stacking position of the [=caret=] is left undefined within the following constraints:
-
- The caret must not be obscured by the background of the element.
+ The [=caret=] must not be obscured by the background of the element.
-
- UAs must render ''caret-shape/block'' carets
- so that the character it overlaps with is not obscured by the caret.
+ UAs must render ''caret-shape/block'' [=carets=]
+ so that the character it overlaps with is not obscured by the [=caret=].
- This illustrates the typical appearance of the various caret shapes.
+ This illustrates the typical appearance of the various [=caret=] shapes.
In each of the sample renderings below,
the insertion point is between the letters u and m.
@@ -1366,7 +1385,7 @@ Shape of the insertion caret: 'caret-shape'
'caret-shape'
| Sample rendering
- | Your browser (focus each cell to see the caret)
+ | Your browser (focus each cell to see the [=caret=])
|
''bar''
@@ -1386,7 +1405,7 @@ Shape of the insertion caret: 'caret-shape'
- ''caret-shape/underscore'' or ''caret-shape/block'' carets are commonly used
+ ''caret-shape/underscore'' or ''caret-shape/block'' [=carets=] are commonly used
in terminals and command lines,
as in this example.
@@ -1425,7 +1444,7 @@ Shape of the insertion caret: 'caret-shape'
Name: caret
Value: <<'caret-color'>> || <<'caret-animation'>> || <<'caret-shape'>>
Initial: auto
- Applies to: elements that accept input
+ Applies to: elements that [=accept input=]
Inherited: yes
Percentages: N/A
@@ -1435,9 +1454,9 @@ Shape of the insertion caret: 'caret-shape'
Omitted values are set to their initial values.
- This example illustrates using the various caret related properties
+ This example illustrates using the various [=caret=] related properties
in combination.
- They are used here to simulate the appearance of the caret
+ They are used here to simulate the appearance of the [=caret=]
on an old phosphor computer monitor.
|