Trevor Slocum b2d7b80afc | ||
---|---|---|
whichkeybind | ||
.gitignore | ||
.gitlab-ci.yml | ||
CHANGELOG | ||
LICENSE | ||
README.md | ||
configuration.go | ||
configuration_test.go | ||
doc.go | ||
go.mod | ||
go.sum | ||
key.go | ||
key_test.go |
README.md
cbind
Key event handling library for tcell
Features
- Set
KeyEvent
handlers - Encode and decode
KeyEvent
s as human-readable strings
Usage
// Create a new input configuration to store the key bindings.
c := NewConfiguration()
handleSave := func(ev *tcell.EventKey) *tcell.EventKey {
// Save
return nil
}
handleOpen := func(ev *tcell.EventKey) *tcell.EventKey {
// Open
return nil
}
handleExit := func(ev *tcell.EventKey) *tcell.EventKey {
// Exit
return nil
}
// Bind Alt+s.
if err := c.Set("Alt+s", handleSave); err != nil {
log.Fatalf("failed to set keybind: %s", err)
}
// Bind Alt+o.
c.SetRune(tcell.ModAlt, 'o', handleOpen)
// Bind Escape.
c.SetKey(tcell.ModNone, tcell.KeyEscape, handleExit)
// Capture input. This will differ based on the framework in use (if any).
// When using tview or cview, call Application.SetInputCapture before calling
// Application.Run.
app.SetInputCapture(c.Capture)
Documentation
Documentation is available via gdooc.
The utility program whichkeybind
may be used to determine and validate key combinations.
go get gitlab.com/tslocum/cbind/whichkeybind
Support
Please share issues and suggestions here.