mirror of https://github.com/gizak/termui.git
0278568ed8
|
||
|---|---|---|
| _assets | ||
| _examples | ||
| _scripts | ||
| _test | ||
| widgets | ||
| .gitignore | ||
| CHANGELOG.md | ||
| LICENSE | ||
| Makefile | ||
| README.md | ||
| alignment.go | ||
| block.go | ||
| buffer.go | ||
| canvas.go | ||
| doc.go | ||
| events.go | ||
| go.mod | ||
| go.sum | ||
| grid.go | ||
| render.go | ||
| style.go | ||
| symbols.go | ||
| symbols_other.go | ||
| symbols_windows.go | ||
| termbox.go | ||
| text_parser.go | ||
| theme.go | ||
| utils.go | ||
README.md
termui
termui is a cross-platform and fully-customizable terminal dashboard and widget library built on top of termbox-go. It is inspired by blessed-contrib and tui-rs and written purely in Go.
Features
- Built in widget implementations for common use cases
- Utilities to create custom widgets
- A grid layout for relative widget positioning
- Mouse support
- Event handling for keyboard, mouse and resizing events
- Colors and styling
Installation
Installing from the master branch is recommended since termui has been completely reworked since the latest release and because the latest release doesn't support Go modules.
Do note that termui is still undergoing breaking changes so make sure to check the changelog when upgrading.
go get -u github.com/gizak/termui@master
Hello World
package main
import (
"log"
ui "github.com/gizak/termui"
"github.com/gizak/termui/widgets"
)
func main() {
if err := ui.Init(); err != nil {
log.Fatalf("failed to initialize termui: %v", err)
}
defer ui.Close()
p := widgets.NewParagraph()
p.Text = "Hello World!"
p.SetRect(0, 0, 25, 5)
ui.Render(p)
for e := range ui.PollEvents() {
if e.Type == ui.KeyboardEvent {
break
}
}
}
Widgets
- BarChart
- Canvas (for drawing braille dots)
- Gauge
- Image
- List
- Paragraph
- PieChart
- Plot (for scatterplots and linecharts)
- Sparkline
- StackedBarChart
- Table
- Tabs
Run an example with go run _examples/{example}.go or run all of them consecutively with make run-examples.