ダウンロードコンポーネント

コアコンポーネントのダウンロードコンポーネントを使用すると、ダウンロードオプションをページ上に作成できます。

使用方法

コアコンポーネントのダウンロードコンポーネントを使用すると、ダウンロードオプションとその関連アセットをページに含めることができます。

• ダウンロードオプションのプロパティは、設定ダイアログで選択できます。
• ダウンロードコンポーネントのデフォルト設定は、デザインダイアログで定義できます。

バージョンと互換性

このドキュメントでは、ダウンロードコンポーネントの現在のバージョン（2022年2月にコアコンポーネントのリリース 2.18.0 で導入された v2）について説明します。

コンポーネントのすべてのサポート対象バージョン、コンポーネントの各バージョンと互換性のある AEM バージョン、以前のバージョンのドキュメントへのリンクを次の表に示します。

コアコンポーネントのバージョンとリリースについて詳しくは、コアコンポーネントのバージョンを参照してください。

コンポーネント出力のサンプル

ダウンロードコンポーネントを体験し、その設定オプションや HTML および JSON 出力の例を確認するには、コンポーネントライブラリを参照してください。

技術的詳細

ダウンロードコンポーネントに関する最新の技術ドキュメントについては、GitHub を参照してください。

コアコンポーネントの開発について詳しくは、コアコンポーネント開発者向けドキュメントを参照してください。

設定ダイアログ

設定ダイアログでは、ダウンロードアイテムそのものと、ページの訪問者に対するダウンロードアイテムの動作および表示をコンテンツ作成者が定義できます。

「アセット」タブ

ダウンロードアセットの選択は、画像コンポーネントの機能とよく似ており、同じく AEM の DAM を利用しています。

• アセットをダウンロード
  • アセットブラウザーからアセットをドロップするか、「参照」オプションをタップすると、ローカルファイルシステムからアップロードできます。
  • 現在選択されている画像を選択解除するには、「クリア」をタップまたはクリックします。
  • アセットエディターで​アセットのレンディションを管理​するには、「編集」をタップまたはクリックします。

「プロパティ」タブ

• タイトル - ダウンロードアイテムのヘッドラインとして表示されます。
  • DAM アセットからタイトルを取得 - タイトルに DAM アセットのタイトルが自動的に入力されます。
• 説明 - ダウンロードアイテムを説明するサブヘッドラインとして表示されます。
  • DAM アセットから説明を取得 - 説明に DAM アセットの説明が自動的に入力されます。
• アクションテキスト - ダウンロードアイテムのアクションテキストとして表示されます。
  • このフィールドは、ファイルシステムからアセットをアップロードする場合には必須です。
  • インライン表示 - 指定した​アクションテキスト​がインライン表示されます。
• ID - このオプションを使用すると、HTML 内およびデータレイヤー内のコンポーネントの一意の識別子を制御できます。
  • 空白のままにした場合、一意の ID が自動的に生成されます。生成された ID は結果のページを調べることで確認できます。
  • ID を指定した場合、作者はその ID が一意であることを確認する必要があります。
  • ID を変更すると、CSS、JS、およびデータレイヤーのトラッキングに影響を与える可能性があります。

「スタイル」タブ

ダウンロードコンポーネントでは、AEM スタイルシステムをサポートしています。

ドロップダウンを使用して、コンポーネントに適用するスタイルを選択します。編集ダイアログでの選択項目は、コンポーネントツールバーから選択した項目と同じ効果があります。

ドロップダウンメニューを使用するには、デザインダイアログでこのコンポーネントのスタイルを設定する必要があります。

デザインダイアログ

デザインダイアログでは、ダウンロードコンポーネントの使用時にコンテンツ作成者に提供されるオプションをテンプレート作成者が定義できます。

「プロパティ」タブ

• ファイルシステムからのアップロードを許可 - コンテンツ作成者が自分のローカルファイルシステムからアセットをダウンロードアセットとしてアップロードできるようにします。
  • デフォルト値はオフです。
• タイトルタイプ - ダウンロードコンポーネントのタイトルに使用する HTML 要素。
  • 値が選択されていない場合、デフォルト値は H3 です。
• ファイルサイズを表示 - アセットのファイルサイズがダウンロードコンポーネントに表示されます。
  • デフォルト値はオンです。
• ファイル形式を表示 - アセットのファイル形式がダウンロードコンポーネントに表示されます。
  • デフォルト値はオンです。
• ファイル名を表示 - アセットのファイル名がダウンロードコンポーネントに表示されます。
  • デフォルト値はオンです。

「スタイル」タブ

画像コンポーネントは、AEM スタイルシステムをサポートしています。