viewport

Documentation

Index

• func Sync(m Model) tea.Cmd
• func ViewDown(m Model, lines []string) tea.Cmd
• func ViewUp(m Model, lines []string) tea.Cmd
• type KeyMap
  • func DefaultKeyMap() KeyMap
• type Model
  • func New(width, height int) (m Model)
  • func (m Model) AtBottom() bool
  • func (m Model) AtTop() bool
  • func (m *Model) GotoBottom() (lines []string)
  • func (m *Model) GotoTop() (lines []string)
  • func (m *Model) HalfViewDown() (lines []string)
  • func (m *Model) HalfViewUp() (lines []string)
  • func (m Model) Init() tea.Cmd
  • func (m *Model) LineDown(n int) (lines []string)
  • func (m *Model) LineUp(n int) (lines []string)
  • func (m Model) PastBottom() bool
  • func (m Model) ScrollPercent() float64
  • func (m *Model) SetContent(s string)
  • func (m *Model) SetYOffset(n int)
  • func (m Model) TotalLineCount() int
  • func (m Model) Update(msg tea.Msg) (Model, tea.Cmd)
  • func (m Model) View() string
  • func (m *Model) ViewDown() []string
  • func (m *Model) ViewUp() []string
  • func (m Model) VisibleLineCount() int
  • func (m Model) VisibleLines() (lines []string)

Functions

func Sync

func Sync(m Model) tea.Cmd

Sync tells the renderer where the viewport will be located and requests a render of the current state of the viewport. It should be called for the first render and after a window resize.

For high performance rendering only.

func ViewDown

func ViewDown(m Model, lines []string) tea.Cmd

ViewDown is a high performance command that moves the viewport up by a given number of lines. Use Model.ViewDown to get the lines that should be rendered. For example:

lines := model.ViewDown(1)
cmd := ViewDown(m, lines)

func ViewUp

func ViewUp(m Model, lines []string) tea.Cmd

ViewUp is a high performance command the moves the viewport down by a given number of lines height. Use Model.ViewUp to get the lines that should be rendered.

Types

type KeyMap

type KeyMap struct {
	PageDown     key.Binding
	PageUp       key.Binding
	HalfPageUp   key.Binding
	HalfPageDown key.Binding
	Down         key.Binding
	Up           key.Binding
}

KeyMap defines the keybindings for the viewport. Note that you don't necessary need to use keybindings at all; the viewport can be controlled programmatically with methods like Model.LineDown(1). See the GoDocs for details.

func DefaultKeyMap

func DefaultKeyMap() KeyMap

DefaultKeyMap returns a set of pager-like default keybindings.

type Model

type Model struct {
	Width  int
	Height int
	KeyMap KeyMap

	// Whether or not to respond to the mouse. The mouse must be enabled in
	// Bubble Tea for this to work. For details, see the Bubble Tea docs.
	MouseWheelEnabled bool

	// The number of lines the mouse wheel will scroll. By default, this is 3.
	MouseWheelDelta int

	// YOffset is the vertical scroll position.
	YOffset int

	// YPosition is the position of the viewport in relation to the terminal
	// window. It's used in high performance rendering only.
	YPosition int

	// Style applies a lipgloss style to the viewport. Realistically, it's most
	// useful for setting borders, margins and padding.
	Style lipgloss.Style

	// HighPerformanceRendering bypasses the normal Bubble Tea renderer to
	// provide higher performance rendering. Most of the time the normal Bubble
	// Tea rendering methods will suffice, but if you're passing content with
	// a lot of ANSI escape codes you may see improved rendering in certain
	// terminals with this enabled.
	//
	// This should only be used in program occupying the entire terminal,
	// which is usually via the alternate screen buffer.
	HighPerformanceRendering bool
	// contains filtered or unexported fields
}

Model is the Bubble Tea model for this viewport element.

func New

func New(width, height int) (m Model)

New returns a new model with the given width and height as well as default key mappings.

func (Model) AtBottom

func (m Model) AtBottom() bool

AtBottom returns whether or not the viewport is at or past the very bottom position.

func (Model) AtTop

func (m Model) AtTop() bool

AtTop returns whether or not the viewport is at the very top position.

func (*Model) GotoBottom

func (m *Model) GotoBottom() (lines []string)

GotoBottom sets the viewport to the bottom position.

func (*Model) GotoTop

func (m *Model) GotoTop() (lines []string)

GotoTop sets the viewport to the top position.

func (*Model) HalfViewDown

func (m *Model) HalfViewDown() (lines []string)

HalfViewDown moves the view down by half the height of the viewport.

func (*Model) HalfViewUp

func (m *Model) HalfViewUp() (lines []string)

HalfViewUp moves the view up by half the height of the viewport.

func (Model) Init

func (m Model) Init() tea.Cmd

Init exists to satisfy the tea.Model interface for composability purposes.

func (*Model) LineDown

func (m *Model) LineDown(n int) (lines []string)

LineDown moves the view down by the given number of lines.

func (*Model) LineUp

func (m *Model) LineUp(n int) (lines []string)

LineUp moves the view down by the given number of lines. Returns the new lines to show.

func (Model) PastBottom

func (m Model) PastBottom() bool

PastBottom returns whether or not the viewport is scrolled beyond the last line. This can happen when adjusting the viewport height.

func (Model) ScrollPercent

func (m Model) ScrollPercent() float64

ScrollPercent returns the amount scrolled as a float between 0 and 1.

func (*Model) SetContent

func (m *Model) SetContent(s string)

SetContent set the pager's text content. For high performance rendering the Sync command should also be called.

func (*Model) SetYOffset

func (m *Model) SetYOffset(n int)

SetYOffset sets the Y offset.

func (Model) TotalLineCount

func (m Model) TotalLineCount() int

TotalLineCount returns the total number of lines (both hidden and visible) within the viewport.

func (Model) Update

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

Update handles standard message-based viewport updates.

func (Model) View

func (m Model) View() string

View renders the viewport into a string.

func (*Model) ViewDown

func (m *Model) ViewDown() []string

ViewDown moves the view down by the number of lines in the viewport. Basically, "page down".

func (*Model) ViewUp

func (m *Model) ViewUp() []string

ViewUp moves the view up by one height of the viewport. Basically, "page up".

func (Model) VisibleLineCount

func (m Model) VisibleLineCount() int

VisibleLineCount returns the number of the visible lines within the viewport.

func (Model) VisibleLines

func (m Model) VisibleLines() (lines []string)