トグルボタン
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
ToggleButtonコントロールは、ユーザーがクリックできる標準的なボタンを提供します。これはButtonコントロールに似ていますが、以下の機能が追加されています:
- ToggleButtonコントロールには2つの状態があり、ユーザーがToggleButtonコントロールをクリックすると、その状態が切り替えられます。ToggleButtonコントロールは、ユーザーがToggleButtonコントロールを含むページを読み込み直すまで、その状態を記憶します。ToggleButtonコントロールは、2つの状態に対して異なるビジュアルスタイルを使用します。
- IsOpenとShowArrowプロパティは ToggleButton コントロール専用です。 Button コントロールと他のすべてのプロパティを共有しています。
ShowArrowプロパティをtrueに設定すると、ToggleButtonコントロールはIsOpenがtrueのときに上を指し、IsOpenがfalseのときには下を指す矢印を表示します。
ButtonTypeプロパティをprimaryに設定すると、見た目SPEAK際立つようになります。Dimensionsプロパティでボタンのサイズをnormalまたはlargeに設定できます。
ユーザーがページの主な目的を実行するためにクリックするToggleButtonコントロールをprimaryに設定し、他のボタンにはそのdefaultを使うべきです。ButtonTypeをinverseに設定することもできます。逆ボタンはデフォルトのボタンと同じ色を使用しますが、テキストと背景色が入れ替わります。
ToggleButtonの 操作はテキストだけでなくアイコンも表示でき、両方を同時に表示することも可能です。
アイコンはImageUrlプロパティを使って指定します。ここでも、コンテンツツリー内のアイテムのアイコンを選択する時と同じアイコンを使用できます。 ToggleButtonコントロールは、スプライトシートから選択した「スプライト」としてアイコンを定義することもサポートしています。ImageUrlプロパティはスプライトシートのURLを、BackgroundPositionプロパティは希望するスプライト(アイコン/画像)の座標を保存します。
アイコンとテキストの両方を使う場合、SPEAKはアイコンをテキストの左側に配置します。この位置は変更できません。
使用時期
以下はToggleButtonコントロールを使う場合の例です。
FilterControlコントロールを使ってファセット付きのパネルを表示する場合、ユーザーがFilterControlを非表示・表示できる機能を提供したいことが多いです。ToggleButtonコントロールを使うと、FilterControlのIsVisibleプロパティをToggleButtonコントロールのIsOpenプロパティにバインドできます。IsOpenプロパティのデフォルト値はfalseなので、ページ読み込み時にFilterControlを開いたままにしたい場合、IsOpenプロパティをtrueに設定する必要があります。
性質
名称
概要
デフォルト
外見
背景 ポジション
スプライト/アイコン/画像のオフセットをスプライトシートファイルで設定します:
-px -PX
ここで 、はスプライトシートの左端から左端までの水平ピクセル数(負の数で表す)を示し、ス プライトシートの上端(負数で表される)からスプライトの上端までの縦方向のピクセル数を示します。
-0px -0px
ボタンタイプ
デフォルト、プライマリ、または逆を選択します。
デフォルト
寸法
ボタンのサイズを設定してください。通常または大きいを選択します。
ノーマル
画像URL(画像URL)
アイコンのSitecoreパス(例:/sitecore/content/homeアイテムのアイコンのNetwork/16x16/home.png)やスプライトシートを設定します。SPEAKは\sitecore\shell\client\Speak\Assets\imgフォルダ(ウェブサイトフォルダ内)に複数のスプライトシートを提供します。
IsOpen(開けたまま)
もし正しい場合、 ToggleButton コントロールは「開く」状態にあります。 ToggleButton コントロールはユーザーがクリックしたときに値を切り替えます。
間違いです
ショーアロー
もし正しい場合、 ToggleButton コントロールはどの状態にあるかを示す矢印を表示します。
間違いです
本文
ToggleButtonコントロールでテキストを表示するように設定してください。静的テキストを入力したり、PageCodeからテキストを設定したり、別のコントロールのプロパティに割り当てたりできます。
構成
ToggleButtonコントロールの設定項目は、ToggleButtonパラメータテンプレートに基づいてアイテムを作成することで作成できます。
設定項目には以下の特定のフィールドがあります:
- ボタンタイプ
- 寸法
- テキスト – このフィールドはテキストプロパティに対応しており、UIテキストの翻訳を容易にするために使います。
- IsOpen(開けたまま)
- 画像URL(画像URL)
- 背景 ポジション
- ショーアロー
以下の場を継承します:
- カチッ
- IsEnabled
- IsVisible(見えるもの)
- アクセスキー
- ツールチップ
- 行動
- ID