切换语言

仪表板

目录

用户通知

提示消息（Toasts）为用户提供简短的通知。它们会临时显示， 不应干扰用户的使用体验。同时，它们无需用户输入即可自动消失。

成功

▸ 成功(msg): void

用于显示成功类型的提示消息（toast message）。

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

警告

▸ 警告(msg): void

用于显示警告类型的提示消息（Toast）。

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

错误

▸ 错误(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 仪表板的其他部分。