ADDRESS 元素 | address 对象 OL 元素 | ol 对象 DHTML 对象
OBJECT 元素 | object 对象
向 HTML 页面中插入对象。
成员表
下面的表格列出了 object 对象引出的成员。请单击左侧的标签来选择你想要查看的成员类型。
标签属性/属性
标签属性 属性 描述 ACCESSKEY accessKey 设置或获取对象的快捷键。 ALIGN align 设置或获取对象针对其邻接文本如何排列。 ALT alt 设置或获取用于替代图像的文本。 altHTML 设置可选的若对象装载失败时要执行的替换 HTML 脚本。 ARCHIVE archive 设置或获取可用于实现对象的你自己的 archive 功能的字符串。 BaseHref 获取可找到对象标签的 URL 字符串。这通常是对象所在文档的 href,或者由 base 元素设置的值。 BORDER border 设置或获取绘制对象周围边框的宽度。 canHaveChildren 获取表明对象是否可以包含子对象的值。 canHaveHTML 获取表明对象是否可以包含丰富的 HTML 标签的值。 CLASSID classid 设置或获取对象的类标识符。 CLASS className 设置或获取对象的类。 clientHeight 获取对象的高度,不计算任何边距、边框、滚动条或可能应用到该对象的补白。 clientLeft 获取 offsetLeft 属性和客户区域的实际左边之间的距离。 clientTop 获取 offsetTop 属性和客户区域的实际顶端之间的距离。 clientWidth 获取对象的宽度,不计算任何边距、边框、滚动条或可能应用到该对象的补白。 CODE code 设置或获取包含已编译的 Java 类的文件的 URL。 CODEBASE codeBase 设置或获取组件的 URL。 CODETYPE codeType 设置或获取于对相关联代码的 Internet 媒体类型。 DATA data 设置或获取引用对象数据的 URL。 DECLARE declare 设置或获取可用于实现对象的你自己的 declare 功能的字符串。 DIR dir 设置或获取对象的阅读顺序。 disabled 获取表明用户是否可与该对象交互的值。 form 获取对象所在表单的引用。 HEIGHT height 设置或获取对象的高度。 HIDEFOCUS hideFocus 设置或获取表明对象是否显式标明焦点的值。 HSPACE hspace 设置或获取对象的水平边距。 ID id 获取标识对象的字符串。 isContentEditable 获取表明用户是否可编辑对象内容的值。 isDisabled 获取表明用户是否可与该对象交互的值。 isMultiLine 获取表明对象的内容是包含一行还是多行的值。 isTextEdit 获取是否可使用该对象创建一个 TextRange 对象。 LANG lang 设置或获取要使用的语言。 LANGUAGE language 设置或获取当前脚本编写用的语言。 NAME name 设置或获取对象的名称。 nextSibling 获取对此对象的下一个兄弟对象的引用。 nodeName 获取特定结点类型的名称。 nodeType 获取所需结点的类型。 nodeValue 设置或获取结点的值。 object 返回包含的对象。 offsetHeight 获取对象相对于版面或由父坐标 offsetParent 属性指定的父坐标的高度。 offsetLeft 获取对象相对于版面或由 offsetParent 属性指定的父坐标的计算左侧位置。 offsetParent 获取定义对象 offsetTop 和 offsetLeft 属性的容器对象的引用。 offsetTop 获取对象相对于版面或由 offsetTop 属性指定的父坐标的计算顶端位置。 offsetWidth 获取对象相对于版面或由父坐标 offsetParent 属性指定的父坐标的宽度。 outerHTML 设置或获取对象及其内容的 HTML 形式。 outerText 设置或获取对象的文本。 parentElement 获取对象层次中的父对象。 parentNode 获取文档层次中的父对象。 parentTextEdit 获取文档层次中可用于创建包含原始对象的 TextRange 的容器对象。 previousSibling 获取对此对象的上一个兄弟对象的引用。 readyState 获取对象的当前状态。 recordset 从数据源对象设置或获取对默认数据集的引用。 scopeName 获取为该元素定义的命名空间。 scrollHeight 获取对象的滚动高度。 scrollLeft 设置或获取位于对象左边界和窗口中目前可见内容的最左端之间的距离。 scrollTop 设置或获取位于对象最顶端和窗口中可见内容的最顶端之间的距离。 scrollWidth 获取对象的滚动宽度。 sourceIndex 获取对象在源序中的依次位置,即对象出现在 document 的 all 集合中的顺序。 STANDBY standby 设置或获取可用于实现对象的你自己的 standby 功能的字符串。 STYLE 为该设置元素设置内嵌样式。 TABINDEX tabIndex 设置或获取定义对象的 Tab 顺序的索引。 tagName 获取对象的标签名称。 tagUrn 设置或获取在命名空间声明中指定的统一资源名称(URN)。 TITLE title 设置或获取对象的咨询信息(工具提示)。 TYPE type 设置或获取对象的 MIME 类型。 uniqueID 获取为对象自动生成的唯一标识符。 UNSELECTABLE 指定该元素不可被选中。 USEMAP useMap 设置或获取用于客户端图像映射的 URL,通常带有一个书签扩展(#name)。 VSPACE vspace 设置或获取对象的垂直边距。 WIDTH width 设置或获取对象的宽度。 行为
行为 描述 clientCaps 提供关于 Internet Explorer 支持的特性的信息,以及提供即用即装的方法。 download 下载文件并在下载完成后通知一个指定的回调函数。 homePage 包含关于用户主页的信息。 httpFolder 包含了允许浏览导航的文件夹视图的脚本特性。 saveFavorite 允许对象在收藏夹中留存数据。 saveHistory 允许对象在浏览器历史中留存数据。 saveSnapshot 允许对象在 Web 页保存时留存数据。 userData 允许对象在用户数据中留存数据。 集合
集合 描述 all 返回对象所包含的元素集合的引用。 attributes 获取对象标签属性的集合。 behaviorUrns 返回标识附加到该元素行为的统一资源名称(URN)字符串的集合。 事件
事件 描述 onactivate 当对象设置为活动元素时触发。 onbeforedeactivate 在 activeElement 从当前对象变为父文档其它对象之前立即触发。 onbeforeeditfocus 在包含于可编辑元素内的对象进入用户界面激活状态前或可编辑容器变成控件选中区前触发。 onblur 在对象失去输入焦点时触发。 oncellchange 在数据供应者中的数据变更时触发。 onclick 在用户用鼠标左键单击对象时触发。 oncontrolselect 当用户将要对该对象制作一个控件选中区时触发。 ondataavailable 每当异步传输数据的数据源对象的数据到达时触发。 ondatasetchanged 当数据源对象对应的数据集发生变更时触发。 ondatasetcomplete 触发就表明数据源对象所有数据都可用。 ondblclick 当用户双击对象时触发。 ondeactivate 当 activeElement 从当前对象变为父文档其它对象时触发。 ondrag 当进行拖曳操作时在源对象上持续触发。 ondragend 当用户在拖曳操作结束后释放鼠标时在源对象上触发。 ondragenter 当用户拖曳对象到一个合法拖曳目标时在目标元素上触发。 ondragleave 当用户在拖曳操作过程中将鼠标移出合法拖曳目标时在目标对象上触发。 ondragover 当用户拖曳对象划过合法拖曳目标时持续在目标元素上触发。 ondragstart 当用户开始拖曳文本选中区或选中对象时在源对象上触发。 ondrop 当鼠标按钮在拖曳操作过程中释放时在目标对象上触发。 onerror 当对象装载过程中发生错误时触发。 onfocus 当对象获得焦点时触发。 onkeydown 当用户按下键盘按键时触发。 onkeypress 当用户按下字面键时触发。 onkeyup 当用户释放键盘按键时触发。 onlosecapture 当对象失去鼠标捕捉时触发。 onmove 当对象移动时触发。 onmoveend 当对象停止移动时触发。 onmovestart 当对象开始移动时触发。 onpropertychange 当在对象上发生对象上发生属性更改时触发。 onreadystatechange 当对象状态变更时触发。 onresize 当对象的大小将要改变时触发。 onresizeend 当用户更改完控件选中区中对象的尺寸时触发。 onresizestart 当用户开始更改控件选中区中对象的尺寸时触发。 onrowenter 触发就表明当前行已经在数据源中更改,对象上有可用的新数据值。 onrowexit 当数据源控件更改对象当前行前触发。 onrowsdelete 当行将要从记录集中被删除时触发。 onrowsinserted 当在当前记录集中插入新行后触发。 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 事件来模拟单击。 cloneNode 从文档层次中复制对对象的引用。 componentFromPoint 通过特定事件返回对象在指定坐标下的位置。 detachEvent 从事件中取消指定函数的绑定,这样当事件触发时函数就不会收到通知了。 dragDrop 初始化拖曳事件。 fireEvent 触发对象的指定事件。 focus 使得元素得到焦点并执行由 onfocus 事件指定的代码。 getAdjacentText 返回邻接文本字符串。 getAttribute 获取指定标签属性的值。 getAttributeNode 获取由 attribute.name 属性引用的 attribute 对象。 getBoundingClientRect 获取指定 TextRectangle 对象集合绑定的对象。 getClientRects 获取描述对象内容或客户区内布局的矩形集合。每个矩形都描述了一条直线。 getExpression 获取给定属性的表达式。 insertAdjacentElement 在指定位置插入元素。 insertBefore 在文档层次中插入元素。 mergeAttributes 复制所有读/写标签属性到指定元素。 namedRecordset 根据来自于数据源对象(DSO)命名数据成员获取记录集。 normalize 合并邻接 TextNode 对象以便生成一个常规的文档对象模型。 releaseCapture 释放当前文档中对象的鼠标捕捉。 removeAttribute 删除对象的给定标签属性。 removeAttributeNode 从对象中删除删除 attribute 对象。 removeBehavior 分离元素的行为。 removeExpression 从指定属性中删除表达式。 removeNode 从文档层次中删除对象。 replaceAdjacentText 替换元素的邻接文本。 replaceNode 用其它元素替换对象。 scrollIntoView 将对象滚动到可见范围内,将其排列到窗口顶部或底部。 setActive 设置对象为当前对象而不将对象置为焦点。 setAttribute 设置指定标签属性的值。 setAttributeNode 设置 attribute 对象为对象的一部分。 setCapture 设置属于当前文档的对象的鼠标捕捉。 setExpression 设置指定对象的表达式。 swapNode 交换文档层次中两个对象的位置。 对象
对象 描述 currentStyle 代表了在全局样式表、内嵌样式和 HTML 标签属性中指定的对象格式和样式。 runtimeStyle 代表了居于全局样式表、内嵌样式和 HTML 标签属性指定的格式和样式之上的对象的格式和样式。 style 代表了给定元素所有可能的内嵌样式的当前设置。 样式
注释
如果对象因为任何原因创建失败,浏览器将会渲染 OBJECT 元素内的 HTML。这提供了一种便捷方式可通知用户对象装入失败。下面的代码段演示了此技术。
<OBJECT CLASSID="clsid:22D6F312-B0F6-11D0-94AB-0080C74C7E95"> <SPAN STYLE="color:red">ActiveX 控件装入失败! -- 请检查浏览器的安全设置。</SPAN> </OBJECT>OBJECT 元素可能的返回值,即由动态 HTML(DHTML)对象模型属性生成的值取决于对象的实现。例如,若对象无法实现 readyState 属性,则 readyState 属性将返回 null 或错误。对象的 DHTML 对象模型属性的可用与否取决于对象的内容。要获得关于所支持的属性的更多信息,请参看单个对象的文档。
事件是直接发送到 OBJECT 元素的。如果事件由嵌入对象返回,那么该事件将接续触发。如果事件不返回,那么将不接续触发。
OBJECT 的事件处理句柄也可以由脚本定义(参看示例)。
注意 如果对象实现的 DHTML 模型成员与 DHTML 定义的成员冲突的话,你可以使用 object 元素的 object 属性来强制使用由对象实现的成员。例如,如果 object 实现了一个 item 方法,而 DHTML 也有一个 item 方法,请使用 document.all.objectID.object.item() 来访问对象自己定义的该方法。此元素在 Microsoft® Internet Explorer 3.0 的 HTML 中可用,在 Internet Explorer 4.0 的脚本中可用。
此元素是一个内嵌元素。
此元素需要关闭标签。
示例
下面的例子使用了脚本来定义 object 元素的事件处理句柄。
<SCRIPT FOR=oObject EVENT=eEvent> : </SCRIPT> <OBJECT ID=oObject CLASSID="xyz"> </OBJECT>
标准信息
此对象定义在 HTML 4.0 和万维网协会(W3C)文档对象模型(DOM) 级别 1 中。