org.w3c.css.sac
Interface 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.
void | comment(String text) - Receive notification of a comment.
|
void | endDocument(InputSource source) - Receive notification of the end of a document.
|
void | endFontFace() - Receive notification of the end of a font face statement.
|
void | endMedia(SACMediaList media) - Receive notification of the end of a media statement.
|
void | endPage(String name, String pseudo_page) - Receive notification of the end of a media statement.
|
void | endSelector(SelectorList selectors) - Receive notification of the end of a rule statement.
|
void | ignorableAtRule(String atRule) - Receive notification of an unknown rule t-rule not supported by this
parser.
|
void | importStyle(String uri, SACMediaList media, String defaultNamespaceURI) - Receive notification of a import statement in the style sheet.
|
void | namespaceDeclaration(String prefix, String uri) - Receive notification of an unknown rule t-rule not supported by this
parser.
|
void | property(String name, LexicalUnit value, boolean important) - Receive notification of a declaration.
|
void | startDocument(InputSource source) - Receive notification of the beginning of a style sheet.
|
void | startFontFace() - Receive notification of the beginning of a font face statement.
|
void | startMedia(SACMediaList media) - Receive notification of the beginning of a media statement.
|
void | startPage(String name, String pseudo_page) - Receive notification of the beginning of a page statement.
|
void | startSelector(SelectorList selectors) - Receive notification of the beginning of a rule statement.
|
comment
public 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.
CSSException
- Any CSS exception, possibly wrapping another
exception.
endDocument
public 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.
CSSException
- Any CSS exception, possibly wrapping another
exception.
endFontFace
public void endFontFace()
throws CSSException
Receive notification of the end of a font face statement.
CSSException
- Any CSS exception, possibly wrapping another
exception.
endMedia
public void endMedia(SACMediaList media)
throws CSSException
Receive notification of the end of a media statement.
media
- The intended destination media for style information.
CSSException
- Any CSS exception, possibly wrapping another
exception.
endPage
public void endPage(String name,
String pseudo_page)
throws CSSException
Receive notification of the end of a media statement.
pseudo_page
- the pseudo page (if any, null otherwise)
CSSException
- Any CSS exception, possibly wrapping another
exception.
endSelector
public void endSelector(SelectorList selectors)
throws CSSException
Receive notification of the end of a rule statement.
selectors
- All intended selectors for all declarations.
CSSException
- Any CSS exception, possibly wrapping another
exception.
ignorableAtRule
public void ignorableAtRule(String atRule)
throws CSSException
Receive notification of an unknown rule t-rule not supported by this
parser.
CSSException
- Any CSS exception, possibly wrapping another
exception.
importStyle
public void importStyle(String uri,
SACMediaList media,
String defaultNamespaceURI)
throws CSSException
Receive notification of a import statement in the style sheet.
uri
- The URI of the imported style sheet.media
- The intended destination media for style information.
CSSException
- Any CSS exception, possibly wrapping another
exception.
namespaceDeclaration
public void namespaceDeclaration(String prefix,
String uri)
throws CSSException
Receive notification of an unknown rule t-rule not supported by this
parser.
prefix
- null
if this is the default namespaceuri
- The URI for this namespace.
CSSException
- Any CSS exception, possibly wrapping another
exception.
property
public void property(String name,
LexicalUnit value,
boolean important)
throws CSSException
Receive notification of a declaration.
name
- the name of the property.value
- the value of the property. All whitespace are stripped.important
- is this property important ?
CSSException
- Any CSS exception, possibly wrapping another
exception.
startDocument
public 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.
CSSException
- Any CSS exception, possibly wrapping another
exception.
startFontFace
public 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.
CSSException
- Any CSS exception, possibly wrapping another
exception.
startMedia
public void startMedia(SACMediaList 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.
media
- The intended destination media for style information.
CSSException
- Any CSS exception, possibly wrapping another
exception.
startPage
public 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.
name
- the name of the page (if any, null otherwise)pseudo_page
- the pseudo page (if any, null otherwise)
CSSException
- Any CSS exception, possibly wrapping another
exception.
startSelector
public void startSelector(SelectorList selectors)
throws CSSException
Receive notification of the beginning of a rule statement.
selectors
- All intended selectors for all declarations.
CSSException
- Any CSS exception, possibly wrapping another
exception.