Skip to content
This repository was archived by the owner on Mar 30, 2021. It is now read-only.

Commit d160577

Browse files
author
prushforth
committed
Update index.html
1 parent 057e617 commit d160577

File tree

1 file changed

+116
-11
lines changed

1 file changed

+116
-11
lines changed

spec/index.html

Lines changed: 116 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -238,8 +238,8 @@ <h3 id="requirements">3.2. Requirements</h3>
238238
and to the extent that those facilities work similarly / are standard across browser implementations, the Custom Type Extension Element is functional. However, as the Custom Element implementation
239239
is intended to provide a proof of concept, efforts to polyfill browser provided facilities such as SVG support have not been made to date. It is unclear whether such effort would be worthwhile.</p>
240240
<p><strong>Ease of authoring</strong>: </p>
241-
<p>The <code>&lt;map&gt;</code> element is primarily intended to simplify the authoring of Web maps, eliminating the hard requirement for script or allowing progressive enhancement the behavior of the element
242-
through script. Additionally, the use of declarative markup enables the use of CSS technology for cartographic and other user experience criteria.</p>
241+
<p>The <code>&lt;map&gt;</code> element is primarily intended to simplify the authoring of dynamic Web maps, eliminating the hard requirement for script or allowing progressive enhancement of the element
242+
with script. Additionally, the use of declarative markup enables the use of standard CSS techniques for cartographic and other user experience criteria.</p>
243243

244244
</div>
245245

@@ -248,13 +248,118 @@ <h3 id="requirements">3.2. Requirements</h3>
248248
<div id="sec-features">
249249
<h2 id="features">4. Features</h2>
250250
<p>This section is normative.</p>
251-
252-
<p><em>Please define the features of the specification here, including the necessary elements, attributes, attribute values, interfaces, methods, and other features.</em></p>
253-
254-
<p><em>Authors are encouraged to also describe features in terms of the IDL using Web IDL [<a href="#ref-WebIDL">WebIDL</a>] blocks inline.</em></p>
255-
256-
<p class="note"><strong>Note:</strong> Specification authors are encouraged to use the <a href="http://www.w3.org/People/Schepers/spec-conventions.html">W3C Typographic Conventions</a> for marking up and styling their documents.</p>
257-
251+
<!-- initially copied from the HTML 5 spec -->
252+
<h4 id="the-map-element"><span class="secno">4.1</span>The <dfn><code>map</code></dfn> element</h4>
253+
<dl class="element"><dt><a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#element-dfn-categories">Categories</a>:</dt>
254+
<dd><a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#flow-content-1">Flow content</a>.</dd>
255+
<dd><a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#phrasing-content-1">Phrasing content</a>.</dd>
256+
<dd><a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#palpable-content-0">Palpable content</a>.</dd>
257+
<dd>If the element has an <code>is="mapml-map"</code> attribute: <a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#embedded-content">Embedded content</a>.</dd>
258+
<dd>If the element has an <code>is="mapml-map"</code> attribute: <a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#interactive-content">Interactive content</a>.</dd>
259+
<dt><a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#element-dfn-contexts">Contexts in which this element can be used</a>:</dt>
260+
<dd>If the element has an <code>is="mapml-map"</code> attribute: where <a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#embedded-content">embedded content</a> is expected.</dd>
261+
<dd>If the element does not have an <code>is="mapml-map"</code> attribute: where <a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#phrasing-content-1">phrasing content</a> is expected.</dd>
262+
<dt><a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#element-dfn-content-model">Content model</a>:</dt>
263+
<dd>If the element has an <code>is="mapml-map"</code> attribute: zero or more <code>layer</code> elements.</dd>
264+
<dd>If the element does not have an <code>is="mapml-map"</code> attribute: <a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#transparent">Transparent</a>.</dd>
265+
<dt><a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#element-dfn-attributes">Content attributes</a>:</dt>
266+
<dd><a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#global-attributes">Global attributes</a></dd>
267+
<dd><code><a href="#attr-map-name">name</a></code> - Name of <a href="http://www.w3.org/TR/2014/REC-html5-20141028/embedded-content-0.html#image-map">image map</a> to reference from the <code><a href="#attr-hyperlink-usemap">usemap</a></code> attribute. If a <code>map</code> element
268+
has a <code>name</code> attribute, it must not have an <code>is="mapml-map"</code> attribute, and vice versa. <em>In a native implementation it might be possible to drive behavior based on the presence or absence of the
269+
<code>name</code> attribute alone.</em></dd>
270+
<dd><code><a href="#attr-map-is">is="mapml-map"</a></code> - designates the <code>map</code> element as a cartographic media element. If the <code>map</code> element has an <code>is="mapml-map"</code> attribute,
271+
it must not have a <code>name</code> attribute, and vice versa.</dd>
272+
<dd><code><a href="#attr-map-zoom">zoom</a></code> - a positive integer zoom (scale) value</dd>
273+
<dd><code><a href="#attr-map-lat">lat</a></code> - a decimal WGS84 latitude value for the map center</dd>
274+
<dd><code><a href="#attr-map-lon">lon</a></code> - a decimal WGS84 longitude value for the map center</dd>
275+
<dd><code><a href="http://www.w3.org/TR/2014/REC-html5-20141028/embedded-content-0.html#attr-dim-width">width</a></code> - Horizontal dimension</dd>
276+
<dd><code><a href="http://www.w3.org/TR/2014/REC-html5-20141028/embedded-content-0.html#attr-dim-height">height</a></code> - Vertical dimension</dd>
277+
<dt><span>Tag omission in text/html</span>:</dt>
278+
<dd>Neither tag is omissible</dd>
279+
<dt>Allowed <a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#aria-role-attribute">ARIA role attribute</a> values:</dt>
280+
<dd>None</dd>
281+
<dt>Allowed <a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#state-and-property-attributes">ARIA state and property attributes</a>:</dt>
282+
<dd><a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#index-aria-global">Global aria-* attributes</a></dd>
283+
<dt><a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#element-dfn-dom">DOM interface</a>:</dt>
284+
<dd>
285+
<pre class="idl">interface <dfn id="htmlmapelement">HTMLMapElement</dfn> : <a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#htmlelement">HTMLElement</a> {
286+
attribute DOMString <a href="#dom-map-name">name</a>;
287+
readonly attribute <a href="http://www.w3.org/TR/2014/REC-html5-20141028/infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-map-areas">areas</a>;
288+
readonly attribute <a href="http://www.w3.org/TR/2014/REC-html5-20141028/infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-map-images">images</a>;
289+
};</pre>
290+
</dd>
291+
</dl>
292+
<p>The <code><a href="#the-map-element">map</a></code> element, in conjunction with an <code><a href="http://www.w3.org/TR/2014/REC-html5-20141028/embedded-content-0.html#the-img-element">img</a></code> element and any
293+
<code><a href="http://www.w3.org/TR/2014/REC-html5-20141028/embedded-content-0.html#the-area-element">area</a></code> element descendants, defines an <a href="http://www.w3.org/TR/2014/REC-html5-20141028/embedded-content-0.html#image-map">image map</a>. The element
294+
<a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#represents">represents</a> its children.</p>
295+
<p>The <dfn id="attr-map-name"><code>name</code></dfn> attribute gives the map a name so that
296+
it can be referenced. The attribute must be present and must have a non-empty value with no <a href="http://www.w3.org/TR/2014/REC-html5-20141028/infrastructure.html#space-character">space characters</a>. The value of the <code><a href="#attr-map-name">name</a></code> attribute must not be a <a href="infrastructure.html#compatibility-caseless">compatibility-caseless</a> match for the value of the <code data-anolis-xref="attr-map-name"><a href="#attr-map-name">name</a></code> attribute of another <code><a href="#the-map-element">map</a></code> element in the same
297+
document. If the <code><a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#the-id-attribute">id</a></code> attribute is also specified, both attributes must
298+
have the same value.</p>
299+
<dl class="domintro"><dt><var>map</var> . <code><a href="#dom-map-areas">areas</a></code></dt>
300+
301+
<dd>
302+
303+
<p>Returns an <code><a href="http://www.w3.org/TR/2014/REC-html5-20141028/infrastructure.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="http://www.w3.org/TR/2014/REC-html5-20141028/embedded-content-0.html#the-area-element">area</a></code> elements in the
304+
<code><a href="#the-map-element">map</a></code>.</p>
305+
306+
</dd>
307+
308+
<dt><var>map</var> . <code><a href="#dom-map-images">images</a></code></dt>
309+
310+
<dd>
311+
312+
<p>Returns an <code><a href="http://www.w3.org/TR/2014/REC-html5-20141028/infrastructure.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="#the-img-element">img</a></code> and <code><a href="http://www.w3.org/TR/2014/REC-html5-20141028/embedded-content-0.html#the-object-element">object</a></code>
313+
elements that use the <code><a href="#the-map-element">map</a></code>.</p>
314+
315+
</dd>
316+
317+
</dl>
318+
<div class="impl">
319+
320+
<p>The <dfn id="dom-map-areas"><code>areas</code></dfn> attribute must return an
321+
<code><a href="http://www.w3.org/TR/2014/REC-html5-20141028/infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the <code><a href="#the-map-element">map</a></code> element, whose filter matches only
322+
<code><a href="#the-area-element">area</a></code> elements.</p>
323+
324+
<p>The <dfn id="dom-map-images"><code>images</code></dfn> attribute must return an
325+
<code><a href="http://www.w3.org/TR/2014/REC-html5-20141028/infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the <code><a href="http://www.w3.org/TR/2014/REC-html5-20141028/dom.html#document">Document</a></code> node, whose filter matches only
326+
<code><a href="#the-img-element">img</a></code> and <code><a href="http://www.w3.org/TR/2014/REC-html5-20141028/embedded-content-0.html#the-object-element">object</a></code> elements that are associated with this <code><a href="#the-map-element">map</a></code>
327+
element according to the <a href="#image-map">image map</a> processing model.</p>
328+
329+
<p>The IDL attribute <dfn id="dom-map-name"><code>name</code></dfn> must <a href="http://www.w3.org/TR/2014/REC-html5-20141028/infrastructure.html#reflect">reflect</a>
330+
the content attribute of the same name.</p>
331+
332+
</div>
333+
<div class="example">
334+
335+
<p>Image maps can be defined in conjunction with other content on the page, to ease maintenance.
336+
This example is of a page with an image map at the top of the page and a corresponding set of
337+
text links at the bottom.</p>
338+
339+
<pre>&lt;!DOCTYPE HTML&gt;
340+
&lt;TITLE&gt;Babies™: Toys&lt;/TITLE&gt;
341+
&lt;HEADER&gt;
342+
&lt;H1&gt;Toys&lt;/H1&gt;
343+
&lt;IMG SRC="/images/menu.gif"
344+
ALT="Babies™ navigation menu. Select a department to go to its page."
345+
USEMAP="#NAV"&gt;
346+
&lt;/HEADER&gt;
347+
...
348+
&lt;FOOTER&gt;
349+
&lt;MAP NAME="NAV"&gt;
350+
&lt;P&gt;
351+
&lt;A HREF="/clothes/"&gt;Clothes&lt;/A&gt;
352+
&lt;AREA ALT="Clothes" COORDS="0,0,100,50" HREF="/clothes/"&gt; |
353+
&lt;A HREF="/toys/"&gt;Toys&lt;/A&gt;
354+
&lt;AREA ALT="Toys" COORDS="0,0,100,50" HREF="/toys/"&gt; |
355+
&lt;A HREF="/food/"&gt;Food&lt;/A&gt;
356+
&lt;AREA ALT="Food" COORDS="0,0,100,50" HREF="/food/"&gt; |
357+
&lt;A HREF="/books/"&gt;Books&lt;/A&gt;
358+
&lt;AREA ALT="Books" COORDS="0,0,100,50" HREF="/books/"&gt;
359+
&lt;/MAP&gt;
360+
&lt;/FOOTER&gt;</pre>
361+
362+
</div>
258363
</div>
259364

260365

@@ -337,8 +442,8 @@ <h3 id="normrefs">9.1. Normative References</h3>
337442

338443
<dt id="ref-RNG"><strong class="normref">[RELAXNG]</strong></dt>
339444
<dd>
340-
<cite><a href="http://www.y12.doe.gov/sgml/sc34/document/0362_files/relaxng-is.pdf">Document Schema Definition Languages (DSDL) — Part 2: Regular grammar-based validation — RELAX NG, ISO/IEC FDIS 19757-2:2002(E)</a></cite>,
341-
J. Clark, <ruby><rb xml:lang="ja">�田 真</rb> <rp>(</rp><rt><span class="familyname">Murata</span> M.</rt><rp>)</rp></ruby>, eds.
445+
<cite><a href="http://www.y12.doe.gov/sgml/sc34/document/0362_files/relaxng-is.pdf">Document Schema Definition Languages (DSDL) � Part 2: Regular grammar-based validation � RELAX NG, ISO/IEC FDIS 19757-2:2002(E)</a></cite>,
446+
J. Clark, <ruby><rb xml:lang="ja">�� 真</rb> <rp>(</rp><rt><span class="familyname">Murata</span> M.</rt><rp>)</rp></ruby>, eds.
342447
International Organization for Standardization, 12 December 2002.
343448
<br/>Available at http://www.y12.doe.gov/sgml/sc34/document/0362_files/relaxng-is.pdf.
344449
</dd>

0 commit comments

Comments
 (0)