Struct StreamPanel 

pub struct StreamPanel<'a> { /* private fields */ }

A streaming log or code output panel with auto-scroll and optional line numbers.

Feed it lines via .lines() and control the scroll with .scroll_offset(). When follow_tail is true (default), new lines auto-scroll to the bottom.

Implementations

impl<'a> StreamPanel<'a>

pub fn new() -> Self

Creates an empty stream panel.

pub fn lines<I, S>(self, lines: I) -> Self

where I: IntoIterator<Item = S>, S: Into<Cow<'a, str>>,

Replaces all lines.

pub fn push_line(self, line: impl Into<Cow<'a, str>>) -> Self

Appends a single line.

pub fn scroll_offset(self, offset: u16) -> Self

Sets the scroll offset from the bottom (0 = last line at bottom).

pub fn follow_tail(self, follow: bool) -> Self

When true, the view follows the last line (default: true).

pub fn show_line_numbers(self, show: bool) -> Self

Shows line numbers in the gutter (default: false).

pub fn tick(self, tick: u64) -> Self

Sets the animation tick.

pub fn palette(self, palette: AislingPalette) -> Self

Sets the color palette.

pub fn block(self, block: Block<'a>) -> Self

Adds a block around the panel.

pub fn render_with_interaction( &self, frame: &mut Frame<'_>, id: impl Into<WidgetId>, area: Rect, )

Renders into a Scrin frame and registers hit regions for visible rows.

pub fn hit_regions(&self, id: impl Into<WidgetId>, area: Rect) -> Vec<HitRegion>

Builds Scrin interaction metadata for the visible stream rows.

pub fn selectable_spans( &self, id: impl Into<WidgetId>, area: Rect, ) -> Vec<SelectableSpan>

Builds selectable spans for the visible stream text.

pub fn scroll_region( &self, id: impl Into<WidgetId>, area: Rect, ) -> Option<(Rect, usize, Vec<ScrollRowHit>)>

Builds Scrin scroll-region metadata for visible stream rows.

pub fn line_count(&self) -> usize

Returns the number of lines currently held.

Trait Implementations

impl<'a> Clone for StreamPanel<'a>

fn clone(&self) -> StreamPanel<'a>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Debug for StreamPanel<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for StreamPanel<'_>

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for StreamPanel<'_>

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Widget for StreamPanel<'_>

fn render(&self, buf: &mut Buffer, area: Rect)