https://github.com/sqweek/dialog

Simple cross-platform dialog API for go-lang
https://github.com/sqweek/dialog

cross-platform dialog golang ui

Last synced: about 2 months ago
JSON representation

Simple cross-platform dialog API for go-lang

• Host: GitHub
• URL: https://github.com/sqweek/dialog
• Owner: sqweek
• License: isc
• Created: 2015-10-22T16:41:20.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2024-05-24T02:34:36.000Z (7 months ago)
• Last Synced: 2024-06-18T12:43:20.205Z (6 months ago)
• Topics: cross-platform, dialog, golang, ui
• Language: Go
• Size: 34.2 KB
• Stars: 485
• Watchers: 6
• Forks: 76
• Open Issues: 24
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# dialog

Simple cross-platform dialog API for go-lang

# examples

    ok := dialog.Message("%s", "Do you want to continue?").Title("Are you sure?").YesNo()

Creates a dialog box titled "Are you sure?", containing the message "Do you want to continue?",

a "Yes" button and a "No" button. Returns true iff the dialog could be displayed and the user

pressed the "Yes" button.

    filename, err := dialog.File().Filter("Mp3 audio file", "mp3").Load()

Creates a file selection dialog allowing the user to select a .mp3 file. The absolute path of

the file is returned, unless an error is encountered or the user cancels/closes the dialog.

In the latter case, `filename` will be the empty string and `err` will equal `dialog.Cancelled`.

    filename, err := dialog.File().Filter("XML files", "xml").Title("Export to XML").Save()

Asks the user for a filename to write data into. If the user selects a file which already exists,

an additional dialog is spawned to confirm they want to overwrite the existing file.

    directory, err := dialog.Directory().Title("Load images").Browse()

Asks the user for a directory.

# platform details

* OSX: uses Cocoa's NSAlert/NSSavePanel/NSOpenPanel/NSApp classes

    * requires macOS 10.6+ for `NSApplicationActivationPolicyAccessory`

* Win32: uses MessageBox/GetOpenFileName/GetSaveFileName (via package github.com/TheTitanrain/w32)

* Linux: uses Gtk's MessageDialog/FileChooserDialog (via cgo; requires gtk3 development packages)

# build

```

go mod download

go build

```

# bugs

On windows, the Load() and Save() calls change the working directory for the whole process while the dialog is open (after which it reset). This is an apparently unavoidable side effect of the underlying W32API; see #63 for more details.