ダウンロードコンポーネント（v1） download-component
コアコンポーネントのダウンロードコンポーネントを使用すると、ダウンロードオプションをページ上に作成できます。
使用方法 usage
コアコンポーネントのダウンロードコンポーネントを使用すると、ダウンロードオプションとその関連アセットをページに含めることができます。
バージョンと互換性 version-and-compatibility
このドキュメントでは、2019年6月にコアコンポーネントのリリース 2.5.0 で導入されたダウンロードコンポーネント v1 について説明します。
コンポーネント出力のサンプル sample-component-output
ダウンロードコンポーネントを体験し、その設定オプションや HTML および JSON 出力の例を確認するには、コンポーネントライブラリを参照してください。
技術的詳細 technical-details
ダウンロードコンポーネントに関する最新の技術ドキュメントについては、GitHub を参照してください。
コアコンポーネントの開発について詳しくは、コアコンポーネント開発者向けドキュメントを参照してください。
設定ダイアログ configure-dialog
設定ダイアログでは、ダウンロードアイテムそのものと、ページの訪問者に対するダウンロードアイテムの動作および表示をコンテンツ作成者が定義できます。
「アセット」タブ asset-tab
ダウンロードアセットの選択は、画像コンポーネントの機能とよく似ており、同じく AEM の DAM を利用しています。
「プロパティ」タブ properties-tab
-
タイトル - ダウンロードアイテムのヘッドラインとして表示されます。
- DAM アセットからタイトルを取得 - タイトルに DAM アセットのタイトルが自動的に入力されます。
-
説明 - ダウンロードアイテムを説明するサブヘッドラインとして表示されます。
- DAM アセットから説明を取得 - 説明に DAM アセットの説明が自動的に入力されます。
-
アクションテキスト - ダウンロードアイテムのアクションテキストとして表示されます。
- このフィールドは、ファイルシステムからアセットをアップロードする場合には必須です。
- インライン表示 - 指定した アクションテキスト がインライン表示されます。
-
ID - このオプションを使用すると、HTML 内およびデータレイヤー内のコンポーネントの一意の識別子を制御できます。
- 空白のままにした場合、一意の ID が自動的に生成されます。生成された ID は結果のページを調べることで確認できます。
- ID を指定した場合、作者はその ID が一意であることを確認する必要があります。
- ID を変更すると、CSS、JS、およびデータレイヤーのトラッキングに影響を与える可能性があります。
デザインダイアログ design-dialog
デザインダイアログでは、ダウンロードコンポーネントの使用時にコンテンツ作成者に提供されるオプションをテンプレート作成者が定義できます。
「プロパティ」タブ properties-tab-design
- ファイルシステムからのアップロードを許可 - コンテンツ作成者が自分のローカルファイルシステムからアセットをダウンロードアセットとしてアップロードできるようにします。
- デフォルト値はオフです。
- タイトルタイプ - ダウンロードコンポーネントのタイトルに使用する HTML 要素。
- 値が選択されていない場合、デフォルト値は H3 です。
- ファイルサイズを表示 - アセットのファイルサイズがダウンロードコンポーネントに表示されます。
- デフォルト値はオンです。
- ファイル形式を表示 - アセットのファイル形式がダウンロードコンポーネントに表示されます。
- デフォルト値はオンです。
- ファイル名を表示 - アセットのファイル名がダウンロードコンポーネントに表示されます。
- デフォルト値はオンです。