ボタンコントロール

Qt Quick 「コントロール」には、ボタンのようなコントロールがいくつか用意されています。

ボタンの種類ごとに、それぞれ固有のユースケースがあります。以下のセクションでは、ユースケースに応じて適切なボタンの種類を選択するためのガイドラインを紹介します。

ボタンコントロール

Button は、アクションを開始したり、ポップアップを開閉したりするためのクリック可能なコントロールです。ボタンには通常、テキストラベルが付いていますが、アイコンを含むこともできます。

ポップアップやダイアログで何らかのアクションを実行する必要がある場合、ボタンは非常に適したコントロールです。最も一般的な例としては、「適用」、「キャンセル」、「保存」、「閉じる」、「ヘルプ」などが挙げられます。

推奨事項：

• ボタンのテキストは、アクションを説明する動詞、または開かれるポップアップのタイトルと一致する名詞にする必要があります。
• 状態を設定するためにボタンを使用しないでください。その目的には、Switch の方が適しています。
• UIガイドラインで特に指定がない限り、デフォルトのフォントを使用してください。
• テキストがローカライズされる場合は、テキストが長くなった際にレイアウトに与える影響を考慮してください。

関連項目： Button およびAbstractButton

CheckBox コントロール

CheckBox は、複数選択可能なオプション リストを構築するために使用されます。オプションは、選択しない場合を含め、いくつでも選択できますが、オプションは相互に排他的であってはなりません。

フォームで利用規約に同意する必要がある場合など、はい/いいえの選択肢には単一のCheckBox を使用してください。

単一の「はい／いいえ」の選択については、スイッチを使用することも可能です。選択内容がオプションに関するものである場合は、CheckBox を使用するのが最適です。実行すべきアクションに関するものである場合は、スイッチの使用が推奨されます。

選択肢をグループ化できる場合は、グループ全体を表すために部分的にチェックされたCheckBox を使用できます。ユーザーがグループ内のサブ項目をすべてではなく一部のみ選択した場合は、 のpartially checked state を使用してください。

チェック状態には、「チェック済み」、「部分的にチェック済み」、「チェックなし」の3種類があります。

選択可能なオプションは、多くの場合、縦に並べて表示されます。

推奨事項：

• チェックボックスのラベルは、チェックマークが付くと真となり、チェックマークが付かないと偽となるような記述にする必要があります。
• チェックボックスのラベルには、否定文を含めないでください。
• UIガイドラインで特に指定がない限り、デフォルトのフォントを使用してください。
• テキストがローカライズされる場合は、テキストが長くなった場合にレイアウトに与える影響を考慮してください。

関連項目 CheckBox

DelayButton コントロール

DelayButton は、アクションを実行する前に遅延を組み込んだボタンです。この遅延により、誤って押してしまうことを防ぎます。

推奨事項:

• タッチ操作のユーザーインターフェイスで使用してください。
• 慎重に実行する必要があるアクションに使用してください。

関連項目： Button およびAbstractButton

ラジオボタン コントロール

RadioButton は、一連の選択肢から 1 つだけを選択するために使用されます。1 つの選択肢を選択すると、以前に選択されていた選択肢は自動的に選択解除されます。

相互に排他的な選択肢が 2 つしかない場合は、それらを 1 つのチェックボックスまたはスイッチにまとめます。

推奨事項：

• ラベルのテキストは1行に収めるようにしてください。
• 適切なデフォルトの選択肢がチェックされていることを確認してください。
• RadioButton の選択肢は縦に並べてください。
• テキストがローカライズされる場合は、テキストが長くなった場合にレイアウトに与える影響を考慮してください。
• UIガイドラインで特に指定がない限り、デフォルトのフォントを使用してください。
• CheckBox と同様に、リストをあまり大きくしすぎないようにしてください。
• 混乱を避けるため、2 つのラジオボタンのグループを隣り合わせに配置しないでください。

関連項目 RadioButton

RoundButton コントロール

RoundButton は、アクションを開始したり、ポップアップを開いたり閉じたりするためのクリック可能なコントロールです。四角い画像アイコンまたは 1 文字のフォントアイコンが付いた丸いボタンは、円形です。円形の「RoundButton 」は、通常の「Button 」よりも場所を取らず、フローティングアクションボタンとしても使用できます。

推奨事項：

• ラベルは短く簡潔に保ってください。
• テキストがローカライズされる場合は、テキストが長くなった場合にレイアウトに与える影響を考慮してください。

関連項目 RoundButton

スイッチコントロール

Switch は、ユーザーが「オン」または「オフ」の状態を選択できる物理的なスイッチを表します。スイッチは、オンにした直後に効果が現れる二値操作に使用してください。例えば、Wi-Fiのオン/オフを切り替えるスイッチなどです。

推奨事項：

• ラベルは短く簡潔に保ってください。
• テキストがローカライズされる場合は、テキストが長くなった際にレイアウトに与える影響を考慮してください。

関連項目 Switch

ToolButton コントロール

ToolButton はButton とほぼ同じですが、ToolBar への挿入に適したグラフィカルな外観を備えています。

関連項目 ToolButton

関連情報

• Qt Quick コントロールのガイドライン