您正位於 MDN Web Docs 的可編輯版本

以 MDN Web Docs 使用者身分檢視: https://developer.mozilla.org/zh-TW/docs/Web/API/HTMLTableRowElement

我們的志工尚未將本文翻譯為 正體中文 (繁體) 版本。加入我們,幫忙翻譯!
您也可以閱讀本文的 English (US) 版本。

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.

Properties

Inherits properties from its parent, HTMLElement.

HTMLTableRowElement.cells Read only
Returns a live HTMLCollection containing the cells in the row. The HTMLCollection is live and is automatically updated when cells are added or removed.
HTMLTableRowElement.rowIndex Read only
Returns a long value which gives the logical position of the row within the entire table. If the row is not part of a table, returns -1.
HTMLTableRowElement.sectionRowIndex Read only
Returns a long value which gives the logical position of the row within the table section it belongs to. If the row is not part of a section, returns -1.

Methods

Inherits methods from its parent, HTMLElement.

HTMLTableRowElement.deleteCell()
Removes the cell at the given position in the row. If the given position is greater (or equal as it starts at zero) than the amount of cells in the row, or is smaller than 0, it raises a DOMException with the IndexSizeError value.
HTMLTableRowElement.insertCell()
Inserts a new cell just before the given position in the row. If the given position is not given or is -1, it appends the cell to the row. If the given position is greater (or equal as it starts at zero) than the amount of cells in the row, or is smaller than -1, it raises a DOMException with the IndexSizeError value. Returns a reference to a HTMLTableCellElement.

Deprecated properties

Warning: These properties have been deprecated and should no longer be used. They are documented primarily to help understand older code bases.

HTMLTableRowElement.align
Is a DOMString containing an enumerated value reflecting the align attribute. It indicates the alignment of the element's contents with respect to the surrounding context. The possible values are "left", "right", and "center".
HTMLTableRowElement.bgColor
Is a DOMString containing the background color of the cells. It reflects the obsolete bgcolor attribute.
HTMLTableRowElement.ch
Is a DOMString containing one single character. This character is the one to align all the cell of a column on. It reflects the char and default to the decimal points associated with the language, e.g. '.' for English, or ',' for French. This property was optional and was not very well supported.
HTMLTableRowElement.chOff
Is a DOMString containing a integer indicating how many characters must be left at the right (for left-to-right scripts; or at the left for right-to-left scripts) of the character defined by HTMLTableRowElement.ch. This property was optional and was not very well supported.
HTMLTableRowElement.vAlign
Is a DOMString representing an enumerated value indicating how the content of the cell must be vertically aligned. It reflects the valign attribute and can have one of the following values: "top", "middle", "bottom", or "baseline".

Specifications

Specification Status Comment
HTML Living Standard
The definition of 'HTMLTableRowElement' in that specification.
Living Standard
HTML5
The definition of 'HTMLTableRowElement' in that specification.
Recommendation The parameter of insertCell is now optional and default to -1.
Document Object Model (DOM) Level 2 HTML Specification
The definition of 'HTMLTableRowElement' in that specification.
Obsolete The cells, rowIndex, and selectionRowIndex properties are now read-only.
The methods insertCell and deleteCell can raise exceptions.
Document Object Model (DOM) Level 1 Specification
The definition of 'HTMLTableRowElement' in that specification.
Obsolete Initial definition.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
HTMLTableRowElementChrome Full support 1Edge Full support 12Firefox Full support 1IE Full support YesOpera Full support ≤12.1Safari Full support YesWebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support ≤12.1Safari iOS Full support YesSamsung Internet Android Full support 1.0
align
DeprecatedNon-standard
Chrome Full support 1Edge Full support 12Firefox Full support 1IE Full support YesOpera Full support ≤12.1Safari Full support YesWebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support ≤12.1Safari iOS Full support YesSamsung Internet Android Full support 1.0
bgColor
DeprecatedNon-standard
Chrome Full support 1Edge Full support 12Firefox Full support 1IE Full support YesOpera Full support ≤12.1Safari Full support YesWebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support ≤12.1Safari iOS Full support YesSamsung Internet Android Full support 1.0
cellsChrome Full support 1Edge Full support 12Firefox Full support 1IE Full support YesOpera Full support ≤12.1Safari Full support YesWebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support ≤12.1Safari iOS Full support YesSamsung Internet Android Full support 1.0
ch
Deprecated
Chrome Full support 1Edge Full support 12Firefox Full support 1IE Full support YesOpera Full support ≤12.1Safari Full support YesWebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support ≤12.1Safari iOS Full support YesSamsung Internet Android Full support 1.0
chOff
Deprecated
Chrome Full support 1Edge Full support 12Firefox Full support 1IE Full support YesOpera Full support ≤12.1Safari Full support YesWebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support ≤12.1Safari iOS Full support YesSamsung Internet Android Full support 1.0
deleteCellChrome Full support 1Edge Full support 12Firefox Full support 1IE Full support YesOpera Full support ≤12.1Safari Full support YesWebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support ≤12.1Safari iOS Full support YesSamsung Internet Android Full support 1.0
insertCellChrome Full support 1Edge Full support 12Firefox Full support 1IE Full support YesOpera Full support ≤12.1Safari Full support YesWebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support ≤12.1Safari iOS Full support YesSamsung Internet Android Full support 1.0
rowIndexChrome Full support 1Edge Full support 12Firefox Full support 1IE Full support YesOpera Full support ≤12.1Safari Full support YesWebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support ≤12.1Safari iOS Full support YesSamsung Internet Android Full support 1.0
sectionRowIndexChrome Full support 1Edge Full support 12Firefox Full support 1IE Full support YesOpera Full support ≤12.1Safari Full support YesWebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support ≤12.1Safari iOS Full support YesSamsung Internet Android Full support 1.0
vAlign
DeprecatedNon-standard
Chrome Full support 1Edge Full support 12Firefox Full support 1IE Full support YesOpera Full support ≤12.1Safari Full support YesWebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support ≤12.1Safari iOS Full support YesSamsung Internet Android Full support 1.0

Legend

Full support  
Full support
Non-standard. Expect poor cross-browser support.
Non-standard. Expect poor cross-browser support.
Deprecated. Not for use in new websites.
Deprecated. Not for use in new websites.

See also

  • The HTML element implementing this interface: <tr>.

文件標籤與貢獻者

最近更新: bernardirfan,