package viewport import ( "math" "strings" "github.com/charmbracelet/bubbles/v2/key" tea "github.com/charmbracelet/bubbletea/v2" "github.com/charmbracelet/lipgloss" ) // New returns a new model with the given width and height as well as default // key mappings. func New(width, height int) (m Model) { m.Width = width m.Height = height m.setInitialValues() return m } // Model is the Bubble Tea model for this viewport element. 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 initialized bool lines []string } func (m *Model) setInitialValues() { m.KeyMap = DefaultKeyMap() m.MouseWheelEnabled = true m.MouseWheelDelta = 3 m.initialized = true } // Init exists to satisfy the tea.Model interface for composability purposes. func (m Model) Init() (Model, tea.Cmd) { return m, nil } // AtTop returns whether or not the viewport is at the very top position. func (m Model) AtTop() bool { return m.YOffset <= 0 } // AtBottom returns whether or not the viewport is at or past the very bottom // position. func (m Model) AtBottom() bool { return m.YOffset >= m.maxYOffset() } // PastBottom returns whether or not the viewport is scrolled beyond the last // line. This can happen when adjusting the viewport height. func (m Model) PastBottom() bool { return m.YOffset > m.maxYOffset() } // 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)) v := y / (t - h) return math.Max(0.0, math.Min(1.0, v)) } // SetContent set the pager's text content. func (m *Model) SetContent(s string) { s = strings.ReplaceAll(s, "\r\n", "\n") // normalize line endings m.lines = strings.Split(s, "\n") if m.YOffset > len(m.lines)-1 { m.GotoBottom() } } // maxYOffset returns the maximum possible value of the y-offset based on the // viewport's content and set height. func (m Model) maxYOffset() int { return max(0, len(m.lines)-m.Height) } // visibleLines returns the lines that should currently be visible in the // viewport. func (m Model) visibleLines() (lines []string) { if len(m.lines) > 0 { top := max(0, m.YOffset) bottom := clamp(m.YOffset+m.Height, top, len(m.lines)) lines = m.lines[top:bottom] } return lines } // SetYOffset sets the Y offset. func (m *Model) SetYOffset(n int) { m.YOffset = clamp(n, 0, m.maxYOffset()) } // 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.LineDown(m.Height) } // ViewUp moves the view up by one height of the viewport. Basically, "page up". func (m *Model) ViewUp() { if m.AtTop() { return } m.LineUp(m.Height) } // HalfViewDown moves the view down by half the height of the viewport. func (m *Model) HalfViewDown() { if m.AtBottom() { return } m.LineDown(m.Height / 2) } // HalfViewUp moves the view up by half the height of the viewport. func (m *Model) HalfViewUp() { if m.AtTop() { return } m.LineUp(m.Height / 2) } // LineDown moves the view down by the given number of lines. func (m *Model) LineDown(n int) { if m.AtBottom() || n == 0 || len(m.lines) == 0 { return } // Make sure the number of lines by which we're going to scroll isn't // greater than the number of lines we actually have left before we reach // the bottom. m.SetYOffset(m.YOffset + n) } // LineUp moves the view down by the given number of lines. Returns the new // lines to show. func (m *Model) LineUp(n int) { if m.AtTop() || n == 0 || len(m.lines) == 0 { return } // Make sure the number of lines by which we're going to scroll isn't // greater than the number of lines we are from the top. m.SetYOffset(m.YOffset - n) } // TotalLineCount returns the total number of lines (both hidden and visible) within the viewport. func (m Model) TotalLineCount() int { return len(m.lines) } // VisibleLineCount returns the number of the visible lines within the viewport. func (m Model) VisibleLineCount() int { return len(m.visibleLines()) } // GotoTop sets the viewport to the top position. func (m *Model) GotoTop() (lines []string) { if m.AtTop() { return nil } m.SetYOffset(0) return m.visibleLines() } // GotoBottom sets the viewport to the bottom position. func (m *Model) GotoBottom() (lines []string) { m.SetYOffset(m.maxYOffset()) return m.visibleLines() } // Update handles standard message-based viewport updates. func (m Model) Update(msg tea.Msg) (Model, tea.Cmd) { m = m.updateAsModel(msg) return m, nil } // Author's note: this method has been broken out to make it easier to // potentially transition Update to satisfy tea.Model. func (m Model) updateAsModel(msg tea.Msg) Model { if !m.initialized { m.setInitialValues() } switch msg := msg.(type) { case tea.KeyPressMsg: switch { case key.Matches(msg, m.KeyMap.PageDown): m.ViewDown() case key.Matches(msg, m.KeyMap.PageUp): m.ViewUp() case key.Matches(msg, m.KeyMap.HalfPageDown): m.HalfViewDown() case key.Matches(msg, m.KeyMap.HalfPageUp): m.HalfViewUp() case key.Matches(msg, m.KeyMap.Down): m.LineDown(1) case key.Matches(msg, m.KeyMap.Up): m.LineUp(1) } case tea.MouseWheelMsg: if !m.MouseWheelEnabled { break } switch msg.Button { case tea.MouseWheelDown: m.LineDown(m.MouseWheelDelta) case tea.MouseWheelUp: m.LineUp(m.MouseWheelDelta) } } return m } // View renders the viewport into a string. func (m Model) View() string { w, h := m.Width, m.Height if sw := m.Style.GetWidth(); sw != 0 { w = min(w, sw) } if sh := m.Style.GetHeight(); sh != 0 { h = min(h, sh) } contentWidth := w - m.Style.GetHorizontalFrameSize() contentHeight := h - m.Style.GetVerticalFrameSize() contents := lipgloss.NewStyle(). Width(contentWidth). // pad to width. Height(contentHeight). // pad to height. MaxHeight(contentHeight). // truncate height if taller. MaxWidth(contentWidth). // truncate width if wider. Render(strings.Join(m.visibleLines(), "\n")) return m.Style. UnsetWidth().UnsetHeight(). // Style size already applied in contents. Render(contents) } func clamp(v, low, high int) int { if high < low { low, high = high, low } return min(high, max(low, v)) } 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 }