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设定为属性的名称。
public:method元素
--------------------------------------------------------------------------------------
定义一个htc的方法,使之暴露于包含该htc的文档。
格式
<public:method
id = "sid"
internalname = "sinternalname"
name = "sname"
/>