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

アイコンハイパーリンクボタン

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

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

IconHyperlinkButtonコントロールは、アイコン付きのハイパーリンクです。SPEAKでは、常にテキストの左側にアイコンが表示され、ユーザーはアイコンとテキストの両方をクリックできます。

IconHyperlinkButtonコントロールは、次の2つの方法で使用できます。

  • リソースのURLを指定でき、ユーザーはボタンをクリックしてこのリソースに移動できます。これには、NavigateUrlプロパティを使用します。

  • ユーザーがボタンをクリックしたときにSPEAKが実行するJavaScriptコードを指定できます。これには、Clickプロパティを使用します。

NavigateUrlプロパティはClickプロパティよりも優先されます。NavigateUrlプロパティに値がある場合、IconHyperlinkButtonコントロールはClickプロパティで指定されたJavaScriptを実行しません。

ImageUrlプロパティで使用するアイコンを指定します。ここでは、たとえば、コンテンツ ツリー内のアイテムのアイコンを選択する場合と同じアイコンを使用できます。

IconHyperlinkButtonコントロールは、スプライト シートから選択された "スプライト" としてアイコンを定義することをサポートしています。ImageUrlプロパティはスプライト シートのURLを格納し、BackgroundPositionプロパティは目的のスプライト (アイコン/画像) の座標を格納します。

プロパティ

Name

Description

Default

Appearance

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

スプライトシートファイル内のスプライト/アイコン/画像のオフセットを示します。値は次の形式にする必要があります。

-<x>px-<y>px

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

-0px -0px

画像URL

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

テキスト

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

Behavior

ナビゲートURL

ボタンがクリックされたときにページが移動する必要があるリソースを指定します。

アイテムへのSitecoreパスを指定できます (例: アプリケーション内の別のページに移動する /sitecore/client/sitecore/applications/sample/pages/about )。

WebリソースのURLを指定することもできます (例: http://www.sitecore.net)。

ターゲット

ボタンがHTMLの "target" 属性としてレンダリングするテキスト文字列を指定します。SPEAKは文字列を検証しず、そのままレンダリングします。このプロパティは、NavigateUrlプロパティが設定されていない場合無視され、ClickプロパティのJavaScriptには影響を与えません。

Events

クリック

ユーザーがボタンをクリックしたときに実行されるJavaScriptを指定します。

構成

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

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

  • テキスト

  • 画像URL

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

  • ナビゲートURL

  • ターゲット

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

  • クリック

  • イズ・イネーブルド

  • 目に見える

  • アクセスキー

  • ツールチップ

  • 動作

  • 身分証明書

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