added default splash screen
authorMarcos Caceres <w3c@marcosc.com>
Wed, 07 Dec 2011 01:13:15 +0000
changeset 9 f5396d91060a
parent 8 8d2ee8f7b842
child 10 95abb12bde9a
added default splash screen
splashscreen/Overview.src.html
--- a/splashscreen/Overview.src.html	Wed Dec 07 00:38:37 2011 +0000
+++ b/splashscreen/Overview.src.html	Wed Dec 07 01:13:15 2011 +0000
@@ -74,21 +74,17 @@
 <p>TBW... </p>
 <h2 class="no-num no-toc">Table of Contents</h2>
 <!--toc-->
-<h2>Open Questions</h2>
-<ul>
-  <li>Do we want a magic file &quot;splash.png&quot; for instance? </li>
-  <li></li>
-</ul>
 <h2>Status of this document</h2>
 <p>This document is undergoing rapid development and is changing frequently. It is inappropriate to cite this document as anything other than a work in progress. </p>
 <h2>Introduction</h2>
 <p><em>This section is non-normative.</em></p>
 <p>TBW</p>
-<h3>Example</h3>
+<h3>Example </h3>
+<h3>Example: using the content element</h3>
 <p>The following example shows how to use the <code>splash</code> attribute. </p>
 <pre>
 &lt;widget xmlns=&quot;http://www.w3.org/ns/widgets&quot;&gt; 
-   &lt;content splash=&quot;splash.png&quot;/&gt; 
+   &lt;content splash=&quot;logo.png&quot;/&gt; 
 &lt;/widget&gt;
 </pre>
 <p>Might appear as the following in a conforming user agent: </p>
@@ -105,8 +101,6 @@
   the <cite>Widget Packaging</cite> specification and its dependencies. </p>
 <h2>Splash screen</h2>
 <p>TBW: define what splash screen is.</p>
-<h2>Rendering the splash screen </h2>
-<p>TBW: We should provide some non-normative guidelines. </p>
 <h2>The <code>splash</code> attribute</h2>
 <p>The <dfn>splash attribute</dfn> is  <span>path attribute</span> of the <code>content</code> element that allows an author to point to a <span>file</span> within the <span>widget package</span>. This file is then used as the splash screen for an application. </p>
 <h2>The default splash screen</h2>
@@ -140,7 +134,7 @@
   </tr>
 </table>
 <p>It is <em class="ct">optional</em> for a <span>user agent</span> to <span title="supported">support</span> the <span title="media type">media types</span> listed in the <span>default splash-screen table</span>.</p>
-<h2>Processing the splash attribute</h2>
+<h2>Finding the splash screen</h2>
 <p>Firstly, when processing the splash attribute in the configuration document, a user agent behaves as if the <span>splash file defaults table</span> had been defined as part of the <a href="http://www.w3.org/TR/widgets/#table-of-configuration-defaults">Table of Configuration Defaults</a> in <a href="http://dev.w3.org/2006/waf/widgets/#step-3--set-the-configuration-defaults">Step 3</a> of the <cite>Widget Packaging</cite> specification.</p>
 <table summary="The configuration defaults that a user agent must set prior to instantiation." class="simple" style="border: 1px solid black">
   <caption>
@@ -163,14 +157,17 @@
     </tr>
   </tbody>
 </table>
-<p>Secondly, the user agent MUST run the <span>steps to locate the splash screen file</span> at 
+<p>Secondly, the user agent MUST run the <span>steps to process the <code>splash</code> attribute</span> at 
   the appropriate point in the <a href="http://dev.w3.org/2006/waf/widgets/#algorithm-to-process-a-configuration-doc">algorithm to process a
-configuration document</a>: the appropriate point is after all other attributes of the <code>content</code> element have been processed. </p>
+configuration document</a>: the appropriate point is after all other attributes of the <code>content</code> element defined in the Widgets Packaging specification have been processed by the user agent. </p>
 <p>Thirdly, if no splash screen file was found by running  the <span>steps to locate the splash screen file</span>, the user agent MUST attempt to locate </p>
-<h3>Locating the splash screen</h3>
-<p>The <dfn>steps to locate the splash screen file</dfn> is given by the following algorithm. </p>
+<h3>Processing the splash attribute</h3>
+<p>The <dfn>steps to process the splash attribute</dfn> is given by the following algorithm. </p>
 <ol>
   <li>
+    <p>If the content element does not have an attribute whose name is &quot;splash&quot;, then terminate this algorithm. </p>
+  </li>
+  <li>
     <p>Let <var>path</var> be the result of applying the <span>rule for getting a
       single attribute value</span> to the <code title="icon src">splash</code> attribute of this <code title="icon element">content</code> element. If <var>path</var> is
       not a <span>valid path</span> or is an empty string, then terminate this algorithm. </p>
@@ -208,6 +205,7 @@
     </ol>
   </li>
 </ol>
-<p>&nbsp;</p>
+<h2>Rendering the splash screen </h2>
+<p>TBW: We should provide some non-normative guidelines.</p>
 </body>
 </html>