cz.vutbr.web.csskit

Class ElementMatcherSafeCS

java.lang.Object

cz.vutbr.web.csskit.ElementMatcherSafeCS

All Implemented Interfaces:

ElementMatcher

Direct Known Subclasses:

ElementMatcherSafeStd

public class ElementMatcherSafeCS
extends Object
implements ElementMatcher

A case-sensitive matcher that corresponds to the XHTML mode matching. This is a safe implementation of the element matcher. It should be compatible with any DOM implementation. On the other hand, its performance is slightly worse because of some additional tests required due to the differences among the DOM implementations.

Author:

burgetr

Field Summary

Fields

Modifier and Type	Field and Description
static String	CLASS_ATTR
static String	CLASS_DELIM
static String	ID_ATTR

Constructor Summary

Constructors

Constructor and Description
ElementMatcherSafeCS()

Method Summary

Modifier and Type	Method and Description
Collection<String>	elementClasses(Element e) Obtains a collection of class names assigned to the given element using its class attribute.
String	elementID(Element e) Obtains the ID of the given element when specified.
String	elementName(Element e) Obtains the name of the given element.
String	getAttribute(Element e, String name) Obtains the value of an element attribute.
boolean	matchesAttribute(Element e, String name, String value, Selector.Operator o) Checks whether the given element attribute has the given value.
boolean	matchesClass(Element e, String className) Checks whether the given element has the given class assigned.
boolean	matchesID(Element e, String id) Checks whether the given element has the given ID assigned.
boolean	matchesName(Element e, String name) Checks whether the given element has the given name.

Methods inherited from class java.lang.Object

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

Field Detail

CLASS_DELIM

public static final String CLASS_DELIM

See Also:

Constant Field Values

CLASS_ATTR

public static final String CLASS_ATTR

See Also:

Constant Field Values

ID_ATTR

public static final String ID_ATTR

See Also:

Constant Field Values

Constructor Detail

ElementMatcherSafeCS

public ElementMatcherSafeCS()

Method Detail

getAttribute

public String getAttribute(Element e,
                           String name)

Description copied from interface: ElementMatcher

Obtains the value of an element attribute.

Specified by:

getAttribute in interface ElementMatcher

Parameters:

e - The DOM element.

name - Attribute name.

Returns:

The value of the given attribute or an empty string when the attribute is not present.

elementClasses

public Collection<String> elementClasses(Element e)

Description copied from interface: ElementMatcher

Obtains a collection of class names assigned to the given element using its class attribute.

Specified by:

elementClasses in interface ElementMatcher

Parameters:

e - The DOM element

Returns:

the list of class names (possibly empty).

matchesClass

public boolean matchesClass(Element e,
                            String className)

Description copied from interface: ElementMatcher

Checks whether the given element has the given class assigned.

Specified by:

matchesClass in interface ElementMatcher

Parameters:

e - The DOM element

className - the class name to check

Returns:

true when any of the element classes matches the given class.

elementID

public String elementID(Element e)

Description copied from interface: ElementMatcher

Obtains the ID of the given element when specified.

Specified by:

elementID in interface ElementMatcher

Parameters:

e - The DOM element

Returns:

The element ID or an empty string when not specified.

matchesID

public boolean matchesID(Element e,
                         String id)

Description copied from interface: ElementMatcher

Checks whether the given element has the given ID assigned.

Specified by:

matchesID in interface ElementMatcher

Parameters:

e - The DOM element

id - the class name to check

Returns:

true when the element has the given ID.

elementName

public String elementName(Element e)

Description copied from interface: ElementMatcher

Obtains the name of the given element.

Specified by:

elementName in interface ElementMatcher

Parameters:

e - The DOM element

Returns:

The element name.

matchesName

public boolean matchesName(Element e,
                           String name)

Description copied from interface: ElementMatcher

Checks whether the given element has the given name.

Specified by:

matchesName in interface ElementMatcher

Parameters:

e - The DOM element

name - the element name to check

Returns:

true when the element has the given name.

matchesAttribute

public boolean matchesAttribute(Element e,
                                String name,
                                String value,
                                Selector.Operator o)

Description copied from interface: ElementMatcher

Checks whether the given element attribute has the given value.

Specified by:

matchesAttribute in interface ElementMatcher

Parameters:

e - The DOM element

name - the attribute name

value - the attribute value

Returns:

true when the given attribute of the element has the given value.