ドロップダウンボタン
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
DropDownButtonコントロールには、ユーザーがクリックできるボタンが表示されます。これには、開いている状態と閉じている状態の2つの状態があります。DropDownButtonコントロールには、現在の状態が矢印で表示されます。開いた状態のときは矢印が上を向き、閉じた状態のときは下向きの矢印です。DropDownButtonコントロールは、ユーザーがボタンをクリックするたびに、これら2つの状態を切り替えます。
DropDownButtonコントロールは、Contentというプレースホルダーを追加します。このプレースホルダーが開いている状態にあるときにこのプレースホルダーに配置したすべてのコントロールが表示されます。このプレースホルダーには、任意のSPEAKコンポーネントを追加できます。
ユーザーがContentプレースホルダー内の任意のコントロールをクリックすると、クリックされたコントロールとDropDownButtonコントロールの両方でクリック イベントが発生します。これは、DropDownButtonコントロールが閉じた状態に切り替わることを意味します。
ButtonTypeプロパティをPrimaryに設定すると、SPEAKによって視覚的に目立ちます。ボタンのサイズをnormalまたはlargeに設定するには、Dimensionsプロパティを使用します。
ユーザーがページの主な目的を実行するためにクリックするボタンのタイプとしてPrimaryを指定し、他のボタンのDefaultを指定する必要があります。 ButtonTypeプロパティをInverseに設定することもできます。 Inverseボタンタイプは、デフォルトボタンタイプと同じ色を使用しますが、テキストと背景色を入れ替えます。
ボタンには、テキストだけでなくアイコンも表示でき、両方を同時に表示できます。
アイコンは、ImageUrlプロパティを使用して指定します。ここでは、コンテンツ ツリー内のアイテムのアイコンを選択するときと同じアイコンを使用できます。ボタン コントロールは、スプライト シートから選択された "スプライト" としてアイコンを定義することもサポートしています。 ImageUrlプロパティはスプライト シートのURLを格納し、BackgroundPositionプロパティは目的のスプライト (アイコン/画像) の座標を格納します。
アイコンとテキストの両方を使用する場合、SPEAKはアイコンをテキストの左側に配置します。この位置は変更できません。
プロパティ
プロパティ
|
Name |
Description |
Default |
|---|---|---|
|
Appearance | ||
|
バックグラウンドポジション |
スプライトシートファイル内のスプライト/アイコン/画像のオフセットを次の形式で指定します。 -<x>px-<y>px ここで、<x> はスプライトシートの左端からスプライトの左端までの水平方向のピクセル数 (負の数で表される)、<y> はスプライトシートの上端 (負の数値で表される) からスプライトの上端までの垂直方向のピクセル数を示します。 |
-0px -0px |
|
ボタンタイプ |
Default、Primary、または Inverse を指定します。 |
デフォルト |
|
コンテンツアライメント |
Contentプレースホルダー内のコンテンツの配置方法を 左 または 右 から指定します。 |
左 |
|
画像URL |
アイコンのSitecoreパス (たとえば、/sitecore/content/homeアイテムに表示されるアイコンのNetwork/16x16/home.png) またはスプライト シートを指定します。SPEAKは、imgフォルダ (\sitecore\shell\client\Speak\Assets\imgフォルダ (Websiteフォルダ内) に多数のスプライトシートを提供します。 | |
|
テキスト |
DropDownButtonコントロールに表示するテキストを指定します。静的テキストを入力したり、ページ コードからテキストを設定したり、別のコントロールのプロパティにバインドしたりできます。 | |
|
Events | ||
|
クリック |
ユーザーがボタンをクリックしたときにSPEAKが実行されるJavaScriptを指定します。 | |
構成
DropDownButtonコントロールの構成項目を作成するには、DropDownButton Parametersテンプレートに基づいて項目を作成します。
構成アイテムには、次の特定のフィールドがあります。
-
ボタンタイプ
-
テキスト – このフィールドはTextプロパティに対応し、このフィールドを使用してUIテキストの翻訳を容易にします。
-
画像URL
-
バックグラウンドポジション
-
コンテンツアライメント
次のフィールドを継承します。
-
クリック
-
イズ・イネーブルド
-
目に見える
-
アクセスキー
-
ツールチップ
-
動作
-
身分証明書