HTC基础篇

概述

HTC 指南

在微软(R)Internet Explorer 5中介绍，HTML组件(HTCs)提供一种机制来使用脚本作为动态HTML(DHTML)行为实现组件功能。以.htc扩展名保存，一份HTC是一份包含脚本和一组用于定义组件的HTC特殊元素的HTML文件。此部分包含相关元素和它们支持的成员。

对象
     document                                在给定的浏览器窗口中表现HTML文档。
     element                          返回一份主文档中连接行为的标签的参考。
     PUBLIC:ATTACH                    绑定一个函数到一个事件上，因此每次事件发生在特殊对象上时函数会被调用。
     PUBLIC:COMPONENT   以HTC指明文件的内容。
     PUBLIC:DEFAULTS       设定一份HTC的默认属性。
     PUBLIC:EVENT             定义一个HTC的事件，使之暴露于包含该HTC的文档。
     PUBLIC:METHOD        定义一个HTC的方法，使之暴露于包含该HTC的文档。
     PUBLIC:PROPERTY              定义一个HTC的属性，使之暴露于包含该HTC的文档。

方法
     createEventObject
     创建一个事件对象，当需要传递事件附加信息给PUBLIC:EVENT元素的fire方法时使用。

事件
     oncontentready
     连接了行为的元素的内容完全被解析时发生。
     oncontentsave
     连接了一份元素行为的一个元素的内容被保存或复制前发生。
     ondetach
     从一个元素解除一份行为的连接前发生。
     ondocumentready
     当包含行为的文档完全被解析时发生。

PUBLIC:PROPERTY元素
--------------------------------------------------------------------------------------
定义一个HTC的属性，使之暴露于包含该HTC的文档。

格式
     <PUBLIC:PROPERTY
      GET = "sGetFunction"
      ID = "sPropertyID"
      INTERNALNAME = "sInternalName"
      NAME = "sName"
      PERSIST = "bPersist"
      PUT = "sPutFunction"
      value = "vvalue"
     />

属性
     GET
     可选。指定属性值被获得时调用的函数的字符串。一个只指定了GET属性而没有指定PUT属性的PUBLIC:PROPERTY元素是一个只读属性。
     ID
     可选。组件内PUBLIC:PROPERTY元素的唯一识别字符串。这个属性类似于DHTML中的ID属性。
     INTERNALNAME
     可选。包含文档中指定方法提交的名称的字符串。这个内部的名称必须在组件内任意参考前广泛的关联；否则，一个脚本错误出现，指出名称未定义。如果没有内部的名称被指定，默认情况下使用NAME属性。
     NAME
     必选。指定暴露给包含文档的属性的名称的字符串。默认情况下，NAME的指定也用于组件内属性的提交，除非INTERNALNAME属性被指定。
     PERSIST
     可选。指定是否坚持属性作为叶面的部分的布尔值。
     PUT
     可选。指定属性值被设定时调用的函数的字符串。一个指定了GET和PUT属性的PUBLIC:PROPERTY元素是一个读写属性。一个PUT函数被指定，而指定GET函数指定失败，会导致该属性只可写，一般来说这是不希望出现的。
     value
     可选。指定属性默认值的变量。

方法
     propertyID.fireChange()
     通报包含文档属性值在元素上发生onpropertychange事件时被改变。如果属性没有PUT属性被指定，在包含文档中属性被设定时onpropertychange会自动发生。

元素信息
     父级元素：     PUBLIC:COMPONENT
     子级元素：　　无

 备注
     当指定NAME属性与一个已经为该元素定义的标准方法的名称相同时，一个行为可以重载元素的默认行为。
     如果PUT或GET属性被指定，INTERNALNAME属性被忽略。通过在PUT和GET属性中指定的函数来设定与/或获得属性值，优先级高于通过INTERNALNAME设定和/或获得属性值。
     PUT属性指定的函数必须注意包含文档中的元素使用PUBLIC:PROPERTY元素的fireChange方法改变属性值的情况。调用这个方法导致onpropertychange事件发生在包含文档的相应元素，同时event对象的propertyName设定为属性的名称。

 

[2] 对象

PUBLIC:METHOD元素
--------------------------------------------------------------------------------------
定义一个HTC的方法，使之暴露于包含该HTC的文档。

格式
     <PUBLIC:METHOD
      ID = "sID"
      INTERNALNAME = "sInternalName"
      NAME = "sName"
     />

属性
     ID
     可选。组件内PUBLIC:METHOD元素的唯一识别字符串。这个属性类似于DHTML中的ID属性。
     INTERNALNAME
     可选。包含文档中指定方法提交的名称的字符串。默认情况下，NAME也指定提交到组件内的方法，除非INTERNALNAME属性被指定。

元素信息
     父级元素
     PUBLIC:COMPONENT
     子级元素
     无
     最小运行环境
  备注
     当指定NAME属性与一个已经为该元素定义的标准方法的名称相同时，一个行为可以重载元素的默认行为。

PUBLIC:EVENT元素
--------------------------------------------------------------------------------------
定义一个HTC的事件，使之暴露于包含该HTC的文档。

格式
     <PUBLIC:EVENT
      ID = "sEventID"
      NAME = "sName"
     />

属性
     ID
     可选。组件内PUBLIC:EVENT元素的唯一识别字符串。这个属性类似于DHTML中的ID属性。
     NAME
     必选。指定主文档中提交的事件的名称的字符串。

方法
     eventID.fire([oEvent])
     包含的文档发生事件。
     这个方法有下面的参数：
           oEvent
           指定event对象包含的附加信息的对象。

元素信息
     父级元素
     PUBLIC:COMPONENT
     子级元素
     无
 备注
     通过指定一个NAME属性，类似于一个已经为元素定义的标准事件，一个行为可以重载元素默认的行为。
     行为定义的事件不起泡。它们只发生在连接了行为的元素上。

PUBLIC:DEFAULTS元素
--------------------------------------------------------------------------------------
设定一份HTC的默认属性。

格式
     <PUBLIC:DEFAULTS
      canHaveHTML = "bCanHaveHTML"
      contentEditable = "bEditable"
      style = "sStyle"
      tabStop = "bIsTabStop"
      viewInheritStyle = "bInheritsStyle"
      viewLinkContent = "bViewLinkContent"
      viewMasterTab = "bViewMasterTab"
     />

属性
     canHaveHTML
     可选。指定为下列之中一个的布尔值。
           false
           HTC文件定义的标签的内容不能包含HTML标签。
           true
           HTC文件定义的标签的内容可以包含HTML标签。
     contentEditable
     可选。指定为下列之中一个的布尔值。
           inherit
           默认值。对象从它的父级继承内容被用户编辑的能力。
           false
           HTC文件定义的标签的内容不能编辑。
           true
           HTC文件定义的标签的内容可以编辑。
     style
     可选。指定HTC文件定义的标签的样式字符串。
     tabStop
     可选。指定为下列之中一个的布尔值。
           false
           默认值。HTC文件定义的标签不可被TAB选择激活。
           true
           HTC文件定义的标签可以被TAB选择激活。
     viewInheritStyle
     可选。指定为下列之中一个的布尔值。
           false
           Viewlink不从主HTML文件中继承样式。
           true
           默认值。Viewlink从主HTML文件中继承样式。
     viewLinkContent
     可选。指定为下列之中一个的布尔值。
           false
           默认值。HTC文件的文档中标签不作为viewlink使用。
           true
           HTC文件的文档中标签作为viewlink使用。
     viewMasterTab
     可选。指定为下列之中一个的布尔值。
           false
           viewlink的主元素不包含在主文档的TAB序列中。
           true
           默认值。viewlink的主元素包含在主文档的TAB序列中。

元素信息
     父级元素
     PUBLIC:COMPONENT
     子级元素
     无 

[3]对象

PUBLIC:COMPONENT元素
--------------------------------------------------------------------------------------
以HTC指明文件的内容。

微软Internet Explorer 6中的新内容
literalContent属性作为一个新的可能值支持嵌套，创建一份嵌套的文字内容元素行为。

格式
     <PUBLIC:COMPONENT
      ID = "sID"
      lightWeight = "bLight"
      literalContent = "sLiteral"
      NAME = "sName"
      supportsEditMode = "bEditable"
      tagName = "sTagName"
      URN = "sURN"
     >
     <!-- 子级元素 -->
     </PUBLIC:COMPONENT>

属性
     ID
     可选。组件内PUBLIC:COMPONENT元素的唯一识别字符串。这个属性类似于DHTML中的ID属性。
     lightWeight
     可选。指定HTC文件是否包含标签的字符串。如果HTC文件不包含标签，这个属性应当设置为true来改进表现效果。这个属性对任何HTC文件均有效。
           true
           HTC文件不包含标签，因而无需每次都解析并表现自定义标签。这些标签由HTC文件定义，在主文档中使用。
           false
           默认值。HTC包含必需解析并表现的自定义标签。这些标签由HTC文件定义，在主文档中使用。
     literalContent
     可选。指定自定义标签包含的内容是被解析并表现，还是作为数据岛处理的字符串。这个属性仅在HTC文件定义一个元素行为时有效，此时需要使用tagName属性。更多信息请查阅备注。
           false
           默认值。由tagName属性定义的标签内的文本和标签并作为数据岛处理，而是解析并表现。
           nested
           Internet Explorer 6及后继版本。Content within the first opening and last closing of the tag defined by the tagName attribute is treated as a data island and is not parsed or rendered.更多信息请查阅使用literalContent属性。
           true
           Content within the first opening and last closing of the tag defined by the tagName attribute is treated as a data island and is not parsed or rendered.
     NAME
     可选。指定主文档中提交的行为的名称的字符串。
     supportEditMode
     可选。指定HTC文件内容是否可编辑的字符串。这个属性仅在HTC文件定义一个元素行为时有效。
           true
           HTC文件包含的标签可编辑。
           false
           默认值。HTC文件包含的标签不可编辑。你能够通过对HTC文件中每个元素设定isContentEditable属性为VARIANT_TRUE来重载此属性值。
     tagName
     可选。指定自定义标签名称的字符串，此标签由HTC文件定义并导入到主文档中。这个属性仅在HTC文件定义一个元素行为时有效。更多信息请查阅备注。
     URN
     可选。字符串，以统一资源名称(URN)格式，从而唯一识别此组件。因而在多个行为发生在同一名称的事件时可以唯一的识别。当事件发生，event对象的srcUrn属性被设定为发生在事件上行为的URN。

元素信息
     子级元素
           至多出现一次
           PUBLIC:DEFAULTS
           一或多次出现
           PUBLIC:ATTACH，PUBLIC:EVENT，PUBLIC:METHOD，PUBLIC:PROPERTY
 备注
     PUBLIC:COMPONENT元素可以定义两种截然不同类型的行为。一种是连接行为，使用behavior层叠样式表(CSS)属性来修改一个已经存在的元素的行为。第二种类型，在Internet Explorer 5.5 中介绍，被称作一个元素行为。一个元素行为用来定义如标准的HTML标签一样在网页中使用的自定义标签。
     一个元素行为意味着网页中一个自定义标签的创建和使用。因此，当HTC文件定义一个元素行为时有必要定义PUBLIC:COMPONENT元素的tagName属性。如先前指出的，此元素的部分属性为元素行为特别设计。更多信息清查询元素行为。
     当多个行为连接到同一元素时，NAME属性特别有用。因为它允许你调用包含文档中需要的行为的属性和方法。如果在一份文档中多个行为被连接到一个<SPAN ID="mySpan">元素，你可以使用下面的格式来设定命名为behaviorABC的行为的delay属性。
     mySpan.behaviorABC.delay = 1000;

 

 

PUBLIC:ATTACH元素
--------------------------------------------------------------------------------------
绑定一个函数到一个事件上，因此每次事件发生在特殊对象上时函数会被调用。

格式
     <PUBLIC:ATTACH
      EVENT = "sEvent"
      FOR = "sObject"
      ID = "sID"
     ONEVENT = "sEventHandler"
     />

属性
     EVENT
     必选。指定一个动态HTML(DHTML)事件、或任何在HTC参考中列举出的由HTML组件(HTC)指定事件的字符串。
     FOR
     可选。指定为下面值中一个的字符串，用来识别事件源。
           document
           引用document对象。
           element
           默认值。引用行为连接的元素。
           window
           引用window对象。
     ID
     可选。组件内PUBLIC:ATTACH元素的唯一识别字符串。这个属性类似于DHTML中的ID属性。
     ONEVENT
     必选。事件处理函数的直接声明或一份行内脚本的指定字符串。

元素信息
     父级元素
     PUBLIC:COMPONENT
     子级元素
     无
  备注
     PUBLIC:ATTACH元素是attachEvent方法的一份声明。
     当指定的事件发生在连接了行为的元素时，首先调用的是元素的事件处理部分，且在行为的事件处理前。如果多个行为被连接到一个元素，同时多个事件处理部分定义在同一元素的同一事件上，函数在元素事件处理部分调用后会随机地被调用。
     当为ONEVENT提供一个值时，避免赋予事件处理部分函数一个已经存在的DHTML事件的名称。使用一个已经存在的DHTML事件的名称可能会递归错误。
     事件的名称对所有脚本语言都是大小写敏感的。

[4]方法

ondocumentready事件
--------------------------------------------------------------------------------------
当包含行为的文档完全被解析时发生。

格式
     <PUBLIC:ATTACH
      EVENT = ondocumentready
      ONEVENT = sEventHandler
      FOR = element
      ID = sID
     />

属性
     EVENT
     必选。指定一个动态HTML(DHTML)事件、或任何在HTC参考中列举出的由HTML组件(HTC)指定事件的字符串。
     FOR
     可选。指定为下面值中一个的字符串，用来识别事件源。
           document
           引用document对象。
           element
           默认值。引用行为连接的元素。
           window
           引用window对象。
     ID
     可选。组件内PUBLIC:ATTACH元素的唯一识别字符串。这个属性类似于DHTML中的ID属性。
     ONEVENT
     必选。事件处理函数的直接声明或一份行内脚本的指定字符串。

备注
     一份连接到元素的行为会接收ondocumentready和oncontentready的通告，但仅在window.onload事件发生之后。
     关于在一份HTC文件和其主文档初始化过程中事件发生的总体看法，请参阅组件初始化。

ondetach事件
--------------------------------------------------------------------------------------
从一个元素解除一份行为的连接前发生。

格式
     <PUBLIC:ATTACH
      EVENT = ondetach
      ONEVENT = sEventHandler
      FOR = element
      ID = sID
     />

属性
     EVENT
     必选。指定一个动态HTML(DHTML)事件、或任何在HTC参考中列举出的由HTML组件(HTC)指定事件的字符串。
     FOR
     可选。指定为下面值中一个的字符串，用来识别事件源。
           document
           引用document对象。
           element
           默认值。引用行为连接的元素。
           window
           引用window对象。
     ID
     可选。组件内PUBLIC:ATTACH元素的唯一识别字符串。这个属性类似于DHTML中的ID属性。
     ONEVENT
     必选。事件处理函数的直接声明或一份行内脚本的指定字符串。

备注
     ondetach事件允许行为在它从元素完全解除连接前实行一些清除工作。
     当使用attachEvent方法连接一个行为到包含叶面的事件时，这个事件允许行为调用detachEvent方法来停止获取来自叶面的通告。使用PUBLIC:ATTACH元素连接一个行为到叶面上的时间时，行为会在将它从元素解除连接时自动停止获取通告，而不需要在ondetach事件发生时使用detachEvent方法。

oncontentsave事件
--------------------------------------------------------------------------------------
连接了一份元素行为的一个元素的内容被保存或复制前发生。

格式
     <PUBLIC:ATTACH
      EVENT = oncontentsave
      ONEVENT = sEventHandler
      FOR = element
      ID = sID
     />

属性
     EVENT
     必选。指定一个动态HTML(DHTML)事件、或任何在HTC参考中列举出的由HTML组件(HTC)指定事件的字符串。
     FOR
     可选。指定为下面值中一个的字符串，用来识别事件源。
           document
           引用document对象。
           element
           默认值。引用行为连接的元素。
           window
           引用window对象。
     ID
     可选。组件内PUBLIC:ATTACH元素的唯一识别字符串。这个属性类似于DHTML中的ID属性。
     ONEVENT
     必选。事件处理函数的直接声明或一份行内脚本的指定字符串。

 

 

oncontentready事件
--------------------------------------------------------------------------------------
连接了行为的元素的内容完全被解析时发生。

格式
     <PUBLIC:ATTACH
      EVENT = oncontentready
      ONEVENT = sEventHandler
      FOR = element
      ID = sID
     />

属性
     EVENT
     必选。指定一个动态HTML(DHTML)事件、或任何在HTC参考中列举出的由HTML组件(HTC)指定事件的字符串。
     FOR
     可选。指定为下面值中一个的字符串，用来识别事件源。
           document
           引用document对象。
           element
           默认值。引用行为连接的元素。
           window
           引用window对象。
     ID
     可选。组件内PUBLIC:ATTACH元素的唯一识别字符串。这个属性类似于DHTML中的ID属性。
     ONEVENT
     必选。事件处理函数的直接声明或一份行内脚本的指定字符串。

备注
     在事件发生前，该元素的innerHTML属性可能无法返回正确的值。
     当事件发生且PUBLIC:COMPONENT元素的literalContent属性为真时，元素行为的文字内容已被存储在innerHTML属性中。这个事件指出元素行为可以访问innerHTML属性。
     因为这个事件仅对HTC组件有效，绑定oncontentready事件的唯一方法是使用PUBLIC:ATTACH元素。attachEvent因为只对标准DHTML事件工作而无法绑定此事件。当一份HTC文件作为Viewlink实现时，oncontentready事件，或其他任何HTC专用事件，在文档片断中无法连接到元素上。
     关于在一份HTC文件和其主文档初始化过程中事件发生的总体看法，请参阅组件初始化。