Web Kit DOM: Element.idl Source File

00001 /*
00002  * Copyright (C) 2006 Apple Computer, Inc.
00003  * Copyright (C) 2006 Samuel Weinig <sam.weinig@gmail.com>
00004  *
00005  * This library is free software; you can redistribute it and/or
00006  * modify it under the terms of the GNU Library General Public
00007  * License as published by the Free Software Foundation; either
00008  * version 2 of the License, or (at your option) any later version.
00009  *
00010  * This library is distributed in the hope that it will be useful,
00011  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00012  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00013  * Library General Public License for more details.
00014  *
00015  * You should have received a copy of the GNU Library General Public License
00016  * along with this library; see the file COPYING.LIB.  If not, write to
00017  * the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
00018  * Boston, MA 02111-1307, USA.
00019  */
00020 
00021 module core {
00022 
00023     interface  Element : EventTargetNode {
00024 
00025         // DOM Level 1 Core
00026 
00027         readonly attribute [ConvertNullStringTo=Null] DOMString tagName;
00028 
00029         [ConvertNullStringTo=Null] DOMString getAttribute(in DOMString name);
00030         [OldStyleObjC] void setAttribute(in DOMString name,
00031                                          in DOMString value)
00032             raises(DOMException);
00033         void removeAttribute(in DOMString name)
00034             raises(DOMException);
00035         Attr getAttributeNode(in DOMString name);
00036         Attr setAttributeNode(in Attr newAttr)
00037             raises(DOMException);
00038         Attr removeAttributeNode(in Attr oldAttr)
00039             raises(DOMException);
00040         NodeList getElementsByTagName(in DOMString name);
00041 
00042         // DOM Level 2 Core
00043 
00044         [OldStyleObjC] DOMString getAttributeNS(in [ConvertNullToNullString] DOMString namespaceURI,
00045                                                 in DOMString localName);
00046         [OldStyleObjC] void setAttributeNS(in [ConvertNullToNullString] DOMString namespaceURI,
00047                                            in DOMString qualifiedName, 
00048                                            in DOMString value)
00049             raises(DOMException);
00050         [OldStyleObjC] void removeAttributeNS(in [ConvertNullToNullString] DOMString namespaceURI,
00051                                               in DOMString localName)
00052             raises(DOMException);
00053         [OldStyleObjC] NodeList getElementsByTagNameNS(in [ConvertNullToNullString] DOMString namespaceURI,
00054                                                        in DOMString localName);
00055         [OldStyleObjC] Attr getAttributeNodeNS(in [ConvertNullToNullString] DOMString namespaceURI,
00056                                                in DOMString localName);
00057         Attr setAttributeNodeNS(in Attr newAttr)
00058             raises(DOMException);
00059         boolean hasAttribute(in DOMString name);
00060         [OldStyleObjC] boolean hasAttributeNS(in [ConvertNullToNullString] DOMString namespaceURI,
00061                                               in DOMString localName);
00062 
00063         readonly attribute CSSStyleDeclaration style;
00064 
00065         // Common extensions
00066 
00067         readonly attribute long offsetLeft;
00068         readonly attribute long offsetTop;
00069         readonly attribute long offsetWidth;
00070         readonly attribute long offsetHeight;
00071         readonly attribute Element offsetParent;
00072         readonly attribute long clientLeft;
00073         readonly attribute long clientTop;
00074         readonly attribute long clientWidth;
00075         readonly attribute long clientHeight;
00076                  attribute long scrollLeft;
00077                  attribute long scrollTop;
00078         readonly attribute long scrollWidth;
00079         readonly attribute long scrollHeight;
00080 
00081         void focus();
00082         void blur();
00083         void scrollIntoView(in [Optional] boolean alignWithTop);
00084 
00085         // IE extensions
00086 
00087         Node insertAdjacentElement(in DOMString position, 
00088                                    in Node element)
00089             raises(DOMException);
00090         boolean contains(in Element element);
00091 
00092         // WebKit extensions
00093 
00094         void scrollIntoViewIfNeeded(in [Optional] boolean centerIfNeeded);
00095         void scrollByLines(in long lines);
00096         void scrollByPages(in long pages);
00097 
00098 #if defined(LANGUAGE_OBJECTIVE_C)
00099         // Objective-C extensions
00100         readonly attribute DOMString innerText;
00101 #endif /* defined(LANGUAGE_OBJECTIVE_C) */
00102 
00103     };
00104 
00105 }