v1.2.2

序列化

最後更新


本頁說明節點樹如何輸出成 JSON:節點層的 json getter、根層的 editor.json 與 editor.export(),以及兩條根層路徑的差異。

節點層:JSONEditorNode.json


JSONEditorNode.json(getter)遞迴呼叫私有的 #json()(JSONEditorNode.js:157),依節點型別回傳 JavaScript 值:
節點型別回傳
array子節點 #json() 結果組成的陣列
object以子節點 key 為鍵的物件
booleanvalue.toLowerCase() === "true"
numberNumber(value)
其他value 原值

object 節點組物件時,沒有 key 的子節點會被略過;例外是該 object 節點本身位於陣列中(this.parent.type === "array"),此時無鍵子節點以目前已收集的鍵數作為數字鍵(JSONEditorNode.js:173)。同名的 key 後者覆蓋前者。

根層:editor.json 與 editor.export()


根層的兩條路徑篩選條件不同:
路徑篩選條件(JSONEditor.js)輸出
editor.json(getter,第 267-277 行)只收 e.key 為真的子節點4 空格縮排的 JSON 字串
editor.export()(第 289-310 行)收 e.key 為真,或 children.length === 1 時也收下載檔案 NanoJSON-{timestamp}.json,同樣 4 空格縮排

兩條路徑都以物件作為根,無鍵子節點寫入時使用鍵 0(result[e.key || 0])。

匯入陣列時的差異


根節點的 editor.type 固定為 "object",匯入的資料若是陣列,根層子節點會是無鍵節點,兩條路徑的結果因此不同:
匯入資料editor.jsoneditor.export() 下載內容
[1]"{}"{"0": 1}
[1, 2]"{}"{}
{"a": 1}{"a": 1}{"a": 1}

根層陣列不會以陣列形式輸出。需要保留陣列根時,請在傳入前包一層物件(例如 { "items": [...] })。

範例


初次渲染後與每次編輯後印出 editor.json:
  1. <section id="editor"></section>
  2. <script>
  3. const editor = new JSONEditor({
  4. id: "editor",
  5. fill: false,
  6. collapsed: false,
  7. json: { count: 1, list: [1, "two", true], nested: { ok: false } },
  8. when: {
  9. rendered: () => console.log(editor.json),
  10. updated: () => console.log(editor.json),
  11. },
  12. });
  13. </script>
即時預覽 · @pardnchiu/nanojson@1.2.2

匯入根層陣列:根層子節點沒有 key,因此 editor.json 為 {}:
  1. <section id="editor"></section>
  2. <script>
  3. const editor = new JSONEditor({
  4. id: "editor",
  5. fill: false,
  6. json: [1, 2],
  7. when: {
  8. rendered: () => console.log("editor.json:", editor.json),
  9. },
  10. });
  11. </script>
即時預覽 · @pardnchiu/nanojson@1.2.2

延伸閱讀


EN