1. コンポーネントライブラリ

トグルボタン

Version:
日本語翻訳に関する免責事項

このページの翻訳は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を使用するように設定する必要があります。 ButtonTypeinverseに設定することもできます。反転ボタンは、デフォルトのボタンと同じ色を使用しますが、テキストと背景色を入れ替えます。

ToggleButtonコントロールは、テキストだけでなくアイコンも表示でき、両方を同時に表示できます。

アイコンは、ImageUrlプロパティを使用して指定します。ここでは、コンテンツ ツリー内のアイテムのアイコンを選択するときと同じアイコンを使用できます。 ToggleButtonコントロールは、スプライトシートから選択された「スプライト」としてアイコンを定義することもサポートしています。 ImageUrlプロパティはスプライト シートのURLを格納し、BackgroundPositionプロパティは目的のスプライト (アイコン/画像) の座標を格納します。

アイコンとテキストの両方を使用する場合、SPEAKはアイコンをテキストの左側に配置します。この位置は変更できません。

いつ使用するか

次に、ToggleButtonコントロールを使用する場合の例を示します。

FilterControlコントロールを使用してファセットを含むパネルを表示する場合、多くの場合、ユーザーにFilterControlの表示と非表示を切り替える機能を提供したい場合があります。これには、FilterControlIsVisibleプロパティをToggleButtonコントロールのIsOpenプロパティにバインドすることで、ToggleButtonコントロールを使用できます。IsOpenプロパティのデフォルト値はfalseであるため、ページの読み込み時にFilterControlを開くには、IsOpenプロパティをtrueに設定する必要があります。

プロパティ

Name

Description

Default

Appearance

バックグラウンドポジション

スプライトシートファイル内のスプライト/アイコン/画像のオフセットを次の形式で設定します。

-<x>px-<y>px

ここで、<x> はスプライトシートの左端からスプライトの左端までの水平方向のピクセル数 (負の数で表される)、<y> はスプライトシートの上端 (負の数値で表される) からスプライトの上端までの垂直方向のピクセル数を示します。

-0px -0px

ボタンタイプ

デフォルト、プライマリ、または インバース を選択します。

デフォルト

次元

ボタンのサイズを設定します。「標準」または「大」を選択します。

正常

画像URL

アイコンのSitecoreパスを設定します (たとえば、/sitecore/content/homeアイテムに表示されるアイコンのNetwork/16x16/home.png) またはスプライト シート。SPEAKは、\sitecore\shell\client\Speak\Assets\imgフォルダー (Websiteフォルダーにあります) に多数のスプライト シートを提供します。

イズオープン

trueの場合、ToggleButtonコントロールは "オープン" 状態になります。 ToggleButtonコントロールは、ユーザーがクリックしたときに値を切り替えます。

表示矢印

trueの場合、ToggleButtonコントロールには、その状態を示す矢印が表示されます。

テキスト

ToggleButtonコントロールに表示するテキストを設定します。静的テキストを入力したり、PageCodeからテキストを設定したり、別のコントロールのプロパティにバインドしたりできます。

構成

ToggleButtonコントロールの構成項目を作成するには、ToggleButton Parametersテンプレートに基づいて項目を作成します。

構成アイテムには、次の特定のフィールドがあります。

  • ボタンタイプ

  • 次元

  • テキスト – このフィールドはTextプロパティに対応し、このフィールドを使用してUIテキストの翻訳を容易にします。

  • イズオープン

  • 画像URL

  • バックグラウンドポジション

  • 表示矢印

次のフィールドを継承します。

  • クリック

  • イズ・イネーブルド

  • 目に見える

  • アクセスキー

  • ツールチップ

  • 動作

  • 身分証明書

この記事を改善するための提案がある場合は、 お知らせください!