# Bone Flow #020 Label - HTML Class Guide

Version: 1.0.61

## 1. 目的

このClassはJavaScriptの `class {}` ではありません。HTML要素の `class=""` に機能Classを設定し、対応Public APIを宣言的に呼び出すためのClass契約です。

Public API function **26件 = HTML Class 26件** を1対1で対応させます。

## 2. Class共通引数契約

- `class="bone-..."`: 対応するPublic APIを指定。
- `data-bone-event`: `load` / `click` / `input` / `change` / `manual` 等。未指定は `load`。
- `data-bone-args`: Public APIの順番に並べたJSON配列。
- `data-bone-arg-N`: 0始まりの引数個別指定。
- `data-bone-once="true"`: DOMイベントを1回だけ処理。
- `data-bone-append-result="false"`: Element戻り値の自動appendを停止。
- `data-bone-throw="true"`: Error保存後にDebug用再throw。

### 特殊値

- `$self`: Classを設定したHTML要素そのものを渡します。element / target / root などの第1引数に使用します。
- `$event`: Class起動の原因になったDOM Eventを渡します。click / input / change等のイベント情報が必要なAPI用です。
- `$value`: input / textarea / select等の現在の value を渡します。
- `$checked`: checkbox / radio等の現在の checked(Boolean)を渡します。
- `$text`: Classを設定した要素の textContent を渡します。
- `$dataset`: Classを設定した要素の dataset を通常Objectとして渡します。
- `$files`: file input の FileList を渡します。
- `$selector:...`: ...をCSS selectorとして document.querySelector() で解決し、そのElementを渡します。
- `$id:...`: ...をDOM idとして document.getElementById() で解決し、そのElementを渡します。
- `$global:...`: window / globalThis上の指定名の値を渡します。
- `$handler:...`: window / globalThis上の指定名のFunctionをコールバック引数として渡します。

## 3. Result / State 契約

- `element.__boneClassResult`: 生の戻り値。
- `data-bone-class-status`: `ok` / `error`。
- `data-bone-class-result`: serializeした結果。
- `bone-html-class-result`: 成功CustomEvent。
- `bone-html-class-error`: 失敗CustomEvent。

## 4. Class一覧

### 1. `bone-label-defaults`

- Public API: `BoneLabel.defaults`
- 説明: BoneLabel.defaults の公開機能をHTML Classから呼び出します。
- 使用する場面: HTMLの class と data-bone-* 属性だけで対応Public APIを呼び出したいとき。
- 引数:
  - 引数なし
- HTML例:

```html
<div class="bone-label-defaults" data-bone-event="manual"></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 2. `bone-label-normalize-value`

- Public API: `BoneLabel.normalizeValue`
- 説明: 値をLabelの正式契約に沿う形へ正規化します。
- 使用する場面: HTMLの class と data-bone-* 属性だけで対応Public APIを呼び出したいとき。
- 引数:
  - `0: input` — API定義値 — `data-bone-arg-0` または `data-bone-args[0]`
- HTML例:

```html
<div class="bone-label-normalize-value" data-bone-event="manual" data-bone-args='[null]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 3. `bone-label-validate-value`

- Public API: `BoneLabel.validateValue`
- 説明: Labelの入力・状態を検証し、Validation結果を返します。
- 使用する場面: HTMLイベントから検証・解析を実行し、その結果をResultとして受け取りたいとき。
- 引数:
  - `0: input` — API定義値 — `data-bone-arg-0` または `data-bone-args[0]`
- HTML例:

```html
<div class="bone-label-validate-value" data-bone-event="manual" data-bone-args='[null]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 4. `bone-label-build-input`

- Public API: `BoneLabel.buildInput`
- 説明: Labelで使用する出力・定義オブジェクトを構築します。
- 使用する場面: HTMLの class と data-bone-* 属性だけで対応Public APIを呼び出したいとき。
- 引数:
  - `0: input` — API定義値 — `data-bone-arg-0` または `data-bone-args[0]`
- HTML例:

```html
<div class="bone-label-build-input" data-bone-event="manual" data-bone-args='[null]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 5. `bone-label-build-output`

- Public API: `BoneLabel.buildOutput`
- 説明: Labelで使用する出力・定義オブジェクトを構築します。
- 使用する場面: HTMLの class と data-bone-* 属性だけで対応Public APIを呼び出したいとき。
- 引数:
  - `0: input` — API定義値 — `data-bone-arg-0` または `data-bone-args[0]`
- HTML例:

```html
<div class="bone-label-build-output" data-bone-event="manual" data-bone-args='[null]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 6. `bone-label-render-output`

- Public API: `BoneLabel.renderOutput`
- 説明: 指定先へLabelの表示を描画・更新します。
- 使用する場面: HTML上のホスト要素からUI生成・描画を開始したいとき。
- 引数:
  - `0: receiverElement` — Element / Instance — `data-bone-arg-0` または `data-bone-args[0]`
  - `1: output` — API定義値 — `data-bone-arg-1` または `data-bone-args[1]`
- HTML例:

```html
<div class="bone-label-render-output" data-bone-event="manual" data-bone-args='[null,null]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 7. `bone-label-create`

- Public API: `BoneLabel.create`
- 説明: Labelの新しい要素またはRuntimeオブジェクトを生成します。
- 使用する場面: HTML上のホスト要素からUI生成・描画を開始したいとき。
- 引数:
  - `0: input` — API定義値 — `data-bone-arg-0` または `data-bone-args[0]`
- HTML例:

```html
<div class="bone-label-create" data-bone-event="manual" data-bone-args='[null]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 8. `bone-label-attach-to-parent`

- Public API: `BoneLabel.attachToParent`
- 説明: BoneLabel.attachToParent の公開機能をHTML Classから呼び出します。
- 使用する場面: HTMLの class と data-bone-* 属性だけで対応Public APIを呼び出したいとき。
- 引数:
  - `0: parentElement` — Element / Instance — `data-bone-arg-0` または `data-bone-args[0]`
  - `1: input` — API定義値 — `data-bone-arg-1` または `data-bone-args[1]`
- HTML例:

```html
<div class="bone-label-attach-to-parent" data-bone-event="manual" data-bone-args='["$self",null]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 9. `bone-label-play-effect`

- Public API: `BoneLabel.playEffect`
- 説明: BoneLabel.playEffect の公開機能をHTML Classから呼び出します。
- 使用する場面: HTMLの class と data-bone-* 属性だけで対応Public APIを呼び出したいとき。
- 引数:
  - `0: element` — Element / Instance — `data-bone-arg-0` または `data-bone-args[0]`
- HTML例:

```html
<div class="bone-label-play-effect" data-bone-event="manual" data-bone-args='["$self"]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 10. `bone-label-distribute-labels`

- Public API: `BoneLabel.distributeLabels`
- 説明: BoneLabel.distributeLabels の公開機能をHTML Classから呼び出します。
- 使用する場面: HTMLの class と data-bone-* 属性だけで対応Public APIを呼び出したいとき。
- 引数:
  - `0: parentElement` — Element / Instance — `data-bone-arg-0` または `data-bone-args[0]`
  - `1: inputs` — API定義値 — `data-bone-arg-1` または `data-bone-args[1]`
  - `2: options` — Object — `data-bone-arg-2` または `data-bone-args[2]`
- HTML例:

```html
<div class="bone-label-distribute-labels" data-bone-event="manual" data-bone-args='["$self",null,{}]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 11. `bone-label-get-input`

- Public API: `BoneLabel.getInput`
- 説明: Labelの「Input」を取得します。
- 使用する場面: JavaScriptを直接記述せず、HTML要素から現在値・状態・一覧を取得したいとき。
- 引数:
  - `0: element` — Element / Instance — `data-bone-arg-0` または `data-bone-args[0]`
- HTML例:

```html
<div class="bone-label-get-input" data-bone-event="manual" data-bone-args='["$self"]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 12. `bone-label-get-output`

- Public API: `BoneLabel.getOutput`
- 説明: Labelの「Output」を取得します。
- 使用する場面: JavaScriptを直接記述せず、HTML要素から現在値・状態・一覧を取得したいとき。
- 引数:
  - `0: element` — Element / Instance — `data-bone-arg-0` または `data-bone-args[0]`
- HTML例:

```html
<div class="bone-label-get-output" data-bone-event="manual" data-bone-args='["$self"]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 13. `bone-label-get-state`

- Public API: `BoneLabel.getState`
- 説明: Labelの「State」を取得します。
- 使用する場面: JavaScriptを直接記述せず、HTML要素から現在値・状態・一覧を取得したいとき。
- 引数:
  - `0: element` — Element / Instance — `data-bone-arg-0` または `data-bone-args[0]`
- HTML例:

```html
<div class="bone-label-get-state" data-bone-event="manual" data-bone-args='["$self"]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 14. `bone-label-is-instance`

- Public API: `BoneLabel.isInstance`
- 説明: 対象がLabelの「Instance」条件を満たすか判定します。
- 使用する場面: JavaScriptを直接記述せず、HTML要素から現在値・状態・一覧を取得したいとき。
- 引数:
  - `0: element` — Element / Instance — `data-bone-arg-0` または `data-bone-args[0]`
- HTML例:

```html
<div class="bone-label-is-instance" data-bone-event="manual" data-bone-args='["$self"]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 15. `bone-label-create-instance`

- Public API: `BoneLabel.createInstance`
- 説明: Labelの新しい要素またはRuntimeオブジェクトを生成します。
- 使用する場面: HTML上のホスト要素からUI生成・描画を開始したいとき。
- 引数:
  - `0: input` — API定義値 — `data-bone-arg-0` または `data-bone-args[0]`
  - `1: options` — Object — `data-bone-arg-1` または `data-bone-args[1]`
- HTML例:

```html
<div class="bone-label-create-instance" data-bone-event="manual" data-bone-args='[null,{}]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 16. `bone-label-attach-instance`

- Public API: `BoneLabel.attachInstance`
- 説明: BoneLabel.attachInstance の公開機能をHTML Classから呼び出します。
- 使用する場面: HTMLの class と data-bone-* 属性だけで対応Public APIを呼び出したいとき。
- 引数:
  - `0: parentElement` — Element / Instance — `data-bone-arg-0` または `data-bone-args[0]`
  - `1: input` — API定義値 — `data-bone-arg-1` または `data-bone-args[1]`
  - `2: options` — Object — `data-bone-arg-2` または `data-bone-args[2]`
- HTML例:

```html
<div class="bone-label-attach-instance" data-bone-event="manual" data-bone-args='["$self",null,{}]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 17. `bone-label-get-instance`

- Public API: `BoneLabel.getInstance`
- 説明: Labelの「Instance」を取得します。
- 使用する場面: JavaScriptを直接記述せず、HTML要素から現在値・状態・一覧を取得したいとき。
- 引数:
  - `0: element` — Element / Instance — `data-bone-arg-0` または `data-bone-args[0]`
- HTML例:

```html
<div class="bone-label-get-instance" data-bone-event="manual" data-bone-args='["$self"]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 18. `bone-label-get-class-list`

- Public API: `BoneLabel.getClassList`
- 説明: Labelの「Class List」を取得します。
- 使用する場面: JavaScriptを直接記述せず、HTML要素から現在値・状態・一覧を取得したいとき。
- 引数:
  - 引数なし
- HTML例:

```html
<div class="bone-label-get-class-list" data-bone-event="manual"></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 19. `bone-label-get-completion-state`

- Public API: `BoneLabel.getCompletionState`
- 説明: Labelの「Completion State」を取得します。
- 使用する場面: JavaScriptを直接記述せず、HTML要素から現在値・状態・一覧を取得したいとき。
- 引数:
  - 引数なし
- HTML例:

```html
<div class="bone-label-get-completion-state" data-bone-event="manual"></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 20. `bone-label-get-animation-state`

- Public API: `BoneLabel.getAnimationState`
- 説明: Labelの「Animation State」を取得します。
- 使用する場面: JavaScriptを直接記述せず、HTML要素から現在値・状態・一覧を取得したいとき。
- 引数:
  - `0: element` — Element / Instance — `data-bone-arg-0` または `data-bone-args[0]`
- HTML例:

```html
<div class="bone-label-get-animation-state" data-bone-event="manual" data-bone-args='["$self"]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 21. `bone-label-get-animation-output`

- Public API: `BoneLabel.getAnimationOutput`
- 説明: Labelの「Animation Output」を取得します。
- 使用する場面: JavaScriptを直接記述せず、HTML要素から現在値・状態・一覧を取得したいとき。
- 引数:
  - `0: element` — Element / Instance — `data-bone-arg-0` または `data-bone-args[0]`
- HTML例:

```html
<div class="bone-label-get-animation-output" data-bone-event="manual" data-bone-args='["$self"]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 22. `bone-label-get-animation-dependency`

- Public API: `BoneLabel.getAnimationDependency`
- 説明: Labelの「Animation Dependency」を取得します。
- 使用する場面: JavaScriptを直接記述せず、HTML要素から現在値・状態・一覧を取得したいとき。
- 引数:
  - 引数なし
- HTML例:

```html
<div class="bone-label-get-animation-dependency" data-bone-event="manual"></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 23. `bone-label-get-hover-border-effect-state`

- Public API: `BoneLabel.getHoverBorderEffectState`
- 説明: Labelの「Hover Border Effect State」を取得します。
- 使用する場面: JavaScriptを直接記述せず、HTML要素から現在値・状態・一覧を取得したいとき。
- 引数:
  - `0: element` — Element / Instance — `data-bone-arg-0` または `data-bone-args[0]`
- HTML例:

```html
<div class="bone-label-get-hover-border-effect-state" data-bone-event="manual" data-bone-args='["$self"]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 24. `bone-label-refresh-hover-border-effect`

- Public API: `BoneLabel.refreshHoverBorderEffect`
- 説明: Labelの表示・接続・状態を現在値から再計算します。
- 使用する場面: HTMLの class と data-bone-* 属性だけで対応Public APIを呼び出したいとき。
- 引数:
  - `0: element` — Element / Instance — `data-bone-arg-0` または `data-bone-args[0]`
- HTML例:

```html
<div class="bone-label-refresh-hover-border-effect" data-bone-event="manual" data-bone-args='["$self"]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 25. `bone-label-complete`

- Public API: `BoneLabel.complete`
- 説明: LabelのCompletion状態を確定します。
- 使用する場面: HTMLの class と data-bone-* 属性だけで対応Public APIを呼び出したいとき。
- 引数:
  - `0: validation` — String / API許容値 — `data-bone-arg-0` または `data-bone-args[0]`
- HTML例:

```html
<div class="bone-label-complete" data-bone-event="manual" data-bone-args='[null]'></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。

### 26. `bone-label-reopen`

- Public API: `BoneLabel.reopen`
- 説明: LabelのCompletion確定を解除して再編集可能にします。
- 使用する場面: HTMLの class と data-bone-* 属性だけで対応Public APIを呼び出したいとき。
- 引数:
  - 引数なし
- HTML例:

```html
<div class="bone-label-reopen" data-bone-event="manual"></div>
```

- Result: `__boneClassResult` / `data-bone-class-status` / `data-bone-class-result`。


## Safe activation marker

HTML Functional Class is active only when `bone-html-class-use` is present together with the API class. Example: `class="bone-html-class-use bone-..."`. This prevents existing presentation classes from being executed as APIs.