MSDN 對 setEndPoint 的說明如下:
TextRange.setEndPoint(sType, oTextRange)
oTextRange 是另一個 TextRange 物件。
sType 是字串型別,共有四種選擇:
StartToEnd
StartToStart
EndToStart
EndToEnd
原文的補充是這樣寫的:"A text range has two endpoints: one at the beginning of the text range and one at the end."
也就是說,一個 text range 有兩個端點,一個在開頭、一個在結尾。而 setEndPoint 的作用,就是拿目前這個 range 的某一端,去對齊另一個 range 的某一端——四種參數剛好是「我的頭/尾」對「對方的頭/尾」的兩兩組合。
搞懂這件事之後,很多原本很難處理的文字選取問題就變得簡單了。舉個實用例子:如何在 textarea 裡刪除光標所在的那一行(類似 Visual Studio 的剪切行功能)?
<textarea id="ice" rows="5" cols="35">
怎樣刪除光標在 textarea 中的那一行?
就像 Visual Studio 中的剪切行的功能。
</textarea>
<input type="button" onclick="delline()" value="delete" />
<script>
function delline() {
var t = document.getElementById("ice");
var range = t.createTextRange();
// 透過 setEndPoint 把選取範圍對齊到整行
range.setEndPoint("EndToEnd", document.selection.createRange());
range.text = "";
}
</script>
需要留意的是,TextRange 與 document.selection 這套 API 屬於舊版 IE 的專屬實作,在現代瀏覽器中已被標準的 Selection 與 Range 物件取代。如果今天要寫跨瀏覽器的編輯器功能,請改用 window.getSelection() 與 Range 的 setStart / setEnd 系列方法。