仪表板

用户通知

Toast 向用户提供简短的通知。它们是暂时出现的,不应中断用户体验。它们也不需要用户输入即可消失。

成功

成功( msg):void

用于显示类型为 success 的 Toast 消息。

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");

打开文件选择对话框

此函数打开一个文件选择器对话框,要求用户选择文件或文件夹。

显示打开对话框( 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):void

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

URL 必须具有协议httphttps.

有关方法参数和可用返回类型的更多详细信息,请参阅 桌面主机 API 参考

已弃用的用户通知

此方法已弃用,并将在未来版本中删除。使用上面指定的方法。

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

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