DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5詳解
用 enctype="application/json" 提交表單:HTML5 的 JSON 表單編碼
編輯:HTML5詳解     

過去表單只能以 key-value 對的形式送到伺服器,這種格式對資料組織幾乎毫無管理能力,巢狀結構、陣列、布林值全都得靠字串拼接與約定俗成的命名(像是 user[name])硬湊。以 JSON 編碼提交表單,是 HTML 對 Web 演進的又一份貢獻:表單內所有欄位會被轉換成結構化的 JSON,伺服器端收到的就是一份現成可用的 JSON。

怎麼聲明

你應該很熟悉檔案上傳的寫法——在 <form> 上加 enctype="multipart/form-data",那是告訴瀏覽器改用上傳模式送出表單。JSON 提交如法炮製:

<form enctype='application/json'>
  ...
</form>

舊瀏覽器會怎麼辦

這是一項相當新的編碼方式,只有實作該規範的瀏覽器才認得 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
}

注意核取方塊的布林值被正確還原成 true,而不是字串 "on"。

例 2:同名欄位自動收攏成陣列

<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"]
}

即使 kids[1] 寫在 kids[0] 前面,輸出仍會依序號排好。

例 4:缺號的索引以 null 補位

<form enctype='application/json'>
  <input name='heartbeat[0]' value='thunk'>
  <input name='heartbeat[2]' value='thunk'>
</form>

// 產生的 JSON
{
  "heartbeat": ["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='Billy'>
</form>

// 產生的 JSON
{
  "pet": [
    { "species": "Dahut", "name": "Hypatia" },
    { "species": "Felis Stultus", "name": "Billy" }
  ]
}

例 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>

// 假設上傳了兩個檔案,產生的 JSON
{
  "file": [
    {
      "type": "text/plain",
      "name": "dahut.txt",
      "body": "REFBQUFBQUFIVVVVVVVVVVVVVCEhIQo="
    },
    {
      "type": "text/plain",
      "name": "litany.txt",
      "body": "SSBtdXN0IG5vdCBmZWFyLlxuRmVhciBpcyB0aGUgbWluZC1raWxsZXIuCg=="
    }
  ]
}

檔案內容會以 Base64 編碼放進 body 欄位。這也提醒我們:若表單裡有大檔案,JSON 模式會讓整包資料變成純文字傳輸,體積與記憶體開銷都要事先評估,這種情境通常還是 multipart/form-data 更合適。

總結

enctype="application/json" 的價值在於讓表單直接產出結構化資料,省掉前端手動序列化的一整段程式,也讓伺服器端拿到乾淨的 JSON。理解它的編碼規則(同名收陣列、中括號建巢狀、缺號補 null)之後,是否採用就取決於你的瀏覽器支援範圍與資料型態了。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved