異步提交表單的需求很常見。當表單欄位一多,一個個 getElementById 取值就變得很不現實。jQuery 當然能做到,jquery.form.js 這類庫也頗流行。但有時候並不想引入額外包,於是用純 JS 自己寫了一版。本例用 POST 提交,服務端腳本用 PHP。
<html> <head> <script type="text/javascript" src="name_form.js"></script> </head> <body> <form action="process.php" id="ajax_form"> Username:<input type="text" name="username" id="username"/><br> <input type="button" onclick="submitForm('name_form')" value="Submit"> </form> <div id="tip"></div> </body> </html>
function createXmlHttp() { var xmlHttp = null; try { //Firefox, Opera 8.0+, Safari xmlHttp = new XMLHttpRequest(); } catch (e) { //IE try { xmlHttp = new ActiveXObject("Msxml2.XMLHTTP"); } catch (e) { xmlHttp = new ActiveXObject("Microsoft.XMLHTTP"); } } return xmlHttp; } function submitForm(formId) { var xmlHttp = createXmlHttp(); if(!xmlHttp) { alert("您的浏覽器不支持AJAX!"); return 0; } var url = 'test.php'; var postData = ""; postData = "username=" + document.getElementById('username').value; postData += "&t=" + Math.random(); xmlHttp.open("POST", url, true); xmlHttp.setRequestHeader("Content-Type", "application/x-www-form-urlencoded"); xmlHttp.onreadystatechange = function() { if(xmlHttp.readyState == 4 && xmlHttp.status == 200) { if(xmlHttp.responseText == '1') { alert('post successed'); } } } xmlHttp.send(postData); }
<?php if(isset($_POST['username'])) { echo '1'; } ?>
整個流程是這樣的:使用者在 test.html 輸入用戶名,name_form.js 以 Ajax 提交,PHP 端判斷用戶名是否存在——存在則輸出 1。實際項目中這一步通常會換成資料庫操作(新增、修改等),然後依操作結果決定輸出什麼。前端在 xmlHttp.responseText 中判斷返回內容,彈出對應提示。
有幾個細節值得單獨強調:
1. echo 之前不能有任何輸出。包括 PHP 起始標簽前的空白、BOM 頭、警告信息,任何多餘字符都會汙染 responseText,導致前端 == '1' 判斷永遠不成立。這是初學者最常遇到的「代碼明明對卻不work」。
2. POST 必須手動設置 Content-Type。GET 不需要,但 POST 若不寫 application/x-www-form-urlencoded,後端 $_POST 會是空的。
3. 拼那個隨機參數 t 是有意義的。某些瀏覽器對 POST 也會做緩存,加時間戳能規避。
如果表單欄位較多,與其手寫拼接,不如用 new FormData(document.getElementById('ajax_form')) 一行搞定,同時還能自動處理檔案上傳——這正是本例手寫方式在現代瀏覽器下的最佳替代。