「註冊」這種流程,早期幾乎都得靠一頁接一頁地跳。使用者填完帳號密碼按繼續,整頁重新整理,再填一次姓名與信箱——每一次送出都是一次完整的換頁。xajax 這個 PHP 函式庫把這件事變得優雅得多:表單的每一步都在同一頁上完成,後端邏輯依然是純 PHP,前端卻有接近桌面程式的即時感。
這份以 xajax 0.1 beta4 撰寫的 signup.php,示範一個兩步驟的註冊流程:
最有趣的地方是:畫面上並沒有兩個表單,只有一個名為 formDiv 的容器。後端把第二步的 HTML 當成字串拼好送回,直接替換掉容器的內容,表單就「換頁」了。
整個機制的骨架其實只有三行:建立 xajax 物件、用 registerFunction 註冊要暴露給前端的 PHP 函式、再呼叫 processRequests 處理傳入的請求。至於 printJavascript(),則負責在頁面輸出讓前端得以呼叫後端函式的那層橋接腳本。
前端送來的是一份「目前表單所有欄位的值」,後端沒有額外的步驟參數可用,於是範例用了一個很聰明的小技巧:檢查陣列裡的鍵。
如果存在 username,代表使用者按的是第一步的送出鈕,交給 processAccountData;如果存在 firstName,代表已經進到第二步,交給 processPersonalData。這是一種不需要 session 記錄步驟、也不需要隱藏欄位的 stateless 判斷法。
兩個處理函式的結構幾乎一致:先 new 一個 xajaxResponse,再用 $bError 這個旗標收集錯誤。帳號為空、密碼為空、兩次密碼不一致,都各自用 addAlert 拋出一句提示;只要 $bError 為真,就把送出鈕的 disabled 設回 false、文字改回 continue,讓使用者可以再試一次。
這個「先停用按鈕、失敗再還原」的細節值得學。非同步化的表單最怕使用者連點兩下,把按鈕鎖住是最基本也最有效的防呆。
驗證通過後,程式清空 $_SESSION,把 trim 過的帳號與密碼寫進 $_SESSION['newaccount'],接著開始組字串:一層 form、幾個 div 包住的 input、最後是送出鈕。組好之後,一連串 addAssign 就派上用場:
第二步完成時,背景再變成偏藍的 rgb(67,97,149),文字改為置中的「Account created. Thank you.」。用顏色當作流程狀態的視覺語言,是很低成本卻很有效的手法。
表單的 onsubmit 指向 submitSignup(),而這個函式做的事非常精簡:用 xajax.$ 取得送出鈕並停用、把文字改成 please wait...,然後呼叫 xajax_processForm(xajax.getFormValues("signupForm")),最後 return false 阻止表單真的送出。getFormValues 就是整套流程的靈魂——它替你把整個表單序列化成一組鍵值對,直接當引數傳進 PHP 函式。
即使放到今天,這份範例想傳達的概念——把表單值整包送到後端、讓後端決定下一步該長什麼樣子——仍然是理解非同步表單最好的一課。