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

7.3 KiB
Raw Blame History

ツールチップ

コントロール機能:マウスオーバー時に表示されるヒント情報を示す、フローティングテキストコントロールです。
タイプ:通常コントロール
親クラスコントロール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 水平方向の配置:leftcenterright(デフォルトは center
valign String 垂直方向の配置:topcenterbottom(デフォルトは 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: boldcfontsize: 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

主なイベント

イベント名 発火タイミング 引数
無し —— ——