以 JSON 編碼格式提交表單資料,是 HTML5 對 Web 發展演進的一大貢獻。過去我們的 HTML 表單資料是透過 key-value 方式傳輸到伺服器端,這種形式對資料組織缺乏管理,顯得相當原始。而新出現的 JSON 格式提交方法,會將表單中的所有資料轉化為具備一定規範的 JSON 格式後再傳輸,伺服器端接收到的就是可直接使用的合格 JSON 程式碼。
如何聲明以 JSON 格式提交表單
大家應該對如何以表單上傳檔案很熟悉——需要在 form 標記上添加 enctype="multipart/form-data" 聲明,告訴瀏覽器以檔案上傳模式發送表單資料。JSON 格式提交的聲明與此類似,寫法是:enctype='application/json'。
對老式瀏覽器的相容性
以 JSON 格式提交表單是 HTML5 中相當新的規範,只有實作了這些規範的現代瀏覽器才能識別 enctype='application/json' 的語義,並正確地將表單資料打包成 JSON 格式。而對於一些老式或尚未實作此標準的瀏覽器,它們無法識別 enctype='application/json',於是表單的 enctype 會自動退化成 application/x-www-form-urlencoded 的預設編碼格式。伺服器端程式碼可以根據 enctype 的值來判斷如何接收資料。
JSON 編碼格式提交表單的格式範例
例 1 基本用法
<form enctype='application/json'> <input name='name' value='Bender'> <select name='hind'> <option selected>Bitable</option> <option>Kickable</option> </select> <input type='checkbox' name='shiny' checked> </form> // 生成的Json數據是 { "name": "Bender" , "hind": "Bitable" , "shiny": true }
例 2 當表單存在多個重名的表單域時,按 JSON 陣列編碼
<form enctype='application/json'> <input type='number' name='bottle-on-wall' value='1'> <input type='number' name='bottle-on-wall' value='2'> <input type='number' name='bottle-on-wall' value='3'> </form> // 生成的Json數據是 { "bottle-on-wall": [1, 2, 3] }
例 3 表單域名稱以陣列形式出現的複雜結構
<form enctype='application/json'> <input name='pet[species]' value='Dahut'> <input name='pet[name]' value='Hypatia'> <input name='kids[1]' value='Thelma'> <input name='kids[0]' value='Ashley'> </form> // 生成的Json數據是 { "pet": { "species": "Dahut" , "name": "Hypatia" } , "kids": ["Ashley", "Thelma"] }
例 4 在上面的例子中,缺失的陣列序號值將以 null 替代
<form enctype='application/json'> <input name='hearbeat[0]' value='thunk'> <input name='hearbeat[2]' value='thunk'> </form> // 生成的Json數據是 { "hearbeat": ["thunk", null, "thunk"] }
例 5 多重陣列嵌套格式,嵌套層數無限制
<form enctype='application/json'> <input name='pet[0][species]' value='Dahut'> <input name='pet[0][name]' value='Hypatia'> <input name='pet[1][species]' value='Felis Stultus'> <input name='pet[1][name]' value='Billie'> </form> // 生成的Json數據是 { "pet": [ { "species": "Dahut" , "name": "Hypatia" } , { "species": "Felis Stultus" , "name": "Billie" } ] }
例 6 真的,沒有陣列維度限制!
<form enctype='application/json'> <input name='wow[such][deep][3][much][power][!]' value='Amaze'> </form> // 生成的Json數據是 { "wow": { "such": { "deep": [ null , null , null , { "much": { "power": { "!": "Amaze" } } } ] } } }
例 7 檔案上傳
<form enctype='application/json'> <input type='file' name='file' multiple> </form> // 假設你上傳了2個文件, 生成的Json數據是: { "file": [ { "type": "text/plain", "name": "dahut.txt", "body": "REFBQUFBQUFIVVVVVVVVVVVVVCEhIQo=" }, { "type": "text/plain", "name": "litany.txt", "body": "SSBtdXN0IG5vdCBmZWFyLlxuRmVhciBpcyB0aGUgbWluZC1raWxsZXIuCg==" } ] }