Webkit IDL中自定义[命名]属性的获取(Getter)以及设置(Setter)函数
一、自定义命名属性的获取(Getter)以及设置(Setter)函数:
[CustomNamedGetter](i), [CustomNamedSetter](i)
- 命名属性的W3C链接如下:?The spec of named properties (注意,下面描述的webkit行为和W3C的规范是不同的)
总结: [CustomNamedGetter] 或者 [CustomNamedSetter] 允许你为命名属性的getter或者setter编写自己的绑定函数.
用法如下:
[ CustomNamedGetter, CustomNamedSetter ] interface MichaelNamedGetter { };
当Michael.foooooo被执行时,命名的getters定义了它的行为, 这里的foooooooo不是Michael的属性. 当语句"XXX.foooooooo = ..." 执行时,命名的setter定义了它的行为。[CustomNamedGetter] 和 [CustomNamedSetter] 允许你按照如下方式编写自己的绑定:
- [CustomNamedGetter] in JavaScriptCore: You can write custom JSXXX::canGetItemsForName(...) and JSXXX::nameGetter(...) in WebCore/bindings/js/JSXXXCustom.cpp:
bool JSXXX::canGetItemsForName(ExecState* exec, XXX* impl, const Identifier& propertyName) { ...; } JSValue JSXXX::nameGetter(ExecState* exec, JSValue slotBase, const Identifier& propertyName) { ...; }
- [CustomNamedSetter] in JavaScriptCore: You can write custom JSXXX::putDelegate(...) in WebCore/bindings/js/JSXXXCustom.cpp:
bool JSXXX::putDelegate(ExecState* exec, const Identifier& propertyName, JSValue value, PutPropertySlot& slot) { ...; }
[Custom](m,a), [CustomGetter](a), [CustomSetter](a)
总结: 他们允许你这样编写绑定代码。
用法: [Custom] 可用于函数和属性. [CustomGetter], [CustomSetter]只能用于属性:
[Custom] void func(); [CustomGetter, JSCustomSetter] attribute DOMString str;
我们应该尽可能少的使用自定义的绑定代码,因为他们可能有问题。在考虑使用他们之前,你应该慎重思考:我真的需要自定义绑定代码吗?推荐你修改代码生成器而不是自定义绑定代码。
在解释细节之前,让我澄清这些IDL属性之间的关系。
- [Custom] 修饰于方法,便是你可以编写方法的绑定代码。
- [CustomGetter] or [CustomSetter] 修饰属性,表示你可以为属性的getter、setter编写自己的代码。
举例:
- Method:
interface XXX { [Custom] void func(int a, int b); };
你可以编写绑定代码:WebCore/bindings/js/JSXXXCustom.cpp:
JSValue JSXXX::func(ExecState* exec) { ...; }
参考更多例子:WebCore/bindings/js/JSXXXCustom.cpp
- Attribute getter:
interface XXX { [CustomGetter] attribute DOMString str; };
编写绑定代码: WebCore/bindings/js/JSXXXCustom.cpp:
JSValue JSXXX::str(ExecState* exec) const { ...; }
参考更多例子:WebCore/bindings/js/JSXXXCustom.cpp
- Attribute setter:
interface XXX { [CustomSetter] attribute DOMString str; };
编写绑定代码: WebCore/bindings/js/JSXXXCustom.cpp:
void JSXXX::setStr(ExecState*, JSValue value) { ...; }
注意: ObjC, GObject,CPP 绑定bindings 不支持自己定义的绑定代码.
郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。