javax.swing.text.html

Class StyleSheet

java.lang.Object

javax.swing.text.StyleContext

javax.swing.text.html.StyleSheet

All Implemented Interfaces:

java.io.Serializable, javax.swing.text.AbstractDocument.AttributeContext

public class StyleSheet
extends javax.swing.text.StyleContext

This class adds support for defining the visual characteristics of HTML views being rendered. This enables views to be customized by a look-and-feel, mulitple views over the same model can be rendered differently. Each EditorPane has its own StyleSheet, but by default one sheet will be shared by all of the HTMLEditorKit instances. An HTMLDocument can also have a StyleSheet, which holds specific CSS specs. In order for Views to store less state and therefore be more lightweight, the StyleSheet can act as a factory for painters that handle some of the rendering tasks. Since the StyleSheet may be used by views over multiple documents the HTML attributes don't effect the selector being used. The rules are stored as named styles, and other information is stored to translate the context of an element to a rule.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	StyleSheet.BoxPainter This class carries out some of the duties of CSS formatting.
static class	StyleSheet.ListPainter This class carries out some of the CSS list formatting duties.

Nested classes/interfaces inherited from class javax.swing.text.StyleContext

javax.swing.text.StyleContext.NamedStyle, javax.swing.text.StyleContext.SmallAttributeSet

Field Summary

Fields inherited from class javax.swing.text.StyleContext

DEFAULT_STYLE

Constructor Summary

Constructors

Constructor and Description
StyleSheet() Constructs a StyleSheet.

Method Summary

Methods

Modifier and Type	Method and Description
javax.swing.text.AttributeSet	addAttribute(javax.swing.text.AttributeSet old, java.lang.Object key, java.lang.Object value) Adds an attribute to the given set and returns a new set.
javax.swing.text.AttributeSet	addAttributes(javax.swing.text.AttributeSet old, javax.swing.text.AttributeSet attr) Adds a set of attributes to the element.
void	addCSSAttribute(javax.swing.text.MutableAttributeSet attr, CSS.Attribute key, java.lang.String value) Adds a CSS attribute to the given set.
boolean	addCSSAttributeFromHTML(javax.swing.text.MutableAttributeSet attr, CSS.Attribute key, java.lang.String value) Adds a CSS attribute to the given set.
void	addRule(java.lang.String rule) Adds a set of rules to the sheet.
void	addStyleSheet(StyleSheet ss) Adds the rules from ss to those of the receiver. ss's rules will override the old rules.
protected javax.swing.text.MutableAttributeSet	createLargeAttributeSet(javax.swing.text.AttributeSet a) Creates a large set of attributes.
protected javax.swing.text.StyleContext.SmallAttributeSet	createSmallAttributeSet(javax.swing.text.AttributeSet a) Creates a compact set of attributes that might be shared.
java.awt.Color	getBackground(javax.swing.text.AttributeSet a) Takes a set of attributes and turns it into a background color specification.
java.net.URL	getBase() Gets the base url.
StyleSheet.BoxPainter	getBoxPainter(javax.swing.text.AttributeSet a) Gets the box formatter to use for the given set of CSS attributes.
javax.swing.text.AttributeSet	getDeclaration(java.lang.String decl) Translates a CSS declaration into an AttributeSet.
java.awt.Font	getFont(javax.swing.text.AttributeSet a) Gets the font to use for the given set.
java.awt.Color	getForeground(javax.swing.text.AttributeSet a) Takes a set of attributes and turns it into a foreground color specification.
static int	getIndexOfSize(float pt) TODO
StyleSheet.ListPainter	getListPainter(javax.swing.text.AttributeSet a) Gets the list formatter to use for the given set of CSS attributes.
float	getPointSize(int index) Gets the point size, given a size index.
float	getPointSize(java.lang.String size) Given the string of the size, returns the point size value.
javax.swing.text.Style	getRule(HTML.Tag t, javax.swing.text.Element e) Gets the style used to render the given tag.
javax.swing.text.Style	getRule(java.lang.String selector) Gets the rule that best matches the selector. selector is a space separated String of element names.
StyleSheet[]	getStyleSheets() Returns an array of the linked StyleSheets.
javax.swing.text.AttributeSet	getViewAttributes(javax.swing.text.View v) Gets a set of attributes to use in the view.
void	importStyleSheet(java.net.URL url) Imports a style sheet from the url.
void	loadRules(java.io.Reader in, java.net.URL ref) Loads a set of rules that have been specified in terms of CSS grammar.
javax.swing.text.AttributeSet	removeAttribute(javax.swing.text.AttributeSet old, java.lang.Object key) Removes an attribute from the set.
javax.swing.text.AttributeSet	removeAttributes(javax.swing.text.AttributeSet old, javax.swing.text.AttributeSet attrs) Removes an attribute from the set.
javax.swing.text.AttributeSet	removeAttributes(javax.swing.text.AttributeSet old, java.util.Enumeration<?> names) Removes a set of attributes for the element.
void	removeStyle(java.lang.String nm) Removes a style previously added.
void	removeStyleSheet(StyleSheet ss) Removes ss from those of the receiver
void	setBase(java.net.URL base) Sets the base url.
void	setBaseFontSize(int sz) Sets the base font size between 1 and 7.
void	setBaseFontSize(java.lang.String size) Sets the base font size from the String.
java.awt.Color	stringToColor(java.lang.String colorName) Convert the color string represenation into java.awt.Color.
javax.swing.text.AttributeSet	translateHTMLToCSS(javax.swing.text.AttributeSet htmlAttrSet) Converts a set of HTML attributes to an equivalent set of CSS attributes.

Methods inherited from class javax.swing.text.StyleContext

addChangeListener, addStyle, getChangeListeners, getCompressionThreshold, getDefaultStyleContext, getEmptySet, getFont, getFontMetrics, getStaticAttribute, getStaticAttributeKey, getStyle, getStyleNames, readAttributes, readAttributeSet, reclaim, registerStaticAttributeKey, removeChangeListener, toString, writeAttributes, writeAttributeSet

Methods inherited from class java.lang.Object

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

Constructor Detail

StyleSheet

public StyleSheet()

Constructs a StyleSheet.

Method Detail

getRule

public javax.swing.text.Style getRule(HTML.Tag t,
                             javax.swing.text.Element e)

Gets the style used to render the given tag. The element represents the tag and can be used to determine the nesting, where the attributes will differ if there is nesting inside of elements.

Parameters:

t - - the tag to translate to visual attributes

e - - the element representing the tag

Returns:

the set of CSS attributes to use to render the tag.

getRule

public javax.swing.text.Style getRule(java.lang.String selector)

Gets the rule that best matches the selector. selector is a space separated String of element names. The attributes of the returned Style will change as rules are added and removed.

Parameters:

selector - - the element names separated by spaces

Returns:

the set of CSS attributes to use to render

addRule

public void addRule(java.lang.String rule)

Adds a set of rules to the sheet. The rules are expected to be in valid CSS format. This is called as a result of parsing a