DIV CSS 佈局教程網

TextRange 物件實戰:抓取輸入框游標位置與選取文字
編輯:關於JavaScript     

TextRange 是 JavaScript 中用來描述 HTML 元素內文字片段的一組物件與方法。它登場得其實很早,IE4 時代就已具備,只是方法名稱偏向晦澀,日常開發中也很少被提及,因此容易被忽略。

TextRange 一般用來做什麼

最傳統的用法,是針對使用者以滑鼠圈選出來的文字做操作,例如替換、刪除或在選取區插入新內容。而實務上最常被拿來解決的兩類問題則是:

  • 在頁面文字中搜尋指定的字串;
  • 取得輸入框(input / textarea)中插入點(游標)的位置。

第二點看似不起眼,卻能延伸出不少實用的效果。舉例來說,要做一個能即時驗證格式的 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 會更省心。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved