在 CustomizableIntroPart 中顯示靜態 HTML 內容

如同任何簡介組件的實作一樣,若要使用 CustomizableIntroPart,您需要遵循基本步驟將它連結到產品。不過,需要有一個額外的步驟來使用這個簡介組件,且會與一個「配置」連結。如同將簡介連結到產品一樣,您必須將 introConfig 連結到 customizableIntroPart。以下是個配置範例:


<extension point="org.eclipse.ui.intro.config">
	<config id = "static001_configId"
		introId="org.eclipse.ui.intro.examples.static_introId"
		content="introContent.xml">
		<presentation  home-page-id="homePageId" 
			standby-page-id="standbyPageId">
			<implementation os="win32" kind="html" /> 
			<implementation kind="swt" />            
		</presentation>
	</config>   
</extension>

在上述構成要素中,以 ID 為 org.eclipse.ui.intro.examples.static_introId 的簡介組件 登錄了一個配置。(假設這個簡介組件是個可自訂的簡介組件實例,且已向工作台登錄。)這個配置定義了要呈現在簡介組件中的內容,並指出呈現給使用者的方式。 其內容會定義在 XML 標記檔 introContent.xml 中,而呈現方式則是由標記中的兩個 implementation 元素來指定。

配置呈現方式可以是 SWT 瀏覽器型或 UI 表單型的呈現方式。在上述構成要素中,win32 平台的呈現方式會是  "html",也就是瀏覽器型; 而所有其他平台則是 "swt",也就是 UI 表單型。在執行時期,當工作台嘗試建立 CustomizableIntroPart 的實例時,會判斷作業系統並選擇呈現方式正確的實作。
同時,也需要指定 home-page-id 或根頁面,因為這會是 customizableIntroPart 所顯示的第一個頁面。如果也指定了 standby-page-id,當簡介組件處於待命模式時, 它會顯示在簡介組件中。

內容檔的詳細資料位於延伸點文件中。作為簡單的範例以及提供靜態內容,我們會使用以下內容:

<?xml version="1.0" encoding="big5" ?>     
<introContent>
	<page id="homePageId" url="http://eclipse.org"/>
	<page id="standbyPageId" url="./static001/standby.html"/>     
</introContent>

在上述構成要素中,使用了一個簡單的 URL 作為根頁面,在本例中則是指向 eclipse.org 網站的 URL。這是為了簡化起見。根頁面可以是任何 HTML 檔,比方說,會載入 flash 展示畫面的本端 HTML 檔。它也定義了一個待命頁面,該頁面會在簡介進入待命模式時顯示。