儀表板

使用者通知

Toast 訊息為使用者提供簡短的通知。它們會暫時出現，且不應中斷使用者的操作體驗。此外，它們也不需要使用者輸入即可自動消失。

成功 (success)

▸ success(msg): void

用於顯示「成功」類型的 Toast 訊息。

ddClient.desktopUI.toast.success("message");

警告 (warning)

▸ warning(msg): void

用於顯示「警告」類型的 Toast 訊息。

ddClient.desktopUI.toast.warning("message");

錯誤 (error)

▸ error(msg): void

用於顯示「錯誤」類型的 Toast 訊息。

ddClient.desktopUI.toast.error("message");

關於方法參數及可用回傳類型的更多詳細資訊，請參閱 Toast API 參考文件。

已棄用的使用者通知

這些方法已棄用，將在未來版本中移除。請使用上述指定的方法。

window.ddClient.toastSuccess("message");
window.ddClient.toastWarning("message");
window.ddClient.toastError("message");

開啟檔案選擇對話框

此函數會開啟一個檔案選擇器對話框，要求使用者選擇檔案或資料夾。

▸ showOpenDialog(dialogProperties): Promise< OpenDialogResult>

dialogProperties 參數是傳遞給 Electron 的旗標列表，用於自訂對話框的行為。例如，您可以傳遞 multiSelections 以允許使用者選擇多個檔案。請參閱 Electron 文件以取得完整列表。

const result = await ddClient.desktopUI.dialog.showOpenDialog({
  properties: ["openDirectory"],
});
if (!result.canceled) {
  console.log(result.paths);
}

開啟 URL

此函數會使用系統預設瀏覽器開啟外部 URL。

▸ openExternal(url): void

ddClient.host.openExternal("https://docker.com");

該 URL 必須具備 http 或 https 協定。

關於方法參數及可用回傳類型的更多詳細資訊，請參閱 桌面主機 API 參考文件。

已棄用的使用者通知

此方法已棄用，將在未來版本中移除。請使用上述指定的方法。

window.ddClient.openExternal("https://docker.com");

導覽至儀表板路由

您可以透過擴充功能 導覽 至 Docker Desktop 儀表板的其他部分。