-
1
-
2
-
3
-
4
-
5
-
6
-
7
-
8
-
9
-
10
-
11
-
12
-
13
-
14
-
15
-
16
-
17
-
18
-
19
-
20
-
21
-
22
-
23
-
24
-
25
-
26
-
27
-
28
-
29
-
30
-
31
-
32
-
33
-
34
-
35
-
36
-
37
-
38
-
39
-
40
-
41
-
42
-
43
-
44
-
45
-
46
-
47
-
48
-
49
-
50
-
51
-
52
-
53
-
54
-
55
-
56
-
57
-
58
-
59
-
60
-
61
-
62
-
63
-
64
-
65
-
66
-
67
-
68
-
69
-
70
-
71
-
72
-
73
-
74
-
75
-
76
-
77
-
78
-
79
-
80
-
81
-
82
-
83
-
84
-
85
-
86
-
87
-
88
-
89
-
90
-
91
-
92
-
93
-
94
-
95
-
96
-
97
-
98
-
99
-
100
-
101
-
102
-
103
-
104
-
105
-
106
-
107
// SPDX-FileCopyrightText: 2024 Shota FUJI <pockawoooh@gmail.com>
// SPDX-License-Identifier: AGPL-3.0-only
export interface UIComponent<
TagName extends string,
Element extends typeof YamoriElement,
> {
readonly tagName: TagName;
readonly constructor: Element;
register(): boolean;
}
export interface UIComponentBuilder<
TagName extends string,
Element extends typeof YamoriElement,
> {
readonly tagName: TagName;
readonly constructor: Element;
readonly dependencies?: readonly UIComponent<string, typeof YamoriElement>[];
}
/**
* CustomElement を使いやすい I/F にラップする。
* 渡された CustomElement は自動的に `nonUAMixin` が適用され、
* `:is(:state(nonua), [x--_nonua])` でクエリできるようになる。
*/
export function wrapElement<
TagName extends string,
Element extends typeof YamoriElement,
>({
tagName,
constructor,
dependencies = [],
}: UIComponentBuilder<TagName, Element>): UIComponent<TagName, Element> {
return {
tagName,
constructor,
register() {
for (const dependency of dependencies) {
dependency.register();
}
if (customElements.get(tagName)) {
return false;
}
customElements.define(tagName, constructor);
return true;
},
};
}
/**
* このプロジェクトで定義する全ての CustomElement の基底クラス。
*
* CSS では未だにビルトインのタグとユーザ定義のタグをセレクトできず、また UA のスタイルを
* 無効化する仕様も存在しない。そのため、UA が勝手に定義したスタイルを削除するためには、
* 1. Custom Element に識別用のマーカーを設定
* 2. マーカーのついていないものを全てリセット
* とするしかない。この手法だと 3rd party の要素までもリセットされてしまうが、
* このプロジェクトにおいては 3rd party の Custom Element は利用しないためこの手法で
* 問題はない。
*
* 付与するマーカーは以下の通り:
*
* A) CustomStateSet の `nonua` ステート (Evergreen Browser)
* B) `x--_nonua` 属性
*
* 全てのマーカーに対応するには以下のようなセレクタが必要。
*
* ```css
* :is(:state(nonua), [x--_nonua])
* ```
*/
export class YamoriElement extends HTMLElement {
internals: ElementInternals;
setCustomState(name: string): void {
const internals = this.internals;
try {
internals.states.add(name);
} catch {
this.setAttribute(`x--_${name}`, "");
}
}
removeCustomState(name: string): void {
const internals = this.internals;
try {
internals.states.delete(name);
} catch {
this.removeAttribute(`x--_${name}`);
}
}
constructor() {
super();
this.internals = this.attachInternals();
}
connectedCallback() {
this.setCustomState("nonua");
}
}