svg2: Use new-style attribute definition boxes in Linking chapter.

details:   https://svgwg.org/hg/svg2/rev/1d638becbf13
branches:  
changeset: 538:1d638becbf13
user:      Cameron McCormack <cam@mcc.id.au>
date:      Mon Sep 23 17:52:53 2013 +1000
description:
Use new-style attribute definition boxes in Linking chapter.

diffstat:

 master/linking.html |  225 ++++++++++++++++++++++++++++++---------------------
 1 files changed, 130 insertions(+), 95 deletions(-)

diffs (262 lines):

diff --git a/master/linking.html b/master/linking.html
--- a/master/linking.html
+++ b/master/linking.html
@@ -402,98 +402,123 @@ a link to an ellipse.</p>
 <p>If the above SVG file is viewed by a user agent that supports both
 SVG and HTML, then clicking on the ellipse will cause the current window
 or frame to be replaced by the W3C home page.</p>
 
 <div id="AElement">
 <edit:elementsummary name='a'/>
 </div>
 
-    <div class="adef-list">
-      <p><em>Attribute definitions:</em></p>
-      <dl>
-         <dt><a id="XLinkShowAttribute2" ></a> <span
-            class="adef">xlink:show</span> = "<span
-              class="attr-value">new</span>" |
-          "<span
-            class="attr-value">replace</span>" </dt>
-        <dd><p>This attribute provides documentation to XLink-aware processors. If
-          <span class="attr-value">target="_blank"</span> then use
-          <span class="attr-value">xlink:show="new"</span> else use
-          <span class="attr-value">'replace'</span>. In
-          case of a conflict, the target attribute has priority, since it can
-          express a wider range of values.
-          Refer to the <a href="http://www.w3.org/TR/xlink/">XML Linking Language (XLink)</a> [<a href="refs.html#ref-XLINK">XLINK</a>].</p>
-          <p class="anim-target"><a
-            href="animate.html#Animatable">Animatable</a>:
-            no.</p></dd>
-        <dt id="AElementXLinkActuateAttribute"><span
-        class="adef">xlink:actuate</span> = <span class='attr-value'>"onRequest"</span></dt>
-        <dd><p>This attribute provides documentation to XLink-aware processors that
-          an application should traverse from the starting
-        resource to the ending resource only on a post-loading
-        event triggered for the purpose of traversal.
-        Refer to the <a href="http://www.w3.org/TR/xlink/">XML Linking Language (XLink)</a> [<a href="refs.html#ref-XLINK">XLINK</a>].</p>
-         <p class="anim-target"><a
-        href="animate.html#Animatable">Animatable</a>:
-        no.</p></dd>
-        <dt id="AElementXLinkHrefAttribute"><span
-          class="adef">xlink:href</span> = "<span class="attr-value"><a href="types.html#DataTypeIRI">&lt;IRI&gt;</a></span>"</dt>
-        <dd><p>The location of the referenced object, expressed as an <a>IRI reference</a>.</p>
-         <p class="anim-target"><a href="animate.html#Animatable">Animatable</a>: yes.</p>
-        </dd>
-        <dt id="AElementTargetAttribute"><span
-          class="adef">target</span> = "<span
-            class="attr-value">_replace</span>" |
-          "<span
-            class="attr-value">_self</span>" |
-          "<span
-            class="attr-value">_parent</span>" |
-          "<span
-            class="attr-value">_top</span>" |
-          "<span
-            class="attr-value">_blank</span>" |
-          "<span class="attr-value"><a href="types.html#DataTypeXML-Name">&lt;XML-Name&gt;</a></span>"
-        </dt>
-        <dd><p>This attribute should be used when there are multiple possible targets for
-          the ending resource, such as when the parent document is a
-          multi-frame HTML or XHTML document. This attribute specifies the
-          name or portion of the target window, frame, pane, tab, or other
-          relevant presentation context (e.g., an HTML or XHTML frame, iframe, or object element) into
-          which a document is to be opened when the link is activated:</p>
-          <dl class="definitions"><dt><span class="attr-value">_replace</span></dt>
-            <dd>The current SVG image is replaced by the linked content in the
-              same rectangular area in the same frame as the current SVG image.</dd>
-            <dt><span class="attr-value">_self</span></dt>
-            <dd>The current SVG image is replaced by the linked content in the
-            same frame as the current SVG image. If the attribute is not specified,
-	    <span class='attr-value'>'_self'</span> is assumed.</dd>
-            <dt><span class="attr-value">_parent</span></dt>
-            <dd>The immediate frameset parent of the SVG image is replaced by the
-              linked content.</dd>
-            <dt><span class="attr-value">_top</span></dt>
-            <dd>The content of the full window or tab, including any frames, is
-              replaced by the linked content</dd>
-            <dt><span class="attr-value">_blank</span></dt>
-              <dd>A new un-named window or tab is requested for the display of the
-                linked content. If this fails, the result is the same as <span class="attr-value">_top</span></dd>
-            <dt><span class="attr-value"><a href="types.html#DataTypeXML-Name">&lt;XML-Name&gt;</a></span></dt>
-              <dd>Specifies the name of the frame, pane, or other relevant
-                presentation context for display of the linked content. If this
-                already exists, it is re-used, replacing the existing content.  If
-                it does not exist, it is created (the same as <span class="attr-value">'_blank'</span>, except that
-                it now has a name). 
-                <!-- Note that frame-target must be an <a href="types.html#DataTypeXML-Name">XML Name</a> [XML11]. --></dd>
-          </dl>
-          <p>Note: The value <span class="attr-value">'_new'</span> is <em>not</em> a legal value for target (use <span class="attr-value">'_blank'</span>).</p>
-         <p class="anim-target"><a
-        href="animate.html#Animatable">Animatable</a>:
-        yes.</p></dd>
-      </dl>
-    </div>
+<p><em>Attribute definitions:</em></p>
+
+<dl class="attrdef-list">
+  <dt>
+    <table class="propdef attrdef">
+      <tr>
+        <th>Name</th>
+        <th>Value</th>
+        <th>Lacuna value</th>
+        <th>Animatable</th>
+      </tr>
+      <tr>
+        <td><dfn id="XLinkShowAttribute2">xlink:show</dfn></td>
+        <td>new | replace</td>
+        <td>(none)</td>
+        <td>no</td>
+      </tr>
+      <tr>
+        <td><dfn id="AElementXLinkActuateElement">xlink:actuate</dfn></td>
+        <td>onRequest</td>
+        <td>(none)</td>
+        <td>no</td>
+      </tr>
+    </table>
+  </dt>
+  <dd>
+    <p>These attribute provides documentation to XLink-aware processors.</p>
+    <p>If <span class="attr-value">target="_blank"</span> then use
+    <span class="attr-value">xlink:show="new"</span> else use
+    <span class="attr-value">'replace'</span>. In
+    case of a conflict, the target attribute has priority, since it can
+    express a wider range of values.</p>
+    <p><a>'xlink:actuate'</a> indicates that an application should traverse from
+    the starting resource to the ending resource only on a post-loading event
+    triggered for the purpose of traversal.</p>
+    <p>Refer to the <a href="http://www.w3.org/TR/xlink/">XML Linking Language (XLink)</a>
+    [<a href="refs.html#ref-XLINK">XLINK</a>].</p>
+  </dd>
+  <dt>
+    <table class="propdef attrdef">
+      <tr>
+        <th>Name</th>
+        <th>Value</th>
+        <th>Lacuna value</th>
+        <th>Animatable</th>
+      </tr>
+      <tr>
+        <td><dfn id="AElementXLinkHrefAttribute">xlink:href</dfn></td>
+        <td><a>&lt;iri&gt;</a></td>
+        <td>(none)</td>
+        <td>yes</td>
+      </tr>
+    </table>
+  </dt>
+  <dd>
+    The location of the referenced object, expressed as an <a>IRI reference</a>.
+  </dd>
+  <dt>
+    <table class="propdef attrdef">
+      <tr>
+        <th>Name</th>
+        <th>Value</th>
+        <th>Lacuna value</th>
+        <th>Animatable</th>
+      </tr>
+      <tr>
+        <td><dfn id="AElementTargetAttribute">target</dfn></td>
+        <td>_replace | _self | _parent | _top | _blank | <a>&lt;XML-Name&gt;</a></td>
+        <td>_self</td>
+        <td>yes</td>
+      </tr>
+    </table>
+  </dt>
+  <dd>
+    <p>This attribute should be used when there are multiple possible targets for
+    the ending resource, such as when the parent document is a
+    multi-frame HTML or XHTML document. This attribute specifies the
+    name or portion of the target window, frame, pane, tab, or other
+    relevant presentation context (e.g., an HTML or XHTML frame, iframe, or object element) into
+    which a document is to be opened when the link is activated:</p>
+    <dl>
+      <dt><span class="attr-value">_replace</span></dt>
+      <dd>The current SVG image is replaced by the linked content in the
+      same rectangular area in the same frame as the current SVG image.</dd>
+      <dt><span class="attr-value">_self</span></dt>
+      <dd>The current SVG image is replaced by the linked content in the
+      same frame as the current SVG image.</dd>
+      <dt><span class="attr-value">_parent</span></dt>
+      <dd>The immediate frameset parent of the SVG image is replaced by the
+      linked content.</dd>
+      <dt><span class="attr-value">_top</span></dt>
+      <dd>The content of the full window or tab, including any frames, is
+      replaced by the linked content</dd>
+      <dt><span class="attr-value">_blank</span></dt>
+      <dd>A new un-named window or tab is requested for the display of the
+      linked content. If this fails, the result is the same as <span class="attr-value">_top</span></dd>
+      <dt><span class="attr-value"><a>&lt;XML-Name&gt;</a></span></dt>
+      <dd>Specifies the name of the frame, pane, or other relevant
+      presentation context for display of the linked content. If this
+      already exists, it is re-used, replacing the existing content.  If
+      it does not exist, it is created (the same as <span class="attr-value">'_blank'</span>, except that
+      it now has a name).
+      <!-- Note that frame-target must be an <a href="types.html#DataTypeXML-Name">XML Name</a> [XML11]. --></dd>
+    </dl>
+    <p>Note: The value <span class="attr-value">'_new'</span> is <em>not</em> a legal value for target (use <span class="attr-value">'_blank'</span>).</p>
+  </dd>
+</dl>
 
 </edit:with>
 
 <h2 id="LinksIntoSVG">Linking into SVG content: IRI fragments and SVG views</h2>
 
 <p>Because SVG content often represents a picture or drawing
 of something, a common need is to link into a particular
 <em>view</em> of the document, where a view indicates
@@ -691,29 +716,39 @@ as follows:</p>
 <h3 id="ViewElement">Predefined views: the <span class="element-name">'view'</span> element</h3>
 
 <edit:with element='view'>
 
 <p>The <span class="element-name">'view'</span> element is defined as follows:</p>
 
 <edit:elementsummary name='view'/>
 
-    <div class="adef-list">
-      <p><em>Attribute definitions:</em></p>
-      <dl>
-        <dt id="ViewElementViewTargetAttribute"><span
-        class="adef">viewTarget</span> = "<em>XML_Name
-        [XML_NAME]*</em>"</dt>
-        <dd>Indicates the target object associated with the view.
-        <br />
-         <span class="anim-target"><a
-        href="animate.html#Animatable">Animatable</a>:
-        no.</span></dd>
-      </dl>
-    </div>
+<p><em>Attribute definitions:</em></p>
+
+<dl class="attrdef-list">
+  <dt>
+    <table class="propdef attrdef">
+      <tr>
+        <th>Name</th>
+        <th>Value</th>
+        <th>Lacuna value</th>
+        <th>Animatable</th>
+      </tr>
+      <tr>
+        <td><dfn id="ViewElementViewTargetAttribute">viewTarget</dfn></td>
+        <td><a>&lt;XML-Name&gt;</a></td>
+        <td>(none)</td>
+        <td>no</td>
+      </tr>
+    </table>
+  </dt>
+  <dd>
+    Indicates the target object associated with the view.
+  </dd>
+</dl>
 
 </edit:with>
 
 <h3 id="ViewHighlight">Highlighting views</h3>
 
 <p>It is helpful to users if the target element(s) are highlighted. The visual
 styling of this highlight should be decided by the document author, because the
 <a>SVG user agent</a> has no way to determine what changes would make the

Received on Monday, 23 September 2013 07:55:26 UTC