javafx.scene

Class CssStyleHelper

java.lang.Object

javafx.scene.CssStyleHelper

final class CssStyleHelper
extends java.lang.Object

The StyleHelper is a helper class used for applying CSS information to Nodes.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	CssStyleHelper.CacheContainer

Field Summary

Fields

Modifier and Type	Field and Description
private CssStyleHelper.CacheContainer	cacheContainer
private static CssMetaData	dummyFontProperty
private Node	firstStyleableAncestor
private static PlatformLogger	LOGGER
private static java.util.Set<PseudoClass>	NULL_PSEUDO_CLASS_STATE
private PseudoClassState	triggerStates A Set of all the pseudo-class states which, if they change, need to cause the Node to be set to UPDATE its CSS styles on the next pulse.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	CssStyleHelper()

Method Summary

Modifier and Type	Method and Description
private CalculatedValue	calculateValue(CascadingStyle style, Styleable styleable, CssMetaData cssMetaData, StyleMap styleMap, java.util.Set<PseudoClass> states, Styleable originatingStyleable, CalculatedValue fontFromCacheEntry)
private static boolean	canReuseStyleHelper(Node node, StyleMap styleMap)
(package private) static CssStyleHelper	createStyleHelper(Node node) Creates a new StyleHelper.
(package private) Font	deriveFont(Font font, java.lang.String fontFamily, FontWeight fontWeight, FontPosture fontPosture, double fontSize)
private static Node	findFirstStyleableAncestor(Styleable st)
private java.lang.String	formatExceptionMessage(Styleable styleable, CssMetaData cssMetaData, Style style, java.lang.Exception e)
private java.lang.String	formatUnresolvedLookupMessage(Styleable styleable, CssMetaData cssMetaData, Style style, ParsedValue resolved, java.lang.ClassCastException cce)
private CalculatedValue	getCachedFont(Styleable styleable)
(package private) java.lang.String	getFontFamily(Font font)
(package private) FontPosture	getFontPosture(Font font)
(package private) FontWeight	getFontWeight(Font font)
private CascadingStyle	getInheritedStyle(Styleable styleable, java.lang.String property) Called when we must getInheritedStyle a value from a parent node in the scenegraph.
private void	getMatchingLookupStyles(Styleable node, ParsedValue parsedValue, java.util.List<CascadingStyle> styleList, boolean matchState)
(package private) static java.util.Map<<any>,java.util.List<Style>>	getMatchingStyles(java.util.Map<<any>,java.util.List<Style>> map, Node node)
(package private) static java.util.List<Style>	getMatchingStyles(Styleable styleable, CssMetaData styleableProperty) Called from Node NodeHelper.getMatchingStyles
private java.util.List<Style>	getMatchingStyles(Styleable node, CssMetaData styleableProperty, boolean matchState)
private void	getMatchingStyles(Styleable node, CssMetaData styleableProperty, java.util.List<CascadingStyle> styleList, boolean matchState)
private CascadingStyle	getStyle(Styleable styleable, java.lang.String property, StyleMap styleMap, java.util.Set<PseudoClass> states) Gets the CSS CascadingStyle for the property of this node in these pseudo-class states.
private static CssStyleHelper	getStyleHelper(Node n)
private StyleMap	getStyleMap(Styleable styleable)
private java.util.Set<PseudoClass>[]	getTransitionStates(Node node) Dynamic pseudo-class state of the node and its parents.
private java.lang.String	getUnresolvedLookup(ParsedValue resolved)
private CalculatedValue	handleNoStyleFound(Styleable styleable, CssMetaData cssMetaData, StyleMap styleMap, java.util.Set<PseudoClass> pseudoClassStates, Styleable originatingStyleable, CalculatedValue cachedFont) Called when there is no style found.
private static boolean	isTrue(<any> booleanProperty)
private boolean	isUserSetFont(Styleable node)
private CalculatedValue	lookup(Styleable styleable, CssMetaData cssMetaData, StyleMap styleMap, java.util.Set<PseudoClass> states, Styleable originatingStyleable, CalculatedValue cachedFont) The main workhorse of this class, the lookup method walks up the CSS style tree looking for the style information for the Node, the property associated with the given styleable, in these states for this font.
(package private) CalculatedValue	lookupFont(Styleable styleable, java.lang.String property, StyleMap styleMap, CalculatedValue cachedFont) Look up a font property.
private CascadingStyle	lookupInheritedFontProperty(Styleable styleable, java.lang.String property, StyleMap styleMap, int distance, CascadingStyle fontShorthand)
(package private) boolean	pseudoClassStateChanged(PseudoClass pseudoClass)
private void	resetToInitialValues(Styleable styleable)
private ParsedValue	resolveLookups(Styleable styleable, ParsedValue parsedValue, StyleMap styleMap, java.util.Set<PseudoClass> states, <any> whence, java.util.Set<ParsedValue> resolves)
private CascadingStyle	resolveRef(Styleable styleable, java.lang.String property, StyleMap styleMap, java.util.Set<PseudoClass> states) Find the property among the styles that pertain to the Node
private static void	setTrue(<any> booleanProperty)
(package private) void	transitionToState(Node node) Called by the Node whenever it has transitioned from one set of pseudo-class states to another.
private static void	updateParentTriggerStates(Styleable styleable, int depth, PseudoClassState[] triggerStates)

Methods inherited from class java.lang.Object

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

Field Detail

LOGGER

private static final PlatformLogger LOGGER

firstStyleableAncestor

private Node firstStyleableAncestor

cacheContainer

private CssStyleHelper.CacheContainer cacheContainer

triggerStates

private PseudoClassState triggerStates

A Set of all the pseudo-class states which, if they change, need to cause the Node to be set to UPDATE its CSS styles on the next pulse. For example, your stylesheet might have:

 .button { ... }
 .button:hover { ... }
 .button *.label { text-fill: black }
 .button:hover *.label { text-fill: blue }
 

In this case, the first 2 rules apply to the Button itself, but the second two rules apply to the label within a Button. When the hover changes on the Button, however, we must mark the Button as needing an UPDATE. StyleHelper though only contains styles for the first two rules for Button. The pseudoclassStateMask would in this case have only a single bit set for "hover". In this way the StyleHelper associated with the Button would know whether a change to "hover" requires the button and all children to be update. Other pseudo-class state changes that are not in this hash set are ignored. * Called "triggerStates" since they would trigger a CSS update.

NULL_PSEUDO_CLASS_STATE

private static final java.util.Set<PseudoClass> NULL_PSEUDO_CLASS_STATE

dummyFontProperty

private static final CssMetaData dummyFontProperty

Constructor Detail

CssStyleHelper

private CssStyleHelper()

Method Detail

createStyleHelper

static CssStyleHelper createStyleHelper(Node node)

Creates a new StyleHelper.

updateParentTriggerStates

private static void updateParentTriggerStates(Styleable styleable,
                                              int depth,
                                              PseudoClassState[] triggerStates)

isUserSetFont

private boolean isUserSetFont(Styleable node)

getStyleHelper

private static CssStyleHelper getStyleHelper(Node n)

findFirstStyleableAncestor

private static Node findFirstStyleableAncestor(Styleable st)

isTrue

private static boolean isTrue(<any> booleanProperty)

setTrue

private static void setTrue(<any> booleanProperty)

canReuseStyleHelper

private static boolean canReuseStyleHelper(Node node,
                                           StyleMap styleMap)

resetToInitialValues

private void resetToInitialValues(Styleable styleable)

getStyleMap

private StyleMap getStyleMap(Styleable styleable)

pseudoClassStateChanged

boolean pseudoClassStateChanged(PseudoClass pseudoClass)

getTransitionStates

private java.util.Set<PseudoClass>[] getTransitionStates(Node node)

Dynamic pseudo-class state of the node and its parents. Only valid during a pulse. The StyleCacheEntry to choose depends on the Node's pseudo-class state and the pseudo-class state of its parents. Without the parent pseudo-class state, the fact that the the node in this pseudo-class state matched foo:blah bar { } is lost.

transitionToState

void transitionToState(Node node)

Called by the Node whenever it has transitioned from one set of pseudo-class states to another. This function will then lookup the new values for each of the styleable variables on the Node, and then either set the value directly or start an animation based on how things are specified in the CSS file. Currently animation support is disabled until the new parser comes online with support for animations and that support is detectable via the API.

getStyle

private CascadingStyle getStyle(Styleable styleable,
                                java.lang.String property,
                                StyleMap styleMap,
                                java.util.Set<PseudoClass> states)

Gets the CSS CascadingStyle for the property of this node in these pseudo-class states. A null style may be returned if there is no style information for this combination of input parameters.

Parameters:

styleable -

property -

styleMap -

states - @return

lookup

private CalculatedValue lookup(Styleable styleable,
                               CssMetaData cssMetaData,
                               StyleMap styleMap,
                               java.util.Set<PseudoClass> states,
                               Styleable originatingStyleable,
                               CalculatedValue cachedFont)

The main workhorse of this class, the lookup method walks up the CSS style tree looking for the style information for the Node, the property associated with the given styleable, in these states for this font.

Parameters:

styleable -

states -

originatingStyleable -

Returns:

handleNoStyleFound

private CalculatedValue handleNoStyleFound(Styleable styleable,
                                           CssMetaData cssMetaData,
                                           StyleMap styleMap,
                                           java.util.Set<PseudoClass> pseudoClassStates,
                                           Styleable originatingStyleable,
                                           CalculatedValue cachedFont)

Called when there is no style found.

getInheritedStyle

private CascadingStyle getInheritedStyle(Styleable styleable,
                                         java.lang.String property)

Called when we must getInheritedStyle a value from a parent node in the scenegraph.

resolveRef

private CascadingStyle resolveRef(Styleable styleable,
                                  java.lang.String property,
                                  StyleMap styleMap,
                                  java.util.Set<PseudoClass> states)

Find the property among the styles that pertain to the Node

resolveLookups

private ParsedValue resolveLookups(Styleable styleable,
                                   ParsedValue parsedValue,
                                   StyleMap styleMap,
                                   java.util.Set<PseudoClass> states,
                                   <any> whence,
                                   java.util.Set<ParsedValue> resolves)

getUnresolvedLookup

private java.lang.String getUnresolvedLookup(ParsedValue resolved)

formatUnresolvedLookupMessage

private java.lang.String formatUnresolvedLookupMessage(Styleable styleable,
                                                       CssMetaData cssMetaData,
                                                       Style style,
                                                       ParsedValue resolved,
                                                       java.lang.ClassCastException cce)

formatExceptionMessage

private java.lang.String formatExceptionMessage(Styleable styleable,
                                                CssMetaData cssMetaData,
                                                Style style,
                                                java.lang.Exception e)

calculateValue

private CalculatedValue calculateValue(CascadingStyle style,
                                       Styleable styleable,
                                       CssMetaData cssMetaData,
                                       StyleMap styleMap,
                                       java.util.Set<PseudoClass> states,
                                       Styleable originatingStyleable,
                                       CalculatedValue fontFromCacheEntry)

getCachedFont

private CalculatedValue getCachedFont(Styleable styleable)

getFontPosture

FontPosture getFontPosture(Font font)

getFontWeight

FontWeight getFontWeight(Font font)

getFontFamily

java.lang.String getFontFamily(Font font)

deriveFont

Font deriveFont(Font font,
                java.lang.String fontFamily,
                FontWeight fontWeight,
                FontPosture fontPosture,
                double fontSize)

lookupFont

CalculatedValue lookupFont(Styleable styleable,
                           java.lang.String property,
                           StyleMap styleMap,
                           CalculatedValue cachedFont)

Look up a font property. This is handled separately from lookup since font is inherited and has sub-properties. One should expect that the text font for the following would be 16px Arial. The lookup method would give 16px system since it would look only for font-size, font-family, etc only if the lookup on font failed.

 Text text = new Text("Hello World");
 text.setStyle("-fx-font-size: 16px;");
 Group group = new Group();
 group.setStyle("-fx-font: 12px Arial;");
 group.getChildren().add(text);
 

lookupInheritedFontProperty

private CascadingStyle lookupInheritedFontProperty(Styleable styleable,
                                                   java.lang.String property,
                                                   StyleMap styleMap,
                                                   int distance,
                                                   CascadingStyle fontShorthand)

getMatchingStyles

static java.util.List<Style> getMatchingStyles(Styleable styleable,
                                               CssMetaData styleableProperty)

Called from Node NodeHelper.getMatchingStyles

Parameters:

styleable -

styleableProperty -

Returns:

getMatchingStyles

static java.util.Map<<any>,java.util.List<Style>> getMatchingStyles(java.util.Map<<any>,java.util.List<Style>> map,
                                                                    Node node)

getMatchingStyles

private java.util.List<Style> getMatchingStyles(Styleable node,
                                                CssMetaData styleableProperty,
                                                boolean matchState)

getMatchingStyles

private void getMatchingStyles(Styleable node,
                               CssMetaData styleableProperty,
                               java.util.List<CascadingStyle> styleList,
                               boolean matchState)

getMatchingLookupStyles

private void getMatchingLookupStyles(Styleable node,
                                     ParsedValue parsedValue,
                                     java.util.List<CascadingStyle> styleList,
                                     boolean matchState)