1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
|
/*
* Copyright (c) 2003 World Wide Web Consortium,
* (Massachusetts Institute of Technology, Institut National de
* Recherche en Informatique et en Automatique, Keio University). All
* Rights Reserved. This program is distributed under the W3C's Software
* Intellectual Property License. This program is distributed in the
* hope that it will be useful, but WITHOUT ANY WARRANTY; without even
* the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
* PURPOSE.
* See W3C License http://www.w3.org/Consortium/Legal/ for more details.
*/
package org.w3c.dom.html2;
import org.w3c.dom.DOMException;
/**
* The select element allows the selection of an option. The contained options
* can be directly accessed through the select element as a collection. See
* the SELECT element definition in HTML 4.01.
* <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>.
*/
public interface HTMLSelectElement extends HTMLElement {
/**
* The type of this form control. This is the string "select-multiple"
* when the multiple attribute is <code>true</code> and the string
* "select-one" when <code>false</code>.
*/
public String getType();
/**
* The ordinal index of the selected option, starting from 0. The value -1
* is returned if no element is selected. If multiple options are
* selected, the index of the first selected option is returned.
*/
public int getSelectedIndex();
/**
* The ordinal index of the selected option, starting from 0. The value -1
* is returned if no element is selected. If multiple options are
* selected, the index of the first selected option is returned.
*/
public void setSelectedIndex(int selectedIndex);
/**
* The current form control value (i.e. the value of the currently
* selected option), if multiple options are selected this is the value
* of the first selected option.
*/
public String getValue();
/**
* The current form control value (i.e. the value of the currently
* selected option), if multiple options are selected this is the value
* of the first selected option.
*/
public void setValue(String value);
/**
* The number of options in this <code>SELECT</code>.
* @version DOM Level 2
*/
public int getLength();
/**
* The number of options in this <code>SELECT</code>.
* @exception DOMException
* NOT_SUPPORTED_ERR: if setting the length is not allowed by the
* implementation.
* @version DOM Level 2
*/
public void setLength(int length)
throws DOMException;
/**
* Returns the <code>FORM</code> element containing this control. Returns
* <code>null</code> if this control is not within the context of a
* form.
*/
public HTMLFormElement getForm();
/**
* The collection of <code>OPTION</code> elements contained by this
* element.
* @version DOM Level 2
*/
public HTMLOptionsCollection getOptions();
/**
* The control is unavailable in this context. See the disabled attribute
* definition in HTML 4.01.
*/
public boolean getDisabled();
/**
* The control is unavailable in this context. See the disabled attribute
* definition in HTML 4.01.
*/
public void setDisabled(boolean disabled);
/**
* If true, multiple <code>OPTION</code> elements may be selected in this
* <code>SELECT</code>. See the multiple attribute definition in HTML
* 4.01.
*/
public boolean getMultiple();
/**
* If true, multiple <code>OPTION</code> elements may be selected in this
* <code>SELECT</code>. See the multiple attribute definition in HTML
* 4.01.
*/
public void setMultiple(boolean multiple);
/**
* Form control or object name when submitted with a form. See the name
* attribute definition in HTML 4.01.
*/
public String getName();
/**
* Form control or object name when submitted with a form. See the name
* attribute definition in HTML 4.01.
*/
public void setName(String name);
/**
* Number of visible rows. See the size attribute definition in HTML 4.01.
*/
public int getSize();
/**
* Number of visible rows. See the size attribute definition in HTML 4.01.
*/
public void setSize(int size);
/**
* Index that represents the element's position in the tabbing order. See
* the tabindex attribute definition in HTML 4.01.
*/
public int getTabIndex();
/**
* Index that represents the element's position in the tabbing order. See
* the tabindex attribute definition in HTML 4.01.
*/
public void setTabIndex(int tabIndex);
/**
* Add a new element to the collection of <code>OPTION</code> elements for
* this <code>SELECT</code>. This method is the equivalent of the
* <code>appendChild</code> method of the <code>Node</code> interface if
* the <code>before</code> parameter is <code>null</code>. It is
* equivalent to the <code>insertBefore</code> method on the parent of
* <code>before</code> in all other cases. This method may have no
* effect if the new element is not an <code>OPTION</code> or an
* <code>OPTGROUP</code>.
* @param element The element to add.
* @param before The element to insert before, or <code>null</code> for
* the tail of the list.
* @exception DOMException
* NOT_FOUND_ERR: Raised if <code>before</code> is not a descendant of
* the <code>SELECT</code> element.
*/
public void add(HTMLElement element,
HTMLElement before)
throws DOMException;
/**
* Remove an element from the collection of <code>OPTION</code> elements
* for this <code>SELECT</code>. Does nothing if no element has the
* given index.
* @param index The index of the item to remove, starting from 0.
*/
public void remove(int index);
/**
* Removes keyboard focus from this element.
*/
public void blur();
/**
* Gives keyboard focus to this element.
*/
public void focus();
}
|
