spinner

Documentation

Index

• Variables
• type Model
  • func New(opts ...Option) Model
  • func (m Model) ID() int
  • func (m Model) Tick() tea.Msg
  • func (m Model) Update(msg tea.Msg) (Model, tea.Cmd)
  • func (m Model) View() string
• type Option
  • func WithSpinner(spinner Spinner) Option
  • func WithStyle(style lipgloss.Style) Option
• type Spinner
• type TickMsg

Variables

var (
	LutakkoSpinner = Spinner{
		Frames:      []string{"🌍", "🌎", "🌏"},
		FPS:         time.Second / 4,
		Description: "loading",
	}
)

Types

type Model

type Model struct {
	Spinner Spinner
	Style   lipgloss.Style
	// contains filtered or unexported fields
}

Model contains the state for the spinner. Use New to create new models rather than using Model as a struct literal.

func New

func New(opts ...Option) Model

New returns a model with default values.

func (Model) ID

func (m Model) ID() int

ID returns the spinner's unique ID.

func (Model) Tick

func (m Model) Tick() tea.Msg

Tick is the command used to advance the spinner one frame. Use this command to effectively start the spinner.

func (Model) Update

func (m Model) Update(msg tea.Msg) (Model, tea.Cmd)

Update is the Tea update function.

func (Model) View

func (m Model) View() string

View renders the model's view.

type Option

type Option func(*Model)

Option is used to set options in New. For example:

spinner := New(WithSpinner(Dot))

func WithSpinner

func WithSpinner(spinner Spinner) Option

WithSpinner is an option to set the spinner.

func WithStyle

func WithStyle(style lipgloss.Style) Option

WithStyle is an option to set the spinner style.

type Spinner

type Spinner struct {
	Frames      []string
	FPS         time.Duration
	Description string
}

Spinner is a set of frames used in animating the spinner.

type TickMsg

type TickMsg struct {
	Time time.Time

	ID int
	// contains filtered or unexported fields
}

TickMsg indicates that the timer has ticked and we should render a frame.