HTMLTableRowElement

在此页

特性
方法
规范
浏览器兼容性
另请参阅
相关话题

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.

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="../API/EventTarget.html" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25  236,20  236,30  226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25  351,20  351,30  341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25  501,20  501,30  491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="../API/HTMLTableRowElement" target="_top"><rect x="301" y="65" width="190" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="396" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLTableRowElement</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

特性

继承的特性来自其父级， HTMLElement .

HTMLTableRowElement.align: 是 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" ，和 "center" .
HTMLTableRowElement.bgColor: 是 DOMString containing the background color of the cells. It reflects the obsolete bgcolor 属性。
HTMLTableRowElement.cells 只读: 返回实时 HTMLCollection containing the cells in the row. The HTMLCollection is live and is automatically updated when cells are added or removed.
HTMLTableRowElement.ch: 是 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: 是 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.rowIndex 只读: 返回 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 只读: 返回 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 .
HTMLTableRowElement.vAlign: 是 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" ，或 "baseline" .

方法

继承方法来自其父级 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 ，引发 DOMException 采用 IndexSizeError 值。
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 ，引发 DOMException 采用 IndexSizeError value. Returns a reference to a HTMLTableCellElement [en-US] .

规范

规范	状态	注释
HTML 实时标准 The definition of 'HTMLTableRowElement' in that specification.	实时标准
HTML5 The definition of 'HTMLTableRowElement' in that specification.	推荐	The parameter of `insertCell` is now optional and default to `-1` .
DOM (文档对象模型) 2 级 HTML 规范 The definition of 'HTMLTableRowElement' in that specification.	过时	`cells` , `rowIndex` ，和 `selectionRowIndex` properties are now read-only. 方法 `insertCell` and `deleteCell` can raise exceptions.
DOM (文档对象模型) 1 级规范 The definition of 'HTMLTableRowElement' in that specification.	过时	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`HTMLTableRowElement`	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`align` 弃用非标	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`bgColor` 弃用非标	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`cells`	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`ch` 弃用	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`chOff` 弃用	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`deleteCell`	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`insertCell`	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`rowIndex`	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`sectionRowIndex`	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`vAlign` 弃用非标	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes

图例

完整支持
非标。预期跨浏览器支持较差。
弃用。不要用于新网站。

另请参阅

The HTML element implementing this interface: <tr> .

元数据

最后修改： 2019 年 3 月 23 日

在此页

特性

方法

规范

浏览器兼容性

图例

另请参阅

相关话题