status_bar (cellium v0.1.0)

View Source

Status bar widget module for displaying application status.

This module provides a status bar widget typically used at the bottom of the screen to display status information, help text, or current mode indicators.

Usage

Basic status bar:

status_bar:new(main_status, "Ready")

Dynamic status bar with formatted text:

StatusText = io_lib:format("Line: ~p | Col: ~p", [Line, Col]),
{status_bar, [{id, status}], lists:flatten(StatusText)}

Properties

  • text (string): The status text to display. Default: empty string
  • width (integer): Width of the status bar. Set by layout system
  • focusable (boolean): Set to false by default (status bars are not focusable)

Display

The status bar renders with inverted colors (background becomes foreground and vice versa) and fills the entire width with the background color. Text is displayed with one space padding on the left.

Format: Status text goes here

Common Use Cases

  • Application status messages
  • Keyboard shortcut hints
  • Current mode or context information
  • File information or cursor position

Summary

Functions

new(Id)

Creates a new status bar with empty text.

new(Id, Text)

Creates a new status bar with the specified text.

render(Widget, Buffer)

Renders the status bar with inverted colors.

Functions

new(Id)

-spec new(term()) -> map().

Creates a new status bar with empty text.

new(Id, Text)

-spec new(term(), string()) -> map().

Creates a new status bar with the specified text.

render(Widget, Buffer)

-spec render(map(), map()) -> map().

Renders the status bar with inverted colors.

The entire width is filled with the background color, and text is rendered with one space of left padding.