The highest tagged major version is v2.

cursor

package

v0.21.0 Latest Latest Go to latest Published: Mar 31, 2025 License: MIT Imports: 4 Imported by: 183

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/charmbracelet/bubbles

Links

Documentation ¶

Overview ¶

Package cursor provides cursor functionality for Bubble Tea applications.

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func Blink ¶

func Blink() tea.Msg

Blink is a command used to initialize cursor blinking.

Types ¶

type BlinkMsg ¶

type BlinkMsg struct {
	// contains filtered or unexported fields
}

BlinkMsg signals that the cursor should blink. It contains metadata that allows us to tell if the blink message is the one we're expecting.

type Mode ¶

type Mode int

Mode describes the behavior of the cursor.

const (
	CursorBlink Mode = iota
	CursorStatic
	CursorHide
)

Available cursor modes.

func (Mode) String ¶

func (c Mode) String() string

String returns the cursor mode in a human-readable format. This method is provisional and for informational purposes only.

type Model ¶

type Model struct {
	BlinkSpeed time.Duration
	// Style for styling the cursor block.
	Style lipgloss.Style
	// TextStyle is the style used for the cursor when it is hidden (when blinking).
	// I.e. displaying normal text.
	TextStyle lipgloss.Style

	// Cursor Blink state.
	Blink bool
	// contains filtered or unexported fields
}

Model is the Bubble Tea model for this cursor element.

func New ¶

func New() Model

New creates a new model with default settings.

func (*Model) BlinkCmd ¶

func (m *Model) BlinkCmd() tea.Cmd

BlinkCmd is a command used to manage cursor blinking.

func (*Model) Blur ¶

func (m *Model) Blur()

Blur blurs the cursor.

func (*Model) Focus ¶

func (m *Model) Focus() tea.Cmd

Focus focuses the cursor to allow it to blink if desired.

func (Model) Mode ¶ added in v0.15.0

func (m Model) Mode() Mode

Mode returns the model's cursor mode. For available cursor modes, see type Mode.

func (*Model) SetChar ¶

func (m *Model) SetChar(char string)

SetChar sets the character under the cursor.

func (*Model) SetMode ¶ added in v0.15.0

func (m *Model) SetMode(mode Mode) tea.Cmd

SetMode sets the model's cursor mode. This method returns a command.

For available cursor modes, see type CursorMode.

func (Model) Update ¶

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

Update updates the cursor.

func (Model) View ¶

func (m Model) View() string

View displays the cursor.

Source Files ¶

View all Source files

cursor.go

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL