2.6 KiB
cview
Terminal-based user interface toolkit
This package is a fork of tview. See FORK.md for more information.
Demo
ssh cview.rocketnine.space -p 20000
Features
Available widgets:
- Input forms (including input/password fields, drop-down selections, checkboxes, and buttons)
- Navigable multi-color text views
- Sophisticated navigable table views
- Flexible tree views
- Selectable lists
- Grid, Flexbox and page layouts
- Modal message windows
- Horizontal and vertical progress bars
- An application wrapper
Widgets may be customized and extended to suit any application.
Mouse support is available.
Installation
go get gitlab.com/tslocum/cview
Hello World
This basic example creates a box titled "Hello, World!" and displays it in your terminal:
package main
import (
"gitlab.com/tslocum/cview"
)
func main() {
box := cview.NewBox().SetBorder(true).SetTitle("Hello, world!")
if err := cview.NewApplication().SetRoot(box, true).Run(); err != nil {
panic(err)
}
}
Examples are available via godoc and in the "demos" subdirectory.
For a presentation highlighting the features of this package, compile and run the program in the "demos/presentation" subdirectory.
Documentation
Package documentation is available via godoc.
An introduction tutorial is also available.
Dependencies
This package is based on github.com/gdamore/tcell (and its dependencies) and github.com/rivo/uniseg.
Support
CONTRIBUTING.md describes how to share issues, suggestions and patches (pull requests).