Table of Contents

Class HTMLTableRowElement

Namespace
CSharpToJavaScript.APIs.JS
Assembly
CSharpToJavaScript.dll

The HTMLTableRowElement interface provides special properties and methods (beyond the HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of rows in an HTML table.

[Value("HTMLTableRowElement")]
public class HTMLTableRowElement : HTMLElement
Inheritance
HTMLTableRowElement
Inherited Members

Remarks

-The HTML element implementing this interface: tr.

See also on MDN

Constructors

HTMLTableRowElement()

public HTMLTableRowElement()

Properties

Align

IMPORTANT
Deprecated
The align property of the HTMLTableRowElement interface is a string indicating how to horizontally align text in the {{htmlelement("tr")}} table row. Individual cells can override it.
[Value("align")]
public string Align { get; set; }

Property Value

string

The possible values are:

Remarks

NOTE

This property is deprecated, and CSS should be used to align text horizontally in a cell. Use the CSS text-align property, which takes precedence, to horizontally align text in a row instead.

-text-align
-Learn: Styling tables

See also on MDN

BgColor

IMPORTANT
Deprecated
The HTMLTableRowElement.bgColor property is used to set the background color of a row or retrieve the value of the obsolete bgColor attribute, if present.
[Value("bgColor")]
public string BgColor { get; set; }

Property Value

string

One of the following value types can be used:

NOTE
The values accepted here are a subset of the CSS color values. You can reuse HTML color values in CSS, but not in the other direction: the unknown colors would appear differently than expected.

Remarks

NOTE

This property is deprecated and CSS should be used to set the background color. Use the background-color property instead.

-BgColor

See also on MDN

Cells

The cells read-only property of the HTMLTableRowElement interface
returns a live HTMLCollection containing the cells in the row. The HTMLCollection is live and is automatically updated when cells are added or removed.

[Value("cells")]
public HTMLCollection Cells { get; }

Property Value

HTMLCollection

A live HTMLCollection of HTMLTableCellElement objects.

Remarks

Ch

IMPORTANT
Deprecated
The ch property of the HTMLTableRowElement interface does nothing. It reflects the char attribute of the tr element.
[Value("ch")]
public string Ch { get; set; }

Property Value

string

A single character.

Remarks

NOTE

This property was designed to participate to the ability to align table cell content on a specific character (typically the decimal point), but was never implemented by browsers.

To achieve such alignment, watch for the support of a string value with the text-align CSS property.

-text-align

See also on MDN

ChOff

IMPORTANT
Deprecated
The chOff property of the HTMLTableRowElement interface does nothing. It reflects the charoff attribute of the tr element.
[Value("chOff")]
public string ChOff { get; set; }

Property Value

string

An integer.

Remarks

NOTE

This property was designed to participate in an ability to align table cell content on a specific character (typically the decimal point), but was never implemented by browsers.

To achieve such alignment, watch for the support of a string value with the text-align CSS property.

-text-align

See also on MDN

RowIndex

The rowIndex read-only property of the HTMLTableRowElement interface
represents the position of a row within the whole table.

[Value("rowIndex")]
public long RowIndex { get; }

Property Value

long

The index of the row, or -1 if the row is not part of a table.

Remarks

Even when the thead, tbody, and
tfoot elements are out of order in the HTML, browsers render the
table in the right order. Therefore the rows count from <thead> to
<tbody>, from <tbody> to
<tfoot>.

-SectionRowIndex

See also on MDN

SectionRowIndex

The sectionRowIndex read-only property of the HTMLTableRowElement interface
represents the position of a row within the current section (thead, tbody, or tfoot).

[Value("sectionRowIndex")]
public long SectionRowIndex { get; }

Property Value

long

The index of the row, or -1 if the row is not part of the section.

Remarks

VAlign

IMPORTANT
Deprecated
The vAlign property of the HTMLTableRowElement interface is a string indicating how to vertically align text in a {{htmlelement("tr")}} table row. Individual cells can override it.
[Value("vAlign")]
public string VAlign { get; set; }

Property Value

string

The possible values are: "top", "middle", "bottom", or "baseline"

Remarks

NOTE

This property is deprecated. Use the CSS vertical-align property to horizontally align text in a row instead.

-vertical-align
-Learn: Styling tables

See also on MDN

Methods

DeleteCell(long)

The deleteCell() method of the HTMLTableRowElement interface removes a
specific row cell from a given tr.

[Value("deleteCell")]
public GlobalObject.Undefined DeleteCell(long index)

Parameters

index long

Returns

GlobalObject.Undefined

None (GlobalObject.Undefined).

Remarks

-InsertRow(long)
-The HTML element representing cells: HTMLTableCellElement

See also on MDN

InsertCell(long)

The insertCell() method of the HTMLTableRowElement interface inserts a new
cell (td) into a table row (tr) and returns a
reference to the cell.

[Value("insertCell")]
public HTMLTableCellElement InsertCell(long index = 0)

Parameters

index long

Returns

HTMLTableCellElement

An HTMLTableCellElement that references the new
cell.

Remarks

NOTE

insertCell() inserts the cell directly into the
row. The cell does not need to be appended separately
with AppendChild(Node) as would be the case if
CreateElement(string, Union34) had been used to create the new
<td> element.

You can not use insertCell() to create a new <th>
element though.

-InsertRow(long)
-The HTML element representing cells: HTMLTableCellElement

See also on MDN