本文雖以 JavaScript 為主題,但特別聚焦在 Notes/Domino 環境中的應用,從物件模型談起,帶你實際操作單選鈕、複選框等表單元素。即使不使用 Notes,這些觀念同樣值得一看。
在 JavaScript 裡,一切都是從物件展開的。window 是物件模型的頂端,通常就是你的瀏覽器;若視窗裡有框架結構,每個框架又各自是一個小視窗。window 擁有屬性(如位址 URL、狀態列文字)與方法(如開啟、關閉)。由於它在階層頂端,JavaScript 會預設它已存在,因此 window.location 與 location 效果相同。
視窗裡是 Web 頁面,其物件階層從 document 開始,每個視窗只有一個文件。依瀏覽器不同,document 有幾種變化:IE 的 document.all 陣列包含文件中所有物件;某些 Netscape 版本則可存取 document.layers。不過 forms 陣列在所有瀏覽器中都可存取。
理論上每個文件至少含一個表單,也可能有多個,因此引用時要透過陣列元素(下標從 0 開始)。與 LotusScript 用圓括號不同,JavaScript 通常用方括號:
window.document.forms[0]; // 或簡寫成 document.forms[0];
請養成在每條語句末尾加分號的習慣——雖然有些瀏覽器不寫也能跑,但這是好習慣。取得表單後,你就準備好存取其中你最關心的元素了。
不像 Notes 有豐富的欄位型別,在 HTML 中沒有「富文本欄位」,也沒有數字型或時間型欄位——HTML 的欄位全都是文字型。即使你用來收集數量或單價,儲存的仍是文字,要當數字用就必須先做型別轉換。請先把「一切都是文字」這個觀念放在心裡。
開啟 Domino Designer,建立一個新表單,放上一個名為「Get editable field value」的按鈕與一個名為 CreatedBy 的文本欄位,並把預設值設為 @V3UserName。在 ND6 中,你可以在右側下拉選單選擇最下面的 Common JavaScript,為 Notes 與 Web 兩種環境同時撰寫程式碼。
在按鈕腳本中輸入:
alert(document.forms[0].CreatedBy.value);
請注意,JavaScript 區分大小寫,這規則不只對元素有效,對欄位名稱同樣適用——你在欄位裡用什麼大小寫,程式碼中就得如實反映。
在瀏覽器中,可編輯欄位會轉成 HTML 的輸入框,有 name 與 value 屬性可供 JavaScript 存取:
<p>Created by:<input name="CreatedBy" value="Anonymous">
但計算欄位在網頁上通常只被當成普通文字輸出,沒有任何標記可供 JavaScript 引用。所以你不能像存取可編輯欄位那樣用 JavaScript 讀取計算欄位(至少在瀏覽器中如此)。此外,當文件處於「非編輯狀態」時,即使是可編輯欄位,HTML 也會退化成純文字,一樣無法用 JavaScript 存取。
HTML 欄位沒有 Notes 那樣的多值屬性。即使你在 Notes 中設定了多值與分隔符,在瀏覽器看到的 HTML 也只是把這些值用一對雙引號包成一個帶分隔符的字串:
<input name="Letters" value="A;B;C;D;E;F;G">
因此對 HTML 與 JavaScript 而言,這只是「一個值」,而非真正的多值。
在 Notes 中,單選鈕是一個有著多個值的單一欄位;在 Web 上,它則是一組「同名的輸入元素陣列」:
<input type="radio" name="RadioButtn" value="A" checked>One<br> <input type="radio" name="RadioButtn" value="B">Two<br> <input type="radio" name="RadioButtn" value="C">Three<br> <input type="radio" name="RadioButtn" value="D">Four
要點有三:其一,所有選項共用同一個 name,HTML 與 JS 才知道它們屬於同一陣列;其二,每個選項的值是「別名」而非顯示文字;其三,用 checked 單字標示預設選中項。
若直接寫 document.forms[0].RadioButtn.value,會得到 undefined——因為它是一個陣列,必須指定索引。而單選鈕並沒有 selectedIndex 屬性,因此要遍歷找出哪個選項被選中:
var doc = document.forms[0];
for(i = 0; i < doc.RadioButtn.length; i++){
if(doc.RadioButtn.checked){
alert(doc.RadioButtn.value);
break;
}
}
這裡有幾個新觀念:var 用來宣告變數(近似 LotusScript 的 Dim/Set);for 迴圈的三個參數——初始值(i=0)、繼續條件(i < doc.RadioButtn.length)、累加方式(i++)。注意 length 對陣列而言是元素個數(從 1 起算),而索引從 0 起算;i++ 等同 i=i+1;if 中的 checked 是布林值,也可寫成 checked == true(兩個等號才是比較,一個等號是賦值);最後 break 相當於 LotusScript 的 Exit For,因為單選鈕只能有一個選項被選中。
複選框與單選鈕類似,差別在於類型是 checkbox,而且可以多選。因此遍歷時不能在找到第一個選中項後就停止,必須全部檢查完:
var doc = document.forms[0];
for(i = 0; i < doc.CheckBx.length; i++){
if(doc.CheckBx.checked){
alert(doc.CheckBx.value);
}
}
相較於單選鈕,這裡只是去掉了 break,讓迴圈跑完所有選項。
還有其他類型的欄位各有其特性,值得你在自己的表單中逐一實驗、查看它們的 HTML 源碼——那正是繼續深入的起點。