diff --git a/sections/acknowledgements.include b/sections/acknowledgements.include index 97aa6acb2d..2f67b901be 100644 --- a/sections/acknowledgements.include +++ b/sections/acknowledgements.include @@ -73,6 +73,7 @@ Léonie Watson, Maciej Stachowiak, Mark Svancarek, + Martin Janecke, Marvin Woo 吴秀诚, Mike™ Smith, Mike West, diff --git a/sections/semantics-embedded-content.include b/sections/semantics-embedded-content.include index 3638fb0161..7f012dc6b8 100644 --- a/sections/semantics-embedded-content.include +++ b/sections/semantics-embedded-content.include @@ -710,7 +710,7 @@
sizes - Image sizes between breakpoints
crossorigin - How the element handles crossorigin requests
usemap - Name of image map to use
-
ismap - Whether the image is a server-side image map
+
<{img/ismap}> - Whether the image is a server-side image map
width - Horizontal dimension
height - Vertical dimension
referrerpolicy - Referrer policy for fetches initiated by the element
@@ -2301,27 +2301,32 @@ map. This affects how events are handled on the corresponding <{a}> element. +

Users who do not have a pointing device, or who cannot see + the image referred to will generally not be able to use a server-side image map successfully. + Authors should use another mechanism, such as a "client-side" image map + made using the <{img/usemap}> attribute, wherever possible.

+ The ismap attribute is a boolean attribute. The attribute must not be specified on an element that does not have an ancestor <{a}> element with an <{a/href}> attribute. - +
In this example the user is asked to identify a person in an image by clicking on it. The server could respond to a click by confirming the correct position or by asking the user to try again. - + <figure> <a href="solve.html"> <img src="zoo.jpg" ismap alt="Animals and people at the zoo, among them Wally with striped clothes"> </a> - <figcaption>Where’s Wally? Click on him!</figcaption> + <figcaption>Where's Wally? Click on him!</figcaption> </figure> - - The coordinates where the user clicks are send to the server with the - request for the resource referenced by the <{a}> element’s + + The coordinates where the user clicks are sent to the server with the + request for the resource referenced by the <{a}> element's href attribute.
@@ -2332,7 +2337,7 @@

- The usemap and ismap attributes can result in confusing behavior + The usemap and <{img/ismap}> attributes can result in confusing behavior when used together with <{source}> elements with the media attribute specified in a <{picture}> element.

@@ -2349,7 +2354,7 @@ reflect the usemap content attribute. The isMap IDL attribute must reflect - the ismap content attribute. + the <{img/ismap}> content attribute. The referrerPolicy IDL attribute must reflect the <{img/referrerpolicy}> content attribute, limited to only known values. @@ -4749,7 +4754,7 @@ attribute's value is a type that a plugin supports, then the value of the

Check out the new icon!

-

If a nested browsing context is not created, e.g. for security reasons or due to incorrect implementation of the <{object/name3}> attribute, +

If a nested browsing context is not created, e.g. for security reasons or due to incorrect implementation of the <{object/name3}> attribute, the target attribute in this example will instead create a new browsing context - typically a new tab - whose browsing context name is the attribute's value, and the resource that the link references will be loaded there.

@@ -5741,11 +5746,11 @@ zero or more <{track}> elements, then should not show this content to the user; it is intended for older Web browsers which do not support <{audio}>, so that legacy audio plugins can be tried, or to show text to the users of these older browsers informing them of how to access the audio contents. - +
In this example, a browser which does not support inline audio can present a download link to the user. - + <audio src="music.ogg" controls> Your browser does not support the audio element. @@ -5806,14 +5811,14 @@ zero or more <{track}> elements, then constructor is found. </div> - + <div class="example"> This example shows how different audio files can be offered to the browser. If the browser does not support a specific codec, it can play one of the alternative files offered. - + This example also shows the boolean <code>controls</code>, <code>autoplay</code>, and <code>loop</code> attributes. - + <xmp highlight="html"> <audio controls autoplay loop> <source src="music.ogg" type="audio/ogg; codecs=vorbis"/> diff --git a/sections/semantics-textlevel.include b/sections/semantics-textlevel.include index dd883997c2..bdbd9fc203 100644 --- a/sections/semantics-textlevel.include +++ b/sections/semantics-textlevel.include @@ -148,7 +148,7 @@ exception. 2. Abort these steps without following the hyperlink. 3. If the target of the <code>click</code> event is an <{img}> element with an - <code>ismap</code> attribute specified, then server-side image map processing must be + <{img/ismap}> attribute specified, then server-side image map processing must be performed, as follows: 1. If the <code>click</code> event was a real pointing-device-triggered <code>click</code> event on the <{img}> element, then let |x| be the distance in CSS