メインコンテンツにスキップ
バージョン: v2.1.0

ダイアログ

ランタイムでは、ファイルセレクターやメッセージボックスといったネイティブダイアログへのアクセスを提供しています。

Javascript

現在、Javascriptランタイムではダイアログをサポートしていません。

OpenDirectoryDialog​

ユーザにディレクトリの選択を求めるダイアログを開きます。 OpenDialogOptionsを使用してカスタマイズできます。

Go: OpenDirectoryDialog(ctx context.Context, dialogOptions OpenDialogOptions) (string, error)

返り値: 選択されたディレクトリ(キャンセルされた場合は空) またはエラー

OpenFileDialog​

ユーザにファイルの選択を求めるダイアログを開きます。 OpenDialogOptionsを使用してカスタマイズできます。

Go: OpenFileDialog(ctx context.Context, dialogOptions OpenDialogOptions) (string, error)

返り値: 選択されたファイル(キャンセルされた場合は空) またはエラー

OpenMultipleFilesDialog​

ユーザに複数ファイルの選択を求めるダイアログを開きます。 OpenDialogOptionsを使用してカスタマイズできます。

Go: OpenMultipleFilesDialog(ctx context.Context, dialogOptions OpenDialogOptions) ([]string, error)

返り値: 選択された複数ファイル(キャンセルされた場合はnil) またはエラー

SaveFileDialog​

保存の目的でユーザにファイル名を入力選択させるダイアログを開きます。 SaveDialogOptionsを使用してカスタマイズできます。

Go: SaveFileDialog(ctx context.Context, dialogOptions SaveDialogOptions) (string, error)

返り値: 入力選択されたファイル(キャンセルされた場合は空) またはエラー

MessageDialog​

メッセージダイアログを使用してメッセージを表示します。 MessageDialogOptionsを使用してカスタマイズできます。

Go: MessageDialog(ctx context.Context, dialogOptions MessageDialogOptions) (string, error)

返り値: 選択されたボタンのテキストまたはエラー

オプション​

OpenDialogOptions​

type OpenDialogOptions struct {
    DefaultDirectory           string
    DefaultFilename            string
    Title                      string
    Filters                    []FileFilter
    ShowHiddenFiles            bool
    CanCreateDirectories       bool
    ResolvesAliases            bool
    TreatPackagesAsDirectories bool
}
FieldDescriptionWinMacLin
DefaultDirectoryダイアログが開かれたときに初期表示するディレクトリ✅✅✅
DefaultFilenameデフォルトファイル名✅✅✅
Titleダイアログのタイトル✅✅✅
Filtersファイルフィルタのリスト✅✅✅
ShowHiddenFilesシステムの隠しファイルを表示✅✅
CanCreateDirectoriesユーザによるディレクトリの作成を許可する✅
ResolvesAliasesエイリアスではなくファイルパスを返す✅
TreatPackagesAsDirectoriesパッケージへのナビゲーションを許可✅

SaveDialogOptions​

type SaveDialogOptions struct {
    DefaultDirectory           string
    DefaultFilename            string
    Title                      string
    Filters                    []FileFilter
    ShowHiddenFiles            bool
    CanCreateDirectories       bool
    TreatPackagesAsDirectories bool
}
FieldDescriptionWinMacLin
DefaultDirectoryダイアログが開かれたときに初期表示するディレクトリ✅✅✅
DefaultFilenameデフォルトファイル名✅✅✅
Titleダイアログのタイトル✅✅✅
Filtersファイルフィルタのリスト✅✅✅
ShowHiddenFilesシステムの隠しファイルを表示✅✅
CanCreateDirectoriesユーザによるディレクトリの作成を許可する✅
TreatPackagesAsDirectoriesパッケージへのナビゲーションを許可✅

MessageDialogOptions​

type MessageDialogOptions struct {
    Type          DialogType
    Title         string
    Message       string
    Buttons       []string
    DefaultButton string
    CancelButton  string
}
FieldDescriptionWinMacLin
Typeメッセージダイアログの種類 (質問、情報など)✅✅✅
Titleダイアログのタイトル✅✅✅
Messageユーザに表示するメッセージ✅✅✅
Buttonsボタンテキストのリスト✅
DefaultButton指定されたテキストのボタンをデフォルトボタンとして扱う。 Bound to return.✅*✅
CancelButton指定されたテキストのボタンをキャンセルボタンとして扱う。 escapeキーにバインドされます。✅

Windows​

Windowsでは、ボタンのカスタマイズができない標準ダイアログタイプがあります。 The value returned will be one of: "Ok", "Cancel", "Abort", "Retry", "Ignore", "Yes", "No", "Try Again" or "Continue".

For Question dialogs, the default button is "Yes" and the cancel button is "No". This can be changed by setting the DefaultButton value to "No".

Example:

    result, err := runtime.MessageDialog(a.ctx, runtime.MessageDialogOptions{
        Type:          runtime.QuestionDialog,
        Title:         "Question",
        Message:       "Do you want to continue?",
        DefaultButton: "No",
    })

Linux​

Linux has standard dialog types in which the buttons are not customisable. The value returned will be one of: "Ok", "Cancel", "Yes", "No"

Mac​

A message dialog on Mac may specify up to 4 buttons. If no DefaultButton or CancelButton is given, the first button is considered default and is bound to the return key.

For the following code:

selection, err := runtime.MessageDialog(b.ctx, runtime.MessageDialogOptions{
    Title:        "It's your turn!",
    Message:      "Select a number",
    Buttons:      []string{"one", "two", "three", "four"},
})

1番目のボタンがデフォルトになります:


And if we specify DefaultButton to be "two":

selection, err := runtime.MessageDialog(b.ctx, runtime.MessageDialogOptions{
    Title:         "It's your turn!",
    Message:       "Select a number",
    Buttons:       []string{"one", "two", "three", "four"},
    DefaultButton: "two",
})

the second button is shown as default. When return is pressed, the value "two" is returned.


If we now specify CancelButton to be "three":

selection, err := runtime.MessageDialog(b.ctx, runtime.MessageDialogOptions{
    Title:         "It's your turn!",
    Message:       "Select a number",
    Buttons:       []string{"one", "two", "three", "four"},
    DefaultButton: "two",
    CancelButton:  "three",
})

the button with "three" is shown at the bottom of the dialog. When escape is pressed, the value "three" is returned:




DialogType​

const (
        InfoDialog     DialogType = "info"
        WarningDialog  DialogType = "warning"
        ErrorDialog    DialogType = "error"
        QuestionDialog DialogType = "question"
     )

FileFilter​

type FileFilter struct {
    DisplayName string // Filter information EG: "Image Files (*.jpg, *.png)"
    Pattern     string // semi-colon separated list of extensions, EG: "*.jpg;*.png"
}

Windows​

Windows allows you to use multiple file filters in dialog boxes. Each FileFilter will show up as a separate entry in the dialog:




Linux​

Linux allows you to use multiple file filters in dialog boxes. Each FileFilter will show up as a separate entry in the dialog:




Mac​

Mac dialogs only have the concept of a single set of patterns to filter files. If multiple FileFilters are provided, Wails will use all the Patterns defined.

Example:

    selection, err := runtime.OpenFileDialog(b.ctx, runtime.OpenDialogOptions{
        Title: "Select File",
        Filters: []runtime.FileFilter{
            {
                DisplayName: "Images (*.png;*.jpg)",
                Pattern:     "*.png;*.jpg",
            }, {
                DisplayName: "Videos (*.mov;*.mp4)",
                Pattern:     "*.mov;*.mp4",
            },
        },
    })

This will result in the Open File dialog using *.png,*.jpg,*.mov,*.mp4 as a filter.