使用Quickviews建立自訂快顯視窗 using-quickviews-to-create-custom-pop-ups

為已上傳的資產建立快速檢視。

您通常會在編輯資產以用於使用的檢視器時建立快速檢視。

取得檢視器內嵌程式碼，以整合您網站中的檢視器。

您現在使用的檢視器必須知道如何使用「快速檢視」。

為此，檢視器使用的處理常式稱為 QuickViewActive.

範例
假設您在網頁上使用下列互動式影像的範例內嵌程式碼：

處理常式會以 setHandlers:

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

使用上述范常式式碼範例，我們提供下列程式碼：

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

深入了解 setHandlers() 方法（如下所示）:

• 互動式影像檢視器： setHandlers
• 互動式視訊檢視器： setHandlers

您現在需要設定 quickViewActivate 處理常式。

quickViewActivate處理常式控制查看器中的Quickviews。 處理常式包含變數清單和函式呼叫，以便與Quickview搭配使用。 內嵌程式碼提供在Quickview中設定的SKU變數對應，以及loadQuickView函式呼叫範例。

變數對應
將您網頁中使用的變數對應至Quickview中包含的SKU值和一般變數：

var *variable1*= inData.*quickviewVariable*

提供的內嵌程式碼有SKU變數的範例對應：

var sku=inData.sku

也可從「快速檢視」對應其他變數，如下所示：

var <i>variable2</i>= inData.<i>quickviewVariable2</i>
 var <i>variable3</i>= inData.<i>quickviewVariable3</i>

函式呼叫
處理常式也需要函式呼叫，Quickview才能運作。 您的主機頁面會假設可存取函式。 內嵌程式碼提供範例函式呼叫：

loadQuickView(sku)

範例函式呼叫假設函式 loadQuickView() 存在且可存取。

請前往下列網址，以進一步了解quickViewActivate方法：

• 互動式影像檢視器 — 事件回呼
• 互動式視訊檢視器 — 事件回呼
• 互動式視訊檢視器中的互動式資料支援 — 互動式資料支援

請執行下列動作：

• 取消對內嵌程式碼的setHandlers區段的註解。

• 映射Quickview中包含的任何其他變數。

  • 更新 loadQuickView(sku,*var1*,*var2*) 如果您要新增其他變數，請呼叫。

• 在檢視器外部的頁面上建立簡單的loadQuickView()函式。

  例如，下列項目會將sku的值寫入瀏覽器主控台：

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

• 將測試HTML頁面上傳至Web伺服器並開啟。

  將Quickview中的變數對應並設定函式呼叫後，瀏覽器主控台會使用提供的範例函式，將變數值寫入瀏覽器主控台。

您現在可以使用函式叫用快速檢視中的簡單快顯視窗。 下列範例使用 DIV ，以取得快顯視窗。

設定快顯視窗的樣式 DIV 以下列方式。 視需要新增您自己的其他樣式。

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

放置快顯視窗 DIV 在HTML頁面的正文中。

其中一個元素的ID是設定的，當用戶調用Quickview時，ID會以sku值更新。 此範例也包含一個簡單按鈕，可在快顯視窗顯示後重新隱藏快顯視窗。

<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>

新增函式以更新快顯視窗中的sku值；取代步驟5中建立的簡單函式，使快顯視窗可見。 並搭配下列項目：

<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>

將測試HTML頁面上傳至您的Web伺服器並開啟。 檢視器會顯示快顯視窗 DIV 當用戶調用快速視圖時。

如何以全螢幕模式顯示自訂快顯視窗

有些檢視器（例如互動式視訊檢視器）支援以全螢幕模式顯示。 不過，如前述步驟所述，使用快顯視窗會使其在全螢幕模式中顯示在檢視器後面。

若要在標準和全螢幕模式中顯示快顯視窗，請將快顯視窗附加至檢視器容器。 若要完成此操作，您可以使用第二個處理常式方法， initComplete.

此 initComplete 檢視器初始化後，會叫用處理器。

"initComplete":function() { code block }

深入了解 init() 方法（如下所示）:

• 互動式影像檢視器 — init
• 互動式視訊檢視器 — init

若要將快顯視窗（如前述步驟所述）附加至檢視器，請使用下列程式碼：

"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中移除。
• 已識別檢視器容器。
• 將快顯視窗附加至檢視器容器。

您的整個setHandlers程式碼現在看起來應類似下列（已使用互動式視訊檢視器）:

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);
    }
});

載入處理程式後，您會初始化檢視器：

*viewerInstance.*init()

範例
此範例使用互動式影像檢視器。

s7interactiveimageviewer.init()

將檢視器內嵌至主機頁面後，請確定已建立檢視器例項，且處理常式已載入，然後才使用叫用檢視器 init().