バージョン: 次期バージョン 🚧

オプション

アプリケーションオプション

Options.App構造体には、アプリケーションの構成設定が含まれています。これをwails.Run()メソッドに渡してください:

Example
import (
    "github.com/wailsapp/wails/v2/pkg/options"
    "github.com/wailsapp/wails/v2/pkg/options/assetserver"
    "github.com/wailsapp/wails/v2/pkg/options/linux"
    "github.com/wailsapp/wails/v2/pkg/options/mac"
    "github.com/wailsapp/wails/v2/pkg/options/windows"
)

func main() {

    err := wails.Run(&options.App{
        Title:              "Menus Demo",
        Width:              800,
        Height:             600,
        DisableResize:      false,
        Fullscreen:         false,
        WindowStartState:   options.Maximised,
        Frameless:          true,
        MinWidth:           400,
        MinHeight:          400,
        MaxWidth:           1280,
        MaxHeight:          1024,
        StartHidden:        false,
        HideWindowOnClose:  false,
        BackgroundColour:   &options.RGBA{R: 0, G: 0, B: 0, A: 255},
        AlwaysOnTop:        false,
        AssetServer: &assetserver.Options{
            Assets:     assets,
            Handler:    assetsHandler,
            Middleware: assetsMidldeware,
        },
        Menu:               app.applicationMenu(),
        Logger:             nil,
        LogLevel:           logger.DEBUG,
        LogLevelProduction: logger.ERROR,
        OnStartup:          app.startup,
        OnDomReady:         app.domready,
        OnShutdown:         app.shutdown,
        OnBeforeClose:      app.beforeClose,
        CSSDragProperty:   "--wails-draggable",
        CSSDragValue:      "drag",
        EnableDefaultContextMenu: false,
        EnableFraudulentWebsiteDetection: false,
        Bind: []interface{}{
            app,
        },
        EnumBind: []interface{}{
            AllWeekdays,
        },
        ErrorFormatter: func(err error) any { return err.Error() },
        SingleInstanceLock: &options.SingleInstanceLock{
          UniqueId:               "c9c8fd93-6758-4144-87d1-34bdb0a8bd60",
          OnSecondInstanceLaunch: app.onSecondInstanceLaunch,
        },
        DragAndDrop: &options.DragAndDrop{
          EnableFileDrop:       false,
          DisableWebViewDrop:   false,
          CSSDropProperty:      "--wails-drop-target",
          CSSDropValue:         "drop",
        },
        Windows: &windows.Options{
            WebviewIsTransparent:              false,
            WindowIsTranslucent:               false,
            BackdropType:                      windows.Mica,
            DisablePinchZoom:               false,
            DisableWindowIcon:                 false,
            DisableFramelessWindowDecorations: false,
            WebviewUserDataPath:               "",
            WebviewBrowserPath:                "",
            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),
            },
            // ZoomFactor is the zoom factor for the WebView2. これは、Edgeのユーザによるズームインまたはズームアウトに対応するオプションです。
            ZoomFactor:           float64,
            // IsZoomControlEnabled enables the zoom factor to be changed by the user.
            IsZoomControlEnabled: bool,
            // User messages that can be customised
            Messages: *windows.Messages
            // OnSuspend is called when Windows enters low power mode
            OnSuspend: func()
            // OnResume is called when Windows resumes from low power mode
            OnResume: func(),
            // Disable GPU hardware acceleration for the webview
                  WebviewGpuDisabled: false,
                  // Class name for the window. If empty, 'wailsWindow' will be used.
                  WindowClassName: "MyWindow",
        },
        Mac: &mac.Options{
            TitleBar: &mac.TitleBar{
                TitlebarAppearsTransparent: true,
                HideTitle:                  false,
                HideTitleBar:               false,
                FullSizeContent:            false,
                UseToolbar:                 false,
                HideToolbarSeparator:       true,
                OnFileOpen: app.onFileOpen,
                      OnUrlOpen:  app.onUrlOpen,
            },
            Appearance:           mac.NSAppearanceNameDarkAqua,
            WebviewIsTransparent: true,
            WindowIsTranslucent:  false,
            About: &mac.AboutInfo{
                Title:   "My Application",
                Message: "© 2021 Me",
                Icon:    icon,
            },
        },
        Linux: &linux.Options{
            Icon: icon,
            WindowIsTranslucent: false,
            WebviewGpuPolicy: linux.WebviewGpuPolicyAlways,
            ProgramName: "wails"
        },
        Debug: options.Debug{
            OpenInspectorOnStartup: false,
        },
    })

    if err != nil {
        log.Fatal(err)
    }
}

Title

ウィンドウのタイトルバーに表示されるテキストです。

名前: Title
データ型: string

Width

ウィンドウの初期幅です。

名前: Width
データ型: int
デフォルト値: 1024

Height

ウィンドウの初期の高さです。

名前: Height
データ型: int
デフォルト値: 768

DisableResize

デフォルトでは、メインウィンドウのサイズは自在に変更することができます。この設定をtrueにすると、サイズが固定されます。

名前: DisableResize
データ型: bool

Fullscreen

非推奨: 代わりにWindowStartStateを使用してください。

WindowStartState

起動時にウィンドウをどのように表示させるかを定義します。

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

名前: WindowStartState
データ型: options.WindowStartState

Frameless

この設定をtrueにすると、ウィンドウに境界線やタイトルバーが表示されなくなります。詳しくはフレームレスウィンドウをご覧ください。

名前: Frameless
データ型: bool

MinWidth

ウィンドウの最小幅を設定します。 Widthの値がこの値より小さい場合、ウィンドウ幅はデフォルトでMinWidthの値となります。

名前: MinWidth
データ型: int

MinHeight

ウィンドウの最小の高さを設定します。 Heightの値がこの値より小さい場合、ウィンドウの高さはデフォルトでMinHeightの値となります。

名前: MinHeight
データ型: int

MaxWidth

ウィンドウの最大幅を設定します。 Widthの値がこの値より大きい場合、ウィンドウ幅はデフォルトでMaxWidthの値となります。

名前: MaxWidth
データ型: int

MaxHeight

ウィンドウの最大の高さを設定します。 Heightの値がこの値より大きい場合、ウィンドウの高さはデフォルトでMaxHeightの値となります。

名前: MaxHeight
データ型: int

StartHidden

trueに設定すると、アプリケーションはWindowShowが呼び出されるまで非表示となります。

名前: StartHidden
データ型: bool

HideWindowOnClose

デフォルトでは、ウィンドウを閉じるとアプリケーションが終了します。この設定をtrueにすると、ウィンドウを閉じる操作をした際に、

ウィンドウが非表示の状態になります。

名前: HideWindowOnClose
データ型: bool

BackgroundColour

ウィンドウのデフォルトの背景色です。例: options.NewRGBA(255,0,0,128) - 50%透過された赤色

名前: BackgroundColour
データ型: *options.RGBA
デフォルト値: white

AlwaysOnTop

ウィンドウへのフォーカスが無くなっても、他ウィンドウより手前側にウィンドウを表示させるかを設定します。

名前: AlwaysOnTop
データ型: bool

Assets

非推奨: 代わりにAssetServerの固有オプションであるAssetsオプションを使用してください。

AssetsHandler

非推奨: 代わりにAssetServerの固有オプションであるAssetsHandlerオプションを使用してください。

AssetServer

AssetServerの固有オプションを定義します。静的なアセットでAssetServerをカスタマイズしたり、http.Handlerで動的なアセットを提供したり、assetserver.Middlewareでリクエストチェーンにフックしたりすることができます。

現在のところ、http.Requestのすべての機能がサポートされているわけではありません。次の機能マトリクスを確認してください:

機能	Win	Mac	Lin
GET	✅	✅	✅
POST	✅	✅	✅ ¹
PUT	✅	✅	✅ ¹
PATCH	✅	✅	✅ ¹
DELETE	✅	✅	✅ ¹
Request Headers	✅	✅	✅ ¹
Request Body	✅	✅	✅ ²
Request Body Streaming	✅	✅	✅ ²
Response StatusCodes	✅	✅	✅ ¹
Response Headers	✅	✅	✅ ¹
Response Body	✅	✅	✅
Response Body Streaming	❌	✅	✅
WebSockets	❌	❌	❌
HTTP Redirects 30x	✅	❌	❌

名前: AssetServer
データ型: *assetserver.Options

Assets

アプリケーションのフロントエンドで使用される静的アセットです。

GETリクエストが要求された場合、まず初めに、このfs.FSからのアセット提供を試みます。 fs.FSから、当該ファイルが存在しない旨のos.ErrNotExistエラーが返された場合、このリクエストはHandlerへフォールバックされ、ハンドラ側でGETリクエストへの応答を試みます。

nilがセットされている場合、GETリクエストに常にHandlerへ転送されます。

名前: Assets
データ型: fs.FS

Handler

アセットハンドラは、アセットが見つからなかった場合のフォールバック処理を担う、ジェネリックなhttp.Handlerです。

Assets内でos.ErrNotExistエラーが発生したことにより、アセットを提供できないと判断されたすべてのGETリクエストによって、このハンドラが呼び出されます。また、GET以外のすべての種類のリクエストは、常にこのハンドラから応答が返されます。ハンドラが定義されていない状態で、ハンドラが呼び出された場合、次の応答が返されます:

GETリクエスト: http.StatusNotFound
その他のリクエスト: http.StatusMethodNotAllowed

情報

This does not work with vite v5.0.0+ and wails v2 due to changes in vite. Changes are planned in v3 to support similar functionality under vite v5.0.0+. If you need this feature, stay with vite v4.0.0+. See issue 3240 for details

注意: フロントエンド側の開発サーバと組み合わせて使用すると、一部制限がかかる場合があります。 Viteは、拡張子を含まないパスに対して、常にindex.htmlを返します。

名前: AssetsHandler
データ型: http.Handler

Middleware

MiddlewareはHTTPミドルウェアで、AssetServerのリクエストチェーンをフックすることができます。例えば、特殊なルーティングを実装したいときなど、デフォルトのリクエストハンドラを動的にスキップさせることができます。 Middlewareは、AssetSeverが使用する新しいhttp.Handlerを生成するために呼び出されます。引数では、AssetServerがデフォルトで使用するハンドラを受け取ります。

Middlewareが定義されていない場合、デフォルトのAssetServerのリクエストチェーンが実行されます。

名前: Middleware
データ型: assetserver.Middleware

アプリケーションで使用されるメニューです。メニューについて詳しくは、メニューのリファレンスをご覧ください。

備考

Macでは、メニューが指定されていない場合、デフォルトメニューが作成されます。

名前: Menu
データ型: *menu.Menu

Logger

アプリケーションで使用するロガーです。ロギングについて詳しくは、ログのリファレンスをご覧ください。

名前: Logger
データ型: logger.Logger
デフォルト値: 標準出力へのロガー

LogLevel

デフォルトのログレベルです。ロギングについて詳しくは、ログのリファレンスをご覧ください。

名前: LogLevel
データ型: logger.LogLevel
デフォルト値: 開発モードの場合はInfo、本番モードの場合はError

LogLevelProduction

本番ビルド時のデフォルトのログレベルです。ロギングについて詳しくは、ログのリファレンスをご覧ください。

名前: LogLevelProduction
データ型: logger.LogLevel
デフォルト値: Error

OnStartup

フロントエンド作成後、index.htmlが読み込まれる前に呼び出されるコールバックです。アプリケーションのcontextが渡されます。

名前: OnStartup
データ型: func(ctx context.Context)

OnDomReady

フロントエンドがindex.htmlとそのリソースを読み込んだ後に呼び出されるコールバックです。アプリケーションのcontextが渡されます。

名前: OnDomReady
データ型: func(ctx context.Context)

OnShutdown

フロントエンドが破棄され、アプリケーションが終了する直前に呼び出されるコールバックです。アプリケーションのcontextが渡されます。

名前: OnShutdown
データ型: func(ctx context.Context)

OnBeforeClose

ウィンドウの閉じるボタンをクリックするか、runtime.Quitが呼ばれて、アプリケーションが終了されそうになっているときに呼び出されるコールバックです。 trueを返すとアプリケーションはそのまま維持され、falseを返すと通常どおりシャットダウンされます。ユーザに対してプログラムの終了を確認したいときは、このコールバックを使うのが良いでしょう。

例:

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

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

名前: OnBeforeClose
データ型: func(ctx context.Context) bool

CSSDragProperty

ウィンドウをドラッグできる要素を特定するためのCSSプロパティ名を設定します。デフォルト値: --wails-draggable

名前: CSSDragProperty
データ型: string

CSSDragValue

ウィンドウのドラッグを有効にするために、CSSDragPropertyスタイルが持つべき値を設定します。デフォルト値: drag

名前: CSSDragValue
データ型: string

EnableDefaultContextMenu

EnableDefaultContextMenuは、本番環境において、ブラウザのデフォルトコンテキストメニューを有効にします。

By default, the browser's default context-menu is only available in development and in a -debug build along with the devtools inspector, Using this option you can enable the default context-menu in production while the devtools inspector won't be available unless the -devtools build flag is used.

このオプションを有効にすると、デフォルトでは、テキストに関するコンテキスト(切り取り/コピー/貼り付け) のみがコンテキストメニューに表示されます。この動作をオーバーライドするには、--default-contextmenuというCSSプロパティを任意のHTML要素(body含む) で以下の値と共に使用してください:

CSSスタイル	動作
`--default-contextmenu: auto;`	(デフォルト) 次の場合にのみデフォルトのコンテキストメニューを表示します: contentEditableがtrueである、またはテキストが選択されている、またはinput要素/textarea要素であるとき
`--default-contextmenu: show;`	常にデフォルトのコンテキストメニューを表示します
`--default-contextmenu: hide;`	常にデフォルトのコンテキストメニューを非表示にします

このルールは通常のCSSルールと同様に継承されるため、ネストも期待どおりに動作します。

備考

このフィルタリング機能は本番環境でのみ有効であり、開発・デバッグビルドでは、フルコンテキストメニューが常に使用できます。

警告

このフィルタリング機能はセキュリティ対策として使用することはできません。開発者は、画像のダウンロード、リロード、ウェブページの保存といったコマンドを含むフルコンテキストメニューが常にリークされる可能性を考慮すべきです。この点が気になる場合、開発者はデフォルトのコンテキストメニューを有効にするべきではありません。

名前: EnableDefaultContextMenu
データ型: bool

EnableFraudulentWebsiteDetection

EnableFraudulentWebsiteDetectionは、マルウェアやフィッシング詐欺などの不正コンテンツのスキャンサービスを有効にします。これらのサービスは、ナビゲートされたURLやその他コンテンツ情報を、アプリからAppleおよびMicrosoftのクラウドサービスに送信する可能性があります。

名前: EnableFraudulentWebsiteDetection
データ型: bool

Bind

フロントエンドにバインドする必要があるメソッドが定義された、構造体インスタンスのスライスです。

名前: Bind
データ型: []interface{}

EnumBind

A slice of Enum arrays that need to be bound to the frontend.

Name: EnumBind
Type: []interface{}

ErrorFormatter

JSからGoへ呼び出されたメソッドがエラーを返す際に、エラーをフォーマットする関数です。返り値はJSONとして変換されます。

名前: ErrorFormatter
データ型: func (error) any

SingleInstanceLock

Enables single instance locking. This means that only one instance of your application can be running at a time.

Name: SingleInstanceLock
Type: *options.SingleInstanceLock

UniqueId

This id is used to generate the mutex name on Windows and macOS and the dbus name on Linux. Use a UUID to ensure that the id is unique.

Name: UniqueId
Type: string

OnSecondInstanceLaunch

Callback that is called when a second instance of your app is launched.

Name: OnSecondInstanceLaunch
Type: func(secondInstanceData SecondInstanceData)

Drag and Drop

Defines the behavior of drag and drop events on the window.

Name: DragAndDrop
Type: options.DragAndDrop

EnableFileDrop

EnableFileDrop enables wails' drag and drop functionality that returns the dropped in files' absolute paths.

When it is set to true the runtime methods can be used.
Or you can listen for the wails:file-drop event with runtime EventsOn method both on the Javascript and GO side to implement any functionality you would like.

The event returns the coordinates of the drop and a file path slice.

Name: EnableFileDrop
Type: bool
Default: false

DisableWebViewDrop

Disables the webview's drag and drop functionality.

It can be used to prevent accidental opening of dragged in files in the webview, when there is no need for drag and drop.

Name: DisableWebViewDrop
Type: bool
Default: false

CSSDropProperty

CSS property to test for drag and drop target elements.

Name: CSSDropProperty
Type: string
Default: --wails-drop-target

CSSDropValue

The CSS Value that the CSSDropProperty must have to be a valid drop target. Default "drop"

Name: CSSDropValue
Type: string
Default: drop

Windows

Windows固有のオプションを定義します。

名前: Windows
データ型: *windows.Options

WebviewIsTransparent

この値をtrueに設定すると、アルファ値が0の際に、WebViewの背景が透明になります。つまり、CSSでbackground-colorにrgba(0,0,0,0)を設定すると、ホストウィンドウが透けて見えるようになります。多くの場合、WindowIsTranslucentと組み合わて、霜のように見えるアプリケーションを作成する際に使用します。

名前: WebviewIsTransparent
データ型: bool

WindowIsTranslucent

この値をtrueに設定すると、ウィンドウの背景が半透明になります。多くの場合、WebviewIsTransparentと組み合わせて使用されます。

ビルド22621より前のWindows 11の場合、半透明を実現させるためにBlurBehindメソッドを使用するため、処理が遅くなる可能性があります。ビルド22621以降のWindows 11では、より高速な、新しい半透明タイプが有効になります。デフォルトで使用される半透明タイプは、Windowsにより決定されます。このタイプを設定するには、BackdropTypeオプションを使用してください。

名前: WindowIsTranslucent
データ型: bool

BackdropType

備考

この設定を適用するには、Windows 11 ビルド22621以降が必要です。

ウィンドウの半透明タイプを設定します。この設定は、WindowIsTranslucentがtrueに設定されている場合にのみ適用されます。

名前: BackdropType
データ型: windows.BackdropType

値は次のいずれかを指定してください:

値	説明
Auto	Windowsに背景を決定させる
None	半透明にしない
Acrylic	アクリルの効果を使用する
Mica	マイカの効果を使用する
Tabbed	タブを使用する。これはマイカに似ている背景です。

ZoomFactor

名前: ZoomFactor
データ型: float64

WebView2の拡大率を定義します。これは、Edgeのユーザによるズームインまたはズームアウトに対応するオプションです。

IsZoomControlEnabled

名前: IsZoomControlEnabled
データ型: bool

このオプションを有効にすると、拡大率をユーザによって変更することができます。拡大率の変更がユーザに許可されていない間は、オプションで拡大率を設定することができますのでご注意ください (例: キオスクアプリケーションなど)。

DisablePinchZoom

Setting this to true will disable pinch zoom gestures.

Name: DisablePinchZoom
Type: bool

DisableWindowIcon

この設定をtrueにすると、タイトルバーの左上隅のアイコンが消去されます。

名前: DisableWindowIcon
データ型: bool

DisableFramelessWindowDecorations

この設定をtrueにすると、フレームレスモードでのウィンドウデコレーションが消去されます。つまり、'Aero Shadow'および'Rounded Corners'がウィンドウに適用されなくなります。なお、'Rounded Corners'はWindows 11でのみサポートされていますのでご注意ください。

名前: DisableFramelessWindowDecorations
データ型: bool

WebviewUserDataPath

WebView2が、ユーザデータを格納するパスを設定します。空の場合は、%APPDATA%\[BinaryName.exe]が使用されます。

名前: WebviewUserDataPath
データ型: string

WebviewBrowserPath

WebView2の実行ファイルおよびライブラリが存在するディレクトリへのパスを設定します。空の場合、システムにインストールされているWebView2が使用されます。

固定バージョンランタイムディストリビューションに関する重要情報:

名前: WebviewBrowserPath
データ型: string

Theme

サポートされるWindowsの最小バージョン: Windows 10 2004/20H1

アプリケーションが使用するテーマを設定します:

値	説明
SystemDefault	_デフォルト値_です。テーマは、システムのデフォルト設定に基づきます。ユーザがシステムのテーマ設定を変更した場合、アプリケーションは新しい設定を使用するように更新されます。
Dark	アプリケーションはダークテーマのみを使用します。
Light	アプリケーションはライトテーマのみを使用します。

名前: Theme
データ型: windows.Theme

CustomTheme

備考

サポートされるWindowsの最小バージョン: Windows 10/11 2009/21H2 ビルド22000

ウィンドウがアクティブまたは非アクティブのときに、ライトモード・ダークモードのそれぞれにおいて、タイトルバー、タイトルテキスト、ボーダーのカスタムカラーを設定できます。

名前: CustomTheme
データ型: windows.CustomTheme

CustomTheme 型

CustomTheme構造体は、int32型で色の値を指定します。これは0x00BBGGAAで表されるWindowsの標準フォーマットで指定します。 RGBの値をこのフォーマットに変換するために、windows.RGB(r,g,b uint8)のようなヘルパー関数が用意されています。

注意: 指定されていない値はデフォルトで黒色になります。

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
}

例:

    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),
    },

Messages

利用可能なWebView2ランタイムが見つからなかったときに表示する、WebView2インストーラに関するメッセージ文字列を設定します。

名前: Messages
データ型: *windows.Messages

プロジェクトがサポートする言語にあわせて、この設定をカスタマイズしてください。

ResizeDebounceMS

ResizeDebounceMSは、ウィンドウサイズが変更されたときに、WebView2の再描画を実行するまでの時間です。デフォルト値(0) は、できるだけ早く再描画を実行します。

名前: ResizeDebounceMS
データ型: uint16

OnSuspend

Windowsがローパワーモード(サスペンド/休止状態) に切り替わると呼び出されるコールバックを設定します。

名前: OnSuspend
データ型: func()

OnResume

Windowsがローパワーモード(サスペンド/休止状態) から復帰したときに呼び出されるコールバックを設定します。

名前: OnResume
データ型: func()

WebviewGpuIsDisabled

trueに設定すると、webviewのGPUハードウェアアクセラレーションが無効化されます。

名前: WebviewGpuIsDisabled
データ型: bool

EnableSwipeGestures

Setting this to true will enable swipe gestures for the webview.

Name: EnableSwipeGestures
Type: bool

WindowClassName

Class name for the window. If empty, 'wailsWindow' will be used.

Name: WindowClassName
Type: string

Mac

Mac固有のオプションを定義します。

名前: Mac
データ定義: *mac.Options

TitleBar

TitleBar構造体は、タイトルバーのルック・アンド・フィールを設定する機能を提供します。

名前: TitleBar
データ型: *mac.TitleBar

Titlebar 構造体

アプリケーションのタイトルバーは、TitleBarオプションを使用することでカスタマイズできます:

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

名前	説明
TitlebarAppearsTransparent	タイトルバーを透明にします。これにより、タイトルバーが非表示になり、コンテンツがウィンドウ全体に表示されます。 Appleドキュメント
HideTitle	ウィンドウタイトルを非表示にします。 Appleドキュメント
HideTitleBar	スタイルマスクからNSWindowStyleMaskTitledを消去します。
FullSizeContent	WebViewをウィンドウ全体に表示します。 Appleドキュメント
UseToolbar	ウィンドウにデフォルトツールバーを追加します。 Appleドキュメント
HideToolbarSeparator	ツールバーの下側の線を消去します。 Appleドキュメント

事前設定されたタイトルバー構成を利用することも可能です:

設定	例
`mac.TitleBarDefault()`
`mac.TitleBarHidden()`
`mac.TitleBarHiddenInset()`

例:

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

タイトルバーのカスタマイズに関してインスピレーションを得たい場合はこちらをご覧ください。

Appearance

Appearanceは、AppleのNSAppearanceNameに従って、アプリケーションのスタイルを設定するために使用します。

名前: Appearance
データ型: mac.AppearanceType

Appearance 型

アプリケーションの外観を指定します。

値	説明
DefaultAppearance	DefaultAppearanceは、システムのデフォルト値を使用します。
NSAppearanceNameAqua	システムの標準的なライト外観
NSAppearanceNameDarkAqua	システムの標準的なダーク外観
NSAppearanceNameVibrantLight	より鮮やかなライト外観
NSAppearanceNameAccessibilityHighContrastAqua	システムの標準的なライト外観のハイコントラスト版
NSAppearanceNameAccessibilityHighContrastDarkAqua	システムの標準的なダーク外観のハイコントラスト版
NSAppearanceNameAccessibilityHighContrastVibrantLight	より鮮やかなライト外観のハイコントラスト版
NSAppearanceNameAccessibilityHighContrastVibrantDark	より鮮やかなダーク外観のハイコントラスト版

例:

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

WebviewIsTransparent

名前: WebviewIsTransparent
データ型: bool

WindowIsTranslucent

この値をtrueに設定すると、ウィンドウの背景が半透明になります。多くの場合、WebviewIsTransparentと組み合わて、霜のように見えるアプリケーションを作成する際に使用します。

名前: WindowIsTranslucent
データ型: bool

OnFileOpen

Callback that is called when a file is opened with the application.

Name: OnFileOpen
Type: func(filePath string)

OnUrlOpen

Callback that is called when a URL is opened with the application.

Name: OnUrlOpen
Type: func(filePath string)

Preferences

The Preferences struct provides the ability to configure the Webview preferences.

Name: Preferences
Type: *mac.Preferences

Preferences struct

You can specify the webview preferences.

type Preferences struct {
    TabFocusesLinks        u.Bool
    TextInteractionEnabled u.Bool
    FullscreenEnabled      u.Bool
}

名前	説明
TabFocusesLinks	A Boolean value that indicates whether pressing the tab key changes the focus to links and form controls. Apple Docs
TextInteractionEnabled	A Boolean value that indicates whether to allow people to select or otherwise interact with text. Apple Docs
FullscreenEnabled	A Boolean value that indicates whether a web view can display content full screen. Apple Docs

例:

Mac: &mac.Options{
    Preferences: &mac.Preferences{
        TabFocusesLinks:        mac.Enabled,
        TextInteractionEnabled: mac.Disabled,
        FullscreenEnabled:      mac.Enabled,
    }
}

About

"AppMenu"ロールで作成されたアプリケーションメニューの中にある"About"メニュー項目において、タイトル、メッセージ、アイコンを設定できます。

名前: About
データ型: *mac.AboutInfo

About 構造体

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

これらの設定が定義されている場合、AppMenuロールが使用されていれば、アプリケーションメニュー内に"About"メニューが表示されます。例えば以下のように設定すると:

//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,
            },
        },
    })

アプリケーションメニューに"About"メニュー項目が表示されます:

クリックすると、アプリケーション概要メッセージボックスが開かれます:

Linux

Linux固有のオプションを定義します。

名前: Linux
データ型: *linux.Options

Icon

ウィンドウを示すアイコンを設定します。このアイコンは、ウィンドウが最小化されたときに使用されます(iconifiedと呼ばれます)。

名前: Icon
データ型: []byte

一部のウィンドウマネージャやデスクトップ環境では、ウィンドウフレームに配置されたり、他のコンテキストで表示される場合もあります。反対に、環境によっては全くアイコンが使用されないこともありますのでご注意ください。

注意: 少なくともWayland上のGnomeでは、このアイコンは表示されません。アプリケーションアイコンを表示させるには、.desktopファイルを使用する必要があります。 KDEの場合は正常に表示されるはずです。

アイコンは、何の加工もされていないサイズで用意してください。つまり、拡大/縮小された画像は使用しないでください。最高品質を確保するために、拡大/縮小は、最終的な目的サイズがはっきりするまで待ってください。

WindowIsTranslucent

この値をtrueに設定すると、ウィンドウの背景が半透明になります。ウィンドウマネージャによっては、この設定を無視したり、ブラックウィンドウになる場合があります。

名前: WindowIsTranslucent
データ型: bool

WebviewGpuPolicy

このオプションでは、webviewのハードウェアアクセラレーションポリシーを指定することができます。

名前: WebviewGpuPolicy
データ型: options.WebviewGpuPolicy
デフォルト値: WebviewGpuPolicyAlways

WebviewGpuPolicy型

値	説明
WebviewGpuPolicyAlways	ハードウェアアクセラレーションを常に有効にする
WebviewGpuPolicyOnDemand	Webコンテンツからの要求に応じて、ハードウェアアクセラレーションの有効/無効を切り替える
WebviewGpuPolicyNever	ハードウェアアクセラレーションを常に無効にする

ProgramName

このオプションでは、GTKのg_set_prgname() を使用し、ウィンドウマネージャのプログラム名を設定することができます。ただし、ローカライズされた名前を設定すべきではありません。詳しくはドキュメントをご覧ください。

.desktopファイルが作成される際、.desktopファイルのNameオプションと実行ファイルのファイル名が異なる場合に、ウィンドウのグループ化およびデスクトップアイコンの表示に、本オプションは役立ちます。

名前: ProgramName
データ型: string

Debug

デバッグビルド時に適用されるデバッグ固有のオプションを定義します。

名前: Debug
データ型: options.Debug

OpenInspectorOnStartup

このオプションをtrueに設定すると、アプリケーション起動時にWeb開発者ツールが表示されます。

名前: OpenInspectorOnStartup
データ型: bool

この機能の動作には、WebKit2GTK 2.36以上が必要となるため、機能を確実に対応させたい場合は、アプリビルド時にビルドタグwebkit2_36を付与してください。これにより、アプリに必要なWebKit2GTKの最小バージョン要件が2.36に引き上げられます。 ↩ ↩² ↩³ ↩⁴ ↩⁵ ↩⁶ ↩⁷
この機能の動作には、WebKit2GTK 2.40以上が必要となるため、機能を確実に対応させたい場合は、アプリビルド時にビルドタグwebkit2_40を付与してください。これにより、アプリに必要なWebKit2GTKの最小バージョン要件が2.40に引き上げられます。 ↩ ↩²

アプリケーションオプション​

Title​

Width​

Height​

DisableResize​

Fullscreen​

WindowStartState​

Frameless​

MinWidth​

MinHeight​

MaxWidth​

MaxHeight​

StartHidden​

HideWindowOnClose​

BackgroundColour​

AlwaysOnTop​

Assets​

AssetsHandler​

AssetServer​

Assets​

Handler​

Middleware​

Menu​

Logger​

LogLevel​

LogLevelProduction​

OnStartup​

OnDomReady​

OnShutdown​

OnBeforeClose​

CSSDragProperty​

CSSDragValue​

EnableDefaultContextMenu​

EnableFraudulentWebsiteDetection​

Bind​

EnumBind​

ErrorFormatter​

SingleInstanceLock​

UniqueId​

OnSecondInstanceLaunch​

Drag and Drop​

EnableFileDrop​

DisableWebViewDrop​

CSSDropProperty​

CSSDropValue​

Windows​

WebviewIsTransparent​

WindowIsTranslucent​

BackdropType​

ZoomFactor​

IsZoomControlEnabled​

DisablePinchZoom​

DisableWindowIcon​

DisableFramelessWindowDecorations​

WebviewUserDataPath​

WebviewBrowserPath​

Theme​

CustomTheme​

CustomTheme 型​

Messages​

ResizeDebounceMS​

OnSuspend​

OnResume​

WebviewGpuIsDisabled​

EnableSwipeGestures​

WindowClassName​

Mac​

TitleBar​

Titlebar 構造体​

Appearance​

Appearance 型​

WebviewIsTransparent​

WindowIsTranslucent​

OnFileOpen​

OnUrlOpen​

Preferences​

Preferences struct​

About​

About 構造体​

Linux​

アプリケーションオプション

Title

Width

Height

DisableResize

Fullscreen

WindowStartState

Frameless

MinWidth

MinHeight

MaxWidth

MaxHeight

StartHidden

HideWindowOnClose

BackgroundColour

AlwaysOnTop

Assets

AssetsHandler

AssetServer

Assets

Handler

Middleware

Menu

Logger

LogLevel

LogLevelProduction

OnStartup

OnDomReady

OnShutdown

OnBeforeClose

CSSDragProperty

CSSDragValue

EnableDefaultContextMenu

EnableFraudulentWebsiteDetection

Bind

EnumBind

ErrorFormatter

SingleInstanceLock

UniqueId

OnSecondInstanceLaunch

Drag and Drop

EnableFileDrop

DisableWebViewDrop

CSSDropProperty

CSSDropValue

Windows

WebviewIsTransparent

WindowIsTranslucent

BackdropType

ZoomFactor

IsZoomControlEnabled

DisablePinchZoom

DisableWindowIcon

DisableFramelessWindowDecorations

WebviewUserDataPath

WebviewBrowserPath

Theme

CustomTheme

CustomTheme 型

Messages

ResizeDebounceMS

OnSuspend

OnResume

WebviewGpuIsDisabled

EnableSwipeGestures

WindowClassName

Mac

TitleBar

Titlebar 構造体

Appearance

Appearance 型

WebviewIsTransparent

WindowIsTranslucent

OnFileOpen

OnUrlOpen

Preferences

Preferences struct

About

About 構造体

Linux