bubbles/viewport/viewport.go

package viewport

import (
	"fmt"
	"strings"

	tea "github.com/charmbracelet/bubbletea"
	te "github.com/muesli/termenv"
)

// MODEL

type Model struct {
	Err    error
	Width  int
	Height 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.
	YPosition int

	// 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 width,
	// usually via the alternate screen buffer.
	HighPerformanceRendering bool

	lines []string
}

func NewModel(width, height int) Model {
	return Model{
		Width:  width,
		Height: height,
	}
}

func (m Model) SetSize(yPos int, width, height int) {
	m.YPosition = yPos
	m.Width = width
	m.Height = height
}

// AtTop returns whether or not the viewport is in the very top position.
func (m Model) AtTop() bool {
	return m.YOffset <= 0
}

// AtBottom returns whether or not the viewport is at the very botom position.
func (m Model) AtBottom() bool {
	return m.YOffset >= len(m.lines)-m.Height-1
}

// Scrollpercent returns the amount scrolled as a float between 0 and 1.
func (m Model) ScrollPercent() float64 {
	if m.Height >= len(m.lines) {
		return 1.0
	}
	y := float64(m.YOffset)
	h := float64(m.Height)
	t := float64(len(m.lines))
	return y / (t - h)
}

// SetContent set the pager's text content. For high performance rendering the
// Sync command should also be called.
func (m *Model) SetContent(s string) {
	s = strings.Replace(s, "\r\n", "\n", -1) // normalize line endings
	m.lines = strings.Split(s, "\n")
}

// ViewDown moves the view down by the number of lines in the viewport.
// Basically, "page down".
func (m *Model) ViewDown() {
	if m.AtBottom() {
		return
	}

	m.YOffset = min(
		m.YOffset+m.Height,    // target
		len(m.lines)-m.Height, // fallback
	)
}

// ViewUp moves the view up by one height of the viewport. Basically, "page up".
func (m *Model) ViewUp() {
	if m.AtTop() {
		return
	}

	m.YOffset = max(
		m.YOffset-m.Height, // target
		0,                  // fallback
	)
}

// HalfViewDown moves the view down by half the height of the viewport.
func (m *Model) HalfViewDown() {
	if m.AtBottom() {
		return
	}

	m.YOffset = min(
		m.YOffset+m.Height/2,  // target
		len(m.lines)-m.Height, // fallback
	)
}

// HalfViewUp moves the view up by half the height of the viewport.
func (m *Model) HalfViewUp() {
	if m.AtTop() {
		return
	}

	m.YOffset = max(
		m.YOffset-m.Height/2, // target
		0,                    // fallback
	)
}

// LineDown moves the view up by the given number of lines.
func (m *Model) LineDown(n int) {
	if m.AtBottom() || n == 0 {
		return
	}

	m.YOffset = min(
		m.YOffset+n,           // target
		len(m.lines)-m.Height, // fallback
	)
}

// LineUp moves the view down by the given number of lines.
func (m *Model) LineUp(n int) {
	if m.AtTop() || n == 0 {
		return
	}

	m.YOffset = max(m.YOffset-n, 0)
}

// COMMANDS

func Sync(m Model) tea.Cmd {
	top := clamp(m.YOffset, 0, len(m.lines))
	bottom := clamp(m.YOffset+m.Height, 0, len(m.lines))
	return tea.SyncScrollArea(
		m.lines[top:bottom],
		m.YPosition,
		m.YPosition+m.Height,
	)
}

func ViewDown(m Model) tea.Cmd {
	if m.AtBottom() {
		return nil
	}

	top := max(m.YOffset+m.Height, 0)
	bottom := min(top+m.Height, len(m.lines)-1)

	return tea.ScrollDown(
		m.lines[top:bottom],
		m.YPosition,
		m.YPosition+m.Height,
	)
}

func ViewUp(m Model) tea.Cmd {
	if m.AtTop() {
		return nil
	}

	top := max(m.YOffset-m.Height, 0)
	bottom := min(m.YOffset, len(m.lines))

	return tea.ScrollUp(
		m.lines[top:bottom],
		m.YPosition,
		m.YPosition+m.Height,
	)
}

func HalfViewDown(m Model) tea.Cmd {
	if m.AtBottom() {
		return nil
	}

	top := max(m.YOffset+m.Height/2, 0)
	bottom := min(top+m.Height, len(m.lines)-1)

	return tea.ScrollDown(
		m.lines[top:bottom],
		m.YPosition,
		m.YPosition+m.Height,
	)
}

func HalfViewUp(m Model) tea.Cmd {
	if m.AtTop() {
		return nil
	}

	top := max(m.YOffset-m.Height/2, 0)
	bottom := clamp(m.YOffset, top, len(m.lines))

	return tea.ScrollUp(
		m.lines[top:bottom],
		m.YPosition,
		m.YPosition+m.Height,
	)
}

func LineDown(m Model, n int) tea.Cmd {
	if m.AtBottom() || n == 0 {
		return nil
	}

	bottom := min(m.YOffset+m.Height+n, len(m.lines))
	top := max(bottom-n, 0)

	return tea.ScrollDown(
		m.lines[top:bottom],
		m.YPosition,
		m.YPosition+m.Height,
	)
}

func LineUp(m Model, n int) tea.Cmd {
	if m.AtTop() || n == 0 {
		return nil
	}

	top := max(m.YOffset-n, 0)
	bottom := min(top+n, len(m.lines))

	return tea.ScrollUp(
		m.lines[top:bottom],
		m.YPosition,
		m.YPosition+m.Height,
	)
}

// UPDATE

// Update runs the update loop with default keybindings. To define your own
// keybindings use the methods on Model and define your own update function.
func Update(msg tea.Msg, m Model) (Model, tea.Cmd) {
	var cmd tea.Cmd

	switch msg := msg.(type) {

	case tea.KeyMsg:
		switch msg.String() {
		// Down one page
		case "pgdown":
			fallthrough
		case " ": // spacebar
			fallthrough
		case "f":
			if m.HighPerformanceRendering {
				cmd = ViewDown(m)
			}
			m.ViewDown()

		// Up one page
		case "pgup":
			fallthrough
		case "b":
			if m.HighPerformanceRendering {
				cmd = ViewUp(m)
			}
			m.ViewUp()

		// Down half page
		case "d":
			if m.HighPerformanceRendering {
				cmd = HalfViewDown(m)
			}
			m.HalfViewDown()

		// Up half page
		case "u":
			if m.HighPerformanceRendering {
				cmd = HalfViewUp(m)
			}
			m.HalfViewUp()

		// Down one line
		case "down":
			fallthrough
		case "j":
			if m.HighPerformanceRendering {
				cmd = LineDown(m, 1)
			}
			m.LineDown(1)

		// Up one line
		case "up":
			fallthrough
		case "k":
			if m.HighPerformanceRendering {
				cmd = LineUp(m, 1)
			}
			m.LineUp(1)
		}
	}

	return m, cmd
}

// VIEW

// View renders the viewport into a string.
func View(m Model) string {

	if m.HighPerformanceRendering {
		// Skip over the area that would normally be rendered
		return fmt.Sprintf(te.CSI+te.CursorDownSeq, m.Height)
	}

	if m.Err != nil {
		return m.Err.Error()
	}

	var lines []string

	if len(m.lines) > 0 {
		top := max(0, m.YOffset)
		bottom := min(len(m.lines), m.YOffset+m.Height)
		lines = m.lines[top:bottom]
	}

	// Fill empty space with newlines
	extraLines := ""
	if len(lines) < m.Height {
		extraLines = strings.Repeat("\n", m.Height-len(lines))
	}

	return strings.Join(lines, "\n") + extraLines
}

// ETC

func min(a, b int) int {
	if a < b {
		return a
	}
	return b
}

func max(a, b int) int {
	if a > b {
		return a
	}
	return b
}

func clamp(val, low, high int) int {
	return max(low, min(high, val))
}