cat.inspiracio.html

Interface HTMLOptionsCollection

All Superinterfaces:

org.w3c.dom.html.HTMLCollection, Iterable<HTMLOptionElement>, NodeList, Serializable

public interface HTMLOptionsCollection
extends HTMLCollection<HTMLOptionElement>, Iterable<HTMLOptionElement>

Spec

Method Summary

Modifier and Type	Method and Description
void	add(HTMLOptGroupElement group) Inserts element at the end of the list.
void	add(HTMLOptGroupElement group, HTMLElement before) Inserts element before the node given by before.
void	add(HTMLOptGroupElement group, int before) Inserts element before the node given by before.
void	add(HTMLOptionElement option) Inserts element at the end of the list.
void	add(HTMLOptionElement option, HTMLElement before) Inserts element before the node given by before.
void	add(HTMLOptionElement option, int before) Inserts element before the node given by before.
HTMLOptionElement	get(String name) Returns the item with ID or name name from the collection.
int	getLength() Returns the number of elements in the collection.
int	getSelectedIndex()
HTMLOptionElement	item(int index) Returns the item with index index from the collection.
HTMLOptionElement	namedItem(String name) Returns the item with ID or name name from the collection.
void	remove(int index) Removes an option from the group.
void	set(int index, HTMLOptionElement option) Sets an option element.
void	setLength(int length) Sets the number of elements in the collection.
void	setSelectedIndex(int index)

Methods inherited from interface java.lang.Iterable

forEach, iterator, spliterator

Method Detail

item

HTMLOptionElement item(int index)

Returns the item with index index from the collection. The items are sorted in tree order.

Specified by:

item in interface org.w3c.dom.html.HTMLCollection

Specified by:

item in interface NodeList

getLength

int getLength()

Returns the number of elements in the collection.

Specified by:

getLength in interface org.w3c.dom.html.HTMLCollection

Specified by:

getLength in interface NodeList

setLength

void setLength(int length)

Sets the number of elements in the collection. When set to a smaller number, truncates the number of option elements in the corresponding container. When set to a greater number, adds new blank option elements to that container.

Parameters:

length - the new length

set

void set(int index,
         HTMLOptionElement option)

Sets an option element. May increase the length and thereby create more option elements. setter creator void (unsigned long index, HTMLOptionElement? option);

Parameters:

index - the index

option - If null, deletes the option at index.

namedItem

HTMLOptionElement namedItem(String name)

Returns the item with ID or name name from the collection. If there are multiple matching items, then the first is returned. Same as get(name).

Specified by:

namedItem in interface org.w3c.dom.html.HTMLCollection

get

HTMLOptionElement get(String name)

Returns the item with ID or name name from the collection. If there are multiple matching items, then the first is returned. Same as namedItem(name).

Parameters:

name - the name

Returns:

the element

add

void add(HTMLOptionElement option)

Inserts element at the end of the list. This method will throw a HierarchyRequestError exception if element is an ancestor of the element into which it is to be inserted.

Parameters:

option - the new option

add

void add(HTMLOptionElement option,
         HTMLElement before)

Inserts element before the node given by before. This method will throw a HierarchyRequestError exception if element is an ancestor of the element into which it is to be inserted.

Parameters:

option - the new option

before - insert it before this one

add

void add(HTMLOptionElement option,
         int before)

Inserts element before the node given by before. The before argument can be a number, in which case element is inserted before the item with that number. If before is a number out of range, then element will be added at the end of the list. This method will throw a HierarchyRequestError exception if element is an ancestor of the element into which it is to be inserted.

Parameters:

option - the new option

before - insert it before this one

add

void add(HTMLOptGroupElement group)

Inserts element at the end of the list. This method will throw a HierarchyRequestError exception if element is an ancestor of the element into which it is to be inserted.

Parameters:

group - the new group

add

void add(HTMLOptGroupElement group,
         HTMLElement before)

Inserts element before the node given by before. If before is null, then element will be added at the end of the list. This method will throw a HierarchyRequestError exception if element is an ancestor of the element into which it is to be inserted.

Parameters:

group - the new group

before - insert before this element

add

void add(HTMLOptGroupElement group,
         int before)

Inserts element before the node given by before. The before argument can be a number, in which case element is inserted before the item with that number. If before is a number out of range, then element will be added at the end of the list. This method will throw a HierarchyRequestError exception if element is an ancestor of the element into which it is to be inserted.

Parameters:

group - the new group

before - insert before this element

remove

void remove(int index)

Removes an option from the group. spec

Parameters:

index - If there is no option with this index, does nothing.

getSelectedIndex

int getSelectedIndex()

setSelectedIndex

void setSelectedIndex(int index)