做 Dreamweaver 外掛開發時,中文資料相對稀少,官方文件多半只有英文版。以下內容整理自 Dreamweaver 8 附帶的《Extending Dreamweaver 8》,重點說明第三方標籤的定義機制。
ASP、ColdFusion、JSP、PHP 等伺服器端技術,會在 HTML 檔中使用非 HTML 的特殊語法,由伺服器動態產生內容。當 Dreamweaver 偵測到非 HTML 標籤時,會去比對第三方標籤的定義檔,藉此得知該如何讀取與顯示這些標籤。
舉例來說,ASP 檔除了 HTML 之外還包含 <% 與 %> 包住的程式碼。在 Dreamweaver 的 Configuration/ThirdPartyTags 資料夾中有一個名為 Tags.xml 的檔案,就是描述各類第三方標籤規範、並定義 Dreamweaver 顯示方式的地方。因為 ASP 已在其中有了規範,Dreamweaver 便不會嘗試解析 <%...%> 之間的內容,而是在設計檢視中顯示一個圖示代表這段程式碼。
你可以定義自己的標籤,並為每一套標籤建立獨立的標籤庫檔案。
注意:本節說明的是「如何讓 Dreamweaver 正確顯示自訂標籤」,並不涵蓋編輯標籤內容或屬性的方法。若要製作屬性 inspectors 來檢視與修改屬性,請參考相關章節。
每個標籤庫檔會定義一個或多個自訂標籤的名稱、類型、內容模式、顯示規範與圖示。你可以建立任意數量的標籤庫檔,但它們必須放在 Configuration/ThirdPartyTags 資料夾中,副檔名為 .xml。
提示:如果你同時維護好幾個不同網站,可以把所有標籤規範集中在一個檔案裡,連同自訂圖示與屬性 inspectors 一起放在某個特定站點。日後交接時,整個標籤庫就能完整移交。
使用 tagspec 這個 XML 標籤來描述一項標籤規範。以下範例定義了一個名為 happy 的標籤:
<tagspec tag_name="happy" tag_type="nonempty" render_contents="false" content_model="marker_model" icon="happy.gif" icon_width="18" icon_height="18"></tagspec>
tagspec 可以定義兩類標籤:
HTML 式的普通標籤
如上例,由 <happy> 開始、在兩者之間含內容、最後以 </happy> 結束。
以字串界定的標籤
由一個字串開始、另一個字串結束,性質上近似 HTML 的空標籤(如 img),因為它既不包含內容也沒有閉合標籤。若 happy 屬於這一類,定義中必須加上 start_string 與 end_string 兩個屬性。ASP 標籤就是典型例子:從 <% 開始、到 %> 結束,沒有閉合標籤。
下列屬性中,帶星號(*)者不適用於字串界定標籤;可選屬性以大括號標示,其餘為必填。
tag_name:自訂的名稱。對字串界定標籤而言,這個名稱只用來判斷某個屬性 inspector 是否適用——若 inspector 第一行在符合規範的位置包含了這個標籤名並標上星號,它就會被允許處理該類標籤。例如 ASP 的標籤名就是 ASP,能檢查 ASP 的 inspector 第一行必須包含 *ASP*。
tag_type:決定標籤是空的(如 img)還是允許在開閉標籤之間放內容(如 code)。此屬性對普通標籤為必填,對字串界定標籤則無效,因為後者一律視為空。有效值為 empty 與 nonempty。
render_contents:決定設計檢視中要顯示標籤內容,還是以特定圖示取代。僅對非空標籤有必要,空標籤沒有內容可顯示。另外,此屬性只作用於插入在屬性之外的標籤;若標籤被插入其他標籤的屬性值內,其內容不會顯示。有效值為 true 或 false。
content_model:描述該標籤能包含哪一類內容,以及它能被插入 HTML 檔的什麼位置。有效值包括 block_model 等選項。
其餘如 icon、icon_width、icon_height 決定設計檢視中的替代圖示與尺寸;detect_in_attribute、parse_attributes 影響偵測與屬性解析行為;equivalent_tag、is_visual、server_model 則分別用於指定等效標籤、是否為視覺元素,以及對應的伺服器端模型。