--- old/src/java.xml/share/classes/org/w3c/dom/html/HTMLTableElement.java 2015-04-15 20:36:10.668667995 -0700 +++ /dev/null 2015-01-24 10:04:07.581594997 -0800 @@ -1,217 +0,0 @@ -/* - * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. - * - * This code is free software; you can redistribute it and/or modify it - * under the terms of the GNU General Public License version 2 only, as - * published by the Free Software Foundation. Oracle designates this - * particular file as subject to the "Classpath" exception as provided - * by Oracle in the LICENSE file that accompanied this code. - * - * This code is distributed in the hope that it will be useful, but WITHOUT - * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or - * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License - * version 2 for more details (a copy is included in the LICENSE file that - * accompanied this code). - * - * You should have received a copy of the GNU General Public License version - * 2 along with this work; if not, write to the Free Software Foundation, - * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. - * - * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA - * or visit www.oracle.com if you need additional information or have any - * questions. - */ - -/* - * This file is available under and governed by the GNU General Public - * License version 2 only, as published by the Free Software Foundation. - * However, the following notice accompanied the original version of this - * file and, per its terms, should not be removed: - * - * Copyright (c) 2000 World Wide Web Consortium, - * (Massachusetts Institute of Technology, Institut National de - * Recherche en Informatique et en Automatique, Keio University). All - * Rights Reserved. This program is distributed under the W3C's Software - * Intellectual Property License. This program is distributed in the - * hope that it will be useful, but WITHOUT ANY WARRANTY; without even - * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR - * PURPOSE. See W3C License http://www.w3.org/Consortium/Legal/ for more - * details. - */ - -package org.w3c.dom.html; - -import org.w3c.dom.DOMException; - -/** - * The create* and delete* methods on the table allow authors to construct - * and modify tables. HTML 4.0 specifies that only one of each of the - * CAPTION , THEAD , and TFOOT - * elements may exist in a table. Therefore, if one exists, and the - * createTHead() or createTFoot() method is called, the method returns the - * existing THead or TFoot element. See the TABLE element definition in HTML - * 4.0. - *

See also the Document Object Model (DOM) Level 2 Specification. - */ -public interface HTMLTableElement extends HTMLElement { - /** - * Returns the table's CAPTION , or void if none exists. - */ - public HTMLTableCaptionElement getCaption(); - public void setCaption(HTMLTableCaptionElement caption); - - /** - * Returns the table's THEAD , or null if none - * exists. - */ - public HTMLTableSectionElement getTHead(); - public void setTHead(HTMLTableSectionElement tHead); - - /** - * Returns the table's TFOOT , or null if none - * exists. - */ - public HTMLTableSectionElement getTFoot(); - public void setTFoot(HTMLTableSectionElement tFoot); - - /** - * Returns a collection of all the rows in the table, including all in - * THEAD , TFOOT , all TBODY - * elements. - */ - public HTMLCollection getRows(); - - /** - * Returns a collection of the defined table bodies. - */ - public HTMLCollection getTBodies(); - - /** - * Specifies the table's position with respect to the rest of the - * document. See the align attribute definition in HTML 4.0. This - * attribute is deprecated in HTML 4.0. - */ - public String getAlign(); - public void setAlign(String align); - - /** - * Cell background color. See the bgcolor attribute definition in HTML - * 4.0. This attribute is deprecated in HTML 4.0. - */ - public String getBgColor(); - public void setBgColor(String bgColor); - - /** - * The width of the border around the table. See the border attribute - * definition in HTML 4.0. - */ - public String getBorder(); - public void setBorder(String border); - - /** - * Specifies the horizontal and vertical space between cell content and - * cell borders. See the cellpadding attribute definition in HTML 4.0. - */ - public String getCellPadding(); - public void setCellPadding(String cellPadding); - - /** - * Specifies the horizontal and vertical separation between cells. See - * the cellspacing attribute definition in HTML 4.0. - */ - public String getCellSpacing(); - public void setCellSpacing(String cellSpacing); - - /** - * Specifies which external table borders to render. See the frame - * attribute definition in HTML 4.0. - */ - public String getFrame(); - public void setFrame(String frame); - - /** - * Specifies which internal table borders to render. See the rules - * attribute definition in HTML 4.0. - */ - public String getRules(); - public void setRules(String rules); - - /** - * Description about the purpose or structure of a table. See the - * summary attribute definition in HTML 4.0. - */ - public String getSummary(); - public void setSummary(String summary); - - /** - * Specifies the desired table width. See the width attribute definition - * in HTML 4.0. - */ - public String getWidth(); - public void setWidth(String width); - - /** - * Create a table header row or return an existing one. - * @return A new table header element (THEAD ). - */ - public HTMLElement createTHead(); - - /** - * Delete the header from the table, if one exists. - */ - public void deleteTHead(); - - /** - * Create a table footer row or return an existing one. - * @return A footer element (TFOOT ). - */ - public HTMLElement createTFoot(); - - /** - * Delete the footer from the table, if one exists. - */ - public void deleteTFoot(); - - /** - * Create a new table caption object or return an existing one. - * @return A CAPTION element. - */ - public HTMLElement createCaption(); - - /** - * Delete the table caption, if one exists. - */ - public void deleteCaption(); - - /** - * Insert a new empty row in the table. The new row is inserted - * immediately before and in the same section as the current - * index th row in the table. If index is equal - * to the number of rows, the new row is appended. In addition, when the - * table is empty the row is inserted into a TBODY which is - * created and inserted into the table. Note. A table row cannot be empty - * according to HTML 4.0 Recommendation. - * @param index The row number where to insert a new row. This index - * starts from 0 and is relative to all the rows contained inside the - * table, regardless of section parentage. - * @return The newly created row. - * @exception DOMException - * INDEX_SIZE_ERR: Raised if the specified index is greater than the - * number of rows or if the index is negative. - */ - public HTMLElement insertRow(int index) - throws DOMException; - - /** - * Delete a table row. - * @param index The index of the row to be deleted. This index starts - * from 0 and is relative to all the rows contained inside the table, - * regardless of section parentage. - * @exception DOMException - * INDEX_SIZE_ERR: Raised if the specified index is greater than or - * equal to the number of rows or if the index is negative. - */ - public void deleteRow(int index) - throws DOMException; - -} --- /dev/null 2015-01-24 10:04:07.581594997 -0800 +++ new/src/jdk.xml.dom/share/classes/org/w3c/dom/html/HTMLTableElement.java 2015-04-15 20:36:10.448657077 -0700 @@ -0,0 +1,217 @@ +/* + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * This code is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License version 2 only, as + * published by the Free Software Foundation. Oracle designates this + * particular file as subject to the "Classpath" exception as provided + * by Oracle in the LICENSE file that accompanied this code. + * + * This code is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License + * version 2 for more details (a copy is included in the LICENSE file that + * accompanied this code). + * + * You should have received a copy of the GNU General Public License version + * 2 along with this work; if not, write to the Free Software Foundation, + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. + * + * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA + * or visit www.oracle.com if you need additional information or have any + * questions. + */ + +/* + * This file is available under and governed by the GNU General Public + * License version 2 only, as published by the Free Software Foundation. + * However, the following notice accompanied the original version of this + * file and, per its terms, should not be removed: + * + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. See W3C License http://www.w3.org/Consortium/Legal/ for more + * details. + */ + +package org.w3c.dom.html; + +import org.w3c.dom.DOMException; + +/** + * The create* and delete* methods on the table allow authors to construct + * and modify tables. HTML 4.0 specifies that only one of each of the + * CAPTION , THEAD , and TFOOT + * elements may exist in a table. Therefore, if one exists, and the + * createTHead() or createTFoot() method is called, the method returns the + * existing THead or TFoot element. See the TABLE element definition in HTML + * 4.0. + *

See also the Document Object Model (DOM) Level 2 Specification. + */ +public interface HTMLTableElement extends HTMLElement { + /** + * Returns the table's CAPTION , or void if none exists. + */ + public HTMLTableCaptionElement getCaption(); + public void setCaption(HTMLTableCaptionElement caption); + + /** + * Returns the table's THEAD , or null if none + * exists. + */ + public HTMLTableSectionElement getTHead(); + public void setTHead(HTMLTableSectionElement tHead); + + /** + * Returns the table's TFOOT , or null if none + * exists. + */ + public HTMLTableSectionElement getTFoot(); + public void setTFoot(HTMLTableSectionElement tFoot); + + /** + * Returns a collection of all the rows in the table, including all in + * THEAD , TFOOT , all TBODY + * elements. + */ + public HTMLCollection getRows(); + + /** + * Returns a collection of the defined table bodies. + */ + public HTMLCollection getTBodies(); + + /** + * Specifies the table's position with respect to the rest of the + * document. See the align attribute definition in HTML 4.0. This + * attribute is deprecated in HTML 4.0. + */ + public String getAlign(); + public void setAlign(String align); + + /** + * Cell background color. See the bgcolor attribute definition in HTML + * 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getBgColor(); + public void setBgColor(String bgColor); + + /** + * The width of the border around the table. See the border attribute + * definition in HTML 4.0. + */ + public String getBorder(); + public void setBorder(String border); + + /** + * Specifies the horizontal and vertical space between cell content and + * cell borders. See the cellpadding attribute definition in HTML 4.0. + */ + public String getCellPadding(); + public void setCellPadding(String cellPadding); + + /** + * Specifies the horizontal and vertical separation between cells. See + * the cellspacing attribute definition in HTML 4.0. + */ + public String getCellSpacing(); + public void setCellSpacing(String cellSpacing); + + /** + * Specifies which external table borders to render. See the frame + * attribute definition in HTML 4.0. + */ + public String getFrame(); + public void setFrame(String frame); + + /** + * Specifies which internal table borders to render. See the rules + * attribute definition in HTML 4.0. + */ + public String getRules(); + public void setRules(String rules); + + /** + * Description about the purpose or structure of a table. See the + * summary attribute definition in HTML 4.0. + */ + public String getSummary(); + public void setSummary(String summary); + + /** + * Specifies the desired table width. See the width attribute definition + * in HTML 4.0. + */ + public String getWidth(); + public void setWidth(String width); + + /** + * Create a table header row or return an existing one. + * @return A new table header element (THEAD ). + */ + public HTMLElement createTHead(); + + /** + * Delete the header from the table, if one exists. + */ + public void deleteTHead(); + + /** + * Create a table footer row or return an existing one. + * @return A footer element (TFOOT ). + */ + public HTMLElement createTFoot(); + + /** + * Delete the footer from the table, if one exists. + */ + public void deleteTFoot(); + + /** + * Create a new table caption object or return an existing one. + * @return A CAPTION element. + */ + public HTMLElement createCaption(); + + /** + * Delete the table caption, if one exists. + */ + public void deleteCaption(); + + /** + * Insert a new empty row in the table. The new row is inserted + * immediately before and in the same section as the current + * index th row in the table. If index is equal + * to the number of rows, the new row is appended. In addition, when the + * table is empty the row is inserted into a TBODY which is + * created and inserted into the table. Note. A table row cannot be empty + * according to HTML 4.0 Recommendation. + * @param index The row number where to insert a new row. This index + * starts from 0 and is relative to all the rows contained inside the + * table, regardless of section parentage. + * @return The newly created row. + * @exception DOMException + * INDEX_SIZE_ERR: Raised if the specified index is greater than the + * number of rows or if the index is negative. + */ + public HTMLElement insertRow(int index) + throws DOMException; + + /** + * Delete a table row. + * @param index The index of the row to be deleted. This index starts + * from 0 and is relative to all the rows contained inside the table, + * regardless of section parentage. + * @exception DOMException + * INDEX_SIZE_ERR: Raised if the specified index is greater than or + * equal to the number of rows or if the index is negative. + */ + public void deleteRow(int index) + throws DOMException; + +}