學習目標:把 XML 的語法規則一次弄懂,從此能自己動手寫出合規的 XML 文件與 DTD。
本單元涵蓋:語法規則、元素、註解、CDATA、Namespaces、Entity、DTD。
XML 文件的外觀和 HTML 原始碼很像,同樣靠標識來標記內容,但規則嚴格得多。建立 XML 文件必須遵守以下六條。
宣告是 XML 文件的第一句,格式如下:
<?xml version="1.0" standalone="yes/no" encoding="UTF-8"?>
它的作用是告訴瀏覽器或其他處理程式:這是一個 XML 文件。其中 version 表示遵循的 XML 規範版本;standalone 表示文件是否附帶 DTD,有則填 no;encoding 表示語言編碼,預設是 UTF-8。
如果這是一個「有效的 XML 文件」,就必須有對應的 DTD,並嚴格遵守 DTD 的規範。DTD 宣告緊跟在 XML 宣告之後:
<!DOCTYPE type-of-doc SYSTEM/PUBLIC "dtd-name">
各參數意義:!DOCTYPE 表示要定義一個文件類型;type-of-doc 是文件類型名稱,由你自行命名,通常與 DTD 檔名相同;SYSTEM 與 PUBLIC 只能擇一,SYSTEM 指向私有 DTD 的網址,PUBLIC 則指向公用 DTD;dtd-name 是 DTD 的網址與檔名,副檔名一律為 .dtd。
沿用上一單元的例子:
<?xml version="1.0" standalone="no" encoding="UTF-8"?>
<!DOCTYPE filelist SYSTEM "filelist.dtd">
XML 完全區分大小寫,<P> 和 <p> 是兩個不同的標識,而且前後標識的大小寫必須一致。例如 <Author>ajie</Author> 正確,寫成 <Author>ajIE</author> 就會出錯。建議養成固定習慣:全部大寫、全部小寫,或只把首字母大寫,能大幅減少這類錯誤。
HTML 裡 <font color=red> 和 <font color="red"> 都能被正確解析;但在 XML 中,所有屬性值都必須用引號(單引號或雙引號)包起來,否則視為錯誤。
HTML 允許 <br> 這類單獨出現的標識,XML 則要求每個開始標識都有對應的結束標識,否則視為錯誤。
空標識指的是標識之間沒有內容的情況,例如 <br>、<img>。XML 的處理方式是在標識結尾補上一個斜線:
<br> 應寫成 <br />
<META name="keywords" content="XML, SGML, HTML"> 應寫成 <META name="keywords" content="XML, SGML, HTML" />
<IMG src="cool.gif"> 應寫成 <IMG src="cool.gif" />
元素由一對標識加上其中的內容組成,例如 <author>ajie</author>,元素名稱與標識名稱相同,標識可以再掛屬性做補充描述。
XML 沒有保留字,你可以自由命名,但仍須遵守:
實務建議:
另外要特別說明屬性的定位。在 HTML 中,屬性用來控制顯示外觀,例如 <font color="red">word</font> 會讓文字變紅;而在 XML 中,屬性只是對標識的描述,與顯示無關,同樣這行字並不會變紅。要讓 XML 內容呈現特定樣式,得靠 CSS 或 XSL,後面會再談。
註解是寫給人看的補充說明,不會被程式解析或瀏覽器顯示,寫法與 HTML 相同:
<!-- 這裡是註解內容 -->
養成寫註解的習慣,文件會更好維護、更容易共享,看起來也更專業。
CDATA 是 character data(字元資料)的縮寫。當你需要在 XML 中直接顯示 <、> 這類已被賦予特殊意義的字元時,就要靠它:
<![CDATA[這裡放要原樣顯示的內容]]>
例如:
<![CDATA[<AUTHOR sex="female">ajie</AUTHOR>]]>
頁面上會原封不動地顯示 <AUTHOR sex="female">ajie</AUTHOR>。
當一份文件裡同時用到多個 DTD,或引用了別人定義的標識,衝突就來了:不同來源可能用同一個名稱表達完全不同的意思,資料於是混亂。
例如 A 文件裡 <table>wood table</table> 的 table 指「桌子」,B 文件裡 <table>namelist</table> 的 table 指「表格」。若同時處理這兩份資料,就會撞名。
命名空間用「名稱 + URL 前綴」的方式把同名標識區分開。它同樣要在文件開頭宣告:
<document xmlns:yourname='URL'>
yourname 是前綴名稱,URL 是命名空間位址。假設「桌子」那份資料來自 https://www.zhuozi.com:
<document xmlns:zhuozi='https://www.zhuozi.com'>
<zhuozi:table>wood table</zhuozi:table>
要留意:寫上 URL 並不代表程式真會去那個位址抓東西,它只是一個辨識用的標記。
Entity 的作用有點像 Word 的「巨集」或 Dreamweaver 的「模板」:先定義一次,之後就能在文件裡反覆引用,甚至跨文件共用。它可以是字元、文字或任何片段。
好處有兩個:一是減少出錯,重複的內容只要輸入一次;二是維護效率高,例如四十份文件都引用同一段版權宣告,要改時只需改最初那一處定義。
XML 定義了兩類 entity:一般 entity 用於 XML 文件,參數 entity 用於 DTD。定義語法:
<!DOCTYPE filename [
<!ENTITY entity-name "entity-content"
]>
例如定義一段版權資訊:
<!DOCTYPE copyright [
<!ENTITY copyright "Copyright 2001, Ajie. All rights reserved"
]>
若要與他人共用同一份外部檔案,可改用外部呼叫:
<!DOCTYPE copyright [
<!ENTITY copyright SYSTEM "https://www.sample.com/copyright.XML">
]>
引用時寫成 &entity-name;。完整範例(可存成 copyright.XML 直接觀看):
<?xml version="1.0" encoding="GB2312"?>
<!DOCTYPE copyright [
<!ENTITY copyright "Copyright 2001, Ajie. All rights reserved">
]>
<myfile>
<title>XML</title>
<author>ajie</author>
<email>ajie@aolhoo.com</email>
<date>20010115</date>
©right;
</myfile>
DTD 是「有效 XML 文件」的必要配備,用來定義元素、屬性以及元素之間的關係。
1. 定義元素
元素定義語法:<!ELEMENT DESCRIPTION (#PCDATA, DEFINITION)*>
其中 <!ELEMENT 是元素宣告;DESCRIPTION 是元素名稱;括號內的部分則是這個元素的使用規則,規範它能包含什麼內容、以什麼順序與次數出現。
2. 元素規則對照表
#PCDATA — 包含字元或文字資料。例:<MYFILE(#PCDATA)> 表示 MYFILE 含一段文字。
#PCDATA, element-name — 同時包含文字與子元素。例:<MYFILE(#PCDATA,TITLE)> 表示 MYFILE 必須含文字和 TITLE 子元素。
逗號 , — 依序排列。例:<MYFILE (TITLE,AUTHOR,EMAIL)> 表示必須依序出現 TITLE、AUTHOR、EMAIL。
豎線 | — 表示「或」。例:<MYFILE (TITLE | AUTHOR | EMAIL)> 表示三者之一。
name — 只能出現一次。例:<MYFILE (TITLE)>。
name? — 出現一次或不出現。例:<MYFILE (TITLE,AUTHOR?,EMAIL?)> 中 AUTHOR、EMAIL 可有可無,但若出現只能一次。
name+ — 至少一次,可多次。例:<MYFILE (TITLE+,AUTHOR?,EMAIL)>。
name* — 一次、多次或完全不出現。例:<MYFILE (TITLE*)>。
( ) — 分組,可巢狀。例:<MYFILE(#PCDATA | TITLE)*> 表示 MYFILE 可含一個或多個文字或 TITLE 子元素;<MYFILE((TITLE*, AUTHOR?, EMAIL)* | COMMENT)> 則表示內容可以是一段註解,也可以是一個或多個由 TITLE、AUTHOR、EMAIL 組成的區塊。
元素也可以定義屬性,但由於不建議依賴屬性,這裡不展開。
把 DTD、XML 與 JavaScript 串起來,你就有了一個能跑的最小完整範例。
1. 存成 myfile.dtd:
<!ELEMENT myfile (title, author)>
<!ELEMENT title (#PCDATA)>
<!ELEMENT author (#PCDATA)>
2. 建立 myfile.XML:
<?xml version="1.0" encoding="GB2312"?>
<!DOCTYPE myfile SYSTEM "myfile.dtd">
<myfile>
<title>XML輕鬆學習手冊</title>
<author>ajie</author>
</myfile>
3. 建立 myfile.htm:
<html>
<head>
<script language="JavaScript" for="window" event="onload">
var xmlDoc = new ActiveXObject("Microsoft.XMLDOM");
xmlDoc.async = "false";
xmlDoc.load("myfile.XML");
nodes = xmlDoc.documentElement.childNodes;
title.innerText = nodes.item(0).text;
author.innerText = nodes.item(1).text;
</script>
<title>在 HTML 中呼叫 XML 資料</title>
</head>
<body bgcolor="#FFFFFF">
<b>標題:</b> <span id="title"></span><br>
<b>作者:</b> <span id="author"></span><br>
</body>
</html>
4. 用 IE5.0 以上版本的瀏覽器打開 myfile.htm,就能看到資料被讀出來的效果。
下一章我們會看一個 XML 實際應用的完整案例,見識它真正的實力。