アイコンHyperlinkButton
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
IconHyperlinkButtonコントロールは、アイコンを含むハイパーリンクです。SPEAKは常にテキストの左側にアイコンを表示し、ユーザーはアイコンとテキストの両方をクリックできます。
IconHyperlinkButtonコントロールは2通りの使い方があります:
- リソースのURLを指定することができ、ユーザーはボタンをクリックしてそのリソースにアクセスできます。このためにNavigateUrlプロパティを使用します。
- ユーザーがボタンをクリックしたときにSPEAKが実行するJavaScriptコードを指定できます。これにはClickプロパティを使用します。
NavigateUrlプロパティがClickプロパティより優先されます。NavigateUrlプロパティに値がある場合、IconHyperlinkButtonコントロールはClickプロパティで指定されたJavaScriptを実行しません。
ImageUrlプロパティで使用するアイコンを指定します。例えば、コンテンツツリーのアイテムのアイコンを選択するときと同じアイコンをここで使うことができます。
IconHyperlinkButtonコントロールは、スプライトシートから選択した「スプライト」としてアイコンを定義することをサポートします。ImageUrlプロパティはスプライトシートのURLを、BackgroundPositionプロパティは目的のスプライト(アイコン/画像)の座標を格納します。
性質
名称
概要
デフォルト
外見
背景 ポジション
スプライトシートファイル内のスプライト/アイコン/画像のオフセットを示します。値は以下の形式でなければなりません:
-px -PX
ここで 、はスプライトシートの左端から左端までの水平ピクセル数(負の数で表す)を示し、ス プライトシートの上端(負数で表される)からスプライトの上端までの縦方向のピクセル数を示します。
-0px -0px
画像URL(画像URL)
アイコンのSitecoreパス(例えば、/sitecore/content/homeアイテムのアイコンのNetwork/16x16/home.png)またはスプライトシート。SPEAKはimgフォルダ\sitecore\shell\client\Speak\Assets\img(ウェブサイトフォルダ内)に複数のスプライトシートを提供します。
本文
IconHyperlinkButtonコントロールで表示したいテキストを指定します。静的なテキストを入力したり、ページコードからテキストを設定したり、別のコントロールのプロパティにバインドしたりできます。
行動
ナビゲーションURL(ナビゲーションURL)
ボタンをクリックしたときにページがナビゲートすべきリソースを指定します。
例えば、 /sitecore/client/sitecore/applications/sample/pages/about 申請書内の別のページへ移動するために、項目へのSitecoreパスを指定することができます。
また、ウェブリソースのURLを指定することもできます。例えば、 http://www.sitecore.net。
ターゲット
ボタンがHTMLの「ターゲット」属性として表示するテキスト文字列を指定します。SPEAKは文字列を検証せず、そのままレンダリングします。NavigateUrlプロパティが設定されていないとこのプロパティは無視され、クリックプロパティのJavaScriptには影響がありません。
イベント
カチッ
ユーザーがボタンをクリックしたときに実行されるJavaScriptを指定します。
構成
IconHyperlinkButtonコントロールの設定項目は、IconHyperlinkButtonパラメータテンプレートに基づいてアイテムを作成することで作成できます。
設定項目には以下の特定のフィールドがあります:
- 本文
- 画像URL(画像URL)
- 背景 ポジション
- ナビゲーションURL(ナビゲーションURL)
- ターゲット
以下の場を継承します:
- カチッ
- IsEnabled
- IsVisible(見えるもの)
- アクセスキー
- ツールチップ
- 行動
- ID