TextRange 是 JavaScript 中用來描述 HTML 元素內文字片段的一組物件與方法。它登場得其實很早,IE4 時代就已具備,只是方法名稱偏向晦澀,日常開發中也很少被提及,因此容易被忽略。
最傳統的用法,是針對使用者以滑鼠圈選出來的文字做操作,例如替換、刪除或在選取區插入新內容。而實務上最常被拿來解決的兩類問題則是:
第二點看似不起眼,卻能延伸出不少實用的效果。舉例來說,要做一個能即時驗證格式的 MaskTextBox,核心就在於先取得游標位置,再用正則表達式判斷游標前或後的內容;又或者要讓方向鍵在多個輸入框組成的矩陣之間自然跳躍,同樣得先知道游標停在哪裡。
整個做法其實很短,之所以陌生,只是因為這些物件與方法不常出現:
function GetCursorPsn(txb) {
var slct = document.selection;
var rng = slct.createRange();
txb.select();
rng.setEndPoint("StartToStart", slct.createRange());
var psn = rng.text.length;
rng.collapse(false);
rng.select();
return psn;
}
把這個方法掛到事件上之後,會伴隨一些行為上的改變,值得先評估:
<input type="text" onkeydown="GetCursorPsn(this)">
套用在單行輸入框時,使用者將無法再以 Shift + 左右方向鍵選取文字;套用在多行輸入框時,Shift + 上下左右四個方向鍵的選取行為都會失效:
<textarea onkeydown="GetCursorPsn(this)"></textarea>
原因在於程式碼取得游標位置之後,又呼叫了 rng.collapse(false),這一步會改寫文字方塊內的 EditPoint,等於把原本的選取狀態重設了一次。
回到最一開始的需求——用上下左右鍵在輸入框之間移動,同時把目標輸入框的內容全選,方便直接覆寫修改。做法如下:
var range = $currentTextfield.createTextRange(); // $currentTextfield 為 jQuery 物件
range.moveStart('character', 0);
range.select();
下面是一個可直接開啟的完整頁面,示範如何跨瀏覽器取得使用者在 textarea 中所選取的字串。程式中刻意準備了兩種實作,第一種走 document.selection 與 window.getSelection 的分流,第二種則改用 selectionStart / selectionEnd,實測在 Firefox 與 IE 上的相容性都更好:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<title>new document</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<style>
body { font-size:12px; }
#show { background-color:#CCFF99; }
</style>
</head>
<body>
<textarea id="content" cols="30" rows="10">河中魚類離奇死亡,下游居民頻染怪病,沿岸植物不斷變異,是殘留農藥?還是生化攻擊?敬請關注今晚CCTV-10《科學探索》,即將播出的專題節目:《神秘的河邊洗腳人--中國男足》</textarea>
<button id="btn">獲取選中值</button>
<div id="show"></div>
<script>
String.prototype.trim = function() {
return this.replace(/^\s+|\s+$/g, "");
}
/* 方法一:IE 下正常,Firefox 下略有問題 */
function getSelectText() {
try {
// IE: document.selection.createRange() W3C: window.getSelection()
var selectText = (document.selection && document.selection.createRange) ?
document.selection.createRange().text : window.getSelection().toString();
if (selectText != null && selectText.trim() != "") {
return selectText;
}
} catch (err) {}
}
/* 方法二:以 selectionStart / selectionEnd 取值 */
function getSelectText2(id) {
var t = document.getElementById(id);
if (window.getSelection) {
if (t.selectionStart != undefined && t.selectionEnd != undefined) {
return t.value.substring(t.selectionStart, t.selectionEnd);
} else {
return "";
}
} else {
return document.selection.createRange().text;
}
}
document.getElementById('btn').onclick = function() {
document.getElementById('show').innerHTML = getSelectText2('content');
}
</script>
</body>
</html>
需要提醒的是,TextRange 屬於 IE 家族特有的實作,現代專案若仍需支援舊版 IE 才值得投入;否則改用 Selection 與 Range 標準 API 會更省心。