Skip to content

Commit f0b104f

Browse files
annevkzcorpan
authored andcommitted
Editorial: add IDs for en-GB terms
In preparation for switching to en-US without breaking links. Part of whatwg#654.
1 parent 90d735d commit f0b104f

File tree

1 file changed

+90
-79
lines changed

1 file changed

+90
-79
lines changed

source

Lines changed: 90 additions & 79 deletions
Original file line numberDiff line numberDiff line change
@@ -610,7 +610,7 @@
610610

611611
<div w-nodev>
612612

613-
<h4>Serialisability of script execution</h4>
613+
<h4 id="serialisability-of-script-execution">Serialisability of script execution</h4>
614614

615615
<!-- NON-NORMATIVE SECTION -->
616616

@@ -5618,8 +5618,9 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d
56185618

56195619
</ol>
56205620

5621-
<p>A string is a <dfn>valid normalised local date and time string</dfn> representing a date and
5622-
time if it consists of the following components in the given order:</p>
5621+
<p>A string is a <dfn id="valid-normalised-local-date-and-time-string" data-noexport="">valid
5622+
normalised local date and time string</dfn> representing a date and time if it consists of the
5623+
following components in the given order:</p>
56235624

56245625
<ol>
56255626

@@ -6530,26 +6531,28 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d
65306531
</div>
65316532

65326533

6533-
<h4>Colours</h4>
6534+
<h4 id="colours">Colours</h4>
65346535

6535-
<p>A <dfn>simple colour</dfn> consists of three 8-bit numbers in the range 0..255, representing the
6536-
red, green, and blue components of the colour respectively, in the sRGB colour space. <ref spec=SRGB></p>
6536+
<p>A <dfn id="simple-colour">simple colour</dfn> consists of three 8-bit numbers in the range
6537+
0..255, representing the red, green, and blue components of the colour respectively, in the sRGB
6538+
colour space. <ref spec=SRGB></p>
65376539

6538-
<p>A string is a <dfn>valid simple colour</dfn> if it is exactly seven characters long, and the
6539-
first character is a U+0023 NUMBER SIGN character (#), and the remaining six characters are all
6540-
<span>ASCII hex digits</span>, with the first two digits representing the red component, the
6541-
middle two digits representing the green component, and the last two digits representing the blue
6542-
component, in hexadecimal.</p>
6540+
<p>A string is a <dfn id="valid-simple-colour">valid simple colour</dfn> if it is exactly seven
6541+
characters long, and the first character is a U+0023 NUMBER SIGN character (#), and the remaining
6542+
six characters are all <span>ASCII hex digits</span>, with the first two digits representing the
6543+
red component, the middle two digits representing the green component, and the last two digits
6544+
representing the blue component, in hexadecimal.</p>
65436545

6544-
<p>A string is a <dfn>valid lowercase simple colour</dfn> if it is a <span>valid simple
6545-
colour</span> and doesn't use any characters in the range U+0041 LATIN CAPITAL LETTER A to U+0046
6546-
LATIN CAPITAL LETTER F.</p>
6546+
<p>A string is a <dfn id="valid-lowercase-simple-colour">valid lowercase simple colour</dfn> if it
6547+
is a <span>valid simple colour</span> and doesn't use any characters in the range U+0041 LATIN
6548+
CAPITAL LETTER A to U+0046 LATIN CAPITAL LETTER F.</p>
65476549

65486550
<div w-nodev>
65496551

6550-
<p>The <dfn>rules for parsing simple colour values</dfn> are as given in the following algorithm.
6551-
When invoked, the steps must be followed in the order given, aborting at the first step that
6552-
returns a value. This algorithm will return either a <span>simple colour</span> or an error.</p>
6552+
<p>The <dfn id="rules-for-parsing-simple-colour-values">rules for parsing simple colour
6553+
values</dfn> are as given in the following algorithm. When invoked, the steps must be followed in
6554+
the order given, aborting at the first step that returns a value. This algorithm will return
6555+
either a <span>simple colour</span> or an error.</p>
65536556

65546557
<ol>
65556558

@@ -6579,8 +6582,8 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d
65796582

65806583
</ol>
65816584

6582-
<p>The <dfn>rules for serialising simple colour values</dfn> given a <span>simple colour</span> are
6583-
as given in the following algorithm:</p>
6585+
<p>The <dfn id="rules-for-serialising-simple-colour-values">rules for serialising simple colour
6586+
values</dfn> given a <span>simple colour</span> are as given in the following algorithm:</p>
65846587

65856588
<ol>
65866589

@@ -6598,10 +6601,11 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d
65986601

65996602
<hr>
66006603

6601-
<p>Some obsolete legacy attributes parse colours in a more complicated manner, using the <dfn>rules
6602-
for parsing a legacy colour value</dfn>, which are given in the following algorithm. When invoked,
6603-
the steps must be followed in the order given, aborting at the first step that returns a value.
6604-
This algorithm will return either a <span>simple colour</span> or an error.</p>
6604+
<p>Some obsolete legacy attributes parse colours in a more complicated manner, using the
6605+
<dfn id="rules-for-parsing-a-legacy-colour-value">rules for parsing a legacy colour value</dfn>,
6606+
which are given in the following algorithm. When invoked, the steps must be followed in the order
6607+
given, aborting at the first step that returns a value. This algorithm will return either a
6608+
<span>simple colour</span> or an error.</p>
66056609

66066610
<ol>
66076611

@@ -21782,7 +21786,7 @@ interface <dfn>HTMLHyperlinkElementUtils</dfn> {
2178221786
operation.</p>
2178321787

2178421788
<p>An element implementing the <code>HTMLHyperlinkElementUtils</code> mixin has an associated <dfn
21785-
data-noexport="">reinitialise url</dfn> algorithm, which runs these steps:</p>
21789+
id="reinitialise-url" data-noexport="">reinitialise url</dfn> algorithm, which runs these steps:</p>
2178621790

2178721791
<ol>
2178821792
<li><p>If element's <span data-x="concept-hyperlink-url">url</span> is non-null, its <span
@@ -26509,8 +26513,9 @@ interface <dfn>HTMLImageElement</dfn> : <span>HTMLElement</span> {
2650926513
no descriptor at all accompanying its URL. Normalising a <span>source set</span> gives every <span>image
2651026514
source</span> a <span>pixel density descriptor</span>.</p>
2651126515

26512-
<p>When asked to <dfn>normalise the source densities</dfn> of a <span>source set</span> <var>source set</var>,
26513-
the user agent must do the following:</p>
26516+
<p>When asked to <dfn id="normalise-the-source-densities" data-noexport="">normalise the source
26517+
densities</dfn> of a <span>source set</span> <var>source set</var>, the user agent must do the
26518+
following:</p>
2651426519

2651526520
<ol>
2651626521

@@ -36492,8 +36497,9 @@ red:89
3649236497
if called with an <var>index</var> argument greater than or equal to the number of ranges
3649336498
represented by the object.</p>
3649436499

36495-
<p>When a <code>TimeRanges</code> object is said to be a <dfn>normalised <code>TimeRanges</code>
36496-
object</dfn>, the ranges it represents must obey the following criteria:</p>
36500+
<p>When a <code>TimeRanges</code> object is said to be a <dfn id="normalised-timeranges-object"
36501+
data-noexport="">normalised <code>TimeRanges</code> object</dfn>, the ranges it represents must
36502+
obey the following criteria:</p>
3649736503

3649836504
<ul>
3649936505

@@ -59418,8 +59424,8 @@ callback <dfn>BlobCallback</dfn> = void (<span>Blob</span>? blob);</pre>
5941859424

5941959425
<li><p><span>Queue a task</span> to <span data-x="es-invoking-callback-functions">invoke</span>
5942059426
the <code>BlobCallback</code> <var>callback</var> with <var>result</var> as its argument. The
59421-
<span>task source</span> for this task is the <dfn>canvas blob serialisation task
59422-
source</dfn>.</p></li>
59427+
<span>task source</span> for this task is the <dfn
59428+
id="canvas-blob-serialisation-task-source">canvas blob serialisation task source</dfn>.</p></li>
5942359429

5942459430
</ol>
5942559431

@@ -62168,24 +62174,24 @@ try {
6216862174
returned. (Such objects are opaque and therefore only useful for assigning to other attributes or
6216962175
for comparison to other gradients or patterns.)</p>
6217062176

62171-
<p>The <dfn>serialisation of a colour</dfn> for a colour value is a string, computed as follows: if
62172-
it has alpha equal to 1.0, then the string is a lowercase six-digit hex value, prefixed with a "#"
62173-
character (U+0023 NUMBER SIGN), with the first two digits representing the red component, the next
62174-
two digits representing the green component, and the last two digits representing the blue
62175-
component, the digits being <span>lowercase ASCII hex digits</span>. Otherwise, the colour value
62176-
has alpha less than 1.0, and the string is the colour value in the CSS <code data-x="">rgba()</code>
62177-
functional-notation format: the literal string "<code data-x="">rgba</code>" (U+0072 U+0067 U+0062
62178-
U+0061) followed by a U+0028 LEFT PARENTHESIS, a base-ten integer in the range 0-255 representing
62179-
the red component (using <span>ASCII digits</span> in the shortest form possible), a literal
62180-
U+002C COMMA and U+0020 SPACE, an integer for the green component, a comma and a space, an integer
62181-
for the blue component, another comma and space, a U+0030 DIGIT ZERO, if the alpha value is
62182-
greater than zero then a U+002E FULL STOP (representing the decimal point), if the alpha value is
62183-
greater than zero then one or more <span>ASCII digits</span> representing the fractional part of
62184-
the alpha<!-- value with no trailing zeros (implied by next sentence)-->, and finally a U+0029
62185-
RIGHT PARENTHESIS. User agents must express the fractional part of the alpha value, if any, with
62186-
the level of precision necessary for the alpha value, when reparsed, to be interpreted as the same
62187-
alpha value.</p> <!-- if people complain this is unreadable, expand it into a <dl> with two nested
62188-
<ol>s -->
62177+
<p>The <dfn id="serialisation-of-a-colour">serialisation of a colour</dfn> for a colour value is a
62178+
string, computed as follows: if it has alpha equal to 1.0, then the string is a lowercase
62179+
six-digit hex value, prefixed with a "#" character (U+0023 NUMBER SIGN), with the first two digits
62180+
representing the red component, the next two digits representing the green component, and the last
62181+
two digits representing the blue component, the digits being <span>lowercase ASCII hex
62182+
digits</span>. Otherwise, the colour value has alpha less than 1.0, and the string is the colour
62183+
value in the CSS <code data-x="">rgba()</code> functional-notation format: the literal string
62184+
"<code data-x="">rgba</code>" (U+0072 U+0067 U+0062 U+0061) followed by a U+0028 LEFT PARENTHESIS,
62185+
a base-ten integer in the range 0-255 representing the red component (using <span>ASCII
62186+
digits</span> in the shortest form possible), a literal U+002C COMMA and U+0020 SPACE, an integer
62187+
for the green component, a comma and a space, an integer for the blue component, another comma and
62188+
space, a U+0030 DIGIT ZERO, if the alpha value is greater than zero then a U+002E FULL STOP
62189+
(representing the decimal point), if the alpha value is greater than zero then one or more
62190+
<span>ASCII digits</span> representing the fractional part of the alpha<!-- value with no trailing
62191+
zeros (implied by next sentence)-->, and finally a U+0029 RIGHT PARENTHESIS. User agents must
62192+
express the fractional part of the alpha value, if any, with the level of precision necessary for
62193+
the alpha value, when reparsed, to be interpreted as the same alpha value.</p> <!-- if people
62194+
complain this is unreadable, expand it into a <dl> with two nested <ol>s -->
6218962195

6219062196
<p>When the context is created, the <code
6219162197
data-x="dom-context-2d-fillStyle">fillStyle</code> and <code
@@ -65545,7 +65551,7 @@ dictionary <dfn>ImageBitmapRenderingContextSettings</dfn> {
6554565551

6554665552
<div w-nodev>
6554765553

65548-
<h5>Colour spaces and colour correction</h5>
65554+
<h5 id="colour-spaces-and-colour-correction">Colour spaces and colour correction</h5>
6554965555

6555065556
<p>The <code>canvas</code> APIs must perform colour correction at only two points: when rendering
6555165557
images with their own gamma correction and colour space information onto a bitmap, to convert the
@@ -65582,13 +65588,14 @@ dictionary <dfn>ImageBitmapRenderingContextSettings</dfn> {
6558265588

6558365589

6558465590

65585-
<h5>Serialising bitmaps to a file</h5>
65591+
<h5 id="serialising-bitmaps-to-a-file">Serialising bitmaps to a file</h5>
6558665592

6558765593
<div w-nodev>
6558865594

65589-
<p>When a user agent is to create <dfn>a serialisation of the bitmap as a file</dfn>, given an
65590-
optional <var>type</var> and <var>quality</var>, it must create an image file in the format given
65591-
by <var>type</var>, or if <var>type</var> was not supplied, in the PNG format. <ref spec=PNG></p>
65595+
<p>When a user agent is to create <dfn id="a-serialisation-of-the-bitmap-as-a-file">a
65596+
serialisation of the bitmap as a file</dfn>, given an optional <var>type</var> and
65597+
<var>quality</var>, it must create an image file in the format given by <var>type</var>, or if
65598+
<var>type</var> was not supplied, in the PNG format. <ref spec=PNG></p>
6559265599

6559365600
<p>The image file's pixel data must be the bitmap's pixel data scaled to one image pixel per
6559465601
coordinate space unit, and if the file format used supports encoding resolution metadata, the
@@ -72286,9 +72293,9 @@ END:VCARD</pre>
7228672293
<dfn>canceled activation steps</dfn> defined for that element, if any.</p>
7228772294

7228872295
<p>When a user agent is to <dfn>run post-click activation steps</dfn> on an element, it must run
72289-
the <dfn>activation behaviour</dfn> defined for that element, if any. Activation behaviours can
72290-
refer to the <code data-x="event-click">click</code> event that was fired by the steps above
72291-
leading up to this point.</p>
72296+
the <dfn id="activation-behaviour">activation behaviour</dfn> defined for that element, if any.
72297+
Activation behaviours can refer to the <code data-x="event-click">click</code> event that was
72298+
fired by the steps above leading up to this point.</p>
7229272299

7229372300
<p id="allowed-to-show-a-popup">An algorithm is <dfn data-export="">triggered by user
7229472301
activation</dfn> if any of the following conditions is true:</p>
@@ -79553,8 +79560,9 @@ callback <dfn>FrameRequestCallback</dfn> = void (<span>DOMHighResTimeStamp</span
7955379560

7955479561
<hr>
7955579562

79556-
<p>The <dfn data-export="">Unicode serialisation of an origin</dfn> is the string obtained by
79557-
applying the following algorithm to the given <span>origin</span> <var>origin</var>:</p>
79563+
<p>The <dfn id="unicode-serialisation-of-an-origin" data-export="">Unicode serialisation of an
79564+
origin</dfn> is the string obtained by applying the following algorithm to the given
79565+
<span>origin</span> <var>origin</var>:</p>
7955879566

7955979567
<ol>
7956079568
<li><p>If <var>origin</var> is an <span data-x="concept-origin-opaque">opaque origin</span>, then
@@ -79586,8 +79594,9 @@ callback <dfn>FrameRequestCallback</dfn> = void (<span>DOMHighResTimeStamp</span
7958679594
data-x="">xn--maraa-rta.example</code>", null, null) is "<code
7958779595
data-x="">https://maraña.example</code>".</p>
7958879596

79589-
<p>The <dfn data-export="">ASCII serialisation of an origin</dfn> is the string obtained by
79590-
applying the following algorithm to the given <span>origin</span> <var>origin</var>:</p>
79597+
<p>The <dfn id="ascii-serialisation-of-an-origin" data-export="">ASCII serialisation of an
79598+
origin</dfn> is the string obtained by applying the following algorithm to the given
79599+
<span>origin</span> <var>origin</var>:</p>
7959179600

7959279601
<ol>
7959379602
<li><p>If <var>origin</var> is an <span data-x="concept-origin-opaque">opaque origin</span>, then
@@ -82279,10 +82288,10 @@ State: &lt;OUTPUT NAME=I>1&lt;/OUTPUT> &lt;INPUT VALUE="Increment" TYPE=BUTTON O
8227982288
data-x="javascript protocol">dereferencing a <code>javascript:</code> URL</span> and when
8228082289
performing <span>an overridden reload</span>.</p>
8228182290

82282-
<p><dfn data-x="initialise the Document object" data-export="">Initialising a new
82283-
<code>Document</code> object</dfn>: when a <code>Document</code> is created as part of the above
82284-
steps, the user agent will be required to additionally run the following algorithm after
82285-
creating the new object:</p>
82291+
<p><dfn id="initialise-the-document-object" data-x="initialise the Document object"
82292+
data-export="">Initialising a new <code>Document</code> object</dfn>: when a
82293+
<code>Document</code> is created as part of the above steps, the user agent will be required to
82294+
additionally run the following algorithm after creating the new object:</p>
8228682295

8228782296
<ol>
8228882297
<li><p>Let <var>window</var> be null.</p></li>
@@ -90357,8 +90366,9 @@ document.body.appendChild(frame)</pre>
9035790366

9035890367
<hr>
9035990368

90360-
<p>The <dfn>timer initialisation steps</dfn>, which are invoked with some method arguments, a <var>method context</var>, a <var>repeat</var> flag which can be true or false, and
90361-
optionally (and only if the <var>repeat</var> flag is true) a <var>previous
90369+
<p>The <dfn id="timer-initialisation-steps">timer initialisation steps</dfn>, which are invoked
90370+
with some method arguments, a <var>method context</var>, a <var>repeat</var> flag which can be
90371+
true or false, and optionally (and only if the <var>repeat</var> flag is true) a <var>previous
9036290372
handle</var>, are as follows:</p>
9036390373

9036490374
<ol>
@@ -108330,11 +108340,12 @@ document.body.appendChild(text);
108330108340
<!--/HTMLPARSER-->
108331108341

108332108342

108333-
<h3>Serialising HTML fragments</h3>
108343+
<h3 id="serialising-html-fragments">Serialising HTML fragments</h3>
108334108344

108335-
<p>The following steps form the <dfn>HTML fragment serialisation algorithm</dfn>. The algorithm
108336-
takes as input a DOM <code>Element</code>, <code>Document</code>, or <code>DocumentFragment</code>
108337-
referred to as <var>the node</var>, and returns a string.</p>
108345+
<p>The following steps form the <dfn id="html-fragment-serialisation-algorithm"
108346+
data-export="">HTML fragment serialisation algorithm</dfn>. The algorithm takes as input a DOM
108347+
<code>Element</code>, <code>Document</code>, or <code>DocumentFragment</code> referred to as
108348+
<var>the node</var>, and returns a string.</p>
108338108349

108339108350
<p class="note">This algorithm serialises the <em>children</em> of the node being serialised, not
108340108351
the node itself.</p>
@@ -108380,8 +108391,8 @@ document.body.appendChild(text);
108380108391
attribute's value, <span data-x="escaping a string">escaped as described below</span> in
108381108392
<i>attribute mode</i>, and a second U+0022 QUOTATION MARK character (&quot;).</p>
108382108393

108383-
<p>An <dfn>attribute's serialised name</dfn> for the purposes of the previous paragraph must
108384-
be determined as follows:</p>
108394+
<p>An <dfn id="attribute's-serialised-name" data-noexport="">attribute's serialised
108395+
name</dfn> for the purposes of the previous paragraph must be determined as follows:</p>
108385108396

108386108397
<dl class="switch">
108387108398

@@ -109005,11 +109016,11 @@ document.body.appendChild(text);
109005109016
<!--//HTMLPARSER-->
109006109017

109007109018

109008-
<h3>Serialising XHTML fragments</h3>
109019+
<h3 id="serialising-xhtml-fragments">Serialising XHTML fragments</h3>
109009109020

109010-
<p>The <dfn>XML fragment serialisation algorithm</dfn> for a <code>Document</code> or
109011-
<code>Element</code> node either returns a fragment of XML that represents that node or throws an
109012-
exception.</p>
109021+
<p>The <dfn id="xml-fragment-serialisation-algorithm">XML fragment serialisation algorithm</dfn>
109022+
for a <code>Document</code> or <code>Element</code> node either returns a fragment of XML that
109023+
represents that node or throws an exception.</p>
109013109024

109014109025
<p>For <code>Document</code>s, the algorithm must return a string in the form of a <a
109015109026
href="https://www.w3.org/TR/xml/#sec-well-formed">document entity</a>, if none of the error cases
@@ -110904,7 +110915,7 @@ details[open] > summary {
110904110915

110905110916
<div w-nodev>
110906110917

110907-
<h4>The <code>input</code> element as a colour well</h4>
110918+
<h4 id="the-input-element-as-a-colour-well">The <code>input</code> element as a colour well</h4>
110908110919

110909110920
<p>An <code>input</code> element whose <code data-x="attr-input-type">type</code> attribute is in
110910110921
the <span data-x="attr-input-type-color">Colour</span> state is expected to render as an
@@ -111451,8 +111462,8 @@ details[open] > summary {
111451111462

111452111463
</ol>
111453111464

111454-
<p>The <dfn>frame border colour</dfn> of a <code>frameset</code> or <code>frame</code> element
111455-
is the colour obtained from the following algorithm:</p>
111465+
<p>The <dfn id="frame-border-colour">frame border colour</dfn> of a <code>frameset</code> or
111466+
<code>frame</code> element is the colour obtained from the following algorithm:</p>
111456111467

111457111468
<ol>
111458111469

0 commit comments

Comments
 (0)