michael@0: /* This Source Code Form is subject to the terms of the Mozilla Public
michael@0:  * License, v. 2.0. If a copy of the MPL was not distributed with this
michael@0:  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
michael@0: 
michael@0: #include "nsISupports.idl"
michael@0: 
michael@0: interface nsIDOMCSSFontFaceRule;
michael@0: interface nsIDOMCSSStyleDeclaration;
michael@0: 
michael@0: [scriptable, uuid(9a3b1272-6585-4f41-b08f-fdc5da444cd0)]
michael@0: interface nsIDOMFontFace : nsISupports
michael@0: {
michael@0:   // An indication of how we found this font during font-matching.
michael@0:   // Note that the same physical font may have been found in multiple ways within a range.
michael@0:   readonly attribute boolean fromFontGroup;
michael@0:   readonly attribute boolean fromLanguagePrefs;
michael@0:   readonly attribute boolean fromSystemFallback;
michael@0: 
michael@0:   // available for all fonts
michael@0:   readonly attribute DOMString name; // full font name as obtained from the font resource
michael@0:   readonly attribute DOMString CSSFamilyName; // a family name that could be used in CSS font-family
michael@0:                                               // (not necessarily the actual name that was used,
michael@0:                                               // due to aliases, generics, localized names, etc)
michael@0: 
michael@0:   // meaningful only when the font is a user font defined using @font-face
michael@0:   readonly attribute nsIDOMCSSFontFaceRule rule; // null if no associated @font-face rule
michael@0:   readonly attribute long srcIndex; // index in the rule's src list, -1 if no @font-face rule
michael@0:   readonly attribute DOMString URI; // null if not a downloaded font, i.e. local
michael@0:   readonly attribute DOMString localName; // null if not a src:local(...) rule
michael@0:   readonly attribute DOMString format; // as per http://www.w3.org/TR/css3-webfonts/#referencing
michael@0:   readonly attribute DOMString metadata; // XML metadata from WOFF file (if any)
michael@0: };