com.gargoylesoftware.htmlunit.javascript.host.html.HTMLTableSectionElement Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of htmlunit Show documentation
Show all versions of htmlunit Show documentation
A headless browser intended for use in testing web-based applications.
/*
* Copyright (c) 2002-2020 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
* http://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.BrowserVersionFeatures.JS_TABLE_VALIGN_SUPPORTS_IE_VALUES;
import static com.gargoylesoftware.htmlunit.javascript.configuration.SupportedBrowser.CHROME;
import static com.gargoylesoftware.htmlunit.javascript.configuration.SupportedBrowser.FF;
import static com.gargoylesoftware.htmlunit.javascript.configuration.SupportedBrowser.FF60;
import static com.gargoylesoftware.htmlunit.javascript.configuration.SupportedBrowser.FF68;
import static com.gargoylesoftware.htmlunit.javascript.configuration.SupportedBrowser.IE;
import com.gargoylesoftware.htmlunit.html.HtmlTableBody;
import com.gargoylesoftware.htmlunit.html.HtmlTableFooter;
import com.gargoylesoftware.htmlunit.html.HtmlTableHeader;
import com.gargoylesoftware.htmlunit.javascript.configuration.JsxClass;
import com.gargoylesoftware.htmlunit.javascript.configuration.JsxConstructor;
import com.gargoylesoftware.htmlunit.javascript.configuration.JsxGetter;
import com.gargoylesoftware.htmlunit.javascript.configuration.JsxSetter;
import net.sourceforge.htmlunit.corejs.javascript.Context;
/**
* A JavaScript object representing "HTMLTableSectionElement", it is used by
* {@link HtmlTableBody}, {@link HtmlTableHeader}, and {@link HtmlTableFooter}.
*
* @author Daniel Gredler
* @author Ahmed Ashour
* @author Ronald Brill
*/
@JsxClass(domClass = HtmlTableBody.class)
@JsxClass(domClass = HtmlTableHeader.class)
@JsxClass(domClass = HtmlTableFooter.class)
public class HTMLTableSectionElement extends RowContainer {
/** The valid "vAlign" values for this element, when emulating IE. */
private static final String[] VALIGN_VALID_VALUES_IE = {"top", "bottom", "middle", "baseline"};
/** The default value of the "vAlign" property. */
private static final String VALIGN_DEFAULT_VALUE = "top";
/**
* Creates an instance.
*/
@JsxConstructor({CHROME, FF, FF68, FF60})
public HTMLTableSectionElement() {
}
/**
* Returns the value of the {@code vAlign} property.
* @return the value of the {@code vAlign} property
*/
@JsxGetter
public String getVAlign() {
return getVAlign(getValidVAlignValues(), VALIGN_DEFAULT_VALUE);
}
/**
* Sets the value of the {@code vAlign} property.
* @param vAlign the value of the {@code vAlign} property
*/
@JsxSetter
public void setVAlign(final Object vAlign) {
setVAlign(vAlign, getValidVAlignValues());
}
/**
* Returns the valid "vAlign" values for this element, depending on the browser being emulated.
* @return the valid "vAlign" values for this element, depending on the browser being emulated
*/
private String[] getValidVAlignValues() {
if (getBrowserVersion().hasFeature(JS_TABLE_VALIGN_SUPPORTS_IE_VALUES)) {
return VALIGN_VALID_VALUES_IE;
}
return null;
}
/**
* Returns the value of the {@code ch} property.
* @return the value of the {@code ch} property
*/
@Override
@JsxGetter
public String getCh() {
return super.getCh();
}
/**
* Sets the value of the {@code ch} property.
* @param ch the value of the {@code ch} property
*/
@Override
@JsxSetter
public void setCh(final String ch) {
super.setCh(ch);
}
/**
* Returns the value of the {@code chOff} property.
* @return the value of the {@code chOff} property
*/
@Override
@JsxGetter
public String getChOff() {
return super.getChOff();
}
/**
* Sets the value of the {@code chOff} property.
* @param chOff the value of the {@code chOff} property
*/
@Override
@JsxSetter
public void setChOff(final String chOff) {
super.setChOff(chOff);
}
/**
* Returns the value of the {@code bgColor} attribute.
* @return the value of the {@code bgColor} attribute
* @see MSDN Documentation
*/
@JsxGetter(IE)
public String getBgColor() {
return getDomNodeOrDie().getAttribute("bgColor");
}
/**
* Sets the value of the {@code bgColor} attribute.
* @param bgColor the value of the {@code bgColor} attribute
* @see MSDN Documentation
*/
@JsxSetter(IE)
public void setBgColor(final String bgColor) {
setColorAttribute("bgColor", bgColor);
}
/**
* Overwritten to throw an exception.
* @param value the new value for replacing this node
*/
@JsxSetter
@Override
public void setOuterHTML(final Object value) {
throw Context.reportRuntimeError("outerHTML is read-only for tag '"
+ getDomNodeOrDie().getNodeName() + "'");
}
/**
* Overwritten to throw an exception because this is readonly.
* @param value the new value for the contents of this node
*/
@Override
@JsxSetter({IE, CHROME})
public void setInnerText(final Object value) {
super.setInnerText(value);
}
}