org.jsoup.nodes

Class Attributes

java.lang.Object

org.jsoup.nodes.Attributes

All Implemented Interfaces:

java.lang.Cloneable, java.lang.Iterable<Attribute>

public class Attributes
extends java.lang.Object
implements java.lang.Iterable<Attribute>, java.lang.Cloneable

The attributes of an Element.

Attributes are treated as a map: there can be only one value associated with an attribute key.

Attribute key and value comparisons are done case insensitively, and keys are normalised to lower-case.

Author:

Jonathan Hedley, jonathan@hedley.net

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.lang.String	dataPrefix

Constructor Summary

Constructors

Constructor and Description
Attributes()

Method Summary

Methods

Modifier and Type	Method and Description
void	addAll(Attributes incoming) Add all the attributes from the incoming set to this set.
java.util.List<Attribute>	asList() Get the attributes as a List, for iteration.
Attributes	clone()
java.util.Map<java.lang.String,java.lang.String>	dataset() Retrieves a filtered view of attributes that are HTML5 custom data attributes; that is, attributes with keys starting with data-.
boolean	equals(java.lang.Object o)
java.lang.String	get(java.lang.String key) Get an attribute value by key.
int	hashCode()
boolean	hasKey(java.lang.String key) Tests if these attributes contain an attribute with this key.
java.lang.String	html() Get the HTML representation of these attributes.
java.util.Iterator<Attribute>	iterator()
void	put(Attribute attribute) Set a new attribute, or replace an existing one by key.
void	put(java.lang.String key, java.lang.String value) Set a new attribute, or replace an existing one by key.
void	remove(java.lang.String key) Remove an attribute by key.
int	size() Get the number of attributes in this set.
java.lang.String	toString()

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

dataPrefix

protected static final java.lang.String dataPrefix

See Also:

Constant Field Values

Constructor Detail

Attributes

public Attributes()

Method Detail

get

public java.lang.String get(java.lang.String key)

Get an attribute value by key.

Parameters:

key - the attribute key

Returns:

the attribute value if set; or empty string if not set.

See Also:

hasKey(String)

put

public void put(java.lang.String key,
       java.lang.String value)

Set a new attribute, or replace an existing one by key.

Parameters:

key - attribute key

value - attribute value

put

public void put(Attribute attribute)

Set a new attribute, or replace an existing one by key.

Parameters:

attribute - attribute

remove

public void remove(java.lang.String key)

Remove an attribute by key.

Parameters:

key - attribute key to remove

hasKey

public boolean hasKey(java.lang.String key)

Tests if these attributes contain an attribute with this key.

Parameters:

key - key to check for

Returns:

true if key exists, false otherwise

size

public int size()

Get the number of attributes in this set.

Returns:

size

addAll

public void addAll(Attributes incoming)

Add all the attributes from the incoming set to this set.

Parameters:

incoming - attributes to add to these attributes.

iterator

public java.util.Iterator<Attribute> iterator()

Specified by:

iterator in interface java.lang.Iterable<Attribute>

asList

public java.util.List<Attribute> asList()

Get the attributes as a List, for iteration. Do not modify the keys of the attributes via this view, as changes to keys will not be recognised in the containing set.

Returns:

an view of the attributes as a List.

dataset

public java.util.Map<java.lang.String,java.lang.String> dataset()

Retrieves a filtered view of attributes that are HTML5 custom data attributes; that is, attributes with keys starting with data-.

Returns:

map of custom data attributes.

html

public java.lang.String html()

Get the HTML representation of these attributes.

Returns:

HTML

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

clone

public Attributes clone()

Overrides:

clone in class java.lang.Object