document 是 DOM 的入口,幾乎所有頁面操作都要從它開始。以下依功能分類整理它的屬性、子物件與集合介面。
document.title // 設置文檔標題,等價於 HTML 的 <title> 標籤 document.bgColor // 設置頁面背景色 document.fgColor // 設置前景色(文字顏色) document.linkColor // 未點擊過的鏈接顏色 document.alinkColor // 激活鏈接(焦點在此鏈接上)的顏色 document.vlinkColor // 已點擊過的鏈接顏色 document.URL // 設置 URL 屬性,從而在同一窗口打開另一網頁 document.fileCreatedDate // 文件建立日期,只讀屬性 document.fileModifiedDate // 文件修改日期,只讀屬性 document.fileSize // 文件大小,只讀屬性 document.cookie // 設置和讀出 cookie document.charset // 設置字符集,簡體中文為 gb2312
其中 bgColor、fgColor、linkColor 這類屬性已被標記為不建議使用,現代做法應透過 CSS 控制。而 fileCreatedDate 等檔案屬性僅 IE 支援,跨瀏覽器專案中不應依賴。
document.body // 文檔主體的開始與結束,等價於 <body></body> document.body.bgColor // 設置或獲取背景顏色 document.body.link // 未點擊過的鏈接顏色 document.body.alink // 激活鏈接的顏色 document.body.vlink // 已點擊過的鏈接顏色 document.body.text // 文字顏色 document.body.innerText // 設置 <body>...</body> 之間的文字 document.body.innerHTML // 設置 <body>...</body> 之間的 HTML 代碼 document.body.topMargin // 頁面上邊距 document.body.leftMargin // 頁面左邊距 document.body.rightMargin // 頁面右邊距 document.body.bottomMargin // 頁面下邊距 document.body.background // 背景圖片 document.body.appendChild(oTag) // 動態生成一個 HTML 物件
常用事件:
document.body.onclick = "func()" // 鼠標指針單擊對象時觸發 document.body.onmouseover = "func()" // 鼠標指針移到對象時觸發 document.body.onmouseout = "func()" // 鼠標指針移出對象時觸發
要注意 margin 系列屬性對應的是 HTML 的舊式屬性,標準做法是用 CSS 的 margin / padding。
document.location.hash // # 號後的部分 document.location.host // 域名 + 端口號 document.location.hostname // 域名 document.location.href // 完整 URL document.location.pathname // 目錄部分 document.location.port // 端口號 document.location.protocol // 網絡協議(http:) document.location.search // ? 號後的部分
常用方法:
document.location.reload() // 刷新網頁 document.location.reload(URL) // 打開新的網頁 document.location.assign(URL) // 打開新的網頁(會留下歷史紀錄) document.location.replace(URL) // 打開新的網頁(不留下歷史紀錄)
assign 與 replace 的差別在於瀏覽器歷史:前者使用者可以按上一頁回來,後者不行。表單提交後跳轉時常用 replace,以避免使用者按上一頁重複送出。
a) 透過集合引用
document.images // 對應頁面上的 <img> 標籤 document.images.length // 對應頁面上 <img> 標籤的個數 document.images[0] // 第 1 個 <img> 標籤 document.images[i - 1] // 第 i 個 <img> 標籤
b) 透過 name 屬性直接引用
<img name="oImage"> document.images.oImage // document.images 的 name 屬性
c) 引用圖片的 src 屬性
document.images.oImage.src
d) 建立一個圖像物件
var oImage = new Image(); oImage.src = "1.jpg";
同時在頁面上建立一個 <img> 標籤與之對應就可以顯示。
動態建立圖像的兩種寫法:
<html>
<img name="oImage">
<script language="javascript">
var oImage = new Image();
document.images.oImage.src = "1.jpg";
</script>
</html>
<html>
<script language="javascript">
var oImage = document.createElement("IMG");
oImage.src = "1.jpg";
document.body.appendChild(oImage);
</script>
</html>
值得一提的是,new Image() 建立物件後即使不掛進 DOM,瀏覽器仍會載入圖片。這個特性常被用來做圖片預載。
a) 透過集合引用
document.forms // 對應頁面上的 <form> 標籤 document.forms.length // 表單個數 document.forms[0] // 第 1 個表單 document.forms[i - 1] // 第 i 個表單 document.forms[i].elements[j] // 第 i 個表單中第 j 個控件
b) 透過標籤 name 屬性直接引用
<form name="Myform"><input name="myctrl"></form> document.Myform.myctrl // document.表單名.控件名
c) 訪問表單的屬性
document.forms.name // 對應 <form name> 屬性 document.forms.action // 對應 <form action> 屬性 document.forms.encoding // 對應 <form enctype> 屬性 document.forms.target // 對應 <form target> 屬性 document.forms.appendChild(oTag) // 動態插入一個控件
表單控件操作的幾個典型場景:
<!-- Text / Password 控件 --> <form name="Myform"> <input type="text" name="oText"> <input type="password" name="oPswd"> </form> <script language="javascript"> document.write(document.Myform.oText.value); document.write(document.Myform.oPswd.value); </script>
<!-- checkbox:注意同名控件會形成集合 -->
<form name="Myform">
<input type="checkbox" name="chk" value="1">1
<input type="checkbox" name="chk" value="2">2
</form>
<script language="javascript">
function fun() {
var length = document.forms[0].chk.length;
for (var i = 0; i < length; i++) {
// 注意:要用 chk[i] 才能取到各個項目
var v = document.forms[0].chk[i].value;
var b = document.forms[0].chk[i].checked;
alert(v + (b ? "被選中" : "未選中"));
}
}
</script>
<a href="#" onclick="fun()">檢查</a>
<!-- Select 控件 -->
<form name="Myform">
<select name="oSelect">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
</select>
</form>
<script language="javascript">
// 依 selectedIndex 取得選中項的值
var i = document.Myform.oSelect.selectedIndex;
document.write(document.Myform.oSelect.options[i].value);
// 動態增加 option
var oOption = document.createElement("OPTION");
oOption.text = "4";
oOption.value = "4";
document.Myform.oSelect.add(oOption);
</script>
這裡有個容易出錯的細節:當多個控件共用同一個 name(如 checkbox 群組)時,form.chk 得到的是一個集合而非單一元素,必須用索引取值。範例原始碼中 document.forms[0].chk.value 在迴圈裡傳回的都是同一個值,這正是漏了索引的緣故。
<div id="oDiv">Text</div>
document.all.oDiv // 引用圖層 oDiv
document.all.oDiv.style.display="" // 圖層設置為可視
document.all.oDiv.style.display="none" // 圖層設置為隱藏
document.getElementById("oDiv") // 通過 id 引用對象
document.all 表示文件中所有物件的集合,僅 IE 支援,因此過去常用來判斷瀏覽器種類。現代開發請一律使用 document.getElementById() 或 querySelector()。
圖層的四個內容屬性:
document.getElementById("ID").innerText // 動態輸出文字
document.getElementById("ID").innerHTML // 動態輸出 HTML
document.getElementById("ID").outerText // 同 innerText
document.getElementById("ID").outerHTML // 包含自身標籤的 HTML
inner 與 outer 的差別在於是否包含元素自身的標籤。實務上應注意:寫入 innerHTML / outerHTML 時若內容含外部資料,存在 XSS 風險,純文字請改用 textContent。
範例:
<html>
<script language="javascript">
function change() {
document.all.oDiv.style.display = "none";
}
</script>
<div id="oDiv" onclick="change()">Text</div>
</html>
<html>
<script language="javascript">
function changeText() {
document.getElementById("oDiv").innerText = "NewText";
}
</script>
<div id="oDiv" onmouseover="changeText()">Text</div>
</html>
document.getElementsByTagName(tag) // 依標籤名取得集合 document.getElementsByName(name) // 依 name 屬性取得集合 document.querySelector(sel) // CSS 選擇器,回傳單一元素 document.querySelectorAll(sel) // CSS 選擇器,回傳靜態集合 document.createElement(tag) // 建立元素節點 document.createTextNode(text) // 建立文字節點 document.write(html) // 直接寫入文檔流
document.write() 有個重要限制:只能在頁面載入過程中呼叫。若在 load 事件之後呼叫,它會清空整個頁面再寫入內容。動態更新內容請一律使用 DOM 方法。
另外,上面提到的 document.表單名.控件名 這種寫法雖然方便,但依賴表單與控件的 name 屬性,在表單結構複雜或 name 命名衝突時容易出問題。更穩健的做法是 document.forms[i].elements[name] 或 querySelector()。