third_party/WebKit/Source/core/html/HTMLOptionsCollection.idl

   1 /*
   2  * Copyright (C) 2006, 2007 Apple Inc. All rights reserved.
   3  * Copyright (C) 2006 Samuel Weinig <sam.weinig@gmail.com>
   4  * Copyright (C) 2013, 2014 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 // https://html.spec.whatwg.org/#the-htmloptionscollection-interface
  23
  24 [
  25     DependentLifetime,
  26     SetWrapperReferenceFrom=ownerNode,
  27 ] interface HTMLOptionsCollection : HTMLCollection {
  28     // inherits item()
  29     [RaisesException=Setter] attribute unsigned long length; // shadows inherited length
  30     // FIXME: The spec has a legacycaller HTMLOptionElement? (DOMString name);
  31     [RaisesException, TypeChecking=Interface] setter void (unsigned long index, HTMLOptionElement? option);
  32     [RaisesException, TypeChecking=Interface] void add((HTMLOptionElement or HTMLOptGroupElement) element, optional (HTMLElement or long)? before = null);
  33     void remove(long index);
  34     attribute long selectedIndex;
  35     // FIXME: Neither of these getters are in the spec, and the
  36     // getters inherited from HTMLCollection always return an Element.
  37     [ImplementedAs=item] getter Node (unsigned long index);
  38     [ImplementedAs=namedGetter] getter (NodeList or Element)? namedItem(DOMString name);
  39 };