com.gargoylesoftware.htmlunit.javascript.host.html.RowContainer Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of xlt Show documentation
Show all versions of xlt Show documentation
XLT (Xceptance LoadTest) is an extensive load and performance test tool developed and maintained by Xceptance.
/*
* Copyright (c) 2002-2021 Gargoyle Software Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.gargoylesoftware.htmlunit.javascript.host.html;
import static com.gargoylesoftware.htmlunit.javascript.configuration.SupportedBrowser.IE;
import com.gargoylesoftware.htmlunit.html.DomElement;
import com.gargoylesoftware.htmlunit.html.DomNode;
import com.gargoylesoftware.htmlunit.html.HtmlPage;
import com.gargoylesoftware.htmlunit.html.HtmlTableRow;
import com.gargoylesoftware.htmlunit.javascript.SimpleScriptable;
import com.gargoylesoftware.htmlunit.javascript.configuration.JsxClass;
import com.gargoylesoftware.htmlunit.javascript.configuration.JsxFunction;
import com.gargoylesoftware.htmlunit.javascript.configuration.JsxGetter;
import com.gargoylesoftware.htmlunit.javascript.configuration.JsxSetter;
import net.sourceforge.htmlunit.corejs.javascript.Context;
import net.sourceforge.htmlunit.corejs.javascript.Undefined;
/**
* Superclass for all row-containing JavaScript host classes, including tables,
* table headers, table bodies and table footers.
*
* @author Daniel Gredler
* @author Chris Erskine
* @author Marc Guillemot
* @author Ahmed Ashour
*/
@JsxClass(isJSObject = false)
public class RowContainer extends HTMLElement {
/**
* Creates an instance.
*/
public RowContainer() {
// Empty.
}
/**
* Returns the rows in the element.
* @return the rows in the element
*/
@JsxGetter
public Object getRows() {
return new HTMLCollection(getDomNodeOrDie(), false) {
@Override
protected boolean isMatching(final DomNode node) {
return node instanceof HtmlTableRow && isContainedRow((HtmlTableRow) node);
}
};
}
/**
* Indicates if the row belongs to this container.
* @param row the row to test
* @return {@code true} if it belongs to this container
*/
protected boolean isContainedRow(final HtmlTableRow row) {
return row.getParentNode() == getDomNodeOrDie();
}
/**
* Deletes the row at the specified index.
* @see MSDN Documentation
* @param rowIndex the zero-based index of the row to delete
*/
@JsxFunction
public void deleteRow(int rowIndex) {
final HTMLCollection rows = (HTMLCollection) getRows();
final int rowCount = rows.getLength();
if (rowIndex == -1) {
rowIndex = rowCount - 1;
}
final boolean rowIndexValid = rowIndex >= 0 && rowIndex < rowCount;
if (rowIndexValid) {
final SimpleScriptable row = (SimpleScriptable) rows.item(Integer.valueOf(rowIndex));
row.getDomNodeOrDie().remove();
}
}
/**
* Inserts a new row at the specified index in the element's row collection. If the index
* is -1 or there is no index specified, then the row is appended at the end of the
* element's row collection.
* @see MSDN Documentation
* @param index specifies where to insert the row in the rows collection.
* The default value is -1, which appends the new row to the end of the rows collection
* @return the newly-created row
*/
@JsxFunction
public Object insertRow(final Object index) {
int rowIndex = -1;
if (!Undefined.isUndefined(index)) {
rowIndex = (int) Context.toNumber(index);
}
final HTMLCollection rows = (HTMLCollection) getRows();
final int rowCount = rows.getLength();
final int r;
if (rowIndex == -1 || rowIndex == rowCount) {
r = Math.max(0, rowCount);
}
else {
r = rowIndex;
}
if (r < 0 || r > rowCount) {
throw Context.reportRuntimeError("Index or size is negative or greater than the allowed amount "
+ "(index: " + rowIndex + ", " + rowCount + " rows)");
}
return insertRow(r);
}
/**
* Inserts a new row at the given position.
* @param index the index where the row should be inserted (0 <= index <= nbRows)
* @return the inserted row
*/
public Object insertRow(final int index) {
final HTMLCollection rows = (HTMLCollection) getRows();
final int rowCount = rows.getLength();
final DomElement newRow = ((HtmlPage) getDomNodeOrDie().getPage()).createElement("tr");
if (rowCount == 0) {
getDomNodeOrDie().appendChild(newRow);
}
else if (index == rowCount) {
final SimpleScriptable row = (SimpleScriptable) rows.item(Integer.valueOf(index - 1));
row.getDomNodeOrDie().getParentNode().appendChild(newRow);
}
else {
final SimpleScriptable row = (SimpleScriptable) rows.item(Integer.valueOf(index));
// if at the end, then in the same "sub-container" as the last existing row
if (index > rowCount - 1) {
row.getDomNodeOrDie().getParentNode().appendChild(newRow);
}
else {
row.getDomNodeOrDie().insertBefore(newRow);
}
}
return getScriptableFor(newRow);
}
/**
* Moves the row at the specified source index to the specified target index, returning
* the row that was moved.
* @param sourceIndex the index of the row to move
* @param targetIndex the index to move the row to
* @return the row that was moved
*/
@JsxFunction(IE)
public Object moveRow(final int sourceIndex, final int targetIndex) {
final HTMLCollection rows = (HTMLCollection) getRows();
final int rowCount = rows.getLength();
final boolean sourceIndexValid = sourceIndex >= 0 && sourceIndex < rowCount;
final boolean targetIndexValid = targetIndex >= 0 && targetIndex < rowCount;
if (sourceIndexValid && targetIndexValid) {
final SimpleScriptable sourceRow = (SimpleScriptable) rows.item(Integer.valueOf(sourceIndex));
final SimpleScriptable targetRow = (SimpleScriptable) rows.item(Integer.valueOf(targetIndex));
targetRow.getDomNodeOrDie().insertBefore(sourceRow.getDomNodeOrDie());
return sourceRow;
}
return null;
}
/**
* Returns the value of the {@code align} property.
* @return the value of the {@code align} property
*/
@JsxGetter
public String getAlign() {
return getAlign(true);
}
/**
* Sets the value of the {@code align} property.
* @param align the value of the {@code align} property
*/
@JsxSetter
public void setAlign(final String align) {
setAlign(align, false);
}
}