v1.2.2

資料載入

最後更新


本頁說明 NanoJSON 接受哪些資料來源、初始設定與 import() 如何載入資料,以及各種載入失敗時的實際結果。

初始資料設定


json / file / path 三個設定欄位可指定初始資料,以 config.file ?? config.json ?? config.path 取第一個非 null 的值(JSONEditor.js:60),因此同時提供時 file 優先:
  1. // 從 JavaScript 物件載入
  2. const editor = new JSONEditor({
  3. id: "editor",
  4. json: { name: "NanoJSON", version: "1.2.1" },
  5. });
  6. // 從遠端 URL 載入
  7. const editor = new JSONEditor({
  8. id: "editor",
  9. file: "https://example.com/data.json",
  10. });

三者皆未提供時,編輯器以空物件 {} 啟動,並自動呼叫一次 insert() 新增一個空節點。

資料來源與失敗行為


所有來源都經過 getJSON()(src/function/getJSON.js):
傳入值處理方式失敗時
null / undefined視為無資料以 {} 載入
FileFileReader.readAsText 後 JSON.parse解析失敗印出 Failed to parse JSON from file ...,以 {} 載入
物件或陣列直接使用—
string(URL)fetch 後 JSON.parse網路錯誤或解析失敗印出 Failed to fetch data from ...,以 {} 載入;HTTP 狀態非 2xx 時 Promise 永不 resolve(getJSON.js:29),初始化停在載入階段、import() 不會重新渲染
其他型別(數字、布林)印出 Invalid data [_type]: ...以 {} 載入

陣列可以載入,但根層輸出時不會保留陣列形式,見序列化。

執行期匯入:import() 與 reset()


editor.import(data) 接受同一組來源,載入後以 #jsonToChildren() 重建全部節點,再呼叫 render(true);初次渲染已完成時會觸發 Lifecycle.update(300ms 防抖後執行 beforeUpdate / updated)。
editor.reset() 等同 import({})。與初始化不同,import() 不會在結果為空時自動 insert(),所以重設後編輯器沒有任何節點,需按「新增」或呼叫 insert()。

內建按鈕


頁尾按鈕對應的動作:
按鈕顯示條件動作
Add一律顯示insert()
Openbutton.import 為真開啟 accept=".json" 的檔案選擇器,選取後 import(file)
Downloadbutton.export 為真confirm("Download?") 確認後 export()
Resetbutton.reset 為真confirm("Reset?") 確認後 import({})

範例


以 URL 字串載入(fetch 後 JSON.parse):
  1. <section id="editor"></section>
  2. <script>
  3. new JSONEditor({
  4. id: "editor",
  5. fill: false,
  6. file: "https://cdn.jsdelivr.net/npm/@pardnchiu/nanojson@1.2.1/package.json",
  7. });
  8. </script>
即時預覽 · @pardnchiu/nanojson@1.2.2

延伸閱讀


EN