v1.2.2

型別系統

最後更新


本頁說明 NanoJSON 如何從 JavaScript 值推導節點型別、各型別的輸入與輸出行為、切換型別時既有值的變化,以及 null 的邊界情況。

型別推導


匯入資料時,型別由 getType()(src/function/getType.js)依 JavaScript 執行期型別推導:
JS 值getType() 回傳
Array.isArray(v) 為真"array"
typeof v === "object"(含 null)"object"
typeof v === "boolean""boolean"
typeof v === "number""number"
其他"string"

各型別的行為


型別輸入元件序列化結果備註
stringtextarea,支援多行原字串—
numbertextarea,placeholder NUMNumber(value)輸入無法解析為數字時整欄清空(-、. 例外,方便輸入負數與小數);空值序列化為 0
booleantrue / false 下拉選單value.toLowerCase() === "true"值為空時自動設為 "true"
object無值輸入框,顯示子節點物件支援無限巢狀
array無值輸入框,子節點以索引顯示、無 key 輸入框陣列同上

切換型別


型別下拉選單(src/function/typeSelect.js:25)只提供 string / number / boolean / array / object 五個選項,不能手動切換成 null。切換時依目標型別處理既有值(typeSelect.js:30-51):
切換為對既有值的處理
object / arrayvalue 清空;若沒有子節點,自動新增一個(經 #add,見核心概念)
number對既有字串 parseFloat;無法解析則清空。children 不清除,切回 object / array 時原子節點仍在
string / booleanvalue 清空、children 清空

切換後呼叫 updateChild() 重建該節點 DOM 並觸發 Lifecycle.update,再把焦點移到 value-{id} 元素。

null 的邊界情況


getType(null) 回傳 "object"(JavaScript 的 typeof null === "object"),兩個呼叫點的處理方式不一致:
  • 物件的子鍵值(JSONEditor.js:227-234):value === null 分支把 _null 指派給節點型別,但原始碼中沒有定義 _null,因此此分支會拋出 ReferenceError。
  • 陣列的子項目(JSONEditor.js:205-209):沒有對應處理。getType() 回傳 "object",但 e != null 為假,落入 else 分支以 String(e) 存成文字 "null",節點型別維持預設的 "string"。

兩者的實際結果:
匯入資料結果
[null]渲染為內容是文字 "null" 的 string 節點;序列化後變成字串 "null"
{"a": null}將資料轉換為節點時拋出 ReferenceError: _null is not defined(src/model/JSONEditor.js:230),編輯器不渲染任何內容,rendered 不會觸發

若資料可能含 null,需在傳入 NanoJSON 前於應用層先轉換(例如改為空字串)。

範例


每種型別各一個節點;[null] 會渲染成內容為 "null" 的字串節點。可從下拉選單切換型別觀察值的變化:
  1. <section id="editor"></section>
  2. <script>
  3. new JSONEditor({
  4. id: "editor",
  5. fill: false,
  6. collapsed: false,
  7. json: {
  8. string: "text",
  9. number: 42,
  10. boolean: true,
  11. object: { key: "value" },
  12. array: [1, 2],
  13. nullInArray: [null],
  14. },
  15. });
  16. </script>
即時預覽 · @pardnchiu/nanojson@1.2.2

物件值為 null 時,初次渲染會拋出錯誤,錯誤訊息顯示於 log:
  1. <section id="editor"></section>
  2. <script>
  3. new JSONEditor({
  4. id: "editor",
  5. fill: false,
  6. json: { a: null },
  7. });
  8. </script>
即時預覽 · @pardnchiu/nanojson@1.2.2

延伸閱讀


EN