萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 讓 Textarea 支持 Tab 鍵:原型擴展方案分析與現代標準 API 替代

原文方案分析:HTMLTextAreaElement.prototype 擴展

原文通過擴展原型添加 `getCaretPosition`、`setCaretPosition`、`hasSelection` 等方法,再在 `keydown` 中手動操作 `value` 字符串實現 Tab 插入。這種方式存在明顯問題:

  • 污染原型:修改內置原型可能與未來標準衝突、影響第三方庫
  • 字符串拼接性能差:大文本時頻繁 `substring` 拼接導致重繪
  • 光標管理複雜:手動計算 `newCaretPosition` 易出錯
  • 未處理選區:多行選中時邏輯缺失
  • Backspace/方向鍵硬編碼:假設縮進固定 4 空格,不靈活

現代標準方案:setRangeText (同上文 68109)

核心優勢:原生支持插入/替換/刪除、自動維護光標位置、支持撤銷棧、處理選區、性能優化。

// 核心 20 行實現所有功能
textarea.addEventListener('keydown', e => {
    if (e.key !== 'Tab' || e.isComposing) return;
    e.preventDefault();
    
    const {selectionStart: s, selectionEnd: e, value} = textarea;
    const tab = '    '; // 4 空格
    
    if (s !== e) { // 有選區:多行縮進/反縮進
        const lines = value.slice(s, e).split('\n');
        const newText = e.shiftKey 
            ? lines.map(l => l.startsWith(tab) ? l.slice(4) : l).join('\n')
            : lines.map(l => tab + l).join('\n');
        textarea.setRangeText(newText, s, e, 'select');
    } else { // 無選區:單點插入/刪除行首縮進
        if (e.shiftKey) {
            const lineStart = value.lastIndexOf('\n', s - 1) + 1;
            if (value.slice(lineStart, s).startsWith(tab)) {
                textarea.setRangeText('', lineStart, lineStart + 4);
            }
        } else {
            textarea.setRangeText(tab, s, e, 'end');
        }
    }
});

對比表:原型擴展 vs 標準 API

維度原型擴展 + value 操作setRangeText 標準 API
代碼量~120 行~25 行
原型污染是否
選區支持無/不完整原生完整支持
撤銷/重做破壞完美保持
性能 (大文本)O(n) 字符串拼接O(1) 瀏覽器優化
輸入法兼容無處理配合 isComposing 易實現
瀏覽器支持IE9+ (需 polyfill)IE9+ (標準)

進階:CodeMirror/Monaco 編輯器替代方案

若需語法高亮、代碼補全、錯誤標記、多游標等 IDE 級功能,**請勿自建**,直接集成成熟編輯器:

<!-- CodeMirror 6 (現代模塊化) -->
<script type="module">
import {EditorView, basicSetup} from "@codemirror/basic-setup";
import {javascript} from "@codemirror/lang-javascript";
import {EditorState} from "@codemirror/state";

new EditorView({
    state: EditorState.create({
        doc: "function hello() {\n  console.log('world');\n}",
        extensions: [basicSetup, javascript()]
    }),
    parent: document.querySelector('#editor')
});
</script>

輕量級替代:Prism + contenteditable

<pre class="language-javascript"><code contenteditable spellcheck="false">
function hello() {
    console.log('world');
}
</code></pre>

<script>
// 簡易 Tab 支持
document.querySelector('code[contenteditable]').addEventListener('keydown', e => {
    if (e.key === 'Tab') {
        e.preventDefault();
        document.execCommand('insertText', false, '    ');
    }
});
</script>

無障礙性考量

  • Tab 鍵是鍵盤導航核心,**攔截 Tab 會破壞無障礙導航**
  • 解決方案:
    1. 提供「代碼編輯模式」開關,默認關閉
    2. 或:只在 textarea **聚焦且有選區/輸入模式** 時攔截
    3. 或:使用 `Alt+Tab` / `Ctrl+]` 等替代快捷鍵
  • ARIA 標識:`