29c60cb3f0c1861d6e46a503640ff5013abc19c9
[WebKit-https.git] / Source / WebCore / html / HTMLSelectElement.idl
1 /*
2  * Copyright (C) 2006, 2010 Apple Inc. All rights reserved.
3  * Copyright (C) 2006 Samuel Weinig <sam.weinig@gmail.com>
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Library General Public
7  * License as published by the Free Software Foundation; either
8  * version 2 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * Library General Public License for more details.
14  *
15  * You should have received a copy of the GNU Library General Public License
16  * along with this library; see the file COPYING.LIB.  If not, write to
17  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
18  * Boston, MA 02110-1301, USA.
19  */
20
21 [
22     CustomIndexedSetter,
23     ExportMacro=WEBCORE_EXPORT,
24     JSGenerateToNativeObject,
25 ] interface HTMLSelectElement : HTMLElement {
26     [Reflect] attribute boolean autofocus;
27     [Reflect] attribute boolean disabled;
28     readonly attribute HTMLFormElement? form;
29     attribute boolean multiple;
30     [Reflect] attribute DOMString name;
31     [Reflect] attribute boolean required;
32
33     attribute unsigned long size;
34
35     readonly attribute DOMString type;
36
37     readonly attribute HTMLOptionsCollection options;
38     [SetterMayThrowLegacyException] attribute unsigned long length;
39
40     getter HTMLOptionElement? item(unsigned long index);
41     HTMLOptionElement? namedItem(DOMString name);
42
43     [MayThrowLegacyException] void add(HTMLElement element, optional HTMLElement? before = null);
44     // FIXME: Should be:
45     // void add((HTMLOptionElement or HTMLOptGroupElement) element, optional (HTMLElement or long)? before = null);
46     [MayThrowLegacyException] void add(HTMLElement element, long index);
47
48     [MayThrowLegacyException] void remove(); // ChildNode overload
49     // FIXME: This overload is not in the specification and was dropped in Blink.
50     void remove(HTMLOptionElement option);
51     [ImplementedAs=removeByIndex] void remove(long index);
52
53     readonly attribute HTMLCollection selectedOptions;
54     attribute long selectedIndex;
55
56     attribute DOMString value;
57
58     readonly attribute boolean willValidate;
59     readonly attribute ValidityState validity;
60     readonly attribute DOMString validationMessage;
61     boolean checkValidity();
62     void setCustomValidity(DOMString? error); // FIXME: Argument should not be nullable.
63
64     readonly attribute NodeList labels;
65
66     attribute DOMString autocomplete;
67 };