- From: CVS User akostiai <cvsmail@w3.org>
- Date: Mon, 14 Oct 2013 07:43:53 +0000
- To: public-dap-commits@w3.org
Update of /sources/public/2009/dap/vibration
In directory roscoe:/tmp/cvs-serv3344
Modified Files:
Overview.html Overview.src.html
Log Message:
allow concurrent invocations in different browsing contexts (ACTION-652)
--- /sources/public/2009/dap/vibration/Overview.html 2013/06/12 17:44:33 1.42
+++ /sources/public/2009/dap/vibration/Overview.html 2013/10/14 07:43:53 1.43
@@ -1,5 +1,5 @@
<!DOCTYPE html>
-<html lang="en" dir="ltr">
+<html lang="en" dir="ltr" typeof="bibo:Document " about="" property="dcterms:language" content="en">
<head>
<title>Vibration API</title>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8">
@@ -421,16 +421,16 @@
border-collapse: collapse;
width: 100%;
}
-</style><link rel="stylesheet" href="http://www.w3.org/StyleSheets/TR/W3C-ED"><!--[if lt IE 9]><script src='http://www.w3.org/2008/site/js/html5shiv.js'></script><![endif]--></head>
- <body class="h-entry"><div class="head">
+</style><link rel="stylesheet" href="https://www.w3.org/StyleSheets/TR/W3C-ED"><!--[if lt IE 9]><script src='https://www.w3.org/2008/site/js/html5shiv.js'></script><![endif]--></head>
+ <body class="h-entry" style="" role="document" id="respecDocument"><div class="head" role="contentinfo" id="respecHeader">
<p>
- <a href="http://www.w3.org/"><img width="72" height="48" src="http://www.w3.org/Icons/w3c_home" alt="W3C"></a>
+ <a href="http://www.w3.org/"><img width="72" height="48" src="https://www.w3.org/Icons/w3c_home" alt="W3C"></a>
</p>
- <h1 class="title p-name" id="title">Vibration API</h1>
+ <h1 class="title p-name" id="title" property="dcterms:title">Vibration API</h1>
- <h2 id="w3c-editor-s-draft-12-june-2013"><abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft <time class="dt-published" datetime="2013-06-12">12 June 2013</time></h2>
+ <h2 property="dcterms:issued" datatype="xsd:dateTime" content="2013-10-14T04:32:19.000Z" id="w3c-editor-s-draft-14-october-2013"><abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft <time class="dt-published" datetime="2013-10-14">14 October 2013</time></h2>
<dl>
<dt>This version:</dt>
@@ -450,7 +450,8 @@
<dt>Editor:</dt>
- <dd class="p-author h-card vcard"><span class="p-name fn">Anssi Kostiainen</span>, Intel</dd>
+ <dd class="p-author h-card vcard" rel="bibo:editor" inlist=""><span typeof="foaf:Person"><span property="foaf:name" class="p-name fn">Anssi Kostiainen</span>, Intel</span>
+</dd>
@@ -461,13 +462,16 @@
<p class="copyright">
- <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> ©
+ <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> ©
2013
- <a href="http://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup>
+ <a href="http://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup>
(<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts Institute of Technology">MIT</abbr></a>,
<a href="http://www.ercim.eu/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>,
- <a href="http://www.keio.ac.jp/">Keio</a>, <a href="http://ev.buaa.edu.cn/">Beihang</a>), All Rights Reserved.
+ <a href="http://www.keio.ac.jp/">Keio</a>, <a href="http://ev.buaa.edu.cn/">Beihang</a>),
+
+ All Rights Reserved.
+
<abbr title="World Wide Web Consortium">W3C</abbr> <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
<a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and
<a href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a> rules apply.
@@ -476,10 +480,10 @@
<hr>
</div>
- <section id="abstract" class="introductory"><h2>Abstract</h2><p>
+ <section id="abstract" class="introductory" property="dcterms:abstract" datatype="" typeof="bibo:Chapter" resource="#abstract" rel="bibo:chapter"><h2 aria-level="1" role="heading" id="h2_abstract">Abstract</h2><p>
This specification defines an API that provides access to the vibration
mechanism of the hosting device. Vibration is a form of tactile feedback.
- </p></section><section id="sotd" class="introductory"><h2>Status of This Document</h2>
+ </p></section><section id="sotd" class="introductory" typeof="bibo:Chapter" resource="#sotd" rel="bibo:chapter"><h2 aria-level="1" role="heading" id="h2_sotd">Status of This Document</h2>
@@ -523,7 +527,9 @@
<p>
This document was produced by a group operating under the
- <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5 February 2004 <abbr title="World Wide Web Consortium">W3C</abbr> Patent Policy</a>.
+
+ <a id="sotd_patent" about="" rel="w3p:patentRules" href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5 February 2004 <abbr title="World Wide Web Consortium">W3C</abbr> Patent Policy</a>.
+
@@ -542,12 +548,12 @@
-</section><section id="toc"><h2 class="introductory">Table of Contents</h2><ul class="toc"><li class="tocline"><a href="#introduction" class="tocxref"><span class="secno">1. </span>Introduction</a></li><li class="tocline"><a href="#conformance" class="tocxref"><span class="secno">2. </span>Conformance</a></li><li class="tocline"><a href="#terminology" class="tocxref"><span class="secno">3. </span>Terminology</a></li><li class="tocline"><a href="#vibration-interface" class="tocxref"><span class="secno">4. </span>Vibration Interface</a></li><li class="tocline"><a href="#examples" class="tocxref"><span class="secno">5. </span>Examples</a></li><li class="tocline"><a href="#acknowledgements" class="tocxref"><span class="secno">A. </span>Acknowledgements</a></li><li class="tocline"><a href="#references" class="tocxref"><span class="secno">B. </span>References</a><ul class="toc"><li class="tocline"><a href="#normative-references" class="tocxref"><span class="secno">B.1 </span>Normative references</a></li><li clas="tocline"><a href="#informative-references" class="tocxref"><span class="secno">B.2 </span>Informative references</a></li></ul></li></ul></section>
+</section><section id="toc"><h2 class="introductory" aria-level="1" role="heading" id="h2_toc">Table of Contents</h2><ul class="toc" role="directory" id="respecContents"><li class="tocline"><a href="#introduction" class="tocxref"><span class="secno">1. </span>Introduction</a></li><li class="tocline"><a href="#conformance" class="tocxref"><span class="secno">2. </span>Conformance</a></li><li class="tocline"><a href="#terminology" class="tocxref"><span class="secno">3. </span>Terminology</a></li><li class="tocline"><a href="#vibration-interface" class="tocxref"><span class="secno">4. </span>Vibration Interface</a></li><li class="tocline"><a href="#examples" class="tocxref"><span class="secno">5. </span>Examples</a></li><li class="tocline"><a href="#acknowledgements" class="tocxref"><span class="secno">A. </span>Acknowledgements</a></li><li class="tocline"><a href="#references" class="tocxref"><span class="secno">B. </span>References</a><ul class="toc"><li class="tocline"><a href="#normative-references" class"tocxref"><span class="secno">B.1 </span>Normative references</a></li><li class="tocline"><a href="#informative-references" class="tocxref"><span class="secno">B.2 </span>Informative references</a></li></ul></li></ul></section>
<section class="informative" id="introduction">
- <!--OddPage--><h2><span class="secno">1. </span>Introduction</h2><p><em>This section is non-normative.</em></p>
+ <!--OddPage--><h2 aria-level="1" role="heading" id="h2_introduction"><span class="secno">1. </span>Introduction</h2><p><em>This section is non-normative.</em></p>
<p>
The API is specifically designed to address use cases that require
simple tactile feedback only. Use cases requiring more fine-grained
@@ -559,7 +565,7 @@
</p>
</section>
- <section id="conformance"><!--OddPage--><h2><span class="secno">2. </span>Conformance</h2>
+ <section id="conformance" typeof="bibo:Chapter" resource="#conformance" rel="bibo:chapter"><!--OddPage--><h2 aria-level="1" role="heading" id="h2_conformance"><span class="secno">2. </span>Conformance</h2>
<p>
As well as sections marked as non-normative, all authoring guidelines, diagrams, examples,
and notes in this specification are non-normative. Everything else in this specification is
@@ -584,7 +590,7 @@
</section>
<section id="terminology">
- <!--OddPage--><h2><span class="secno">3. </span>Terminology</h2>
+ <!--OddPage--><h2 aria-level="1" role="heading" id="h2_terminology"><span class="secno">3. </span>Terminology</h2>
<p>
The concepts <dfn id="dfn-browsing-context"><a href="http://www.w3.org/TR/html5/browsers.html#browsing-context">
browsing context</a></dfn> and
@@ -594,13 +600,14 @@
</section>
<section id="vibration-interface">
- <!--OddPage--><h2><span class="secno">4. </span>Vibration Interface</h2>
+ <!--OddPage--><h2 aria-level="1" role="heading" id="h2_vibration-interface"><span class="secno">4. </span>Vibration Interface</h2>
<pre class="idl"><span class="idlInterface" id="idl-def-Navigator">partial interface <span class="idlInterfaceID">Navigator</span> {
<span class="idlMethod"> <span class="idlMethType"><a>boolean</a></span> <span class="idlMethName"><a href="#widl-Navigator-vibrate-boolean-unsigned-long-sequence-unsigned-long--pattern">vibrate</a></span> (<span class="idlParam"><span class="idlParamType">(<a>unsigned long</a> or sequence<<a>unsigned long</a>>)</span> <span class="idlParamName">pattern</span></span>);</span>
};</span></pre>
<p>
- The <code>vibrate()</code> method, when invoked, <em class="rfc2119" title="MUST">MUST</em> run the algorithm
+ The <code id="widl-Navigator-vibrate-boolean-unsigned-long-sequence-unsigned-long--pattern">vibrate()</code>
+ method, when invoked, <em class="rfc2119" title="MUST">MUST</em> run the algorithm
for <a href="#dfn-processing-vibration-patterns" class="internalDFN">processing vibration patterns</a>.
</p>
<p>
@@ -643,7 +650,7 @@
<a href="http://dvcs.w3.org/hg/webperf/raw-file/tip/specs/PageVisibility/Overview.html#dom-document-hidden">
hidden</a></code> attribute [<cite><a class="bibref" href="#bib-PAGE-VISIBILITY">PAGE-VISIBILITY</a></cite>] is set to true,
then return false and terminate these steps.
- <div class="note"><div class="note-title" role="heading" aria-level="3"><span>Note</span></div><div class="">
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_1"><span>Note</span></div><div class="">
A trusted (also known as privileged) application that integrates
closely with the operating system's functionality may vibrate the
device even if such an application is not visible at all, and thus
@@ -652,7 +659,7 @@
</li>
<li>
An implementation <em class="rfc2119" title="MAY">MAY</em> return false and terminate these steps.
- <div class="note"><div class="note-title" role="heading" aria-level="3"><span>Note</span></div><div class="">
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_2"><span>Note</span></div><div class="">
For example, an implementation might abort the
algorithm because the user has set a preference indicating that
pages at a given origin should never be able to vibrate the device,
@@ -662,15 +669,21 @@
</div></div>
</li>
<li>
- Cancel the pre-existing instance of the <a href="#dfn-processing-vibration-patterns" class="internalDFN">processing vibration
- patterns</a> algorithm, if any.
- </li>
- <li>
- If <var>pattern</var> is an empty list, or if the device does
- not provide a vibration mechanism (or it is disabled), then return
- true and terminate these steps.
- </li>
- <li>
+ If there is a pre-existing instance of the <a href="#dfn-processing-vibration-patterns" class="internalDFN">processing vibration
+ patterns</a> algorithm running for this browsing context, run the
+ following substeps:
+ <ol>
+ <li>
+ Cancel the pre-existing instance of the <a href="#dfn-processing-vibration-patterns" class="internalDFN">processing vibration
+ patterns</a> algorithm, if any.
+ </li>
+ <li>
+ If <var>pattern</var> is an empty list, or if the device does
+ not provide a vibration mechanism (or it is disabled), then
+ return true and terminate these steps.
+ </li>
+ </ol>
+ </li><li>
Return true, and then continue running these steps asynchronously.
</li>
<li>
@@ -699,7 +712,7 @@
</section>
<section class="informative" id="examples">
- <!--OddPage--><h2><span class="secno">5. </span>Examples</h2><p><em>This section is non-normative.</em></p>
+ <!--OddPage--><h2 aria-level="1" role="heading" id="h2_examples"><span class="secno">5. </span>Examples</h2><p><em>This section is non-normative.</em></p>
<p>
In the following example the device will vibrate for 1000 milliseconds (ms):
</p><div class="example"><div class="example-title"><span>Example 1</span></div><pre class="example highlight prettyprint"><span class="com">// vibrate for 1000 ms</span><span class="pln">
@@ -723,7 +736,7 @@
navigator</span><span class="pun">.</span><span class="pln">vibrate</span><span class="pun">([]);</span></pre></div>
</section>
<section class="appendix" id="acknowledgements">
- <!--OddPage--><h2><span class="secno">A. </span>Acknowledgements</h2>
+ <!--OddPage--><h2 aria-level="1" role="heading" id="h2_acknowledgements"><span class="secno">A. </span>Acknowledgements</h2>
<p>
The group is deeply indebted to Justin Lebar, Mounir Lamouri, Jonas
Sicking, and the Mozilla WebAPI team for their contributions, and for
@@ -732,9 +745,9 @@
</section>
-<section id="references" class="appendix"><!--OddPage--><h2><span class="secno">B. </span>References</h2><section id="normative-references"><h3><span class="secno">B.1 </span>Normative references</h3><dl class="bibliography"><dt id="bib-HTML5">[HTML5]</dt><dd>Robin Berjon et al. <a href="http://www.w3.org/TR/html5/"><cite>HTML5</cite></a>. 17 December 2012. W3C Candidate Recommendation. URL: <a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a>
-</dd><dt id="bib-PAGE-VISIBILITY">[PAGE-VISIBILITY]</dt><dd>Jatinder Mann; Arvind Jain. <a href="http://www.w3.org/TR/page-visibility/"><cite>Page Visibility</cite></a>. 14 May 2013. W3C Recommendation. URL: <a href="http://www.w3.org/TR/page-visibility/">http://www.w3.org/TR/page-visibility/</a>
-</dd><dt id="bib-RFC2119">[RFC2119]</dt><dd>S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>Key words for use in RFCs to Indicate Requirement Levels.</cite></a> March 1997. Internet RFC 2119. URL: <a href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a>
-</dd><dt id="bib-WEBIDL">[WEBIDL]</dt><dd>Cameron McCormack. <a href="http://www.w3.org/TR/WebIDL/"><cite>Web IDL</cite></a>. 19 April 2012. W3C Candidate Recommendation. URL: <a href="http://www.w3.org/TR/WebIDL/">http://www.w3.org/TR/WebIDL/</a>
-</dd></dl></section><section id="informative-references"><h3><span class="secno">B.2 </span>Informative references</h3><dl class="bibliography"><dt id="bib-notifications">[notifications]</dt><dd>Anne van Kesteren; John Gregg. <a href="http://www.w3.org/TR/notifications/"><cite>Web Notifications</cite></a>. 14 June 2012. W3C Working Draft. URL: <a href="http://www.w3.org/TR/notifications/">http://www.w3.org/TR/notifications/</a>
+<section id="references" class="appendix" typeof="bibo:Chapter" resource="#references" rel="bibo:chapter"><!--OddPage--><h2 aria-level="1" role="heading" id="h2_references"><span class="secno">B. </span>References</h2><section id="normative-references" typeof="bibo:Chapter" resource="#normative-references" rel="bibo:chapter"><h3 aria-level="2" role="heading" id="h3_normative-references"><span class="secno">B.1 </span>Normative references</h3><dl class="bibliography" about=""><dt id="bib-HTML5">[HTML5]</dt><dd rel="dcterms:requires">Robin Berjon; Steve Faulkner; Travis Leithead; Erika Doyle Navara; Edward O'Connor; Silvia Pfeiffer. <a href="http://www.w3.org/TR/html5/"><cite>HTML5</cite></a>. 6 August 2013. W3C Candidate Recommendation. URL: <a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a>
+</dd><dt id="bib-PAGE-VISIBILITY">[PAGE-VISIBILITY]</dt><dd rel="dcterms:requires">Jatinder Mann; Arvind Jain. <a href="http://www.w3.org/TR/page-visibility/"><cite>Page Visibility</cite></a>. 14 May 2013. W3C Recommendation. URL: <a href="http://www.w3.org/TR/page-visibility/">http://www.w3.org/TR/page-visibility/</a>
+</dd><dt id="bib-RFC2119">[RFC2119]</dt><dd rel="dcterms:requires">S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>Key words for use in RFCs to Indicate Requirement Levels.</cite></a> March 1997. Internet RFC 2119. URL: <a href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a>
+</dd><dt id="bib-WEBIDL">[WEBIDL]</dt><dd rel="dcterms:requires">Cameron McCormack. <a href="http://www.w3.org/TR/WebIDL/"><cite>Web IDL</cite></a>. 19 April 2012. W3C Candidate Recommendation. URL: <a href="http://www.w3.org/TR/WebIDL/">http://www.w3.org/TR/WebIDL/</a>
+</dd></dl></section><section id="informative-references" typeof="bibo:Chapter" resource="#informative-references" rel="bibo:chapter"><h3 aria-level="2" role="heading" id="h3_informative-references"><span class="secno">B.2 </span>Informative references</h3><dl class="bibliography" about=""><dt id="bib-notifications">[notifications]</dt><dd rel="dcterms:references">John Gregg; Anne van Kesteren. <a href="http://www.w3.org/TR/notifications/"><cite>Web Notifications</cite></a>. 12 September 2013. W3C Last Call Working Draft. URL: <a href="http://www.w3.org/TR/notifications/">http://www.w3.org/TR/notifications/</a>
</dd></dl></section></section></body></html>
\ No newline at end of file
--- /sources/public/2009/dap/vibration/Overview.src.html 2013/07/09 14:24:20 1.6
+++ /sources/public/2009/dap/vibration/Overview.src.html 2013/10/14 07:43:53 1.7
@@ -156,14 +156,20 @@
</div>
</li>
<li>
- Cancel the pre-existing instance of the <a>processing vibration
- patterns</a> algorithm, if any.
- </li>
- <li>
- If <var>pattern</var> is an empty list, or if the device does
- not provide a vibration mechanism (or it is disabled), then return
- true and terminate these steps.
- </li>
+ If there is a pre-existing instance of the <a>processing vibration
+ patterns</a> algorithm running for this browsing context, run the
+ following substeps:
+ <ol>
+ <li>
+ Cancel the pre-existing instance of the <a>processing vibration
+ patterns</a> algorithm, if any.
+ </li>
+ <li>
+ If <var>pattern</var> is an empty list, or if the device does
+ not provide a vibration mechanism (or it is disabled), then
+ return true and terminate these steps.
+ </li>
+ </ol>
<li>
Return true, and then continue running these steps asynchronously.
</li>
Received on Monday, 14 October 2013 07:43:55 UTC