CUSTOM 元素 | custom 对象

代表了一个用户自定义元素。

成员表

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

标签属性/属性

SHOW: 标签属性/属性 集合 事件 滤镜 方法 对象 样式 标签属性 属性 描述 ACCESSKEY accessKey 设置或获取对象的快捷键。 ATOMICSELECTION 指定元素及其内容是否可以一不可见单位统一选择。 blockDirection 获取表明块元素内容的绕排方向的值，是由左至右，还是由右至左。 canHaveChildren 获取表明对象是否可以包含子对象的值。 canHaveHTML 获取表明对象是否可以包含丰富的 HTML 标签的值。 CLASS className 设置或获取对象的类。 clientHeight 获取对象的高度，不计算任何边距、边框、滚动条或可能应用到该对象的补白。 clientLeft 获取 offsetLeft 属性和客户区域的实际左边之间的距离。 clientTop 获取 offsetTop 属性和客户区域的实际顶端之间的距离。 clientWidth 获取对象的宽度，不计算任何边距、边框、滚动条或可能应用到该对象的补白。 CONTENTEDITABLE contentEditable 设置或获取表明用户是否可编辑对象内容的字符串。 DIR dir 设置或获取对象的阅读顺序。 DISABLED disabled 设置或获取控件的状态。 HIDEFOCUS hideFocus 设置或获取表明对象是否显式标明焦点的值。 ID id 获取标识对象的字符串。 innerHTML 设置或获取位于对象起始和结束标签内的 HTML。 innerText 设置或获取位于对象起始和结束标签内的文本。 isContentEditable 获取表明用户是否可编辑对象内容的值。 isDisabled 获取表明用户是否可与该对象交互的值。 isMultiLine 获取表明对象的内容是包含一行还是多行的值。 isTextEdit 获取是否可使用该对象创建一个 TextRange 对象。 LANG lang 设置或获取要使用的语言。 LANGUAGE language 设置或获取当前脚本编写用的语言。 offsetHeight 获取对象相对于版面或由父坐标 offsetParent 属性指定的父坐标的高度。 offsetLeft 获取对象相对于版面或由 offsetParent 属性指定的父坐标的计算左侧位置。 offsetParent 获取定义对象 offsetTop 和 offsetLeft 属性的容器对象的引用。 offsetTop 获取对象相对于版面或由 offsetTop 属性指定的父坐标的计算顶端位置。 offsetWidth 获取对象相对于版面或由父坐标 offsetParent 属性指定的父坐标的宽度。 onOffBehavior 获取表明指定的 Microsoft® DirectAnimation® 行为是否正在运行的对象。 outerHTML 设置或获取对象及其内容的 HTML 形式。 outerText 设置或获取对象的文本。 parentElement 获取对象层次中的父对象。 parentTextEdit 获取文档层次中可用于创建包含原始对象的 TextRange 的容器对象。 readyState 获取对象的当前状态。 scopeName 获取为该元素定义的命名空间。 scrollHeight 获取对象的滚动高度。 scrollLeft 设置或获取位于对象左边界和窗口中目前可见内容的最左端之间的距离。 scrollTop 设置或获取位于对象最顶端和窗口中可见内容的最顶端之间的距离。 scrollWidth 获取对象的滚动宽度。 sourceIndex 获取对象在源序中的依次位置，即对象出现在 document 的 all 集合中的顺序。 STYLE 为该设置元素设置内嵌样式。 TABINDEX tabIndex 设置或获取定义对象的 Tab 顺序的索引。 tagName 获取对象的标签名称。 tagUrn 设置或获取在命名空间声明中指定的统一资源名称(URN)。 TITLE title 设置或获取对象的咨询信息(工具提示)。 UNSELECTABLE 指定该元素不可被选中。

标签属性/属性

集合

集合	描述
all	返回对象所包含的元素集合的引用。
behaviorUrns	返回标识附加到该元素行为的统一资源名称(URN)字符串的集合。
children	获取作为对象直接后代的 DHTML 对象的集合。
filters	获取应用于对象的滤镜集合。

事件

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

滤镜

滤镜属性	描述
Alpha	调整对象内容的不透明度。
AlphaImageLoader	在对象的边界和对象背景到内容之间显示图像，可选剪裁或缩放图像大小。当装入便携网络图像(PNG)时，从 0 到 100% 的 透明度都是支持的。
Barn	以开门或关门的运动方式显示对象的新内容。
BasicImage	调整对象内容的颜色处理、图像旋转或不透明度。
BlendTrans	以渐隐原始内容的形式显示对象的新内容。
Blinds	以打开或关闭盲点的运动方式显示对象的新内容。
Blur	模糊对象的内容以便使其看起来失去焦点。
CheckerBoard	以揭开覆盖在原始内容上的棋盘的形式显示对象的新内容。
Chroma	将对象内容的指定颜色显示为透明。
Compositor	以新旧内容逻辑颜色组合的形式显示对象的新内容。每个版本的颜色和 alpha 值都会被计算用来决定输出图像的最终颜色。
DropShadow	创建对象内容的实体阴影，偏移量位于指定方向。这将使得内容看起来是浮动的因此会产生阴影。
Emboss	使用灰度值对对象以浮雕纹理显示。
Engrave	使用灰度值对对象以雕刻纹理显示。
Fade	以渐隐原始内容的形式显示对象的新内容。
FlipH	以沿水平方向翻转的形式显示对象内容。
FlipV	以沿垂直方向翻转的形式显示对象内容。
Glow	在对象边缘外侧添加光晕以便使其看起来像发光的样子。
Gradient	在对象的背景和内容之间显示一个渐变色彩的表面。
GradientWipe	以在原有内容上覆盖渐变带的形式显示对象的新内容。
Gray	以灰度显示对象内容。
ICMFilter	根据图像颜色管理(ICM)配置文件转换对象的彩色内容。这将允许指定内容的显示效果得以改善，或者在打印机或监视器等硬件设备上模拟显示。
Inset	以对角线方向显示对象的新内容。
Invert	反转对象内容的色调、饱和度和亮度。
Iris	以彩虹效果显示对象的新内容，这与照相机光圈打开相似。
Light	在对象的内容上创建灯光效果。
MaskFilter	将对象内容的透明像素显示为彩色遮罩，将非透明像素显示为透明。
Matrix	使用矩阵变换缩放、旋转或显现对象的内容。
MotionBlur	以运动模糊的效果显示对象内容。
Pixelate	将对象的内容显示为彩色方块，其颜色取决于该方块所替代区域的平均颜色值。此滤镜显示可用于切换。
RadialWipe	以辐射状擦除的形式显现对象的新内容。
RandomBars	以随机像素线爆炸的形式显现对象的新内容。
RandomDissolve	以随机像素爆炸的形式显现对象的新内容。
Redirect	目前还不支持。
RevealTrans	使用 24 种预先定义的切换效果显现对象的新内容。
Shadow	创建对象内容的实体阴影，偏移量位于指定方向。这将创建阴影效果。
Slide	以图像滑行的形式显现对象的新内容。
Spiral	以螺旋运动的形式显现对象的新内容。
Stretch	以拉伸覆盖原始内容的形式显现对象的新内容。有一个选项类似立方体从一个表面转到另外一个表面。
Strips	以条形覆盖的形式显现对象的原始内容，好像有一把锯将原始内容锯开。
Wave	在对象的内容上执行垂直方向的正弦波扭曲。
Wheel	以旋转运动的形式显现对象的新内容，好像轮子滚过原始内容。
Xray	更改对象内容的颜色深度将其以黑白显示。
Zigzag	在对象上将对象的新内容进行来回移动以便覆盖原始内容。

方法

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

对象

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

样式

样式标签属性	样式属性	描述
ACCELERATOR	accelerator	设置或获取表明对象是否包含快捷键的字符串。
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 行为的位置。
border	border	设置或获取对象周围边框的绘制属性。
border-bottom	borderBottom	设置或获取对象下边框的属性。
border-bottom-color	borderBottomColor	设置或获取对象下边框的颜色。
border-bottom-style	borderBottomStyle	设置或获取对象下边框的样式。
border-bottom-width	borderBottomWidth	设置或获取对象下边框的宽度。
border-color	borderColor	设置或获取对象的边框颜色。
border-left	borderLeft	设置或获取对象左边框的属性。
border-left-color	borderLeftColor	设置或获取对象左边框的颜色。
border-left-style	borderLeftStyle	设置或获取对象左边框的样式。
border-left-width	borderLeftWidth	设置或获取对象左边框的宽度。
border-right	borderRight	设置或获取对象右边框的属性。
border-right-color	borderRightColor	设置或获取对象右边框的颜色。
border-right-style	borderRightStyle	设置或获取对象右边框的样式。
border-right-width	borderRightWidth	设置或获取对象右边框的宽度。
border-style	borderStyle	设置或获取对象上下左右边框的样式。
border-top	borderTop	设置或获取对象上边框的属性。
border-top-color	borderTopColor	设置或获取对象上边框的颜色。
border-top-style	borderTopStyle	设置或获取对象上边框的样式。
border-top-width	borderTopWidth	设置或获取对象上边框的宽度。
border-width	borderWidth	设置或获取对象上下左右边框的宽度。
bottom	bottom	设置或获取对象相对于文档层次中下个定位对象的底部的位置。
clear	clear	设置或获取对象是否允许在其左侧、右侧或两边放置浮动对象，以防下段文本显示在浮动对象上。
clip	clip	设置或获取定位对象的哪个部分可见。
color	color	设置或获取对象文本的颜色。
cursor	cursor	设置或获取当鼠标指针指向对象时所使用的鼠标指针。
direction	direction	设置或获取对象的阅读顺序。
display	display	设置或获取对象是否要渲染。
filter	filter	设置或获取应用于对象的滤镜或滤镜集合。
font	font	设置或获取对象最多六个独立的字体属性。
font-family	fontFamily	设置或获取对象文本所使用的字体名称。
font-size	fontSize	设置或获取对象文本使用的字体大小。
font-style	fontStyle	设置或获取对象的字体样式，如斜体、常规或倾斜。
font-variant	fontVariant	设置或获取对象文本是否以小型大写字母显示。
font-weight	fontWeight	设置或获取对象的字体宽度。
	hasLayout	获取表明对象是否有布局的值。
height	height	设置或获取对象的高度。
layout-flow	layoutFlow	设置或获取对象内容的方向和绕排方向。
layout-grid	layoutGrid	设置或获取指定文本字符版面的组合文档格线属性。
layout-grid-mode	layoutGridMode	设置或获取文本布局网格是否使用二维。
left	left	设置或获取对象相对于文档层次中下个定位对象的左边界的位置。
letter-spacing	letterSpacing	设置或获取对象的字符间附加空间的总和。
line-height	lineHeight	设置或获取对象两行间的距离。
margin	margin	设置或获取对象的上下左右边距。
margin-bottom	marginBottom	设置或获取对象的下边距宽度。
margin-left	marginLeft	设置或获取对象的左边距宽度。
margin-right	marginRight	设置或获取对象的右边距宽度。
margin-top	marginTop	设置或获取对象的上边距宽度。
overflow	overflow	设置或获取表明当内容超出对象高度或宽度时如何管理对象内容的值。
overflow-x	overflowX	设置或获取当内容超出对象宽度时如何管理对象内容。
overflow-y	overflowY	设置或获取当内容超出对象高度时如何管理对象内容。
padding	padding	设置或获取要在对象和其边距或若存在的边框的话就是对象和其边框之间要插入的全部空间。
padding-bottom	paddingBottom	设置或获取要在对象下边框和内容之间插入的空间总量。
padding-left	paddingLeft	设置或获取要在对象左边框和内容之间插入的空间总量。
padding-right	paddingRight	设置或获取要在对象右边框和内容之间插入的空间总量。
padding-top	paddingTop	设置或获取对象上边框和内容之间插入的空间总量。
	pixelBottom	设置或获取对象的下方位置。
	pixelHeight	设置或获取对象的高度。
	pixelLeft	设置或获取对象的左侧位置。
	pixelRight	设置或获取对象的右侧位置。
	pixelTop	设置或获取对象的上方位置。
	pixelWidth	设置或获取对象的宽度。
	posBottom	设置或获取以 bottom 标签属性指定的单位的对象下方位置。
	posHeight	设置或获取以 height 标签属性指定的单位的对象高度。
position	position	设置或获取对象所使用的定位方式。
	posLeft	设置或获取以 left 标签属性指定的单位的对象左侧位置。
	posRight	设置或获取以 right 标签属性指定的单位的对象右侧位置。
	posTop	设置或获取以 top 标签属性指定的单位的对象上方位置。
	posWidth	设置或获取以 width 标签属性指定的单位的对象宽度。
scrollbar-3dlight-color	scrollbar3dLightColor	设置或获取滚动条上滚动按钮和滚动滑块的左上颜色。
scrollbar-arrow-color	scrollbarArrowColor	设置或获取滚动箭头标识的颜色。
scrollbar-base-color	scrollbarBaseColor	设置或获取滚动条的主要颜色，其中包含滚动按钮和滚动滑块。
scrollbar-darkshadow-color	scrollbarDarkShadowColor	设置或获取滚动条上滑槽的颜色。
scrollbar-face-color	scrollbarFaceColor	设置或获取滚动条和滚动条的滚动箭头的颜色。
scrollbar-highlight-color	scrollbarHighlightColor	设置或获取滚动框和滚动条滚动箭头的左上边缘颜色。
scrollbar-shadow-color	scrollbarShadowColor	设置或获取滚动框和滚动条滚动箭头的右下边缘颜色。
scrollbar-track-color	scrollbarTrackColor	设置或获取滚动条轨迹元素的颜色。
float	styleFloat	设置或获取文本要绕排到对象的哪一侧。
text-align-last	textAlignLast	设置或获取如何排列对象的最后一行或仅有的一行。
text-autospace	textAutospace	设置或获取自动留空和文本的窄空间宽度调整。
text-decoration	textDecoration	设置或获取对象中的文本是否有闪烁、删除线、上划线或下划线的样式。
	textDecorationBlink	设置或获取表明对象的 textDecoration 属性是否含有有“blink”的 Boolean 值。
	textDecorationLineThrough	设置或获取表明对象内的文本是否有删除线的 Boolean 值。
	textDecorationNone	设置或获取表明对象的 textDecoration 属性是否设置为 none 的 Boolean 值。
	textDecorationOverline	设置或获取表明对象中的文本是否有上划线的 Boolean 值。
	textDecorationUnderline	设置或获取对象中的文本是否有下划线的 Boolean 值。
text-kashida-space	textKashidaSpace	设置或获取对象内文本对齐行时所使用空白扩展的 kashida 扩展的倍率。
text-overflow	textOverflow	设置或获取表明是否显示省略号以表明文本溢出的值。
text-transform	textTransform	设置或获取对象中文本的渲染方式。
text-underline-position	textUnderlinePosition	设置或获取对象的 textDecoration 属性中设置的下划线的位置。
top	top	设置或获取对象相对于文档层次中下个定位对象的上边界的位置。
unicode-bidi	unicodeBidi	设置或获取关于双向法则的嵌入级别。
vertical-align	verticalAlign	设置或获取对象的垂直排列。
visibility	visibility	设置或获取对象的内容是否显示。
white-space	whiteSpace	设置或获取对象中是否自动换行。
width	width	设置或获取对象的宽度。
word-spacing	wordSpacing	设置或获取对象中单词间的附加空间总量。
word-wrap	wordWrap	设置或获取当内容超过其容器边界时是否断词。
writing-mode	writingMode	设置或获取对象内容的方向和绕排。
z-index	zIndex	设置或获取定位对象的堆叠次序。
zoom	zoom	设置或获取对象的放大比例。

注释

Microsoft^® Internet Explorer 对于 HTML 页面上自定义标签的支持需要为该标签定义命名空间。否则，自定义标签将在文档被处理时被作为未知标签对待。尽管在 Internet Explorer 中浏览带有未知标签的页面不会导致错误，未知标签仍然带有无法包含其它标签也无法对其应用行为的缺点。

要声明命名空间，请使用 HTML 元素的 XMLNS 标签属性。

当定义自定义标签时，你必须在 @media 包装内完成自定标签的定义。

自定义标签当应用 DHTML 行为时将会变得有趣得多。DHTML 行为(或称行为)应用到页面上元素的方法与和样式表属性一样。说得更明白一点，已提议的 CSS behavior 属性允许 Web 编著者指定行为的位置并将该行为应用到页面上的元素。

此元素在 Microsoft^® Internet Explorer 5 的 HTML 和脚本中可用。

此元素是内嵌元素。

此元素需要关闭标签。

示例

下面的例子使用 custom 元素创建自定义 RED, GREEN 和 BLUE 元素。这些元素将更改文本的颜色为红、绿或蓝色，这取决于文本外围的标签是 RED, GREEN 还是 BLUE。在下面的例子中，RED, GREEN 和 BLUE 标签都定义在 CUSTOMTAG 的命名空间内。