Adobe Experience League

eCatalog搜尋

eCatalog搜尋檢視器是一種目錄檢視器，可依分頁或分頁顯示電子小冊子。eCatalog可讓使用者使用其他使用者介面元素或專用的縮圖模式，來導覽目錄。使用者也可以放大每個頁面，以取得更詳細的資訊。

此檢視器可與ecatalog搭配使用，並支援選用的影像地圖和社交分享工具。它提供縮放工具、目錄導覽工具、全螢幕支援、縮圖，以及可選的關閉按鈕。檢視器也支援社交分享工具、列印、下載和我的最愛。專為在桌上型電腦和行動裝置上運作而設計。

用戶也可以對目錄內容執行基於關鍵字或基於短語的搜索。

注意

此檢視器不支援使用IR（影像轉譯）或UGC（使用者產生的內容）的影像。

檢視器類型513。

請參閱系統要求和必要條件。

示範URL

https://s7d9.scene7.com/s7viewers/html5/eCatalogSearchViewer.html?emailurl=https://s7d9.scene7.com/s7/emailFriend&serverUrl=https://s7d9.scene7.com/is/image/&config=Scene7SharedAssets/Universal_HTML5_eCatalog_Search&contenturl=https://s7d9.scene7.com/skins/&asset=Viewers/Pluralist&searchserverurl=https://s7search1.scene7.com/s7search/

使用eCatalog檢視器

eCatalog搜尋檢視器代表檢視器在執行階段下載的主要JavaScript檔案和一組協助檔案（單一JavaScript包含此特定檢視器、資產、CSS所使用的所有檢視器SDK元件）

您可以使用隨IS檢視器提供的可生產使用的HTML頁面，或以內嵌模式，在快顯模式中使用eCatalog搜尋檢視器，在此模式中，使用記錄的API將其整合至目標網頁。

設定和外觀與其他檢視器的設定和外觀類似。所有外觀設定都是透過自訂CSS來達成。

請參閱所有檢視器通用的命令參考 — 設定屬性和所有檢視器通用的命令參考 — URL

與eCatalog搜尋檢視器互動

eCatalog搜尋檢視器支援下列其他行動應用程式中常見的觸控手勢。

手勢	說明
單點擊	在色票中選取新縮圖。
按兩下	放大到達到最大放大率為止。下一個雙點觸控手勢會將檢視器重設為初始檢視狀態。
代號	放大或縮小。
水準滑動或輕觸	如果使用幻燈片幀轉變，則滾動目錄頁清單。
垂直滑動或輕觸	當影像處於重設狀態時，會執行原生頁面捲動。縮圖處於活動狀態時，會捲動縮圖清單。

可以在目錄頁面之間導航時啟用逼真的頁面翻轉動畫效果。在這種情況下，使用者可以按住並拖曳頁面角，然後翻轉頁面。

此查看器還支援Windows設備上的觸摸輸入和滑鼠輸入，該設備帶有觸摸屏和滑鼠。不過，此支援僅限Chrome、Internet Explorer 11和Edge網頁瀏覽器。

使用eCatalog搜尋檢視器的社交媒體分享工具

eCatalog搜尋檢視器支援社交分享工具。這些工具可作為主控制列的按鈕使用，當使用者點按或點選時，主控制列會展開為分享工具列。

共用工具列包含支援之每種共用管道類型的圖示，包括Facebook、Twitter、電子郵件共用、內嵌程式碼共用和連結共用。啟用電子郵件共用、內嵌共用或連結共用工具時，檢視器會顯示含有對應資料輸入表單的強制回應對話方塊。呼叫Facebook或Twitter時，檢視器會將使用者重新導向至社交服務的標準共用對話方塊。由於網頁瀏覽器安全性限制，無法以全螢幕模式使用共用工具。

檢視器的「搜尋」功能在主工具列中以外觀玻璃圖示的形式提供。按一下或點選圖示會啟用「搜尋」面板並搭配輸入欄位。輸入關鍵字或片語並按Enter後，檢視器會在面板中呈現搜尋結果，並反白標示主檢視中找到的字詞。

嵌入eCatalog搜索查看器

不同的網頁對檢視者行為有不同的需求。有時，網頁會提供連結，當按一下連結時，就會在個別瀏覽器視窗中開啟檢視器。在其他情況下，必須將檢視器直接內嵌在托管頁面中。在後一種情況下，網頁可能具有靜態頁面版面，或使用在不同裝置上或針對不同瀏覽器視窗大小顯示不同的回應式設計。為了滿足這些需求，檢視器支援三種主要操作模式：快顯視窗、固定大小內嵌和回應式設計內嵌。

關於快顯模式

在快顯模式中，檢視器會在個別的網頁瀏覽器視窗或標籤中開啟。它會取用整個瀏覽器視窗區域，並在瀏覽器調整大小或行動裝置的方向變更時進行調整。

快顯模式是行動裝置最常見的模式。網頁會使用window.open() JavaScript呼叫、正確設定的A HTML元素或任何其他適當的方法載入檢視器。

建議您對快顯作業模式使用現成可用的HTML頁面。在此情況下，稱為eCatalogSearchViewer.html，位於標準IS-Viewers部署的html5/子資料夾中：

<s7viewers_root>/html5/eCatalogSearchViewer.html

您可以套用自訂CSS來達到視覺化自訂。

以下是在新視窗中開啟檢視器的HTML程式碼範例：

<a href="https://s7d9.scene7.com/s7viewers/html5/eCatalogSearchViewer.html?emailurl=https://s7d9.scene7.com/s7/emailFriend&serverUrl=https://s7d9.scene7.com/is/image/&config=Scene7SharedAssets/Universal_HTML5_eCatalog_Search&contenturl=https://s7d9.scene7.com/skins/&asset=Viewers/Pluralist&searchserverurl=https://s7search1.scene7.com/s7search/" target="_blank">Open pop-up viewer</a>

關於固定大小嵌入模式和響應式設計嵌入模式

在內嵌模式中，檢視器會新增至現有網頁，而現有網頁可能已有與檢視器無關的客戶內容。觀看者通常只佔有網頁的一部分房地產。

主要使用案例是以桌上型電腦或平板電腦裝置為導向的網頁，以及可回應的設計頁面，這些頁面會根據裝置類型自動調整版面。

當檢視器在初始載入後未變更大小時，會使用固定大小內嵌。這是靜態版面的網頁最佳選擇。

回應式設計內嵌假設檢視器可能需要在執行階段調整大小，以回應其容器DIV的大小變更。最常見的使用案例是在使用彈性頁面版面的網頁中新增檢視器。

在回應式設計內嵌模式中，檢視器的運作方式會因網頁大小其容器DIV而有所不同。如果網頁僅設定容器的寬度DIV，保持高度不受限制，則檢視器會根據所使用資產的外觀比例自動選擇其高度。此功能可確保資產完全符合檢視，而無需邊框上的邊框間距。此使用案例是使用回應式版面架構(如Bootstrap、Foundation等)的網頁中最常見的使用案例。

否則，如果網頁同時設定了查看器容器DIV的寬度和高度，則查看器只會填入該區域，並遵循網頁佈局提供的大小。一個很好的範例是將檢視器嵌入強制回應覆蓋中，其中覆蓋會根據網頁瀏覽器視窗大小來調整大小。

固定大小嵌入

您可以執行下列操作，將檢視器新增至網頁：

將檢視器JavaScript檔案新增至您的網頁。
定義容器DIV。
設定檢視器大小。
建立和初始化檢視器。
將檢視器JavaScript檔案新增至您的網頁。

建立檢視器需要在HTML標題中新增指令碼標籤。使用檢視器API之前，請務必加入eCatalogSearchViewer.js。 eCatalogSearchViewer.js檔案位於標準IS-Viewers部署的html5/js/子資料夾下：

<s7viewers_root>/html5/js/eCatalogSearchViewer.js

如果檢視器部署在其中一個AdobeDynamic Media伺服器上，且是從相同網域提供，則可使用相對路徑。否則，您將指定安裝IS-Viewers之一的AdobeDynamic Media伺服器的完整路徑。

相對路徑如下所示：

<script language="javascript" type="text/javascript" src="/s7viewers/html5/js/eCatalogSearchViewer.js"></script>

定義容器DIV。

將空白的DIV元素新增至您希望檢視器顯示的頁面。 DIV元素必須定義其ID，因為此ID稍後會傳遞至檢視器API。

預留位置DIV是已定位的元素，這表示position CSS屬性已設為relative或absolute。

以下是定義預留位置DIV元素的範例：
```
<div id="s7viewer" style="position:relative"></div>
```
設定檢視器大小

您可以為檢視器設定靜態大小，方法是以絕對單位為.s7ecatalogsearchviewer頂層CSS類別聲明，或使用stagesize修飾詞。

您可以直接將CSS中的大小調整放在HTML頁面上，或放在自訂檢視器CSS檔案中，該檔案稍後會指派給Dynamic Media Classic中的檢視器預設集記錄，或使用style命令明確傳遞。

如需使用CSS來設定檢視器樣式的詳細資訊，請參閱自訂eCatalog檢視器。

以下是在HTML頁面中定義靜態檢視器大小的範例：
```
#s7viewer.s7ecatalogsearchviewer { 
 width: 640px; 
 height: 480px; 
}
```
您可以在Dynamic Media Classic的檢視器預設集記錄中設定stagesize修飾元，或以params集合的檢視器初始化程式碼明確傳遞，或以「命令參考」區段所述之API呼叫的形式傳遞，如下所示：
```
eCatalogSearchViewer.setParam("stagesize", 
"640,480");
```
正在初始化查看器。

完成上述步驟後，可以建立s7viewers.eCatalogSearchViewer類的實例，將所有配置資訊傳遞到其建構子，並在查看器實例上調用init()方法。設定資訊會以JSON物件的形式傳遞至建構函式。此物件至少會有containerId欄位，該欄位包含檢視器容器ID的名稱，並巢狀params JSON物件，以及檢視器支援的設定參數。在此情況下，params物件至少必須以serverUrl屬性傳遞影像伺服URL，並以asset參數傳遞初始資產。 JSON型初始化API可讓您使用一行程式碼來建立和啟動檢視器。

請務必將檢視器容器新增至DOM，讓檢視器程式碼可以透過其ID來尋找容器元素。有些瀏覽器會延遲建立DOM，直到網頁結尾為止。但是，要獲得最大相容性，請在結尾的BODY標籤前或在body onload()事件上調用init()方法。

同時，容器元素還不一定是網頁版面的一部分。例如，可使用指派給它的display:none樣式來隱藏它。在此情況下，檢視器會延遲其初始化程式，直到網頁將容器元素帶回版面的那一刻為止。發生此情況時，檢視器載入會自動繼續。

以下是建立查看器實例、將最小必要配置選項傳遞給建構子並調用init()方法的示例。此範例假設eCatalogSearchViewer為檢視器例項；s7viewer是佔位符DIV的名稱；http://s7d1.scene7.com/is/image/是影像伺服URL，而Viewers/Pluralist是資產：
```
<script type="text/javascript"> 
var eCatalogSearchViewer = new s7viewers.eCatalogSearchViewer({ 
 "containerId":"s7viewer", 
"params":{ 
 "asset":"Viewers/Pluralist", 
 "serverurl":"http://s7d1.scene7.com/is/image/", 
 "searchserverurl":"http://s7search1.scene7.com/s7search/" 
} 
}).init(); 
</script>
```
以下代碼是嵌入大小固定的eCatalog搜索查看器的簡單網頁的完整示例：
```
<!DOCTYPE html> 
<html> 
<head> 
<script type="text/javascript" src="http://s7d1.scene7.com/s7viewers/html5/js/eCatalogSearchViewer.js"></script> 
<style type="text/css"> 
#s7viewer.s7ecatalogsearchviewer { 
 width: 640px; 
 height: 480px; 
} 
</style> 
</head> 
<body> 
<div id="s7viewer" style="position:relative"></div> 
<script type="text/javascript"> 
var eCatalogSearchViewer = new s7viewers.eCatalogSearchViewer({ 
 "containerId":"s7viewer", 
"params":{ 
 "asset":"Viewers/Pluralist", 
 "serverurl":"http://s7d1.scene7.com/is/image/", 
 "searchserverurl":"http://s7search1.scene7.com/s7search/" 
} 
}).init(); 
</script> 
</body> 
</html>
```

無限制高度的回應式設計內嵌

透過回應式設計內嵌，網頁通常會有某種彈性的版面配置，指定檢視器容器DIV的執行階段大小。在此範例中，假設網頁允許檢視器的容器DIV取用40%的網頁瀏覽器視窗大小，使其高度不受限制。產生的網頁HTML程式碼如下所示：

<!DOCTYPE html> 
<html> 
<head> 
<style type="text/css"> 
.holder { 
 width: 40%; 
} 
</style> 
</head> 
<body> 
<div class="holder"></div> 
</body> 
</html>

將檢視器新增至此類頁麵類似於固定大小內嵌，唯一的差異是您不需要明確定義檢視器大小。

將檢視器JavaScript檔案新增至您的網頁。
定義容器DIV。
建立和初始化檢視器。

上述所有步驟與固定大小嵌入相同。將容器DIV添加到現有的「保持器」 DIV。下列程式碼為完整的範例。您可以查看瀏覽器調整大小時檢視器大小的變更，以及檢視器外觀比例與資產的相符情形。

<!DOCTYPE html> 
<html> 
<head> 
<script type="text/javascript" src="http://s7d1.scene7.com/s7viewers/html5/js/eCatalogSearchViewer.js"></script> 
<style type="text/css"> 
.holder { 
 width: 40%; 
} 
</style> 
</head> 
<body> 
<div class="holder"> 
<div id="s7viewer" style="position:relative"></div> 
</div> 
<script type="text/javascript"> 
var eCatalogSearchViewer = new s7viewers.eCatalogSearchViewer({ 
 "containerId":"s7viewer", 
"params":{ 
 "asset":"Viewers/Pluralist", 
 "serverurl":"http://s7d1.scene7.com/is/image/", 
 "searchserverurl":"http://s7search1.scene7.com/s7search/" 
} 
}).init(); 
</script> 
</body> 
</html>

下列範例頁面說明在不受限制高度下內嵌回應式設計的更多實際使用案例：

即時演示

定義寬度和高度的靈活大小嵌入

若是定義寬度和高度的彈性內嵌，網頁樣式會有所不同。也就是說，它會提供「holder」 DIV的兩種大小，並將其置於瀏覽器視窗中。此外，網頁還將HTML和BODY元素的大小設定為100%:

<!DOCTYPE html> 
<html> 
<head> 
<style type="text/css"> 
html, body { 
 width: 100%; 
 height: 100%; 
} 
.holder { 
 position: absolute; 
 left: 20%; 
 top: 20%; 
 width: 60%; 
height: 60%; 
} 
</style> 
</head> 
<body> 
<div class="holder"></div> 
</body> 
</html>

其餘的嵌入步驟與高度不受限制的響應式設計嵌入相同。產生的範例如下：

<!DOCTYPE html> 
<html> 
<head> 
<script type="text/javascript" src="http://s7d1.scene7.com/s7viewers/html5/js/eCatalogSearchViewer.js"></script> 
<style type="text/css"> 
html, body { 
 width: 100%; 
 height: 100%; 
} 
.holder { 
 position: absolute; 
 left: 20%; 
 top: 20%; 
 width: 60%; 
height: 60%; 
} 
</style> 
</head> 
<body> 
<div class="holder"> 
<div id="s7viewer" style="position:relative"></div> 
</div> 
<script type="text/javascript"> 
var eCatalogSearchViewer = new s7viewers.eCatalogSearchViewer({ 
 "containerId":"s7viewer", 
"params":{ 
 "asset":"Viewers/Pluralist", 
 "serverurl":"http://s7d1.scene7.com/is/image/", 
 "searchserverurl":"http://s7search1.scene7.com/s7search/" 
} 
}).init(); 
</script> 
</body> 
</html>

使用基於Setter的API嵌入

與其使用JSON型初始化，您可以使用setter型API和無目標建構子。使用該API建構函式時，不會採用任何參數，且會使用setContainerId()、setParam()及setAsset() API方法（搭配個別的JavaScript呼叫）指定設定參數。

下列範例顯示使用setter型API進行固定大小內嵌：

<!DOCTYPE html> 
<html> 
<head> 
<script type="text/javascript" src="http://s7d1.scene7.com/s7viewers/html5/js/eCatalogSearchViewer.js"></script> 
<style type="text/css"> 
#s7viewer.s7ecatalogsearchviewer { 
 width: 640px; 
 height: 480px; 
} 
</style> 
</head> 
<body> 
<div id="s7viewer" style="position:relative"></div> 
<script type="text/javascript"> 
var eCatalogSearchViewer = new s7viewers.eCatalogSearchViewer(); 
eCatalogSearchViewer.setContainerId("s7viewer"); 
eCatalogSearchViewer.setParam("serverurl", "http://s7d1.scene7.com/is/image/"); 
eCatalogSearchViewer.setParam("searchserverurl", "http://s7search1.scene7.com/s7search/"); 
eCatalogSearchViewer.setAsset("Viewers/Pluralist"); 
eCatalogSearchViewer.init(); 
</script> 
</body> 
</html>

adobe.com 上的資源

Style System Auto Form Fill Embedded Charts Version History Content Management Headless Cms

eCatalog搜尋

示範URL

使用eCatalog檢視器

與eCatalog搜尋檢視器互動

使用eCatalog搜尋檢視器的社交媒體分享工具

嵌入eCatalog搜索查看器

adobe.com 上的資源

本頁內容

檢視下一個:

學習

說明文件

社群

技術支援

資源

Adobe 帳戶

Adobe