TR 元素 | tr 对象

指定表格中的一行。

成员表

下面的表格列出了 tr 对象引出的成员。请单击左侧的标签来选择你想要查看的成员类型。

标签属性/属性

SHOW: 标签属性/属性 行为 集合 事件 方法 对象 样式 标签属性 属性 描述 ACCESSKEY accessKey 设置或获取对象的快捷键。 ALIGN align 设置或获取对象相对于显示或表格的排列方式。 ATOMICSELECTION 指定元素及其内容是否可以一不可见单位统一选择。 BEGIN begin 设置或获取时间线在该元素上播放前的延迟时间。 BGCOLOR bgColor 不推荐。设置或获取对象后面的背景颜色。 BORDERCOLOR borderColor 设置或获取对象的边框颜色。 borderColorDark 设置或获取用于绘制对象 3D 边框的两种颜色的一种。 borderColorLight 设置或获取用于绘制对象 3D 边框的两种颜色的一种。 canHaveChildren 获取表明对象是否可以包含子对象的值。 canHaveHTML 获取表明对象是否可以包含丰富的 HTML 标签的值。 CH ch 设置或获取可用于实现对象的你自己的 ch 功能的字符串。 CHOFF chOff 设置或获取可用于实现对象的你自己的 chOff 功能的字符串。 CLASS className 设置或获取对象的类。 clientHeight 获取对象的高度，不计算任何边距、边框、滚动条或可能应用到该对象的补白。 clientLeft 获取 offsetLeft 属性和客户区域的实际左边之间的距离。 clientTop 获取 offsetTop 属性和客户区域的实际顶端之间的距离。 clientWidth 获取对象的宽度，不计算任何边距、边框、滚动条或可能应用到该对象的补白。 DIR dir 设置或获取对象的阅读顺序。 disabled 获取表明用户是否可与该对象交互的值。 END end 设置或获取表明元素结束时间的值，或者元素设置为重复的简单持续终止时间。 firstChild 获取对象的 childNodes 集合的第一个子对象的引用。 hasMedia 获取一个表明元素是否为 HTML+TIME 媒体元素的 Boolean 值。 HEIGHT height 设置或获取对象的高度。 HIDEFOCUS hideFocus 设置或获取表明对象是否显式标明焦点的值。 ID id 获取标识对象的字符串。 innerHTML 设置或获取位于对象起始和结束标签内的 HTML。 innerText 设置或获取位于对象起始和结束标签内的文本。 isContentEditable 获取表明用户是否可编辑对象内容的值。 isDisabled 获取表明用户是否可与该对象交互的值。 isMultiLine 获取表明对象的内容是包含一行还是多行的值。 isTextEdit 获取是否可使用该对象创建一个 TextRange 对象。 LANG lang 设置或获取要使用的语言。 LANGUAGE language 设置或获取当前脚本编写用的语言。 lastChild 获取该对象 childNodes 集合中最后一个子对象的引用。 nextSibling 获取对此对象的下一个兄弟对象的引用。 nodeName 获取特定结点类型的名称。 nodeType 获取所需结点的类型。 nodeValue 设置或获取结点的值。 offsetHeight 获取对象相对于版面或由父坐标 offsetParent 属性指定的父坐标的高度。 offsetLeft 获取对象相对于版面或由 offsetParent 属性指定的父坐标的计算左侧位置。 offsetParent 获取定义对象 offsetTop 和 offsetLeft 属性的容器对象的引用。 offsetTop 获取对象相对于版面或由 offsetTop 属性指定的父坐标的计算顶端位置。 offsetWidth 获取对象相对于版面或由父坐标 offsetParent 属性指定的父坐标的宽度。 onOffBehavior 获取表明指定的 Microsoft® DirectAnimation® 行为是否正在运行的对象。 outerHTML 设置或获取对象及其内容的 HTML 形式。 outerText 设置或获取对象的文本。 ownerDocument 设置或获取结点关联的 document 对象。 parentElement 获取对象层次中的父对象。 parentNode 获取文档层次中的父对象。 parentTextEdit 获取文档层次中可用于创建包含原始对象的 TextRange 的容器对象。 previousSibling 获取对此对象的上一个兄弟对象的引用。 readyState 获取表明对象当前状态的值。 rowIndex 获取对象在表格的 rows 集合中的位置。 scopeName 获取为该元素定义的命名空间。 scrollHeight 获取对象的滚动高度。 scrollLeft 设置或获取位于对象左边界和窗口中目前可见内容的最左端之间的距离。 scrollTop 设置或获取位于对象最顶端和窗口中可见内容的最顶端之间的距离。 scrollWidth 获取对象的滚动宽度。 sectionRowIndex 获取对象位于 tBody, tHead, tFoot 或 rows 集合中的位置。 sourceIndex 获取对象在源序中的依次位置，即对象出现在 document 的 all 集合中的顺序。 STYLE 为该设置元素设置内嵌样式。 SYNCMASTER syncMaster 设置或获取时间容器是否必须在此元素上同步回放。 SYSTEMBITRATE 获取系统中大约可用带宽的 bps。 SYSTEMCAPTION 表明是否要显示文本来代替演示的的音频部分。 SYSTEMLANGUAGE 表明是否在用户计算机上的选项设置中选中了给定语言。 SYSTEMOVERDUBORSUBTITLE 指定针对那些正在观看演示但对被播放的音频所使用的语言并不熟悉的用户来说是否要渲染配音或字幕。 TABINDEX tabIndex 设置或获取定义对象的 Tab 顺序的索引。 tagName 获取对象的标签名称。 tagUrn 设置或获取在命名空间声明中指定的统一资源名称(URN)。 TIMECONTAINER timeContainer 设置或获取与元素关联的时间线类型。 TITLE title 设置或获取对象的咨询信息(工具提示)。 uniqueID 获取为对象自动生成的唯一标识符。 VALIGN vAlign 设置或获取文本和其它内容在对象内的垂直方向上如何排列。 WIDTH width 设置或获取对象的宽度。

标签属性/属性

行为

行为	描述
clientCaps	提供关于 Internet Explorer 支持的特性的信息，以及提供即用即装的方法。
download	下载文件并在下载完成后通知一个指定的回调函数。
homePage	包含关于用户主页的信息。
time	为 HTML 元素提供一个活动的时间线。
time2	为 HTML 元素或一组元素提供一个活动的时间线。

集合

集合	描述
all	返回对象所包含的元素集合的引用。
attributes	获取对象标签属性的集合。
behaviorUrns	返回标识附加到该元素行为的统一资源名称(URN)字符串的集合。
cells	获取表格行或整个表格中所有单元格的集合。
childNodes	获取作为指定对象直接后代的 HTML 元素和 TextNode 对象的集合。
children	获取作为对象直接后代的 DHTML 对象的集合。

事件

事件	描述
onactivate	当对象设置为活动元素时触发。
onbeforeactivate	对象要被设置为当前元素前立即触发。
onbeforecopy	当选中区复制到系统剪贴板之前在源对象触发。
onbeforecut	当选中区从文档中删除之前在源对象触发。
onbeforedeactivate	在 activeElement 从当前对象变为父文档其它对象之前立即触发。
onbeforeeditfocus	在包含于可编辑元素内的对象进入用户界面激活状态前或可编辑容器变成控件选中区前触发。
onbeforepaste	在选中区从系统剪贴板粘贴到文档前在目标对象上触发。
onblur	在对象失去输入焦点时触发。
onclick	在用户用鼠标左键单击对象时触发。
oncontextmenu	在用户使用鼠标右键单击客户区打开上下文菜单时触发。
oncontrolselect	当用户将要对该对象制作一个控件选中区时触发。
oncopy	当用户复制对象或选中区，将其添加到系统剪贴板上时在源元素上触发。
oncut	当对象或选中区从文档中删除并添加到系统剪贴板上时在源元素上触发。
ondblclick	当用户双击对象时触发。
ondeactivate	当 activeElement 从当前对象变为父文档其它对象时触发。
ondrag	当进行拖曳操作时在源对象上持续触发。
ondragend	当用户在拖曳操作结束后释放鼠标时在源对象上触发。
ondragenter	当用户拖曳对象到一个合法拖曳目标时在目标元素上触发。
ondragleave	当用户在拖曳操作过程中将鼠标移出合法拖曳目标时在目标对象上触发。
ondragover	当用户拖曳对象划过合法拖曳目标时持续在目标元素上触发。
ondragstart	当用户开始拖曳文本选中区或选中对象时在源对象上触发。
ondrop	当鼠标按钮在拖曳操作过程中释放时在目标对象上触发。
onfilterchange	当可视滤镜更改状态或完成转换时触发。
onfocus	当对象获得焦点时触发。
onfocusin	当元素将要被设置为焦点之前触发。
onfocusout	在移动焦点到其它元素之后立即触发于当前拥有焦点的元素上触发。
onhelp	当用户在浏览器为当前窗口时按 F1 键时触发。
onkeydown	当用户按下键盘按键时触发。
onkeypress	当用户按下字面键时触发。
onkeyup	当用户释放键盘按键时触发。
onlosecapture	当对象失去鼠标捕捉时触发。
onmousedown	当用户用任何鼠标按钮单击对象时触发。
onmouseenter	当用户将鼠标指针移动到对象内时触发。
onmouseleave	当用户将鼠标指针移出对象边界时触发。
onmousemove	当用户将鼠标划过对象时触发。
onmouseout	当用户将鼠标指针移出对象边界时触发。
onmouseover	当用户将鼠标指针移动到对象内时触发。
onmouseup	当用户在鼠标位于对象之上时释放鼠标按钮时触发。
onmousewheel	当鼠标滚轮按钮旋转时触发。
onmove	当对象移动时触发。
onmoveend	当对象停止移动时触发。
onmovestart	当对象开始移动时触发。
onpaste	当用户粘贴数据以便从系统剪贴板向文档传送数据时在目标对象上触发。
onpropertychange	当在对象上发生对象上发生属性更改时触发。
onreadystatechange	当对象状态变更时触发。
onresizeend	当用户更改完控件选中区中对象的尺寸时触发。
onresizestart	当用户开始更改控件选中区中对象的尺寸时触发。
onselectstart	对象将要被选中时触发。
ontimeerror	当特定时间错误发生时无条件触发，通常由将属性设置为无效值导致。

方法

方法	描述
addBehavior	给元素附加一个行为。
appendChild	给对象追加一个子元素。
applyElement	使得元素成为其它元素的子元素或父元素。
attachEvent	将指定函数绑定到事件，以便每当该事件在对象上触发时都调用该函数。
blur	使元素失去焦点并触发 onblur 事件。
clearAttributes	从对象中删除全部标签属性和值。
click	触发 onclick 事件来模拟单击。
cloneNode	从文档层次中复制对对象的引用。
componentFromPoint	通过特定事件返回对象在指定坐标下的位置。
contains	检查对象中是否包含给定元素。
deleteCell	从表格行及 cells 集合中删除指定单元格(td)。
detachEvent	从事件中取消指定函数的绑定，这样当事件触发时函数就不会收到通知了。
dragDrop	初始化拖曳事件。
fireEvent	触发对象的指定事件。
focus	使得元素得到焦点并执行由 onfocus 事件指定的代码。
getAdjacentText	返回邻接文本字符串。
getAttribute	获取指定标签属性的值。
getAttributeNode	获取由 attribute.name 属性引用的 attribute 对象。
getBoundingClientRect	获取指定 TextRectangle 对象集合绑定的对象。
getClientRects	获取描述对象内容或客户区内布局的矩形集合。每个矩形都描述了一条直线。
getElementsByTagName	获取基于指定元素名称的对象集合。
getExpression	获取给定属性的表达式。
hasChildNodes	返回表明对象是否有子对象的值。
insertAdjacentElement	在指定位置插入元素。
insertBefore	在文档层次中插入元素作为父对象的子结点。
insertCell	在表格行(tr)中创建新单元格，并将单元格添加到 cells 集合中。
mergeAttributes	复制所有读/写标签属性到指定元素。
normalize	合并邻接 TextNode 对象以便生成一个常规的文档对象模型。
releaseCapture	释放当前文档中对象的鼠标捕捉。
removeAttribute	删除对象的给定标签属性。
removeAttributeNode	从对象中删除删除 attribute 对象。
removeBehavior	分离元素的行为。
removeChild	从元素上删除子结点。
removeExpression	从指定属性中删除表达式。
removeNode	从文档层次中删除对象。
replaceAdjacentText	替换元素的邻接文本。
replaceChild	用新的子元素替换已有的子元素。
replaceNode	用其它元素替换对象。
scrollIntoView	将对象滚动到可见范围内，将其排列到窗口顶部或底部。
setActive	设置对象为当前对象而不将对象置为焦点。
setAttribute	设置指定标签属性的值。
setAttributeNode	设置 attribute 对象为对象的一部分。
setCapture	设置属于当前文档的对象的鼠标捕捉。
setExpression	设置指定对象的表达式。
swapNode	交换文档层次中两个对象的位置。

对象

对象	描述
currentStyle	代表了在全局样式表、内嵌样式和 HTML 标签属性中指定的对象格式和样式。
runtimeStyle	代表了居于全局样式表、内嵌样式和 HTML 标签属性指定的格式和样式之上的对象的格式和样式。
style	代表了给定元素所有可能的内嵌样式的当前设置。

样式

样式标签属性	样式属性	描述
background	background	设置或获取对象最多五个独立的背景属性。
background-attachment	backgroundAttachment	设置或获取背景图像如何附加到文档内的对象中。
background-color	backgroundColor	设置或获取对象内容后的颜色。
background-image	backgroundImage	设置或获取对象的背景图像。
background-position	backgroundPosition	设置或获取对象背景的位置。
background-position-x	backgroundPositionX	设置或获取 backgroundPosition 属性的 x 坐标。
background-position-y	backgroundPositionY	设置或获取 backgroundPosition 属性的 y 坐标。
background-repeat	backgroundRepeat	设置或获取对象的 backgroundImage 属性如何平铺。
behavior	behavior	设置或获取 DHTML 行为的位置。
clear	clear	设置或获取对象是否允许在其左侧、右侧或两边放置浮动对象，以防下段文本显示在浮动对象上。
clip	clip	设置或获取定位对象的哪个部分可见。
color	color	设置或获取对象文本的颜色。
cursor	cursor	设置或获取当鼠标指针指向对象时所使用的鼠标指针。
direction	direction	设置或获取对象的阅读顺序。
display	display	设置或获取对象是否要渲染。
font	font	设置或获取对象最多六个独立的字体属性。
font-family	fontFamily	设置或获取对象文本所使用的字体名称。
font-size	fontSize	设置或获取对象文本使用的字体大小。
font-style	fontStyle	设置或获取对象的字体样式，如斜体、常规或倾斜。
font-variant	fontVariant	设置或获取对象文本是否以小型大写字母显示。
font-weight	fontWeight	设置或获取对象的字体宽度。
height	height	设置或获取对象的高度。
layout-grid	layoutGrid	设置或获取指定文本字符版面的组合文档格线属性。
layout-grid-char	layoutGridChar	设置或获取用于渲染元素文本内容的字符网格大小。
layout-grid-line	layoutGridLine	设置或获取用于渲染元素文本内容的网格线值。
layout-grid-mode	layoutGridMode	设置或获取文本布局网格是否使用二维。
layout-grid-type	layoutGridType	设置或获取用于渲染元素文本内容的网格类型。
letter-spacing	letterSpacing	设置或获取对象的字符间附加空间的总和。
line-break	lineBreak	设置或获取日本文本的换行规则。
line-height	lineHeight	设置或获取对象两行间的距离。
min-height	minHeight	设置或获取元素的最小高度。
page-break-after	pageBreakAfter	设置或获取表明对象后发生换页的字符串。
page-break-before	pageBreakBefore	设置或获取表明对象前发生换页的字符串。
	pixelBottom	设置或获取对象的下方位置。
	pixelHeight	设置或获取对象的高度。
	pixelLeft	设置或获取对象的左侧位置。
	pixelRight	设置或获取对象的右侧位置。
	pixelTop	设置或获取对象的上方位置。
	pixelWidth	设置或获取对象的宽度。
	posBottom	设置或获取以 bottom 标签属性指定的单位的对象下方位置。
	posHeight	设置或获取以 height 标签属性指定的单位的对象高度。
position	position	设置或获取对象所使用的定位方式。
	posLeft	设置或获取以 left 标签属性指定的单位的对象左侧位置。
	posRight	设置或获取以 right 标签属性指定的单位的对象右侧位置。
	posTop	设置或获取以 top 标签属性指定的单位的对象上方位置。
	posWidth	设置或获取以 width 标签属性指定的单位的对象宽度。
text-align	textAlign	设置或获取对象中的文本是左对齐、右对齐、居中对齐还是两端对齐。
text-autospace	textAutospace	设置或获取自动留空和文本的窄空间宽度调整。
text-decoration	textDecoration	设置或获取对象中的文本是否有闪烁、删除线、上划线或下划线的样式。
	textDecorationBlink	设置或获取表明对象的 textDecoration 属性是否含有有“blink”的 Boolean 值。
	textDecorationLineThrough	设置或获取表明对象内的文本是否有删除线的 Boolean 值。
	textDecorationNone	设置或获取表明对象的 textDecoration 属性是否设置为 none 的 Boolean 值。
	textDecorationOverline	设置或获取表明对象中的文本是否有上划线的 Boolean 值。
	textDecorationUnderline	设置或获取对象中的文本是否有下划线的 Boolean 值。
text-indent	textIndent	设置或获取对象中文本的缩进。
text-justify	textJustify	设置或获取对象内的文本所使用的对齐类型。
text-transform	textTransform	设置或获取对象中文本的渲染方式。
text-underline-position	textUnderlinePosition	设置或获取对象的 textDecoration 属性中设置的下划线的位置。
unicode-bidi	unicodeBidi	设置或获取关于双向法则的嵌入级别。
vertical-align	verticalAlign	设置或获取对象的垂直排列。
visibility	visibility	设置或获取对象的内容是否显示。
word-break	wordBreak	设置或获取单词内的换行行为，特别是对象中出现多语言的情况。
word-spacing	wordSpacing	设置或获取对象中单词间的附加空间总量。
z-index	zIndex	设置或获取定位对象的堆叠次序。
zoom	zoom	设置或获取对象的放大比例。

注释

TD 和 TH 元素可以在行中出现。

要更改 TR 元素中的 HTML，请使用表格对象模型。例如，使用 rowIndex 属性或 rows 集合获取对特定表格行的引用。你可以使用 insertRow 和 deleteRow 方法添加或删除行。要获取对特定单元格的引用，请使用 cellIndex 属性或 cells 集合。你可以使用 insertCell 和 deleteCell 方法添加或删除单元格。要更改特定单元格的内容，请使用 innerHTML 或 innerText 属性。

table 对象及其相关的元素有独立的表格对象模型，这与常规对象模型所采用的方法有很大不同。要获得关于表格对象模型更多的信息，请参看如何动态生成表格。

此元素在 Microsoft^® Internet Explorer 3.0 的 HTML 中可用，在 Internet Explorer 4.0 的脚本中可用。

此元素是块元素。

此元素需要关闭标签。

示例

下面的例子演示了如何在 HTML 和脚本中创建表格行。

这个例子使用了 TR 元素和 TABLE, TD 及 TR 元素创建了两行的表格。

SHOWExample

<TABLE>
<TR>
<TD>这是第一行。</TD>
</TR>
<TR>
<TD>这是第二行。</TD>
</TR>
</TABLE>

这个例子使用表格对象模型在用户单击按钮时向表格中动态添加了两行和两个单元格。

SHOWExample

<SCRIPT>
function createRows(){
// 插入两行。
var oRow1=oTable.insertRow(oTable.rows.length);
var oRow2=oTable.insertRow(oTable.rows.length);
// 获取表格的行集合。
var aRows=oTable.rows;
// 获取第一行的单元格集合。
var aCells=oRow1.cells;
// 在第一行中插入两个单元格。
var oCell1_1=aRows(oRow1.rowIndex).insertCell(aCells.length);
var oCell1_2=aRows(oRow1.rowIndex).insertCell(aCells.length);
// 获取第二行的单元格集合。
aCells=oRow2.cells;
// 在第二行中插入两个单元格。
var oCell2_1=aRows(oRow2.rowIndex).insertCell(aCells.length);
var oCell2_2=aRows(oRow2.rowIndex).insertCell(aCells.length);
// 为 4 个新单元格添加规范的 HTML 值。
oCell1_1.innerHTML="<B>Cell 1.1!</B>";
oCell1_2.innerHTML="<B>Cell 1.2!</B>";
oCell2_1.innerHTML="<B>Cell 2.1!</B>";
oCell2_2.innerHTML="<B>Cell 2.2!</B>";
}
</SCRIPT>
<INPUT TYPE="button" VALUE="创建行" onclick="createRows()">
<TABLE BORDER=1 ID="oTable">
<TR><TD></TD></TR>
</TABLE>

标准信息

此对象定义在 HTML 3.2  和万维网协会(W3C)文档对象模型(DOM) 级别 1  中。

参看

如何动态生成表格, table, borderCollapse