反应性元素
当你想要创建一个反应性的 WebApp 时, 你需要元素能对不同的输入(attribute/property)做出反应,即重新渲染。
定义
定义具备反应性的 Attribute,使用装饰器 @attribute:
// 省略导入...
@customElement('my-element')
class MyElement extends GemElement {
@attribute firstName;
@template()
#content = () => {
return html`${this.firstName}`;
};
}上述例子中 MyElement 的字段 firstName 被声明成反应性属性,
当属性更改时,MyElement 的已经挂载实例将重新渲染,
此外,该字段映射到元素的 first-name Attribute。
类似 @attribute,GemElement 还提供 numattribute boolattribute 以支持数字和布尔值。而 @property 用来反应指定的 Property:
// 省略导入...
@customElement('my-element')
class MyElement extends GemElement {
@property data;
@template()
#content = () => {
return html`${this.data.id} ${store.name}`;
};
}TIP
- 不要在元素内修改 prop/attr,他们应该由父元素单向传递进来,就像原生元素一样
GemElement扩展自HTMLElement,不要覆盖HTMLElement的 attribute/property/method/event,使用私有字段来避免GemElement/HTMLElement的属性方法被覆盖
另外,Gem 提供了 createState API 来创建元素自身的状态,
创建的状态对象也充当了更新函数,调用时触发元素重新渲染。
例子
initialization...
@customElement('my-element')
class MyElement extends GemElement {
@attribute name;
#state = createState({ count: 1 });
#clicked = () => {
this.#state({ count: ++this.#state.count });
};
@template()
#content = () => {
return html`
<button @click=${this.#clicked}>
${this.name}:
Clicked ${this.#state.count} times
</button>
`;
};
}<my-element name="World"></my-element>
<my-element name="Friend"></my-element>生命周期
使用装饰器在元素的不同阶段执行代码,例如:
// 省略导入...
@customElement('my-element')
class MyElement extends GemElement {
@mounted()
#log = () => {
console.log('element mounted!');
return () => console.log('element unmounted!');
};
}完整的生命周期:
+-------------+ +----------------------+
| constructor | |attr/prop/store update|
+-------------+ +----------------------+
| |
| (@template condition)
| |
+------v-------------------------v------+
| @memo / @willMount |
+---------------------------------------+
| |
| |
+------v-------------------------v------+
| @template |
+---------------------------------------+
| |
| |
+------v-------------------------v------+
| @effect / @mounted / @unmounted |
+---------------------------------------+NOTE
父元素的
constructor和@unmounted先于子元素执行,但@mounted后于子元素执行
