Bubbles =======
[![Latest Release](https://img.shields.io/github/release/charmbracelet/bubbles.svg)](https://github.com/charmbracelet/bubbles/releases) [![GoDoc](https://godoc.org/github.com/golang/gddo?status.svg)](https://pkg.go.dev/github.com/charmbracelet/bubbles) [![Build Status](https://github.com/charmbracelet/bubbles/workflows/build/badge.svg)](https://github.com/charmbracelet/bubbles/actions) [![Go ReportCard](https://goreportcard.com/badge/charmbracelet/bubbles)](https://goreportcard.com/report/charmbracelet/bubbles) Some components for [Bubble Tea](https://github.com/charmbracelet/bubbletea) applications. These components are used in production in [Glow][glow] and [Charm][charm]. [glow]: https://github.com/charmbracelet/glow [charm]: https://github.com/charmbracelet/charm ## Spinner A spinner, useful for indicating that some kind an operation is happening. There are a couple default ones, but you can also pass your own ”frames.” * [Example code](https://github.com/charmbracelet/tea/tree/master/examples/spinner/main.go) ## Text Input A text input field, akin to an `` in HTML. Supports unicode, pasting, in-place scrolling when the value exceeds the width of the element and the common, and many customization options. * [Example code, one field](https://github.com/charmbracelet/tea/tree/master/examples/textinput/main.go) * [Example code, many fields](https://github.com/charmbracelet/tea/tree/master/examples/textinputs/main.go) ## Progress A simple, customizable progress meter. Supports solid and gradient fills. The empty and filled runes can be set to whatever you'd like. The percentage readout is customizable and can also be omitted entirely. * [Example code](https://github.com/charmbracelet/bubbletea/blob/master/examples/progress/main.go) ## Paginator A component for handling pagination logic and optionally drawing pagination UI. Supports "dot-style" pagination (similar to what you might see on iOS) and numeric page numbering, but you could also just use this component for the logic and visualize pagination however you like. This component is used in [Glow][glow] to browse documents and [Charm][charm] to browse SSH keys. ## Viewport A viewport for vertically scrolling content. Optionally includes standard pager keybindings and mouse wheel support. A high performance mode is available for applications which make use of the alternate screen buffer. * [Example code](https://github.com/charmbracelet/tea/tree/master/examples/pager/main.go) This component is well complimented with [Reflow][reflow] for ANSI-aware indenting and text wrapping. [reflow]: https://github.com/muesli/reflow ## Additional Bubbles * [promptkit](https://github.com/erikgeiser/promptkit): A collection of common prompts for cases like selection, text input, and confirmation. Each prompt comes with sensible defaults, remappable keybindings, any many customization options. If you’ve built a Bubble you think should be listed here, [let us know](mailto:vt100@charm.sh). ## License [MIT](https://github.com/charmbracelet/teaparty/raw/master/LICENSE) *** Part of [Charm](https://charm.sh). Charm热爱开源 • Charm loves open source