跳到主要內容

總覽

Blocklet Uploader 是一個專為 blocklets 設計的綜合檔案上傳解決方案,它建立在強大且可擴展的 Uppy 檔案上傳器之上。它由兩個主要套件組成,共同提供從瀏覽器中的使用者介面到伺服器上的檔案處理的無縫體驗。

運作方式

標準工作流程涉及使用者在您應用程式的前端與 @blocklet/uploader 元件互動。然後,此元件與由 @blocklet/uploader-server 驅動的後端端點通訊,該端點處理實際的檔案儲存和處理。

需要注意的是,如果存在 Media Kit blocklet,@blocklet/uploader 可以在沒有自訂後端的情況下運作,因為它提供了預設的上傳處理。只有當您需要自訂的伺服器端邏輯時,例如在上傳完成後將檔案元資料儲存到特定資料庫中,才需要安裝和設定 @blocklet/uploader-server。

主要功能

  • 由 Uppy 驅動:利用成熟、經過實戰考驗的核心來實現可靠的上傳。
  • 彈性架構:解耦的前端和後端套件允許獨立使用和自訂。
  • 豐富的外掛系統:支援標準 Uppy 外掛,如 ImageEditorWebcamUrl,以及自訂的 blocklet 特定外掛。
  • 遠端來源整合:使用 Companion 中介軟體,輕鬆讓使用者從 Unsplash 等外部來源匯入檔案。
  • 可自訂的 Hooks:在客戶端和伺服器端都提供 onUploadFinish 回呼,讓您完全控制上傳後的處理。
  • 自動 Media Kit 整合:當 Media Kit blocklet 可用時,無縫偵測並自行設定。

準備好開始了嗎?讓我們將上傳器整合到您的 blocklet 中。

開始使用

遵循我們的逐步指南,在您的應用程式中設定前端元件和後端伺服器。

開始指南