bricks/docs/ja/widget.md
2025-11-19 12:30:39 +08:00

201 lines
7.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# ツールチップ
**コントロール機能**:マウスオーバー時に表示されるヒント情報を示す、フローティングテキストコントロールです。
**タイプ**:通常コントロール
**親クラスコントロール**`bricks.Text`
## 初期化パラメータ
| パラメータ名 | 型 | 説明 |
|--------------|-----|------|
| `otext` | String | 表示する元のテキスト内容。国際化をサポート |
| `rate` | Number | フォントサイズの拡大縮小比率。デフォルトは `0.8` |
| `tip` | null | `null` に固定され、tooltip の継承動作を防止 |
> 注:`Tooltip` は生成時に自動的に `rate=0.8` を設定し、「modal」CSS クラスを追加します。最小幅は `90px` に設定されます。
## 主なイベント
| イベント名 | 発火タイミング | 引数 |
|------------|----------------|-------|
| カスタムイベントなし | —— | —— |
> `Tooltip` 自体はカスタムイベントを発行しませんが、`show(otext, event)` および `hide()` メソッドにより表示・非表示を制御できます。
---
# Textテキスト
**コントロール機能**:基本的なテキスト表示コントロール。中央揃えや、文字サイズに応じたフォントサイズの動的調整に対応。
**タイプ**:通常コントロール
**親クラスコントロール**`bricks.TextBase`
## 初期化パラメータ
| パラメータ名 | 型 | 説明 |
|--------------|-----|------|
| `text` | String | 表示するテキスト内容 |
| `otext` | String | 国際化対応用の元テキスト |
| `i18n` | Boolean | 国際化を有効にするかどうか。デフォルトは無効 |
| `halign` | String | 水平方向の配置:`left``center``right`(デフォルトは `center` |
| `valign` | String | 垂直方向の配置:`top``center``bottom`(デフォルトは `center` |
| `wrap` | Boolean | 折り返しを許可するかどうか |
| `css` | String | カスタムCSSクラス名 |
| `rate` | Number | フォントサイズの拡大縮小係数。デフォルトは `1` |
> フォントサイズはグローバルな `bricks.app.charsize` に基づいて動的に調整され、初期値 `cfontsize = 1` です。
## 主なイベント
| イベント名 | 発火タイミング | 引数 |
|------------|----------------|-------|
| 無し | `Text` は静的コントロールであり、インタラクションイベントを発生させない | —— |
---
# KeyinTextキー入力テキスト
**コントロール機能**:テキスト入力可能なコントロール。キーボードイベントを監視して表示内容を動的に更新。簡易的な入力シーンに適しています。
**タイプ**:通常コントロール
**親クラスコントロール**`bricks.Text`
## 初期化パラメータ
| パラメータ名 | 型 | 説明 |
|--------------|-----|------|
| `name` | String | データフィールド名。デフォルトは `'data'``changed` イベントの出力キー名として使用 |
| その他のパラメータは `Text` から継承 | —— | `Text` のすべてのパラメータをサポート |
> グローバルな `keydown` イベントに自動バインドされ、アルファベット、数字、Enterキーなどの単一文字入力を受信します。
## 主なイベント
| イベント名 | 発火タイミング | 引数 |
|------------|----------------|-------|
| `changed` | テキストが変更されたとき(入力・削除を含む) | オブジェクト形式:`{ [this.name]: 現在のテキスト }`。例:`{ data: "abc" }` |
---
# Title1タイトル1
**コントロール機能**:第一レベルのタイトルコントロール。太字かつ大きなフォントサイズで、ページのメインタイトル表示に使用。
**タイプ**:通常コントロール
**親クラスコントロール**`bricks.TextBase`
## 初期化パラメータ
| パラメータ名 | 型 | 説明 |
|--------------|-----|------|
| `text` / `otext` | String | 表示テキストまたは国際化用の原文 |
| `i18n` | Boolean | 国際化を有効にするかどうか |
| `halign` | String | 水平方向の配置 |
| `valign` | String | 垂直方向の配置 |
| `rate` | Number | 拡大縮小比率。デフォルトは継承値 |
> 組み込みスタイル:`fontWeight: bold`、`cfontsize: 1.96`。文字サイズの変化に応じて動的に調整。
## 主なイベント
| イベント名 | 発火タイミング | 引数 |
|------------|----------------|-------|
| 無し | 静的なテキストコントロールのため、インタラクションイベントなし | —— |
---
# Title2タイトル2
**コントロール機能**第二レベルのタイトルコントロール。太字で、Title1より若干小さいフォントサイズ。章の見出しに使用。
**タイプ**:通常コントロール
**親クラスコントロール**`bricks.TextBase`
## 初期化パラメータ
`Title1` と同じ。すべてのパラメータをサポート。
> 組み込み属性:`cfontsize: 1.80`。その他は `Title1` と同一。
## 主なイベント
| イベント名 | 発火タイミング | 引数 |
|------------|----------------|-------|
| 無し | 静的コントロール | —— |
---
# Title3タイトル3
**コントロール機能**:第三レベルのタイトルコントロール。サブモジュールまたは小さなセクションの見出しに使用。
**タイプ**:通常コントロール
**親クラスコントロール**`bricks.TextBase`
## 初期化パラメータ
上記と同じ。
> `cfontsize: 1.64`
## 主なイベント
| イベント名 | 発火タイミング | 引数 |
|------------|----------------|-------|
| 無し | —— | —— |
---
# Title4タイトル4
**コントロール機能**:第四レベルのタイトルコントロール。小さいサイズの太字タイトル。細かい構造区分に適しています。
**タイプ**:通常コントロール
**親クラスコントロール**`bricks.TextBase`
## 初期化パラメータ
上記と同じ。
> `cfontsize: 1.48`
## 主なイベント
| イベント名 | 発火タイミング | 引数 |
|------------|----------------|-------|
| 無し | —— | —— |
---
# Title5タイトル5
**コントロール機能**:第五レベルのタイトルコントロール。軽量なタイトルスタイル。
**タイプ**:通常コントロール
**親クラスコントロール**`bricks.TextBase`
## 初期化パラメータ
上記と同じ。
> `cfontsize: 1.32`
## 主なイベント
| イベント名 | 発火タイミング | 引数 |
|------------|----------------|-------|
| 無し | —— | —— |
---
# Title6タイトル6
**コントロール機能**:第六レベルのタイトルコントロール。最小のタイトルスタイル。本文に近いが太字になっている。
**タイプ**:通常コントロール
**親クラスコントロール**`bricks.TextBase`
## 初期化パラメータ
上記と同じ。
> `cfontsize: 1.16`
## 主なイベント
| イベント名 | 発火タイミング | 引数 |
|------------|----------------|-------|
| 無し | —— | —— |