仪表板

用户通知

提示（Toast）提供对用户的简短通知。它们会临时显示，不应中断用户体验，也不需要用户输入即可消失。

success

▸ success(msg): void

用于显示成功类型的消息提示。

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

warning

▸ warning(msg): void

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

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

error

▸ error(msg): void

用于显示错误类型的消息提示。

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。

有关可用方法参数和返回类型的更多详细信息，请参阅 Desktop host API 参考。

已弃用的用户通知

此方法已被弃用，将在未来版本中移除。请使用上面指定的方法。

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

导航到仪表板路由

从您的扩展中，您还可以 导航 到 Docker Desktop 仪表板的其他部分。