document 是每個網頁的入口物件。這篇把它常用的屬性、方法與子物件整理成一份可以隨時翻的清單。
document.title:設定文件標題,等同 HTML 的 title 標籤document.bgColor:頁面背景色document.fgColor:前景色(文字顏色)document.linkColor:未點擊過的連結顏色document.alinkColor:作用中連結(焦點在此)的顏色document.vlinkColor:已點擊過的連結顏色document.URL:目前頁面網址document.charset:字元集,簡體中文為 gb2312document.cookie:讀寫 cookiedocument.fileCreatedDate / fileModifiedDate / fileSize:唯讀,且僅 IE 支援document.write() // 動態向頁面寫入內容 document.createElement(Tag) // 建立一個 HTML 元素物件 document.getElementById(ID) // 依 id 取得元素 document.getElementsByName(Name) // 依 name 取得元素集合 document.body.appendChild(oTag) // 掛到 body 底下
document.write() 在頁面載入完成後呼叫會清空整個文件,實務上請改用 DOM 操作。
document.body:文件主體,等同 <body>...</body>bgColor、link、alink、vlink、text:背景色、各類連結顏色、文字色innerText:設定 body 之間的純文字innerHTML:設定 body 之間的 HTML 碼topMargin / leftMargin / rightMargin / bottomMargin:四邊留白(非標準,建議改用 CSS margin)background:背景圖片appendChild(oTag):動態生成並掛上元素document.body.onclick = "func()" // 單擊 document.body.onmouseover = "func()" // 指標移入 document.body.onmouseout = "func()" // 指標移出
hash:# 號後的部分host:主機名(含連接埠)hostname:域名href:完整 URLpathname:目錄與檔案路徑port:連接埠protocol:網路協定,如 http:search:? 號後的查詢字串reload():重新載入assign(URL) / replace(URL):跳轉(replace 不留歷史紀錄)用來操作使用者在頁面上選取的文字:
<div>請選中這裡的部分文字。</div>
<div><input type="button" value="清除選取"
onclick="javascript:Foo();" /></div>
<script type="text/javascript">
function Foo() {
document.selection.empty();
}
</script>
document.selection.createRange() 會依當前選取回傳 TextRange 或 ControlRange 物件。搭配 execCommand 可以做加粗、斜體、複製、貼上、建立超連結等所見即所得編輯操作。要注意這整套 API 屬 IE 特有,標準做法請用 window.getSelection() 與 Range 物件。
document.images.length // img 標籤數量 document.images[0] // 第一個 img document.images[i] // 第 i-1 個 img document.images.oImage // 依 name 屬性存取 document.images.oImage.src // 取圖片網址
動態建立圖片:
var oImage = new Image(); oImage.src = "1.jpg";
document.forms.length // form 數量 document.forms[0] // 第一個 form document.forms[i].length // 該 form 中的控制項數量 document.forms[i].elements[j] // 該 form 中第 j-1 個控制項 document.Myform.myctrl // 依 form name 與控制項 name 存取
表單屬性對應:name、action、encoding(對應 enctype)、target。
唯讀屬性,回傳值有五種狀態(Firefox 早期版本不支援):
0 - UNINITIALIZED:物件已建立,尚未載入任何文件1 - LOADING:載入進行中,尚未開始解析2 - LOADED:部分內容已載入並解析,物件模型尚未生效3 - INTERACTIVE:已載入部分可用,物件模型有效但唯讀4 - COMPLETED:文件完全載入document.onreadystatechange = subSomething;
function subSomething() {
if (document.readyState == "complete") {
// 頁面完全就緒後的操作
}
}
現在的標準做法是監聽 DOMContentLoaded(DOM 就緒)與 load(含資源載入完成)兩個事件,不必再輪詢 readyState。
它代表文件中的所有元素,以陣列形式保存,因此可以這樣動態改屬性:
document.all["元素名"].屬性名 = "屬性值";
用這一句話就能做出大量動態效果:換圖、改文字背景、改網頁背景、調整圖片或文字大小與顏色等。
以下範例列出文件中所有元素的標籤名:
<script type="text/javascript">
var i, origLength;
origLength = document.all.length;
document.write('document.all.length=' + origLength + "<br />");
for (i = 0; i < origLength; i++) {
document.write("document.all[" + i + "]=" + document.all[i].tagName + "<br />");
}
</script>
執行結果會依序列出 !、HTML、HEAD、TITLE、META、BODY、H1、HR、P、EM…… 等標籤,共 18 項。
存取特定元素有多種寫法:
document.all["docid"]
document.all["docname"]
document.all.item("docid")
document.all[7]
document.all.tags("div")[0] // 回傳所有 div 的集合
用這些方式可以動態修改元素屬性,例如點擊時改 <h1> 的對齊與顏色:
<input type="button" value="Red" onclick="document.all['heading1'].style.color='red';" /> <input type="button" value="Change Text" onclick="document.all['heading1'].innerText=document.testform.userText.value;" />
本頁多數內容屬於 DOM Level 0 與 IE 私有 API 的時代產物,document.all、document.layers、innerText、bgColor 這類寫法如今都應避免。查閱它的價值在於讀懂老系統的程式碼。
現代開發請改用標準 API:querySelector / querySelectorAll 取元素,classList 操作樣式類別,addEventListener 綁事件,fetch 取代 cookie 之外的手工請示,樣式一律交給 CSS。把這份清單當成「對照表」,你就知道舊寫法該換成什麼。