版本：下个版本 🚧

参数选项

应用程序参数选项

该Options.App结构包含应用程序配置。它被传递给wails.Run()方法：

Example
import "github.com/wailsapp/wails/v2/pkg/options"

func main() {

    err := wails.Run(&options.App{
        Title:             "Menus Demo",
        Width:             800,
        Height:            600,
        DisableResize:     false,
        Fullscreen:        false,
        Frameless:         true,
        MinWidth:          400,
        MinHeight:         400,
        MaxWidth:          1280,
        MaxHeight:         1024,
        StartHidden:       false,
        HideWindowOnClose: false,
        RGBA:              &options.RGBA{R: 0, G: 0, B: 0, A: 255},
        AlwaysOnTop:       false,
        Assets:            assets,
        Menu:              app.applicationMenu(),
        Logger:            nil,
        LogLevel:          logger.DEBUG,
        OnStartup:         app.startup,
        OnDomReady:        app.domready,
        OnShutdown:        app.shutdown,
        OnBeforeClose:     app.beforeClose,
        WindowStartState:  options.Maximised,
        Bind: []interface{}{
            app,
        },
        Windows: &windows.Options{
            WebviewIsTransparent:              false,
            WindowIsTranslucent:               false,
            DisableWindowIcon:                 false,
            DisableFramelessWindowDecorations: false,
            WebviewUserDataPath:               "",
            Theme:                             windows.SystemDefault,
            CustomTheme: &windows.ThemeSettings{
                DarkModeTitleBar:   windows.RGB(20, 20, 20),
                DarkModeTitleText:  windows.RGB(200, 200, 200),
                DarkModeBorder:     windows.RGB(20, 0, 20),
                LightModeTitleBar:  windows.RGB(200, 200, 200),
                LightModeTitleText: windows.RGB(20, 20, 20),
                LightModeBorder:    windows.RGB(200, 200, 200),
            },
            // 可以自定义的用户消息
            Messages *windows.Messages
        },
        Mac: &mac.Options{
            TitleBar: &mac.TitleBar{
                TitlebarAppearsTransparent: true,
                HideTitle:                  false,
                HideTitleBar:               false,
                FullSizeContent:            false,
                UseToolbar:                 false,
                HideToolbarSeparator:       true,
            },
            Appearance:           mac.NSAppearanceNameDarkAqua,
            WebviewIsTransparent: true,
            WindowIsTranslucent:  false,
            About: &mac.AboutInfo{
                Title:   "My Application",
                Message: "© 2021 Me",
                Icon:    icon,
            },
        },
        Linux: &linux.Options{
            Icon: icon,
        },
    })
    if err != nil {
        log.Fatal(err)
    }
}

标题

名称：Title

类型：string

窗口标题栏中显示的文本。

宽度

名称：Width

类型：int

窗口的初始宽度。默认值：1024。

高度

名称：Height

类型：int

窗口的初始高度。默认值：768

禁用调整窗口尺寸

名称：DisableResize

类型：bool

默认情况下，主窗口可调整大小。将此设置为 true 将使其保持固定大小。

Fullscreen

名称：Fullscreen

类型：bool

将此设置为 true 将在启动时使窗口全屏。

无边框

名称：Frameless

类型：bool

设置为true时，窗口将没有边框或标题栏。另请参阅无边框窗口。

最小宽度

名称：MinWidth

类型：int

这将设置窗口的最小宽度。如果给出的值Width小于这个值，窗口将被设置为MinWidth默认值。

最小高度

名称：MinHeight

类型：int

这将设置窗口的最小高度。如果给出的值Height小于这个值，窗口将被设置为MinHeight默认值。

最大宽度

名称：MaxWidth

类型：int

这将设置窗口的最大宽度。如果给出的值Width大于这个值，窗口将被设置为MaxWidth默认值。

最大高度

名称：MaxHeight

类型：int

这将设置窗口的最大高度。如果给出的值Height大于这个值，窗口将被设置为MaxHeight默认值。

启动时隐藏窗口

名称：StartHidden

类型：bool

设置为true时，应用程序将被隐藏，直到调用显示窗口。

关闭时隐藏窗口

名称：HideWindowOnClose

类型：bool

默认情况下，关闭窗口将关闭应用程序。将此设置为true意味着关闭窗口将隐藏窗口。

RGBA

名称：RGBA

类型：int (0xRRGGBBAA) 示例：0xFF000088 - 透明度为 50% 的红色

This value is the default background colour of the window. Default: white Default: white

窗口固定在最顶层

名称：AlwaysOnTop

类型：bool

窗口在失去焦点时应保持在其他窗口之上。

资源

名称：Assets

类型：*embed.FS

应用程序要使用的前端资源。需要一个index.html文件。

菜单

类型：*menu.Menu

类型：logger.Logger

注意：在 Mac 上，如果未指定菜单，则将创建默认菜单。

值	Win	Mac	Lin
GET	✅	✅	✅
POST	✅	✅	❌
PUT	✅	✅	❌
PATCH	✅	✅	❌
DELETE	✅	✅	❌
Request Headers	✅	✅	❌
Request Body	✅	✅	❌
Request Body Streaming	❌	❌	❌
Response StatusCodes	✅	✅	❌
Response Headers	✅	✅	❌
Response Body	✅	✅	✅
Response Body Streaming	❌	❌	✅

NOTE: Linux is currently very limited due to targeting a WebKit2GTK Version < 2.36.0. In the future some features will be supported by the introduction of WebKit2GTK 2.36.0+ support. In the future some features will be supported by the introduction of WebKit2GTK 2.36.0+ support.

NOTE: When used in combination with a Frontend DevServer there might be limitations, eg. Vite serves the index.html on every path, that does not contain a file extension. NOTE: When used in combination with a Frontend DevServer there might be limitations, eg. Vite serves the index.html on every path, that does not contain a file extension. Vite serves the index.html on every path, that does not contain a file extension.

日志

默认值：Logger to Stdout

名称：Menu

应用程序要使用的菜单。菜单参考中有关菜单的更多详细信息。

类型：logger.LogLevel

日志级别

默认值：在开发模式下是Info，在生产模式下是Error。

名称：Logger

名称：OnStartup

应用程序要使用的记录器。有关日志记录的更多详细信息，请参阅日志参考。

应用启动回调

名称：LogLevel

名称：OnDomReady

类型：func(ctx context.Context)

默认日志级别。有关日志记录的更多详细信息，请参阅日志参考。

前端 Dom 加载完成回调

名称：OnShutdown

名称：OnDomReady

Default: Error

The default log level for production builds. 有关日志记录的更多详细信息，请参阅日志参考。有关日志记录的更多详细信息，请参阅日志参考。

应用退出回调

类型：func(ctx context.Context) bool

类型：func(ctx context.Context)

此回调在前端创建之后调用，但在index.html加载之前调用。它提供了应用程序上下文。

关闭应用程序之前回调

名称：WindowStartState

类型：func(ctx context.Context)

在前端加载完毕index.html及其资源后调用此回调。它提供了应用程序上下文。

窗口启动状态

名称：Bind

类型：func(ctx context.Context)

在前端被销毁之后，应用程序终止之前，调用此回调。它提供了应用程序上下文。

绑定

名称：Windows

类型：*windows.Options

如果设置了此回调，它将在通过单击窗口关闭按钮或调用runtime.Quit即将退出应用程序时被调用. 返回 true 将导致应用程序继续，false 将继续正常关闭。 Returning true will cause the application to continue, false will continue shutdown as normal. 这有助于与用户确认他们希望退出程序。这有助于与用户确认他们希望退出程序。

名称：Mac

windowsapp.go
func (b *App) beforeClose(ctx context.Context) (prevent bool) {
    dialog, err := runtime.MessageDialog(ctx, runtime.MessageDialogOptions{
        类型：          runtime.QuestionDialog,
        Title:         "Quit?",
        Message:       "Are you sure you want to quit?",
    })

    if err != nil {
        return false
    }
    return dialog != "Yes"

WindowStartState

类型：*mac.Options

这定义了Mac 特定的选项。

名称：Linux

值	Win	Mac	Lin
Fullscreen	✅	✅	✅
Maximised	✅	✅	✅
Minimised	✅	❌	✅

Bind

类型：*linux.Options

这定义了Linux 特定的选项.

名称：WebviewIsTransparent

Windows

类型：bool

类型：*windows.Messages

名称：WindowIsTranslucent

Mac

类型：bool

Type: *mac.Options

名称：DisableWindowIcon

Linux

类型：bool

将此设置为 true 将删除标题栏左上角的图标。

名称：DisableFramelessWindowDecorations

Windows 特定选项

禁用窗口图标

类型：bool

设置为 true 时将使 WebView 背景透明。这意味着如果你使用rgba(0,0,0,0)，主窗口将显示。通常与窗口半透明结合使用以制作冰霜效果的应用程序。

禁用无边框窗口装饰

类型：string

类型：bool

将此设置为 true 将使窗口半透明。通常与网页透明结合使用以制作冰霜效果的应用程序。

Webview 用户数据路径

类型：windows.Theme

类型：bool

这定义了应用程序应该使用的主题：

主题

名称：CustomTheme

类型：bool

将此设置为true将移除无边框模式下的窗口装饰。这意味着将不会有Aero 阴影 和 圆角显示在窗口上。请注意，圆角只在 Windows 11 上支持。

自定义主题

允许您为浅色和深色模式以及窗口处于活动或非活动状态的 TitleBar、TitleText 和 Border 指定自定义颜色。

类型：string

这定义了 WebView2 存储用户数据的路径。如果为空将使用%APPDATA%\[BinaryName.exe]。

消息

示例：

类型：string

This defines the path to a directory with WebView2 executable files and libraries. If empty, webview2 installed in the system will be used. If empty, webview2 installed in the system will be used.

Important information about distribution of fixed version runtime:

标题栏

名称：TitleBar

类型：*mac.TitleBar

TitleBar 结构提供了配置标题栏外观的能力。

名称：Appearance

值	描述
SystemDefault	默认. 主题将基于系统默认值。 The theme will be based on the system default. The theme will be based on the system default. 如果用户更改了他们的主题，应用程序将更新以使用新设置 The theme will be based on the system default. 如果用户更改了他们的主题，应用程序将更新以使用新设置
Dark	该应用程序将只使用深色主题
Light	从样式掩码中移除 NSWindowStyleMaskTitled。

外观

类型：AppearanceType

Appearance 用于根据 Apple 的 NSAppearance 名称设置应用程序的样式。

名称：WebviewIsTransparent

类型：bool

外观

CustomTheme 结构使用 int32 指定颜色值. 这些是非标准 Windows 格式： 0x00BBGGAA。 These are in the standard(!) Windows format of: 0x00BBGGAA. These are in the standard(!) Windows format of: 0x00BBGGAA. 提供了一个辅助函数来将 RGB 转换为这种格式：windows.RGB(r,g,b uint8)。

名称：WindowIsTranslucent

type ThemeSettings struct {
    DarkModeTitleBar           int32
    DarkModeTitleBarInactive   int32
    DarkModeTitleText          int32
    DarkModeTitleTextInactive  int32
    DarkModeBorder             int32
    DarkModeBorderInactive     int32
    LightModeTitleBar          int32
    LightModeTitleBarInactive  int32
    LightModeTitleText         int32
    LightModeTitleTextInactive int32
    LightModeBorder            int32
    LightModeBorderInactive    int32
}

名称：Mac

    CustomTheme: &windows.ThemeSettings{
        // Theme to use when window is active
        DarkModeTitleBar:   windows.RGB(255, 0, 0),   // Red
        DarkModeTitleText:  windows.RGB(0, 255, 0),   // Green
        DarkModeBorder:     windows.RGB(0, 0, 255),   // Blue
        LightModeTitleBar:  windows.RGB(200, 200, 200),
        LightModeTitleText: windows.RGB(20, 20, 20),
        LightModeBorder:    windows.RGB(200, 200, 200),
        // Theme to use when window is inactive
        DarkModeTitleBarInactive:   windows.RGB(128, 0, 0),
        DarkModeTitleTextInactive:  windows.RGB(0, 128, 0),
        DarkModeBorderInactive:     windows.RGB(0, 0, 128),
        LightModeTitleBarInactive:  windows.RGB(100, 100, 100),
        LightModeTitleTextInactive: windows.RGB(10, 10, 10),
        LightModeBorderInactive:    windows.RGB(100, 100, 100),
    },

网页透明

名称：Theme

名称：About

一个如果找不到有效的 webview2 运行时，webview2 安装程序所使用的字符串结构。您可以选择支持的任意语言定制此选项。

窗口半透明

此配置允许您为“AppMenu” role 创建的应用程序菜单中的“关于”菜单项设置标题、消息和图标。

可以使用 TitleBar 选项自定义应用程序的标题栏：

ResizeDebounceMS is the amount of time to debounce redraws of webview2 when resizing the window. The default value (0) will perform redraws as fast as it can. The default value (0) will perform redraws as fast as it can.

关于

示例：

单击此处获取有关自定义标题栏的一些灵感。

您可以指定应用程序的外观。

OnResume

示例：

单击此处获取有关自定义标题栏的一些灵感。

“关于”菜单项将出现在应用程序菜单中：

Mac 特定选项

TitleBar

名称：OnBeforeClose

单击后，将打开一个关于消息框：

The TitleBar struct provides the ability to configure the look and feel of the title bar.

Appearance

名称：Icon

类型：[]byte

Appearance is used to set the style of your app in accordance with Apple's NSAppearance names.

禁用窗口图标

类型：bool

设置为 true 时将使 WebView 背景透明。这意味着如果你使用rgba(0,0,0,0)，主窗口将显示。通常与窗口半透明结合使用以制作冰霜效果的应用程序。

禁用无边框窗口装饰

类型：string

类型：bool

将此设置为 true 将使窗口半透明。通常与网页透明结合使用以制作冰霜效果的应用程序。

About

名称：WebviewUserDataPath

类型：About

This configuration lets you set the title, message and icon for the "About" menu item in the app menu created by the "AppMenu" role.

标题栏结构

预设的标题栏设置可用：

type TitleBar struct {
    TitlebarAppearsTransparent bool
    HideTitle                  bool
    HideTitleBar               bool
    FullSizeContent            bool
    UseToolbar                 bool
    HideToolbarSeparator       bool
}

设置	描述
TitlebarAppearsTransparent	使标题栏透明。 This has the effect of hiding the titlebar and the content fill the window. This has the effect of hiding the titlebar and the content fill the window. Apple Docs
HideTitle	隐藏窗口的标题。 Apple Docs
HideTitleBar	Removes NSWindowStyleMaskTitled from the style mask
FullSizeContent	使 webview 填满整个窗口。 Apple Docs
UseToolbar	向窗口添加默认工具栏。 Apple Docs
HideToolbarSeparator	删除工具栏下方的线条。 Apple Docs

Preconfigured titlebar settings are available:

值	描述
`mac.TitleBarDefault()`
`mac.TitleBarHidden()`
`mac.TitleBarHiddenInset()`

名称：Mac

Mac: &mac.Options{
    TitleBar:     mac.TitleBarHiddenInset(),
}

Click here for some inspiration on customising the titlebar.

外观类型

You can specify the application's appearance.

值	描述
DefaultAppearance	使用默认系统值
NSAppearanceNameAqua	标准日间系统外观
NSAppearanceNameDarkAqua	标准黑夜系统外观
NSAppearanceNameVibrantLight	轻盈灵动的外观
NSAppearanceNameAccessibilityHighContrastAqua	标准白天系统外观的高对比度版本
NSAppearanceNameAccessibilityHighContrastDarkAqua	标准黑夜系统外观的高对比度版本
NSAppearanceNameAccessibilityHighContrastVibrantLight	轻盈灵动外观的高对比度版本
NSAppearanceNameAccessibilityHighContrastVibrantDark	深色活力外观的高对比度版本

名称：Mac

Mac: &mac.Options{
    Appearance: mac.NSAppearanceNameDarkAqua,
}

关于结构

type AboutInfo struct {
    Title   string
    Message string
    Icon    []byte
}

如果提供了这些设置，“关于”菜单项将出现在应用程序菜单中（使用AppMenu role 时）。建议这样配置：

//go:embed build/appicon.png
var icon []byte

func main() {
    err := wails.Run(&options.App{
        ...
        Mac: &mac.Options{
            About: &mac.AboutInfo{
                Title:   "My Application",
                Message: "© 2021 Me",
                Icon:    icon,
            },
        },
    })
        Mac: &mac.Options{
            About: &mac.AboutInfo{
                Title:   "My Application",
                Message: "© 2021 Me",
                Icon:    icon,
            },
        },
    })
        Mac: &mac.Options{
            About: &mac.AboutInfo{
                Title:   "My Application",
                Message: "© 2021 Me",
                Icon:    icon,
            },
        },
    })

The "About" menu item will appear in the app menu:

When clicked, that will open an about message box:

Linux 特定选项

Icon

Name: Icon

Type: []byte

设置代表窗口的图标。当窗口最小化（也称为图标化）时使用此图标。一些窗口管理器或桌面环境也可能将其放置在窗口框架中，或在其他上下文中显示。在其他情况下，根本不使用该图标，因此您的预计情况可能会有所不同。

注意：Wayland 上的 Gnome 至少不显示此图标。要在那里有一个应用程序图标，必须使用一个.desktop文件。在 KDE 上它应该可以工作。

图标应该以自然绘制的任何尺寸提供；也就是说，在传递图像之前不要缩放图像。缩放将延迟到当所需的最终尺寸已知的最后一刻，以获得最佳质量。

参数选项

应用程序参数选项​

标题​

宽度​

高度​

禁用调整窗口尺寸​

Fullscreen​

无边框​

最小宽度​

最小高度​

最大宽度​

最大高度​

启动时隐藏窗口​

关闭时隐藏窗口​

RGBA​

窗口固定在最顶层​

资源​

菜单​

日志​

日志级别​

应用启动回调​

前端 Dom 加载完成回调​

应用退出回调​

关闭应用程序之前回调​

窗口启动状态​

绑定​

WindowStartState​

Bind​

Windows​

Mac​

Linux​

Windows 特定选项​

禁用窗口图标​

禁用无边框窗口装饰​

Webview 用户数据路径​

主题​

自定义主题​

消息​

标题栏​

外观​

外观​

网页透明​

窗口半透明​

关于​

OnResume​

Mac 特定选项​

TitleBar​

Appearance​

禁用窗口图标​

禁用无边框窗口装饰​

About​

标题栏结构​

外观类型​

关于结构​

Linux 特定选项​

Icon​

应用程序参数选项

标题

宽度

高度

禁用调整窗口尺寸

Fullscreen

无边框

最小宽度

最小高度

最大宽度

最大高度

启动时隐藏窗口

关闭时隐藏窗口

RGBA

窗口固定在最顶层

资源

菜单

日志

日志级别

应用启动回调

前端 Dom 加载完成回调

应用退出回调

关闭应用程序之前回调

窗口启动状态

绑定

WindowStartState

Bind

Windows

Mac

Linux

Windows 特定选项

禁用窗口图标

禁用无边框窗口装饰

Webview 用户数据路径

主题

自定义主题

消息

标题栏

外观

外观

网页透明

窗口半透明

关于

OnResume

Mac 特定选项

TitleBar

Appearance

禁用窗口图标

禁用无边框窗口装饰

About

标题栏结构

外观类型

关于结构

Linux 特定选项

Icon