ドキュメントAEM 6.5ユーザーガイド

クイックビューを使用してカスタムポップアップを作成する using-quickviews-to-create-custom-pop-ups

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • ユーザー
  • 管理者

e コマースエクスペリエンスでは、デフォルトのクイックビューが使用され、ポップアップに購入を促す商品情報が表示されます。ただし、このようなポップアップにカスタムコンテンツが表示されるように設定できます。ビューアによりますが、この機能を使用すると、ホットスポットやサムネール画像、画像マップをクリックして、情報や関連コンテンツを表示できるようになります。

クイックビューをサポートしている Dynamic Media のビューアは、次のとおりです。

  • インタラクティブ画像（クリック可能なホットスポット）
  • インタラクティブビデオ（ビデオの再生中にクリック可能なサムネール画像）
  • カルーセルバナー（クリック可能なホットスポットまたは画像マップ）

ビューアによって機能は異なりますが、クイックビューの作成手順はサポートする 3 つのビューアで同じです。

クイックビューを使用してカスタムポップアップを作成するには：

  1. アップロードしたアセット用にクイックビューを作成します。

    一般には、使用しているビューアでアセットを使用できるように編集すると同時にクイックビューを作成します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 html-authored no-header
    使用しているビューア クイックビューを作成するには、次の手順を実行します
    インタラクティブ画像 画像バナーにホットスポットを追加します。
    インタラクティブビデオ ビデオへのインタラクティブ機能の追加.
    カルーセルバナー バナーにホットスポットまたは画像マップを追加します。

  2. ビューアの埋め込みコードを取得し、web サイトにビューアを統合します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 html-authored no-header
    使用しているビューア ビューアを web サイトに統合するには、次の手順を実行します
    インタラクティブ画像 インタラクティブ画像の Web サイトへの統合.
    インタラクティブビデオ インタラクティブビデオの Web サイトへの統合.
    カルーセルバナー Web サイトページへのカルーセルバナーの追加.

  3. 使用しているビューアがクイックビューの使用方法を認識できる必要があります。

    ビューアは QuickViewActive というハンドラーを使用します。

    例
    Web ページで、インタラクティブ画像用に次の埋め込みコードのサンプルを使用するとします。

    chlimage_1-291

    ハンドラーは setHandlers を使用してビューアに読み込まれます。

    *viewerInstance*.setHandlers({ *handler 1*, *handler 2*}, ...

    上記の埋め込みコードの例を使用すると、次のようなコードになります。

    code language-xml 
    s7interactiveimageviewer.setHandlers({
    quickViewActivate": function(inData) {
        var sku=inData.sku;
        var genericVariable1=inData.genericVariable1;
        var genericVariable2=inData.genericVariable2;
       loadQuickView(sku,genericVariable1,genericVariable2);
    }
})

    setHandlers() メソッドについて詳しくは、以下を参照してください。

  4. 次に quickViewActivate ハンドラーを設定します。

    quickViewActivate ハンドラーはビューアのクイックビューを制御します。このハンドラーには、クイックビューで使用する変数のリストと関数呼び出しが含まれています。埋め込みコードは、クイックビューに設定された SKU 変数と loadQuickView 関数呼び出しのサンプルにマッピングを提供します。

    変数マッピング Web ページで使用する変数を SKU 値とクイックビューに含まれる一般変数にマッピングします。

    var *variable1*= inData.*quickviewVariable*

    提供された埋め込みコードには、SKU 変数用のサンプルマッピングが含まれています。

    var sku=inData.sku

    以下のように、クイックビューからの追加変数もマッピングします。

    code language-none 
    var <i>variable2</i>= inData.<i>quickviewVariable2</i>
 var <i>variable3</i>= inData.<i>quickviewVariable3</i>

    関数呼び出し ​ハンドラーには、クイックビューを機能させるために関数呼び出しも必要です。この関数は、ホストページからアクセスできることが前提となります。埋め込みコードには、サンプル関数呼び出しが含まれています。

    loadQuickView(sku)

    このサンプル関数呼び出しは、関数 loadQuickView() が存在しアクセス可能であることが前提となります。

    quickViewActivate メソッドについて詳しくは、以下を参照してください。

  5. 以下の操作を実行してください。

    • 埋め込みコードの「setHandlers」セクションのコメントを解除します。

    • クイックビューに含まれている追加変数をマッピングします。

      • 変数を追加する場合は、loadQuickView(sku,*var1*,*var2*) 呼び出しを更新します。

    • ビューア外でページにシンプルな loadQuickView () 関数を作成します。

      例えば、以下の場合は、ブラウザーのコンソールに SKU の値が書き込まれます。

    code language-xml 
    function loadQuickView(sku){
    console.log ("quickview sku value is " + sku);
}

    • Web サーバーにテスト HTML ページをアップロードし、開きます。

      クイックビューからの変数がマッピングされ、関数呼び出しが追加された状態で、ブラウザーコンソールは提供されたサンプル関数を使用してブラウザーコンソールに変数値を書き込みます。

  6. これで、関数を使用してクイックビューでシンプルなポップアップを起動できるようになりました。以下の例では、ポップアップに DIV を使用しています。

  7. ポップアップの DIV を以下のようなスタイルにします。必要に応じて独自のスタイルを追加します。

    code language-xml 
    <style type="text/css">
    #quickview_div{
        position: absolute;
        z-index: 99999999;
        display: none;
    }
</style>

  8. HTML ページのボディにポップアップの DIV を配置します。

    要素の 1 つは、ユーザーがクイックビューを起動すると SKU 値で更新される ID に設定されます。この例には、ポップアップを表示後に再び隠すための簡単なボタンも含まれています。

    code language-xml 
    <div id="quickview_div" >
    <table>
        <tr><td><input id="btnClosePopup" type="button" value="Close"        onclick='document.getElementById("quickview_div").style.display="none"' /><br /></td></tr>
        <tr><td>SKU</td><td><input type="text" id="txtSku" name="txtSku"></td></tr>
    </table>
</div>

  9. ポップアップで SKU の値を更新できるように関数を追加します。手順 5 で作成した簡単な関数を次のように置き換えて、ポップアップを表示させます。

    code language-xml 
    <script type="text/javascript">
    function loadQuickView(sku){
        document.getElementById("txtSku").setAttribute("value",sku); // write sku value
        document.getElementById("quickview_div").style.display="block"; // show popup
    }
</script>

  10. Web サーバーにテスト用の HTML ページをアップロードして開きます。ユーザーがクイックビューを起動すると、ビューアにポップアップの DIV が表示されます。

  11. 全画面表示モードでカスタムポップアップを表示する方法

    インタラクティブビデオビューアなどの一部のビューアでは、全画面表示モードでの表示をサポートしています。ただし、前の手順で説明したポップアップを使用すると、全画面表示モード中はビューアの背後に表示されるようになります。

    標準モードと全画面表示モードの両方でポップアップを表示させるには、ビューアのコンテナにポップアップをアタッチします。2 つ目のハンドラーメソッドである initComplete を使用します。

    initComplete ハンドラーは、ビューアの初期化後に呼び出されます。

    code language-xml 
    "initComplete":function() { code block }

    init() メソッドについて詳しくは、以下を参照してください。

  12. 前の手順で説明したようにポップアップをビューアにアタッチするには、次のコードを使用します。

    code language-xml 
    "initComplete":function() {
    var popup = document.getElementById('quickview_div');
    popup.parentNode.removeChild(popup);
    var sdkContainerId = s7interactivevideoviewer.getComponent("container").getInnerContainerId();
    var inner_container = document.getElementById(sdkContainerId);
    inner_container.appendChild(popup);
}

    上記のコードでは、次の処理を実行しました。

    • カスタムポップアップを特定しました。
    • DOM からの削除
    • ビューアコンテナーの指定
    • ビューアコンテナーへのポップアップのアタッチ

  13. setHandlers コード全体は次に似たものになります（インタラクティブビデオビューアを使用しています）。

    code language-xml 
    s7interactivevideoviewer.setHandlers({
    "quickViewActivate": function(inData) {
        var sku=inData.sku;
        loadQuickView(sku);

    },
    "initComplete":function() {
        var popup = document.getElementById('quickview_div'); // get custom quick view container
        popup.parentNode.removeChild(popup); // remove it from current DOM
        var sdkContainerId = s7interactivevideoviewer.getComponent("container").getInnerContainerId();
        var inner_container = document.getElementById(sdkContainerId);
        inner_container.appendChild(popup);
    }
});

  14. ハンドラーを読み込んだ後で、ビューアを初期化します。

    *viewerInstance.*init()

    例
    この例では、インタラクティブ画像ビューアを使用しています。

    s7interactiveimageviewer.init()

    ホストページにビューアを埋め込んだら、init() でビューアを呼び出す前に、ビューアインスタンスが作成され、ハンドラーが読み込まれていることを確認してください。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2