萬盛學電腦網

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

文本域換行符處理全攻略:前後端協作的最佳實踐

<textarea> 內容提交到後端、從後端回顯,換行符處理不當會導致換行丟失或顯示異常。本文提供前後端協作的完整方案:前端替換佔位符、後端統一存儲、安全防 XSS。

問題根源

  • 瀏覽器 textarea.value 獲取到的是 \n (LF, U+000A)
  • HTML 渲染不換行,需轉 <br> 或 CSS white-space: pre-wrap
  • 數據庫存儲建議統一 \n,避免平台差異 (\r\n Windows, \r 老 Mac)
  • JSON 傳輸中 \n 需轉義為 \\n

方案一:前端佔位符替換法 (傳統、兼容性好)

約定佔位符 @@@@ (極低衝突概率),前後端雙向轉換。

前端代碼

<script>
// 頁面初始化:後端返回的 @@@@ 替換為換行
$(document).ready(function() {
  var content = '${backendContent}'; // 後端模板輸出,已將 \n 替換為 @@@@
  if (content) {
    // 全局替換 /g 旗標
    content = content.replace(/@@@@/g, '\n');
    $('#content').val(content);
  }
});

// 提交前:換行 \n 替換為 @@@@
function doSubmit() {
  var content = $('#content').val();
  if (!content.trim()) {
    alert('請填寫備注說明!');
    return false;
  }
  // 統一轉換為 @@@@ 提交
  $('#content').val(content.replace(/\n/g, '@@@@'));
  $('#updateForm').submit();
}
</script>

<textarea id="content" rows="15" cols="50"></textarea>
<button onclick="doSubmit()">保存</button>

後端處理 (Java 示例)

// 保存前:@@@@ → \n
String content = request.getParameter("content");
if (content != null) {
  content = content.replace("@@@@", "\n");
  // 存入數據庫
}

// 讀取後:\n → @@@@
String dbContent = article.getContent();
if (dbContent != null) {
  dbContent = dbContent.replace("\n", "@@@@");
  // 返回前端
}

方案二:現代標準化方案 (推薦新項目)

前端保持 \n,後端存儲 \n,前端顯示用 CSS 或安全轉義渲染。

前端顯示:CSS 白空間處理

<style>
.pre-wrap { white-space: pre-wrap; word-wrap: break-word; }
</style>

<!-- 直接顯示,保留換行 -->
<div class="pre-wrap">${article.content}</div>

<!-- 或 textarea 回顯 -->
<textarea>${article.content}</textarea>

前端編輯器同步 (如 Markdown 編輯器)

// 獲取原始 \n
var raw = editor.getValue(); // 含 \n

// 提交前:無需替換,直接發送 JSON
$.ajax({
  url: '/api/save',
  type: 'POST',
  contentType: 'application/json',
  data: JSON.stringify({content: raw}) // JSON.stringify 自動轉義 \n → \\n
});

// 後端接收:Jackson/Gson 自動反轉義 \\n → \n

富文本輸出防 XSS:DOMPurify + pre-wrap

<script src="https://cdn.jsdelivr.net/npm/dompurify@3.0.5/dist/purify.min.js"></script>
<div id="display" class="pre-wrap"></div>

<script>
function renderSafe(html) {
  // 1. 消毒:只保留安全標籤
  var clean = DOMPurify.sanitize(html, {
    ALLOWED_TAGS: ['b', 'i', 'u', 'br', 'p', 'ul', 'ol', 'li', 'a'],
    ALLOWED_ATTR: ['href', 'target']
  });
  // 2. 渲染
  document.getElementById('display').innerHTML = clean;
}
</script>

方案對比

維度佔位符法標準 \n + CSS
後端存儲需雙向替換原樣存 \n
前端顯示textarea 正常、div 需替換CSS pre-wrap 完美支持
JSON 傳輸無特殊處理自動轉義 \\n
跨平台一致性依賴替換邏輯正確原生 \n 標準化
安全性需額外防 XSS配合 DOMPurify 更安全
適用場景老系統、非 JSON 接口新項目、RESTful API

避坑清單

  1. .val() 獲取 textarea 值保留 \n,.text() 同樣;.html() 獲取的是實體內容。
  2. 正則替換必須加 /g 全局標誌,否則只替換第一個。
  3. 佔位符選擇極低衝突字符串:@@@@、__BR__、\u0001 (控制字符)。
  4. Windows \r\n 統一正規化:str.replace(/\r\n/g, '\n')。
  5. 數據庫字段類型用 TEXT 或 LONGTEXT,編碼 utf8mb4。

現代項目首選 方案二:前後端統一 \n,前端用 white-space: pre-wrap 顯示,富文本用 DOMPurify 消毒。老系統維護用佔位符法,但需嚴格保證雙向替換邏輯一致。

copyright © 萬盛學電腦網 all rights reserved