TUI components for Bubble Tea 🫧
Go to file
2022-11-09 17:44:05 +00:00
.github chore(deps): bump actions/checkout from 2 to 3 2022-09-26 08:16:51 +02:00
cursor Revert "chore: move cursor bubble to internal" 2022-10-06 15:33:16 -04:00
help заменяет на Maks1mS/bubbles 2022-11-09 12:20:21 +00:00
key chore: use latest gofmt 2022-09-26 08:13:03 +02:00
list заменяет на Maks1mS/bubbles 2022-11-09 12:20:21 +00:00
paginator заменяет на Maks1mS/bubbles 2022-11-09 12:20:21 +00:00
progress chore: Miscellaneous minor fixes (#243) 2022-09-15 10:51:42 -04:00
spinner заменяет на Maks1mS/bubbles 2022-11-09 12:20:21 +00:00
stopwatch Expose stopwatch StartStopMsg and ResetMsg and bind them to IDs 2022-01-10 13:37:34 -05:00
table заменяет на Maks1mS/bubbles 2022-11-09 12:20:21 +00:00
textarea добавляет isChanged = true 2022-11-09 17:44:05 +00:00
textinput заменяет на Maks1mS/bubbles 2022-11-09 12:20:21 +00:00
timer fix(timer): stop should return cmd (#138) 2022-07-01 10:36:12 -04:00
viewport заменяет на Maks1mS/bubbles 2022-11-09 12:20:21 +00:00
.gitignore Initial commit. Add .gitignore 2020-01-18 10:56:08 -05:00
.golangci-soft.yml ci: add separate sets of hard- and soft-enforced linters 2022-09-26 08:13:03 +02:00
.golangci.yml ci: add separate sets of hard- and soft-enforced linters 2022-09-26 08:13:03 +02:00
bubbles.go Rename to Bubbles + copy over components from Bubble Tea + remove examples 2020-05-25 20:08:37 -04:00
go.mod обновляет go.mod 2022-11-09 12:15:39 +00:00
go.sum feat(deps): bump github.com/charmbracelet/bubbletea 2022-09-26 08:26:06 +02:00
LICENSE Add README and LICENSE 2020-01-27 21:29:52 -05:00
README.md docs: picture tag is causing display issues 2022-10-25 03:23:29 +02:00

Bubbles

The Bubbles Logo

Latest Release GoDoc Build Status Go ReportCard

Some components for Bubble Tea applications. These components are used in production in Glow, Charm and many other applications.

Spinner

Spinner Example

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.”

Text Input

Text Input Example

A text input field, akin to an <input type="text"> in HTML. Supports unicode, pasting, in-place scrolling when the value exceeds the width of the element and the common, and many customization options.

Text Area

Text Area Example

A text area field, akin to an <textarea /> in HTML. Allows for input that spans multiple lines. Supports unicode, pasting, vertical scrolling when the value exceeds the width and height of the element, and many customization options.

Table

Table Example

A component for displaying and navigating tabular data (columns and rows). Supports vertical scrolling and many customization options.

Progress

Progressbar Example

A simple, customizable progress meter, with optional animation via Harmonica. 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.

Paginator

Paginator Example

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.

Viewport

Viewport Example

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.

This component is well complemented with Reflow for ANSI-aware indenting and text wrapping.

List

List Example

A customizable, batteries-included component for browsing a set of items. Features pagination, fuzzy filtering, auto-generated help, an activity spinner, and status messages, all of which can be enabled and disabled as needed. Extrapolated from Glow.

Timer

A simple, flexible component for counting down. The update frequency and output can be customized as you like.

Timer example

Stopwatch

Stopwatch example

A simple, flexible component for counting up. The update frequency and output can be customized as you see fit.

Help

Help Example

A customizable horizontal mini help view that automatically generates itself from your keybindings. It features single and multi-line modes, which the user can optionally toggle between. It will truncate gracefully if the terminal is too wide for the content.

Key

A non-visual component for managing keybindings. Its useful for allowing users to remap keybindings as well as generating help views corresponding to your keybindings.

type KeyMap struct {
    Up key.Binding
    Down key.Binding
}

var DefaultKeyMap = KeyMap{
    Up: key.NewBinding(
        key.WithKeys("k", "up"),        // actual keybindings
        key.WithHelp("↑/k", "move up"), // corresponding help text
    ),
    Down: key.NewBinding(
        key.WithKeys("j", "down"),
        key.WithHelp("↓/j", "move down"),
    ),
}

func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    switch msg := msg.(type) {
    case tea.KeyMsg:
        switch {
        case key.Matches(msg, DefaultKeyMap.Up):
            // The user pressed up
        case key.Matches(msg, DefaultKeyMap.Down):
            // The user pressed down
        }
    }
    return m, nil
}

Additional Bubbles

  • 76creates/stickers: Responsive flexbox and table components.
  • calyptia/go-bubble-table: An interactive, customizable, scrollable table component.
  • 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.
  • evertras/bubble-table: Interactive, customizable, paginated tables.
  • knipferrc/teacup: Various handy bubbles and utilities for building Bubble Tea applications.
  • mritd/bubbles: Some general-purpose bubbles. Inputs with validation, menu selection, a modified progressbar, and so on.
  • treilik/bubbleboxer: Layout multiple bubbles side-by-side in a layout-tree.
  • treilik/bubblelister: An alternate list that is scrollable without pagination and has the ability to contain other bubbles as list items.

If youve built a Bubble you think should be listed here, let us know.

Feedback

Wed love to hear your thoughts on this project. Feel free to drop us a note!

License

MIT


Part of Charm.

The Charm logo

Charm热爱开源 • Charm loves open source