- From: SVG Working Group repository <cam+svgwgrepo@mcc.id.au>
- Date: Mon, 23 Sep 2013 00:54:53 -0700
- To: public-svg-wg@w3.org
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"><IRI></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"><XML-Name></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"><XML-Name></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><iri></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><XML-Name></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><XML-Name></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><XML-Name></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