GPUI の Web バックエンドが描画する実際のコンポーネントです。WebGPU 対応のブラウザが必要です。
Label::new(id, &focus_handle, text) は、ネイティブの Label セマンティクスと、
そのテキストに一致するアクセシブルな名前を持つプレーンテキストを描画します。クリックすると、
指定された既存のコントロールにフォーカスします。Label は自身のフォーカスハンドルも Tab ストップも持たないため、
通常のキーボード移動はコントロールに残ります。その Styled インターフェースは、
アプリケーションが管理するテキストスタイルとレイアウトを提供します。インタラクティブな子コンテンツではなく、テキストを受け付けます。
let preview = self.preview.read(cx);
let label = Label::new(
"preview-percentage-label",
preview.thumb_focus_handle(0),
"Preview percentage",
)
.disabled(preview.is_disabled())
.text_color(muted);
let slider = Slider::new("preview-percentage", &self.preview)
.accessibility_label("Preview percentage")
.child(SliderThumb::new(&self.preview, 0).accessibility_label("Preview percentage"));
div().flex().flex_col().gap_1().child(label).child(slider)参照先のターゲットは同じウィンドウ内にマウントしたままにし、描画のたびに
.disabled(bool) でその無効状態を反映させてください。無効な Label はフォーカスを
移しません。渡された FocusHandle はターゲットを識別しますが、コントロールが有効かどうかは
Label に伝わりません。そのポリシーはアプリケーションが管理し、変化したときに再描画します。Label は
コントロールの状態を別に保持しません。
フォーカスの動作はターゲットをアクティブ化しません。Select を開いたり、 Slider を調整したり、Checkbox/Switch をトグルしたりはしません。ネイティブのサンプルは Drawing tool と Preview percentage の上でこれを使用しており、どちらのラベルをクリックしても、コントロールが通常のキーボード入力を受け取る前に 選択や値は変わりません。
ターゲットの accessibility_label(...) は個別に設定してください。固定された GPUI API は、
これらの兄弟要素に対する公開された labelled-by 関係を提供していないため、
Label はターゲットに自動的に名前を付けません。ネイティブの Label ロールとテキストの
名前は、ラベル自体を説明します。Input/Textarea のラベル、ヘルプ、検証の
関連付けには Field を使用してください。Field は保持された input にメタデータを反映し、
ラベルがクリックされたときに input の現在の無効状態を確認します。