1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/dom/interfaces/html/nsIDOMHTMLSelectElement.idl Wed Dec 31 06:09:35 2014 +0100
1.3 @@ -0,0 +1,60 @@
1.4 +/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
1.5 +/* This Source Code Form is subject to the terms of the Mozilla Public
1.6 + * License, v. 2.0. If a copy of the MPL was not distributed with this
1.7 + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
1.8 +
1.9 +#include "nsIDOMHTMLElement.idl"
1.10 +#include "nsIDOMHTMLOptionsCollection.idl"
1.11 +
1.12 +/**
1.13 + * The nsIDOMHTMLSelectElement interface is the interface to a [X]HTML
1.14 + * select element.
1.15 + *
1.16 + * This interface is trying to follow the DOM Level 2 HTML specification:
1.17 + * http://www.w3.org/TR/DOM-Level-2-HTML/
1.18 + *
1.19 + * with changes from the work-in-progress WHATWG HTML specification:
1.20 + * http://www.whatwg.org/specs/web-apps/current-work/
1.21 + */
1.22 +
1.23 +interface nsIDOMValidityState;
1.24 +
1.25 +[scriptable, uuid(d8914a2d-3556-4b66-911c-a84c4394e7fa)]
1.26 +interface nsIDOMHTMLSelectElement : nsISupports
1.27 +{
1.28 + attribute boolean autofocus;
1.29 + attribute boolean disabled;
1.30 + readonly attribute nsIDOMHTMLFormElement form;
1.31 + attribute boolean multiple;
1.32 + attribute DOMString name;
1.33 + attribute unsigned long size;
1.34 +
1.35 + readonly attribute DOMString type;
1.36 +
1.37 + readonly attribute nsIDOMHTMLOptionsCollection options;
1.38 + attribute unsigned long length;
1.39 + nsIDOMNode item(in unsigned long index);
1.40 + nsIDOMNode namedItem(in DOMString name);
1.41 + // This add method implementation means the following
1.42 + // since IDL doesn't support overfload.
1.43 + // void add(in nsIDOMHTMLElement, [optional] in nsIDOMHTMLElement)
1.44 + // void add(in nsIDOMHTMLElement, in long)
1.45 + void add(in nsIDOMHTMLElement element,
1.46 + [optional] in nsIVariant before)
1.47 + raises(DOMException);
1.48 + void remove(in long index);
1.49 +
1.50 + readonly attribute nsIDOMHTMLCollection selectedOptions;
1.51 + attribute long selectedIndex;
1.52 + attribute DOMString value;
1.53 +
1.54 + // The following lines are part of the constraint validation API, see:
1.55 + // http://www.whatwg.org/specs/web-apps/current-work/#the-constraint-validation-api
1.56 + readonly attribute boolean willValidate;
1.57 + readonly attribute nsIDOMValidityState validity;
1.58 + readonly attribute DOMString validationMessage;
1.59 + boolean checkValidity();
1.60 + void setCustomValidity(in DOMString error);
1.61 +
1.62 + attribute boolean required;
1.63 +};
