[css3-fonts] revised definition of CSSFontFaceRule

Author: John Daggett

css3-fonts/Fonts.html

@@ -107,15 +107,15 @@
 
    <h1>CSS Fonts Module Level 3</h1>
 
-   <h2 class="no-num no-toc" id=editors-draft-12-november-2012>Editor's Draft
-    12 November 2012</h2>
+   <h2 class="no-num no-toc" id=editors-draft-13-november-2012>Editor's Draft
+    13 November 2012</h2>
 
    <dl id=authors>
     <dt>This version:
 
     <dd><a
      href="http://dev.w3.org/csswg/css3-fonts/">http://dev.w3.org/csswg/css3-fonts/</a>
-     <!-- <dd><a href="http://www.w3.org/TR/2012/ED-css3-fonts-20121112/">http://www.w3.org/TR/2012/ED-css3-fonts-20121112/</a> -->
+     <!-- <dd><a href="http://www.w3.org/TR/2012/ED-css3-fonts-20121113/">http://www.w3.org/TR/2012/ED-css3-fonts-20121113/</a> -->
 
 
     <dt>Latest version:
@@ -378,25 +378,31 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
       </span>Feature precedence examples</a>
     </ul>
 
-   <li><a href="#font-load-events"><span class=secno>8 </span>Font Load
+   <li><a href="#object-model"><span class=secno>8 </span>Object Model</a>
+    <ul class=toc>
+     <li><a href="#om-fontface"><span class=secno>8.1 </span>The
+      <code>CSSFontFaceRule</code> interface</a>
+
+     <li><a href="#om-fontfeaturevalues"><span class=secno>8.2 </span>The
+      <code>CSSFontFeatureValuesRule</code> interface</a>
+    </ul>
+
+   <li><a href="#font-load-events"><span class=secno>9 </span>Font Load
     Events</a>
     <ul class=toc>
-     <li><a href="#document-fontloader"><span class=secno>8.1
+     <li><a href="#document-fontloader"><span class=secno>9.1
       </span>Extension to the <code>document</code> interface</a>
 
-     <li><a href="#fontloader-interface"><span class=secno>8.2 </span>The
+     <li><a href="#fontloader-interface"><span class=secno>9.2 </span>The
       <code>FontLoader</code> Interface</a>
 
-     <li><a href="#font-load-event-examples"><span class=secno>8.3
+     <li><a href="#font-load-event-examples"><span class=secno>9.3
       </span>Font load event examples</a>
     </ul>
 
    <li class=no-num><a href="#platform-props-to-css">Appendix A: Mapping
     platform font properties to CSS properties</a>
 
-   <li class=no-num><a href="#font-feature-values-DOM">Appendix B: DOM
-    Interfaces</a>
-
    <li class=no-num><a href="#ch-ch-ch-changes">Changes</a>
     <ul class=toc>
      <li class=no-num><a href="#recent-changes"> Changes from the August 2012
@@ -2952,12 +2958,11 @@ <h3 id=cluster-matching><span class=secno>5.2 </span>Cluster matching</h3>
     selection rules defined in the previous section.
     <ol>
      <li>If all characters in the sequence <em>b + c1 + c2 …</em> are
-      completely supported by the font's character map, select this font for
-      the sequence.
+      completely supported by the font, select this font for the sequence.
 
      <li>If a sequence of multiple codepoints is canonically equivalent to a
-      single character and the font's character map supports that character,
-      select this font for the sequence.
+      single character and the font supports that character, select this font
+      for the sequence.
     </ol>
 
    <li>If no font was found in the font list in step 1:
@@ -4910,14 +4915,71 @@ <h3 id=feature-precedence-examples><span class=secno>7.3 </span>Feature
     discretionary ligatures.</p>
   </div>
 
-  <h2 id=font-load-events><span class=secno>8 </span>Font Load Events</h2>
+  <h2 id=object-model><span class=secno>8 </span>Object Model</h2>
+
+  <p>The contents of <code>@font-face</code> and
+   <code>@font-feature-values</code> rules can be accessed via the following
+   extensions to the CSS Object Model.
+
+  <h3 id=om-fontface><span class=secno>8.1 </span>The <a
+   href="#cssfontfacerule"><code>CSSFontFaceRule</code></a> interface</h3>
+
+  <p>The <dfn id=cssfontfacerule>CSSFontFaceRule</dfn> interface represents a
+   ‘<code class=css>@font-face</code>’ rule.
+
+  <pre class=idl>
+interface CSSFontFaceRule : CSSRule {
+  readonly attribute DOMString family;
+  readonly attribute DOMString src;
+  readonly attribute DOMString style;
+  readonly attribute DOMString weight;
+  readonly attribute DOMString stretch;
+  readonly attribute DOMString unicodeRange;
+  readonly attribute DOMString variant;
+  readonly attribute DOMString featureSettings;
+}</pre>
+
+  <p>The CSS 2.0 specification defined a different variant of this rule. This
+   definition supercedes that one.
+
+  <h3 id=om-fontfeaturevalues><span class=secno>8.2 </span>The <a
+   href="#cssfontfeaturevaluesrule"><code>CSSFontFeatureValuesRule</code></a>
+   interface</h3>
+
+  <p>The <code>CSSRule</code> interface is extended as follows:
+
+  <pre class=idl>partial interface CSSRule {
+  const unsigned short FONT_FEATURE_VALUES_RULE = 14;
+}</pre>
+
+  <p>The <dfn id=cssfontfeaturevaluesrule>CSSFontFeatureValuesRule</dfn>
+   interface represents a ‘<code class=css>@font-feature-values</code>’
+   rule.
+
+  <pre class=idl>interface CSSFontFeatureValuesRule : CSSRule {
+  readonly attribute DOMString familyList;
+  readonly attribute DOMString valueText;
+};</pre>
+
+  <dl class=idl-attributes>
+   <dt><var>familyList</var> of type <code>DOMString</code>, readonly
+
+   <dd>The list of one or more font families for which a given set of feature
+    values is defined.
+
+   <dt><var>valueText</var> of type <code>DOMString</code>, readonly
+
+   <dd>Serialized set of feature values.
+  </dl>
+
+  <h2 id=font-load-events><span class=secno>9 </span>Font Load Events</h2>
 
   <p>Since fonts defined via @font-face rules are loaded on demand, pages may
    need to know precisely when fonts have completed downloading before
    measuring text elements on the page or to show some form of interim user
    interface state.
 
-  <h3 id=document-fontloader><span class=secno>8.1 </span>Extension to the
+  <h3 id=document-fontloader><span class=secno>9.1 </span>Extension to the
    <code>document</code> interface</h3>
 
   <p>To allow font loading to be tracked explicitly within content the
@@ -4928,7 +4990,7 @@ <h3 id=document-fontloader><span class=secno>8.1 </span>Extension to the
 };
 </pre>
 
-  <h3 id=fontloader-interface><span class=secno>8.2 </span>The
+  <h3 id=fontloader-interface><span class=secno>9.2 </span>The
    <code>FontLoader</code> Interface</h3>
 
   <pre class=idl>[Constructor]
@@ -5006,7 +5068,7 @@ <h3 id=fontloader-interface><span class=secno>8.2 </span>The
    authors need to explicitly call this method again to have the callback
    called again.
 
-  <h3 id=font-load-event-examples><span class=secno>8.3 </span>Font load
+  <h3 id=font-load-event-examples><span class=secno>9.3 </span>Font load
    event examples</h3>
 
   <div class=example>
@@ -5135,99 +5197,6 @@ <h2 class=no-num id=platform-props-to-css>Appendix A: Mapping platform font
    Mac OS X. Apple has indicated it intends to support complex script
    rendering using OpenType font features in the future.
 
-  <h2 class=no-num id=font-feature-values-DOM>Appendix B: DOM Interfaces</h2>
-
-  <p><em>This appendix is normative.</em>
-
-  <p>Font feature values defined within <code>@font-feature-values</code>
-   rules are accessible via the following modifications to the CSS Object
-   Model.
-
-  <dl>
-   <dt><b>Interface <i><a id=DOM-CSSRule name=DOM-CSSRule>CSSRule</a></i></b>
-
-   <dd>
-    <p>The following additional rule type is added to the
-     <code>CSSRule</code> interface.</p>
-
-    <dl>
-     <dt><b>IDL Definition</b>
-
-     <dd>
-      <div class=idl-code>
-       <pre>
-interface CSSRule {
-...
-const unsigned short FONT_FEATURE_VALUES_RULE = 14;
-...
-};</pre>
-      </div>
-     </dd>
-     <!-- IDL -->
-    </dl>
-
-   <dt><b>Interface <i><a id=DOM-CSSFontFeatureValuesRule
-    name=DOM-CSSFontFeatureValuesRule>CSSFontFeatureValuesRule</a></i></b>
-
-   <dd>
-    <p> The <code>CSSFontFeatureValuesRule</code> interface represents font
-     feature selector values for a given set of font families.</p>
-
-    <dl>
-     <dt> <br>
-      <b>IDL Definition</b>
-
-     <dd>
-      <div class=idl-code>
-       <pre>
-interface CSSFontFeatureValuesRule : CSSRule {
-  attribute DOMString fontFamily;
-                        // raises(DOMException) on setting
-  attribute DOMString valueText;
-                        // raises(DOMException) on setting
-};
-</pre>
-      </div>
-      <br>
-
-     <dt><b>Attributes</b>
-
-     <dd>
-      <dl>
-       <dt><code class=attribute-name><a
-        id=DOM-CSSFontFeatureValuesRule-fontFamily
-        name=DOM-CSSFontFeatureValuesRule-fontFamily>fontFamily</a></code> of
-        type <code>DOMString</code>
-
-       <dd>This attribute represents the list of font families for which a
-        particular set of values are defined. The syntax is the same as that
-        of the font-family property.
-      </dl>
-
-     <dd>
-      <dl>
-       <dt><code class=attribute-name><a
-        id=DOM-CSSFontFeatureValuesRule-valueText
-        name=DOM-CSSFontFeatureValuesRule-valueText>valueText</a></code> of
-        type <code>DOMString</code>
-
-       <dd>Parsable text representing the set of feature values defined for a
-        given set of font families.
-      </dl>
-
-     <dt><b>Exceptions on setting</b>
-    </dl>
-
-    <dl>
-     <dt><code>DOMException SYNTAX_ERR</code>
-
-     <dd>Thrown when the specified string value has a syntax error or is
-      unparsable.
-    </dl>
-
-   <dt><b>No Methods</b>
-  </dl>
-
   <h2 class=no-num id=ch-ch-ch-changes>Changes</h2>
 
   <h3 class=no-num id=recent-changes> Changes from the <a
@@ -5247,6 +5216,10 @@ <h3 class=no-num id=recent-changes> Changes from the <a
    <li>Added definition of font load events
 
    <li>Defined explicit steps for font matching grapheme clusters
+
+   <li>Added font-stretch values to the font shorthand
+
+   <li>Created object model section and revised definition of CSSFontFaceRule
   </ul>
 
   <h2 class=no-num id=acknowledgments>Acknowledgments</h2>
@@ -5651,6 +5624,12 @@ <h2 class=no-num id=index>Index</h2>
    <li>contextual, <a href="#contextual"
     title=contextual><strong>6.4</strong></a>
 
+   <li>CSSFontFaceRule, <a href="#cssfontfacerule"
+    title=CSSFontFaceRule><strong>8.1</strong></a>
+
+   <li>CSSFontFeatureValuesRule, <a href="#cssfontfeaturevaluesrule"
+    title=CSSFontFeatureValuesRule><strong>8.2</strong></a>
+
    <li>cursive, definition of, <a href="#cursive0" title="cursive, definition
     of"><strong>#</strong></a>