Module io.sf.carte.css4j

Package io.sf.carte.doc.style.css.om

Class DOMCSSStyleSheetFactory

java.lang.Object

io.sf.carte.doc.style.css.om.AbstractCSSStyleSheetFactory

io.sf.carte.doc.style.css.om.BaseCSSStyleSheetFactory

io.sf.carte.doc.style.css.om.DOMCSSStyleSheetFactory

All Implemented Interfaces:

CSSStyleSheetFactory, Serializable

public class DOMCSSStyleSheetFactory
extends BaseCSSStyleSheetFactory

CSS style sheet factory for DOM.

Allows the creation of stand-alone style sheets; also provides a method (createCSSDocument(Document)) to wrap any DOM Document into a CSSDocument, and access to an implementation of UserAgent based on those wrapped documents.

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	DOMCSSStyleSheetFactory.WrapperUserAgent

Field Summary

Fields inherited from class io.sf.carte.doc.style.css.om.AbstractCSSStyleSheetFactory

STRING_DOUBLE_QUOTE, STRING_SINGLE_QUOTE

Fields inherited from interface io.sf.carte.doc.style.css.CSSStyleSheetFactory

FLAG_STRING_DOUBLE_QUOTE, FLAG_STRING_SINGLE_QUOTE, ORIGIN_AUTHOR, ORIGIN_USER, ORIGIN_USER_AGENT, ORIGIN_USER_IMPORTANT

Constructor Summary

Constructors

Constructor	Description
DOMCSSStyleSheetFactory()
DOMCSSStyleSheetFactory(EnumSet<Parser.Flag> parserFlags)

Method Summary

Modifier and Type	Method	Description
AbstractCSSStyleDeclaration	createAnonymousStyleDeclaration(Node node)	Create a style declaration for an anonymous inline box, associated to a text/cdata node.
StylableDocumentWrapper	createCSSDocument(Document document)	Wrap a DOM document with a CSS-enabled wrapper that allows styles to be computed.
protected DOMDocumentCSSStyleSheet	createDocumentStyleSheet(byte origin)	Creates a Document CSS style sheet for all media.
protected EntityResolver	createEntityResolver()
protected InlineStyle	createInlineStyle(Node owner)	Create an inline style.
protected BaseCSSStyleSheet	createLinkedStyleSheet(Node ownerNode, String title, MediaQueryList mediaList)	Creates an author (document-linked) CSS style sheet.
protected DOMCSSStyleSheet	createRuleStyleSheet(AbstractCSSRule ownerRule, String title, MediaQueryList mediaList)	Creates a CSS style sheet owned by a CSS rule.
protected BaseDocumentCSSStyleSheet	getDefaultStyleSheet(CSSDocument.ComplianceMode mode)	Get the style sheet resulting from the merge of the user agent sheet and the non-important part of the user style sheet.
DOMCSSStyleSheetFactory.WrapperUserAgent	getUserAgent()	Gets a lazily instantiated user agent, appropriate to retrieve resources.
BaseDocumentCSSStyleSheet	getUserAgentStyleSheet(CSSDocument.ComplianceMode mode)	Gets the User Agent default CSS style sheet to be used by this factory.
void	setDefaultHTMLUserAgentSheet()	Sets a default HTML default style sheet as the user agent style sheet.

Methods inherited from class io.sf.carte.doc.style.css.om.BaseCSSStyleSheetFactory

createDefaultStyleFormattingFactory, createImmutableMediaQueryList, createInlineStyleErrorHandler, createMediaQueryList, createPropertyDefinition, createSACParser, createSheetErrorHandler, createStyleDeclarationErrorHandler, createStyleSheet, getDeviceFactory, getParserFlags, getStyleFormattingFactory, getSystemDefaultValue, getUserImportantStyleSheet, getUserNormalStyleSheet, getValueFactory, hasCompatValueFlags, hasFactoryFlag, htmlDefaultSheet, htmlQuirksDefaultSheet, setClassLoader, setDeviceFactory, setFactoryFlag, setLenientSystemValues, setStyleFormattingFactory, setUserStyleSheet, setUserStyleSheet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DOMCSSStyleSheetFactory

public DOMCSSStyleSheetFactory()

DOMCSSStyleSheetFactory

public DOMCSSStyleSheetFactory(EnumSet<Parser.Flag> parserFlags)

Method Details

createDocumentStyleSheet

protected DOMDocumentCSSStyleSheet createDocumentStyleSheet(byte origin)

Description copied from class: BaseCSSStyleSheetFactory

Creates a Document CSS style sheet for all media.

Specified by:

createDocumentStyleSheet in class BaseCSSStyleSheetFactory

Parameters:

origin - the origin of the sheet (like author, user agent, etc.)

Returns:

the style sheet.

createRuleStyleSheet

protected DOMCSSStyleSheet createRuleStyleSheet(AbstractCSSRule ownerRule,
 String title,
 MediaQueryList mediaList)

Description copied from class: BaseCSSStyleSheetFactory

Creates a CSS style sheet owned by a CSS rule.

Specified by:

createRuleStyleSheet in class BaseCSSStyleSheetFactory

Parameters:

ownerRule - the owner rule.

title - the advisory title.

mediaList - the list of target media for style.

Returns:

the style sheet.

createLinkedStyleSheet

protected BaseCSSStyleSheet createLinkedStyleSheet(Node ownerNode,
 String title,
 MediaQueryList mediaList)

Description copied from class: AbstractCSSStyleSheetFactory

Creates an author (document-linked) CSS style sheet.

Specified by:

createLinkedStyleSheet in class AbstractCSSStyleSheetFactory

Parameters:

ownerNode - the node that associates the style sheet to the document. In HTML it can be a link or style element. For style sheets that are included by other style sheets, the value of this parameter is null.

title - the advisory title.

mediaList - the target media list for style.

Returns:

the style sheet.

getUserAgentStyleSheet

public BaseDocumentCSSStyleSheet getUserAgentStyleSheet(CSSDocument.ComplianceMode mode)

Gets the User Agent default CSS style sheet to be used by this factory.

This implementation does not support !important rules in the user agent style sheet, as that support would imply some overhead that is unnecessary with the usual user agent sheets.

The sheet will be appropriately merged with the non-important part of the user-preference style sheet to provide the document's default sheet.

Parameters:

mode - the compliance mode.

Returns:

the default style sheet, or an empty sheet if no User Agent sheet was defined.

getDefaultStyleSheet

protected BaseDocumentCSSStyleSheet getDefaultStyleSheet(CSSDocument.ComplianceMode mode)

Description copied from class: AbstractCSSStyleSheetFactory

Get the style sheet resulting from the merge of the user agent sheet and the non-important part of the user style sheet.

Specified by:

getDefaultStyleSheet in class AbstractCSSStyleSheetFactory

Parameters:

mode - the compliance mode.

Returns:

the default style sheet at the top of the cascade.

setDefaultHTMLUserAgentSheet

public void setDefaultHTMLUserAgentSheet()

Description copied from class: AbstractCSSStyleSheetFactory

Sets a default HTML default style sheet as the user agent style sheet.

The sheet will be appropriately merged with the non-important part of the user-preference style sheet to provide the document's default sheet.

Specified by:

setDefaultHTMLUserAgentSheet in interface CSSStyleSheetFactory

Specified by:

setDefaultHTMLUserAgentSheet in class AbstractCSSStyleSheetFactory

getUserAgent

public DOMCSSStyleSheetFactory.WrapperUserAgent getUserAgent()

Gets a lazily instantiated user agent, appropriate to retrieve resources.

It reads XML documents with a DocumentBuilder that can be set with DOMCSSStyleSheetFactory.WrapperUserAgent.setDocumentBuilder(DocumentBuilder) and wraps them with CSS capabilities.

Returns:

the user agent.

createCSSDocument

public StylableDocumentWrapper createCSSDocument(Document document)

Wrap a DOM document with a CSS-enabled wrapper that allows styles to be computed.

The resulting document is read-only, and does not apply non-CSS presentational hints.

Parameters:

document - the document to wrap.

Returns:

the CSS-enabled document wrapper.

createAnonymousStyleDeclaration

public AbstractCSSStyleDeclaration createAnonymousStyleDeclaration(Node node)

Description copied from interface: CSSStyleSheetFactory

Create a style declaration for an anonymous inline box, associated to a text/cdata node.

Specified by:

createAnonymousStyleDeclaration in interface CSSStyleSheetFactory

Specified by:

createAnonymousStyleDeclaration in class AbstractCSSStyleSheetFactory

Parameters:

node - the node that has the declaration associated to it.

Returns:

the anonymous style declaration.

createInlineStyle

protected InlineStyle createInlineStyle(Node owner)

Description copied from class: AbstractCSSStyleSheetFactory

Create an inline style.

Specified by:

createInlineStyle in class AbstractCSSStyleSheetFactory

Parameters:

owner - the style's owner node (an attribute node).

Returns:

the inline style.

createEntityResolver

protected EntityResolver createEntityResolver()