All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface org.w3c.css.sac.DocumentHandler

public interface DocumentHandler
This is the main interface that most CSS applications implement: if the application needs to be informed of basic parsing events, it implements this interface and registers an instance with the CSS parser using the setCSSHandler method.


Method Index

 o comment(String)
Receive notification of a comment.
 o endDocument(InputSource)
Receive notification of the end of a document.
 o endFontFace()
Receive notification of the end of a font face statement.
 o endMedia(MediaList)
Receive notification of the end of a media statement.
 o endPage(String, String)
Receive notification of the end of a media statement.
 o endSelector(SelectorList)
Receive notification of the end of a rule statement.
 o ignorableAtRule(String)
Receive notification of an unknown rule t-rule not supported by this parser.
 o importStyle(String, MediaList, String)
Receive notification of a import statement in the style sheet.
 o namespaceDeclaration(String, String)
Receive notification of an unknown rule t-rule not supported by this parser.
 o property(String, LexicalUnit, boolean)
Receive notification of a declaration.
 o startDocument(InputSource)
Receive notification of the beginning of a style sheet.
 o startFontFace()
Receive notification of the beginning of a font face statement.
 o startMedia(MediaList)
Receive notification of the beginning of a media statement.
 o startPage(String, String)
Receive notification of the beginning of a page statement.
 o startSelector(SelectorList)
Receive notification of the beginning of a rule statement.

Methods

 o startDocument
 public abstract void startDocument(InputSource source) throws CSSException
Receive notification of the beginning of a style sheet. The CSS parser will invoke this method only once, before any other methods in this interface.

Parameters:
uri - The URI of the style sheet. @@TODO can be NULL ! (inline style sheet)
Throws: CSSException
Any CSS exception, possibly wrapping another exception.
 o endDocument
 public abstract void endDocument(InputSource source) throws CSSException
Receive notification of the end of a document. The CSS parser will invoke this method only once, and it will be the last method invoked during the parse. The parser shall not invoke this method until it has either abandoned parsing (because of an unrecoverable error) or reached the end of input.

Parameters:
uri - The URI of the style sheet.
Throws: CSSException
Any CSS exception, possibly wrapping another exception.
 o comment
 public abstract void comment(String text) throws CSSException
Receive notification of a comment. If the comment appears in a declaration (e.g. color: /* comment * / blue;), the parser notifies the comment before the declaration.

Parameters:
text - The comment.
Throws: CSSException
Any CSS exception, possibly wrapping another exception.
 o ignorableAtRule
 public abstract void ignorableAtRule(String atRule) throws CSSException
Receive notification of an unknown rule t-rule not supported by this parser.

Parameters:
at-rule - The complete ignored at-rule.
Throws: CSSException
Any CSS exception, possibly wrapping another exception.
 o namespaceDeclaration
 public abstract void namespaceDeclaration(String prefix,
                                           String uri) throws CSSException
Receive notification of an unknown rule t-rule not supported by this parser.

Parameters:
prefix - null if this is the default namespace
uri - The URI for this namespace.
Throws: CSSException
Any CSS exception, possibly wrapping another exception.
 o importStyle
 public abstract void importStyle(String uri,
                                  MediaList media,
                                  String defaultNamespaceURI) throws CSSException
Receive notification of a import statement in the style sheet.

Parameters:
uri - The URI of the imported style sheet.
media - The intended destination media for style information.
defaultNamepaceURI - The default namespace URI for the imported style sheet.
Throws: CSSException
Any CSS exception, possibly wrapping another exception.
 o startMedia
 public abstract void startMedia(MediaList media) throws CSSException
Receive notification of the beginning of a media statement. The Parser will invoke this method at the beginning of every media statement in the style sheet. there will be a corresponding endMedia() event for every startElement() event.

Parameters:
media - The intended destination media for style information.
Throws: CSSException
Any CSS exception, possibly wrapping another exception.
 o endMedia
 public abstract void endMedia(MediaList media) throws CSSException
Receive notification of the end of a media statement.

Parameters:
media - The intended destination media for style information.
Throws: CSSException
Any CSS exception, possibly wrapping another exception.
 o startPage
 public abstract void startPage(String name,
                                String pseudo_page) throws CSSException
Receive notification of the beginning of a page statement. The Parser will invoke this method at the beginning of every page statement in the style sheet. there will be a corresponding endPage() event for every startPage() event.

Parameters:
name - the name of the page (if any, null otherwise)
pseudo_page - the pseudo page (if any, null otherwise)
Throws: CSSException
Any CSS exception, possibly wrapping another exception.
 o endPage
 public abstract void endPage(String name,
                              String pseudo_page) throws CSSException
Receive notification of the end of a media statement.

Parameters:
media - The intended destination medium for style information.
pseudo_page - the pseudo page (if any, null otherwise)
Throws: CSSException
Any CSS exception, possibly wrapping another exception.
 o startFontFace
 public abstract void startFontFace() throws CSSException
Receive notification of the beginning of a font face statement. The Parser will invoke this method at the beginning of every font face statement in the style sheet. there will be a corresponding endFontFace() event for every startFontFace() event.

Throws: CSSException
Any CSS exception, possibly wrapping another exception.
 o endFontFace
 public abstract void endFontFace() throws CSSException
Receive notification of the end of a font face statement.

Throws: CSSException
Any CSS exception, possibly wrapping another exception.
 o startSelector
 public abstract void startSelector(SelectorList selectors) throws CSSException
Receive notification of the beginning of a rule statement.

Parameters:
selectors - All intended selectors for all declarations.
Throws: CSSException
Any CSS exception, possibly wrapping another exception.
 o endSelector
 public abstract void endSelector(SelectorList selectors) throws CSSException
Receive notification of the end of a rule statement.

Parameters:
selectors - All intended selectors for all declarations.
Throws: CSSException
Any CSS exception, possibly wrapping another exception.
 o property
 public abstract void property(String name,
                               LexicalUnit value,
                               boolean important) throws CSSException
Receive notification of a declaration.

Parameters:
name - the name of the property.
value - the value of the property. All whitespace are stripped.
important - is this property important ?
Throws: CSSException
Any CSS exception, possibly wrapping another exception.

All Packages  Class Hierarchy  This Package  Previous  Next  Index