Implement support for the autocomplete attribute
[WebKit-https.git] / Source / WebCore / html / HTMLInputElement.idl
1 /*
2  * Copyright (C) 2006, 2010 Apple Inc. All rights reserved.
3  * Copyright (C) 2006 Samuel Weinig <sam.weinig@gmail.com>
4  * Copyright (C) 2012 Samsung Electronics. All rights reserved.
5  *
6  * This library is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Library General Public
8  * License as published by the Free Software Foundation; either
9  * version 2 of the License, or (at your option) any later version.
10  *
11  * This library is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  * Library General Public License for more details.
15  *
16  * You should have received a copy of the GNU Library General Public License
17  * along with this library; see the file COPYING.LIB.  If not, write to
18  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
19  * Boston, MA 02110-1301, USA.
20  */
21
22 interface HTMLInputElement : HTMLElement {
23     [Reflect] attribute DOMString accept;
24     [Reflect] attribute DOMString alt;
25     attribute DOMString autocomplete;
26     [Reflect] attribute boolean autofocus;
27     [Reflect=checked] attribute boolean defaultChecked;
28     attribute boolean checked;
29     [Reflect] attribute DOMString dirName;
30     [Reflect] attribute boolean disabled;
31     readonly attribute HTMLFormElement form;
32     attribute FileList files;
33     [Reflect, URL] attribute DOMString formAction;
34     [TreatNullAs=NullString] attribute DOMString formEnctype;
35     [TreatNullAs=NullString] attribute DOMString formMethod;
36     [Reflect] attribute boolean formNoValidate;
37     [Reflect] attribute DOMString formTarget;
38     attribute unsigned long height;
39     attribute boolean indeterminate;
40     [Conditional=DATALIST_ELEMENT] readonly attribute HTMLElement list;
41     [Reflect] attribute DOMString max;
42     [SetterRaisesException] attribute long maxLength;
43     [Reflect] attribute DOMString min;
44     [Reflect] attribute boolean multiple;
45     [Reflect] attribute DOMString name;
46     [Reflect] attribute DOMString pattern;
47     [Reflect] attribute DOMString placeholder;
48     [Reflect] attribute boolean readOnly;
49     [Reflect] attribute boolean required;
50 #if defined(LANGUAGE_OBJECTIVE_C) && LANGUAGE_OBJECTIVE_C
51     [ObjCImplementedAsUnsignedLong] attribute DOMString size; // DOM level 2 changed this to a long, but ObjC API is a string
52 #else
53     [SetterRaisesException] attribute unsigned long size; // Changed string -> long -> unsigned long
54 #endif
55     [Reflect, URL] attribute DOMString src;
56     [Reflect] attribute DOMString step;
57     attribute DOMString type; // readonly dropped as part of DOM level 2
58     [TreatNullAs=NullString] attribute DOMString defaultValue;
59     // See the discussion in https://bugs.webkit.org/show_bug.cgi?id=100085
60 #if defined(LANGUAGE_JAVASCRIPT) && LANGUAGE_JAVASCRIPT
61     [TreatNullAs=NullString, SetterRaisesException] attribute DOMString value;
62 #else
63     [TreatNullAs=NullString] attribute DOMString value;
64 #endif
65     [SetterRaisesException] attribute Date valueAsDate;
66     [SetterRaisesException] attribute unrestricted double valueAsNumber;
67
68     [RaisesException] void stepUp(optional long n = 1);
69     [RaisesException] void stepDown(optional long n = 1);
70
71     attribute unsigned long width;
72     readonly attribute boolean willValidate;
73     readonly attribute ValidityState validity;
74     readonly attribute DOMString validationMessage;
75     boolean checkValidity();
76     void setCustomValidity([TreatNullAs=NullString, TreatUndefinedAs=NullString] DOMString error);
77
78     readonly attribute NodeList labels;
79
80     void select();
81     [Custom] attribute long selectionStart;
82     [Custom] attribute long selectionEnd;
83     [Custom] attribute DOMString selectionDirection;
84
85     [RaisesException] void setRangeText(DOMString replacement);
86     [RaisesException] void setRangeText(DOMString replacement,
87                         unsigned long start,
88                         unsigned long end,
89                         [Default=NullString] optional DOMString selectionMode);
90
91 #if defined(LANGUAGE_OBJECTIVE_C) && LANGUAGE_OBJECTIVE_C
92     [Custom] void setSelectionRange(long start, long end);
93 #else
94     [Custom] void setSelectionRange([Default=Undefined] optional long start, 
95                                     [Default=Undefined] optional long end, 
96                                     optional DOMString direction);
97 #endif
98
99     // Non-standard attributes
100     [Reflect] attribute DOMString align;
101     [Reflect] attribute DOMString useMap;
102     [Reflect] attribute boolean incremental;
103
104 #if defined(LANGUAGE_OBJECTIVE_C) && LANGUAGE_OBJECTIVE_C
105     [Reflect] attribute DOMString accessKey;
106 #endif
107
108 #if defined(LANGUAGE_OBJECTIVE_C) && LANGUAGE_OBJECTIVE_C
109     void click();
110 #endif
111
112 #if !defined(LANGUAGE_JAVASCRIPT) || !LANGUAGE_JAVASCRIPT
113     void setValueForUser([TreatNullAs=NullString] DOMString value);
114 #endif
115
116 #if defined(LANGUAGE_OBJECTIVE_C) && LANGUAGE_OBJECTIVE_C
117     // Objective-C extension:
118     readonly attribute DOMString altDisplayString;
119     readonly attribute URL absoluteImageURL;
120 #endif
121
122     [Conditional=IOS_AUTOCORRECT_AND_AUTOCAPITALIZE] attribute boolean autocorrect;
123     [Conditional=IOS_AUTOCORRECT_AND_AUTOCAPITALIZE, TreatNullAs=NullString] attribute DOMString autocapitalize;
124
125     // See http://www.w3.org/TR/html-media-capture/
126     [Conditional=MEDIA_CAPTURE, Reflect] attribute boolean capture;
127 };