Create custom pop-ups using Quickviews

Create a Quickview for an uploaded asset.

You typically create a Quickview the same time you edit an asset for use with the viewer you are using.

Obtain the viewer embed code to Integrate the viewer within your website.

The viewer you are using now needs to know how to use the Quickview.

To do this the viewer uses a handler called QuickViewActive.

Example
Suppose you were using the following sample embed code on your web page for an interactive image:

The handler is loaded into the viewer using setHandlers:

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

Using the sample embed code example from above, we have the following code:

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

Learn more about setHandlers() method at the following:

• Interactive Image viewer: setHandlers
• Interactive Video viewer: setHandlers

You now need to configure the quickViewActivate handler.

The quickViewActivate handler controls the Quickviews in the viewer. The handler contains the variable list and function calls for use with the Quickview. The embed code provides mapping for the SKU variable set in the Quickview as well as a sample loadQuickView function call.

Variable mapping
Map variables for use in your web page to the SKU value and generic variables contained in the Quickview:

var *variable1*= inData.*quickviewVariable*

The provided embed code has a sample mapping for the SKU variable:

var sku=inData.sku

Map additional variables from the Quickview too, as in the following:

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

Function call
The handler also requires a function call for the Quickview to work. The function is assumed to be accessible by your host page. The embed code provides a sample function call:

loadQuickView(sku)

The sample function call assumes the function loadQuickView() exists and is accessible.

Learn more about quickViewActivate method at the following:

• Interactive Image viewer – Event callbacks
• Interactive Video viewer – Event callbacks
• Interactive data support in Interactive Video viewer – Interactive data support

Do the following:

• Uncomment the setHandlers section of the embed code.

• Map any additional variables contained in the Quickview.

  • Update the loadQuickView(sku,*var1*,*var2*) call if you are adding additional variables.

• Create a simple loadQuickView () function on page, outside of the viewer.

  For example, the following writes the value of sku to the browser console:

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

• Upload a test HTML page to a webserver and open.

  With the variables from the Quickview mapped and the function call in place, the browser console writes the variable value to the browser console using the sample function provided.

You can now use a function to invoke a simple pop-up in the Quickview. The following example uses a DIV for a popup.

Style the pop-up DIV in the following manner. Add your own additional styling as desired.

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

Place the pop-up DIV in the body of your HTML page.

One of the elements is set with an ID that is updated with sku value when the user invokes a Quickview. The example also includes a simple button to hide the pop-up again after it becomes visible.

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

Add a function to update the sku value in the pop-up; make the pop-up visible by replacing the simple function created in step 5. with the following:

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

Upload a test HTML page to your webserver and open. The viewer displays the pop-up DIV when a user invokes a Quickview.

How to display the custom pop-up in full screen mode

Some viewers, such as the Interactive Video viewer, support display in fullscreen mode. However, using the pop-up as described in the previous steps causes it to display behind the viewer while in full screen mode.

To have the pop-up display in both standard and full screen modes, you attach the pop-up to the viewer container. To accomplish this, you can use a second handler method, initComplete.

The initComplete hander is invoked after the viewer is initialized.

"initComplete":function() { code block }

Learn more about init() method at the following:

• Interactive Image viewer – init
• Interactive Video viewer – init

To attach the pop-up–described in the previous steps–to the viewer, use the following code:

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

In the code above, we have done the following:

• Identified our custom pop-up.
• Removed it from the DOM.
• Identified the viewer container.
• Attached the pop-up to the viewer container.

Your entire setHandlers code should now look similar to the following (Interactive Video viewer was used):

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

After the handlers are loaded, you initialize the viewer:

*viewerInstance.*init()

Example
This example uses the Interactive image viewer.

s7interactiveimageviewer.init()

After you embed the viewer into your host page, be sure that the viewer instance is created and the handlers are loaded before the viewer is invoked using init().