DIV CSS 佈局教程網

在文本框游標位置插入字元的跨瀏覽器實作
編輯:關於JavaScript     

要讓「插入」按鈕把文字塞進輸入框當前游標處而非直接覆蓋整個值,關鍵是取得游標位置資訊。這件事在 IE 與標準瀏覽器上的做法完全不同。

IE 的 TextRange 方案

<script language="javascript" type="text/javascript">
function Button4_onclick(obj) {
  obj.focus();
  var rng = document.selection.createRange();
  rng.setEndPoint("StartToStart", obj.createTextRange());
  var eng = document.selection.createRange();
  eng.setEndPoint("EndToEnd", obj.createTextRange());
  var kone = document.getElementById("Text1");
  kone.value = rng.text + "插入字符" + eng.text;
}
</script>

<input id="Text1" type="text" value="1235467890"/>
<input id="Button4" type="button"
       value="button" onclick="return Button4_onclick(Text1)" />

思路是把游標位置之前(StartToStart)與之後(EndToEnd)的兩段文字分別取出,中間插入新字元後再拼回去。

跨瀏覽器封裝

<%@ Page Language="C#" AutoEventWireup="true" AspCompat="true"
    CodeBehind="WebForm1.aspx.cs" Inherits="SJLERP.WebForm1" %>
<!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">
<script type="text/javascript">
function setCaret(textObj) {
  if (textObj.createTextRange) {
    textObj.caretPos = document.selection.createRange().duplicate();
  }
}

function insertAtCaret(textObj, textFeildValue) {
  if (document.all) {
    if (textObj.createTextRange && textObj.caretPos) {
      var caretPos = textObj.caretPos;
      caretPos.text = caretPos.text.charAt(caretPos.text.length - 1) == ' '
        ? textFeildValue + ' ' : textFeildValue;
    } else {
      textObj.value = textFeildValue;
    }
  } else {
    if (textObj.setSelectionRange) {
      var rangeStart = textObj.selectionStart;
      var rangeEnd = textObj.selectionEnd;
      var tempStr1 = textObj.value.substring(0, rangeStart);
      var tempStr2 = textObj.value.substring(rangeEnd);
      textObj.value = tempStr1 + textFeildValue + tempStr2;
    } else {
      alert("This version of Mozilla based browser does not support setSelectionRange");
    }
  }
}
</script>

<form id="form1" action="" onsubmit="" method="post" enctype="text/plain">
<p>
<textarea name="tarea" rows="" cols="" style="width:300px;height:120px;"
  onselect="setCaret(this);"
  onclick="setCaret(this);"
  onkeyup="setCaret(this);">例子例子例 Forget Never 子例子例子 asp.net </textarea>
<br/><br/>
<input type="text" name="textfield" style="width:220px;" value="插入FireFox"/>
<br/>
<input type="button" value="插入"
  onclick="insertAtCaret(this.form.tarea, this.form.textfield.value);"/>
</p>
</form>
</html>

為什麼需要 setCaret

IE 的問題在於:游標位置只在元素處於焦點狀態時才有效。當使用者點擊「插入」按鈕,焦點從 textarea 移走,原本的 selection 就失效了。

解法是在 textarea 的 onselect、onclick、onkeyup 三個時機持續把當前 selection 存進 textObj.caretPos 這個自訂屬性,等按鈕被點擊時再取出使用。duplicate() 呼叫是為了存一份獨立的副本,而非活的參考。

標準瀏覽器則不需要這層處理,因為 selectionStart 與 selectionEnd 是元素上的持久屬性,失焦後仍可讀取。

現代寫法

這套程式碼今天已經可以大幅簡化。document.all 判斷、createTextRange、setSelectionRange 的存在性檢查,在 IE6~8 以外的環境都已無必要。

function insertAtCaret(el, text) {
  var start = el.selectionStart;
  var end = el.selectionEnd;
  el.value = el.value.substring(0, start) + text + el.value.substring(end);
  // 把游標移到插入內容之後,維持連續輸入體驗
  el.selectionStart = el.selectionEnd = start + text.length;
  el.focus();
}

三個關鍵點:

一是用 selectionStart / selectionEnd 取代 Range 物件,這是標準 API,所有現代瀏覽器一致支援。

二是插入後主動設定游標位置。少了這步,插入完成後游標會跳回原處或跑到末尾,使用者無法連續輸入。把 selectionStart 與 selectionEnd 設為同一值,等同把游標移到該處。

三是最後呼叫 focus(),確保焦點回到輸入框。

若需要支援「選取一段文字後插入會取代選取內容」的行為,上面的實作已經天然涵蓋——因為 substring(0, start) + text + substring(end) 正好跳過了 start 到 end 之間的內容。

另外提醒一個無關但常見的細節:範例的 form 用了 enctype="text/plain",這會讓表單以純文字格式送出,多數後端框架無法正常解析。除非有特別需求,請移除這個屬性。

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