以 JSON 編碼格式提交表單資料,是 HTML5 為 Web 發展帶來的又一項重要進化。過去,HTML 表單資料只能透過 key-value 的方式傳輸到伺服器端,這種形式對資料組織缺乏管理,顯得頗為原始。而新出現的 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 的值來判斷如何接收資料。
例 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=="
}
]
}