Overview.src.html
changeset 27 ab7a04f3700a
parent 26 381a000f6e48
child 28 7acbce272677
--- a/Overview.src.html	Mon Jul 09 11:28:29 2012 +0100
+++ b/Overview.src.html	Tue Jul 24 13:41:20 2012 +0200
@@ -203,15 +203,49 @@
 delivery of email.
 
 <p>Each <span title=concept-notification>notification</span> has a
-<dfn>title</dfn> and an <dfn>origin</dfn>. For specification simplicity each
-<span title=concept-notification>notification</span> also has a
-<dfn>title direction</dfn> and <dfn>body direction</dfn>.
+<dfn>title</dfn>, <dfn>direction</dfn>, <dfn>language</dfn>, and an
+<dfn>origin</dfn>.
 
 <p>Each <span title=concept-notification>notification</span> <em>can</em>
 have an associated <dfn>body</dfn>, <dfn>tag</dfn>, <dfn>icon URL</dfn>, and
 <dfn>icon</dfn>.
 
 
+<h3>Direction</h3>
+
+<p>This section is written in terms equivalent to those used in the
+Rendering section of HTML. <span data-anolis-ref>HTML</span>
+
+<!-- keep this in sync with
+     http://www.whatwg.org/specs/web-apps/current-work/#text-rendered-in-native-user-interfaces -->
+
+<p>User agents are expected to honor the Unicode semantics of the text of a
+<span title=concept-notification>notification</span>'s <span>title</span>
+and <span>body</span>. Each is expected to be treated as an independent set
+of one or more bidirectional algorithm paragraphs when displayed, as defined
+by the bidirectional algorithm's rules P1, P2, and P3, including, for
+instance, supporting the paragraph-breaking behaviour of
+U+000A LINE FEED (LF) characters. For each paragraph of the
+<span>title</span> and <span>body</span>, the
+<span title=concept-notification>notification</span>'s
+<span>direction</span> provides the higher-level override of rules P2 and P3
+if it has a value other than "<code title>auto</code>".
+<span data-anolis-ref>BIDI</span>
+
+
+<h3>Language</h3>
+
+<!-- keep this in sync with
+     http://www.whatwg.org/specs/web-apps/current-work/#attr-lang -->
+
+<p>The <span title=concept-notification>notification</span>'s
+<span>language</span> specifies the primary language for the
+<span title=concept-notification>notification</span>'s <span>title</span>
+and <span>body</span>. Its value is a valid BCP 47 language tag, or the
+empty string. The empty string indicates that the primary language is
+unknown. <span data-anolis-ref>LANG</span>
+
+
 <h3>Permission</h3>
 
 <p><span title=concept-notification>Notifications</span> can only be
@@ -419,9 +453,9 @@
 };
 
 dictionary <dfn>NotificationOptions</dfn> {
-  <span>NotificationDirection</span> titleDir = "auto";
+  <span>NotificationDirection</span> dir = "auto";
+  DOMString lang = "";
   DOMString body;
-  <span>NotificationDirection</span> bodyDir = "auto";
   DOMString tag;
   DOMString icon;
 };
@@ -453,15 +487,18 @@
  <var title>title</var>,
  <span data-anolis-spec=webidl title="convert a DOMString to a sequence of Unicode characters">converted to Unicode</span>.
 
+ <li><p>Set <var title>notification</var>'s <span>direction</span> to
+ <var title>options</var>'s <code title>dir</code>.
+
+ <li><p>If <var title>options</var>'s <code title>lang</code> is a valid
+ BCP 47 language tag, or the empty string, set
+ <var title>notification</var>'s <span>language</span> to
+ <var title>options</var>'s <code title>lang</code>, or set it to the empty
+ string otherwise. <span data-anolis-ref>LANG</span>
+
  <li><p>Set <var title>notifications</var>'s <span>origin</span> to the
  current <span data-anolis-spec=origin>origin</span>.
 
- <li><p>Set <var title>notification</var>'s <span>title direction</span> to
- <var title>options</var>'s <code title>titleDir</code>.
-
- <li><p>Set <var title>notification</var>'s <span>body direction</span> to
- <var title>options</var>'s <code title>bodyDir</code>.
-
  <li><p>If <var title>options</var>'s <code title>body</code> is present,
  set <var title>notification</var>'s <span>body</span> to
  <code title>body</code>,
@@ -554,29 +591,6 @@
 
 
 
-<h2>Rendering</h2>
-
-<p>This section is written in terms equivalent to those used in the
-Rendering section of HTML. <span data-anolis-ref>HTML</span>
-
-<!-- keep this in sync with
-     http://www.whatwg.org/specs/web-apps/current-work/#text-rendered-in-native-user-interfaces -->
-
-<p>User agents are expected to honor the Unicode semantics of the text of a
-<span title=concept-notification>notification</span>'s <span>title</span>
-and <span>body</span>. Each is expected to be treated as an independent set
-of one or more bidirectional algorithm paragraphs when displayed, as defined
-by the bidirectional algorithm's rules P1, P2, and P3, including, for
-instance, supporting the paragraph-breaking behaviour of
-U+000A LINE FEED (LF) characters. For each paragraph of the
-<span>title</span> and <span>body</span>, the
-<span title=concept-notification>notification</span>'s
-<span>title direction</span> and <span>body direction</span> respectively
-provide the higher-level override of rules P2 and P3 if they have a value
-other than "<code title>auto</code>".
-<span data-anolis-ref>BIDI</span>
-
-
 <h2>Examples</h2>
 
 <h3>Using events</h3>