配置 JSP 程式庫定義
JSP 程式庫定義
「JSP 程式庫定義」編輯器用來配置如何將新的 JSP 程式庫納入至專案的詳細資料。
關於這項作業
- 程式庫名稱
- 程式庫的名稱。
- 說明
- 程式庫的說明。
- Taglib URI
- 元件程式庫的 taglib URI。
- 字首
- 提供給標籤的字首。
- 版本
- 版本號碼指出程式庫定義中的配置層次。當現有 Web 應用程式可能有可用的新資源時,它會以信號示意。在初次建立程式庫定義時,會挑選對所選標籤庫有意義的版本。舉例來說,從可公開取得之標籤庫的版次號碼開始。一般的版本號碼格式是帶點字串,例如 1.2.3.4。當程式庫定義使用中,且標籤庫的資源已安裝在一或多個 Web 應用程式中之後,如果對該定義進一步變更,就可能需要進行版本更新。只要在已部署之程式庫定義的應用程式配置區段中進行變更,版本號碼就會增加。增加的版本號碼是向工作台指出,有可用的新資源或配置變更。凡是使用標籤庫的 Web 專案都會標示錯誤。與該錯誤相關聯的「快速修正程式」可利用現行配置來更新 Web 專案。記住: 如果未在 Web 專案中新增標籤庫,就不需要增加版本號碼。系統會動態讀取對「程式庫定義」的任何區域(但不包括「應用程式配置」區段)所做的變更,因此不需要進行版本變更。
應用程式配置
以下詳述如何將 Web 專案設定成使用新的元件程式庫。配置會宣告如何將檔案複製到 Web 專案,以及為了使元件運作正常而必須進行的任何配置變更。
關於這項作業
- 資源
- 資源區域用來定義當第一次使用程式庫時,要複製到 Web 專案中的檔案。來源路徑是「JSP 定義」專案內之檔案的相對路徑。目標路徑是使用程式庫之專案中的路徑。例如,對來源路徑 /mystylesheet.css 中的檔案來說,其目標可能是 /theme。此目標路徑會產生 CSS 檔案副本,並放在 Web 專案的 /theme 資料夾中。
- web.xml 更新
- 此區段提供資訊,來說明對於使用程式庫之 Web 專案的部署描述子, 可進行數種類型的修改。新的 Servlet、環境定義參數以及過濾器,都可配置在編輯器的相對應子區段之下。
- 如果要新增 Servlet、環境定義參數或過濾器,請執行下列動作:
- 選取 web.xml。
- 按一下新增,並從對話框中選取項目。
- Servlet
- 這個頁面定義要新增至 web.xml 的新 Servlet 的參數。
- 環境定義參數
- 此區段記錄有關將環境定義參數新增至 Web 部署描述子的詳細資料。當在 Web 專案中第一次使用程式庫時,會修改 web.xml 檔,以包含此資訊。
- 過濾器
- 此區段定義新的過濾器,以新增至 web.xml 檔。當在編輯器中按一下新增時,會新增這個過濾器的起始設定參數。
- 起始設定參數
- 此頁面收集 web.xml 過濾器定義起始設定參數的相關資料。
- URL 對映
- 此區段收集過濾器的任何 URL 型對映。
- Servlet 對映
- 此區段收集以定義在 web.xml 中其他位置之 Servlet 名稱為基礎的過濾器對映。
標籤庫
此區段列出構成程式庫的所有自訂標籤, 並且可讓您配置工具行為的一些詳細資料。例如,您可以在「選用區」中指定標籤的外觀、 將標籤放到編輯器時的行為、網頁原始檔中之元件的視覺化外觀, 以及標籤屬性和資料連結的各種相關詳細資料。
關於這項作業
編輯器的這個區段用來配置元件庫中實際標籤的相關詳細資料。當產生程式庫定義時,它會包含元件程式庫中的所有標籤。您可以使用上移和下移按鈕,來變更標籤的順序 . 指定的標籤順序會顯示在「選用區」中的程式庫外觀內。
在這個頁面中,您可以配置程式庫選用區種類的相關視覺化資訊。請在這裡配置任何樣式表鏈結或 JavaScript 參照,以便套用至程式庫中的所有標籤。當從選用區新增標籤時,會將對應的 <link> 和 <script> 標籤新增至網頁。
- 標籤
- 這個頁面是配置選用區中的元件標籤外觀,包括:圖示和標籤 (label) 資訊。依預設,也可以隱藏標籤,或從選用區選項中移除。
- 放下內容
- 從選用區插入新標籤的行為,可用這個頁面中的參數來修改。如果元件是一個儲存器型的控制項,並容許其他元件作為子項,請選取容許子項。您可以依標籤,在這個頁面中分別指定樣式表鏈結和 JavaScript 參照。也可以在「標籤」頁面中,針對整個程式庫建立樣式表和 JavaScript 規格。
- 預設標籤屬性
- 如果要設定標籤的預設屬性值,請指定屬性的名稱和值。從選用區新增元件標籤時,會自動設定這個屬性值。
- 視覺化
- 對於多數元件,可以正確呈現視覺化頁面編輯器中所顯示的標籤。在某些情況下,標籤會整個呈現失敗,或者未能適當呈現。如果呈現失敗,標籤會以灰框配上標籤名稱出現。當發生此問題時,您可以指定基本 HTML 標籤,並提供一些變數修飾元,來自訂標籤的外觀。這個標籤可在頁面編輯器內作為替換的視覺化。
- 系統會提供範例視覺化範本,並包含一些範例,來說明如何使用變數修飾元。如果要檢視範本,請按一下「詳細資料」區段中的編輯。進一步瞭解視覺化型樣變數:
視覺化型樣用來在頁面編輯器的設計窗格中控制元件的外觀。型樣是由 HTML 標記與一些選用的替代變數組成,可動態變更視覺化的內容。將元件拖曳至頁面時,會評估對應的型樣。頁面編輯器使用產生的 HTML,來建立有用的設計時期表示法。表格 1 顯示可用型樣變數的詳細資料。
表 1. 視覺化型樣變數. 說明和範例提供變數的相關資訊。 變數 說明 範例 ${children} ${children} 變數會在型樣中之 ${children} 變數的位置,針對要視覺化的標籤,產生其所有的子標籤(若有的話)。子標籤的插入順序,就是其出現在原始頁面中的順序。由於子標籤也可以使用型樣,頁面編輯器會計算這些子標籤的視覺化。由於所有子標籤都是插入到相同位置,型樣可以只使用一個 ${children} 變數。 <div> ${children} </div>${children:row} ${children} 變數的 row 修飾元會依 HTML 表格資料格 <td> 元素的順序,來產生子標籤。當您要水平排列多個元件時,請使用此變數。 <table> <tr> ${children:row} </tr> </table>${children:grid(param[,param]*)} grid 修飾元會建立一組 HTML 表格列和資料格,且其中含有標籤的子項。會從左到右新增子項,並在抵達指定的直欄數時,折返到下一列。預設直欄計數是 2。選用的參數清單(以逗點區隔)會置換網格中的直欄數。
參數選項如下:- attr.attrName
- 具有 attrName 名稱之標籤屬性的值。這個參數必須解析成整數。
- N
- 正整數常數。
會循序檢查參數,直到找到有效值為止。例如,${children:grid(attr.size, attr.numcols, 3)} 型樣會使用標籤的 size 屬性(若有定義的話),否則會使用 numcols 屬性(若有定義的話)。如果這些屬性都沒有定義,則會使用常數 3。
<table> ${children:grid(attr.columns, 2)} </table>${children:stack(param)} stack 修飾元用於已加上標籤的畫面中,以建立表格列和資料格,來移入堆疊資料格視覺化。它會建立水平的標籤 (label) 表格,可讓您針對每一個子標籤 (tag) 按一下所要的標籤 (label)。當按一下其中一個標籤 (label) 時,會在堆疊頂端將子標籤 (tag) 視覺化。選用參數可讓您使用 attr.attrName 語法,來指定要讓標籤 (label) 採用子標籤 (tag) 的哪個標籤 (tag) 屬性。 <table> ${children:stack(attr.label)} </table>${attr:attrName} 這個變數會替換位於型樣現行位置之標籤的屬性值。如果屬性沒有設定值,會插入空字串。 <input type="text" value="${attr:value}" /> - 標籤屬性
- 您可以針對每一個標籤,指定屬性說明和類型。清單中的屬性順序和每一個屬性的類型,會影響它們在「內容」視圖中的顯示和編輯方式。某些類型指出一組可用的選項,或可協助設定屬性值的特定 Helper 對話框。
- 內容視圖
- 這個選用區段含有使用者介面元素,以及使用者定義之「內容視圖」頁面的佈置資訊。巢狀子元素可以新增至「內容視圖」區段之下,來定義一或多個標籤的內容。
- 標籤 (Tab)
- 標籤包含它的其他使用者介面元素,並且對應至「內容視圖」。標籤名稱顯示在視圖中,一開始會顯示主要(第一個)標籤。第一個標籤一律使用所選標籤的名稱,因此會忽略第一個標籤之名稱屬性的值。
- 直欄
- 「直欄」元素是以視覺化方式將一組其他的使用者介面元素分組成一個垂直欄。「標籤」或「區段」元素內會定義二或多個直欄,每一個直欄內會配置子控制項。在使用直欄的相同儲存器內,不支援非直欄元素。可能會要求您將多直欄排列,劃分到區段內其自己的區域中。
- 編輯器
- 「編輯器」元素定義:
- 「內容視圖」中要顯示哪種類型的使用者介面控制項,例如:圓鈕。
- 使用者介面控制項要修改現行標籤的哪個屬性。
- 使用者介面控制項旁要顯示哪個字串標籤 (label)。
- 編輯器參數
- 有些編輯器元素可以採用選用編輯器參數,來自訂控制項的行為。例如,您可以使用用來定義容許值的選項參數,來配置組合框和其他類似的選擇控制項。選項參數的值使用 enum{value1, value2, value3} 語法,如果在組合框中使用個別的標籤和值,則語法是:enum{name1:value1, name2:value2}。其他預先定義的編輯器參數大部分都接受 true 或 false 值。
- 標籤 (Label)
- 「標籤」元素會在「內容視圖」中放置一個含有文字資訊的標籤。
- 區段
- 「區段」元素是一個儲存器,用來定義使用者介面中一個自行包含的部分。區段可以用來控制其所包含之控制項的間距。舉例來說,可以將區段配置成在含括的佈置中跨多個直欄,或針對其本身的內容定義一個新的直欄結構。
- 分隔字元
- 「分隔字元」元素會使用水平尺規,來分割「內容視圖」的內容。