class RatatuiRuby::Buffer::Cell

Represents a single cell in the terminal buffer.

A terminal grid is made of cells. Each cell contains a character (symbol) and styling (colors, modifiers). When testing, you often need to verify that a specific cell renders correctly.

This object encapsulates that state. It provides predicate methods for modifiers, making assertions readable.

Use it to inspect the visual state of your application in tests.

Examples

cell = RatatuiRuby.get_cell_at(0, 0)
cell.char   # => "H"
cell.fg     # => :red
cell.bold?  # => true

Attributes

bg [R]

The background color of the cell (e.g., :black, nil).

char [R]

The character displayed in the cell.

Named to match Ratatui’s Cell::symbol() method.

fg [R]

The foreground color of the cell (e.g., :red, :blue, “#ff0000”).

modifiers [R]

The list of active modifiers (e.g., [“bold”, “italic”]).

symbol [R]

The character displayed in the cell.

Named to match Ratatui’s Cell::symbol() method.

underline_color [R]

The underline color of the cell.

Distinct from foreground color. Some terminals support colored underlines.

Public Class Methods

char (char)

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 114
def self.char(char)
  symbol(char)
end

Alias for Rubyists who prefer a shorter name.

default ()

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 89
def self.default
  empty
end

Returns a default cell (alias for empty).

Example

Buffer::Cell.default # => #<RatatuiRuby::Buffer::Cell char=" ">

empty ()

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 71
def self.empty
  new(symbol: " ", fg: nil, bg: nil, underline_color: nil, modifiers: [])
end

Returns an empty cell (space character, no styles).

Example

Buffer::Cell.empty # => #<RatatuiRuby::Buffer::Cell char=" ">

new (symbol: nil, char: nil, fg: nil, bg: nil, underline_color: nil, modifiers: [])

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 126
def initialize(symbol: nil, char: nil, fg: nil, bg: nil, underline_color: nil, modifiers: [])
  @symbol = (symbol || char || " ").freeze
  @fg = fg&.freeze
  @bg = bg&.freeze
  @underline_color = underline_color&.freeze
  @modifiers = modifiers.map { |m| m.respond_to?(:to_sym) ? m.to_sym : m.to_s.to_sym }.freeze
  freeze
end

Creates a new Cell.

symbol: String (single character). Aliased as char:.
fg: Symbol or String (nullable).
bg: Symbol or String (nullable).
underline_color: Symbol or String (nullable).
modifiers: Array of Strings, Symbols, or any object responding to to_sym or to_s. Normalized to Symbols for consistent output.

symbol (symbol)

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 109
def self.symbol(symbol)
  new(symbol:, fg: nil, bg: nil, underline_color: nil, modifiers: [])
end

Returns a cell with a specific character and no styles.

symbol: String (single character).

Example

Buffer::Cell.symbol("X") # => #<RatatuiRuby::Buffer::Cell symbol="X">

Public Instance Methods

== (other)

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 181
def ==(other)
  other.is_a?(Cell) &&
    char == other.char &&
    fg == other.fg &&
    bg == other.bg &&
    underline_color == other.underline_color &&
    modifiers == other.modifiers
end

Checks equality with another Cell.

bold? ()

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 136
def bold?
  modifiers.include?(:bold)
end

Returns true if the cell has the bold modifier.

crossed_out? ()

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 176
def crossed_out?
  modifiers.include?(:crossed_out)
end

Returns true if the cell has the crossed_out modifier.

deconstruct_keys (keys)

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 207
def deconstruct_keys(keys)
  { symbol:, char: symbol, fg:, bg:, underline_color:, modifiers: }
end

Support for pattern matching. Supports both :symbol and :char keys.

dim? ()

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 141
def dim?
  modifiers.include?(:dim)
end

Returns true if the cell has the dim modifier.

hidden? ()

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 171
def hidden?
  modifiers.include?(:hidden)
end

Returns true if the cell has the hidden modifier.

inspect ()

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 191
def inspect
  parts = ["symbol=#{symbol.inspect}"]
  parts << "fg=#{fg.inspect}" if fg
  parts << "bg=#{bg.inspect}" if bg
  parts << "underline_color=#{underline_color.inspect}" if underline_color
  parts << "modifiers=#{modifiers.inspect}" unless modifiers.empty?
  "#<#{self.class} #{parts.join(' ')}>"
end

Returns a string representation of the cell.

italic? ()

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 146
def italic?
  modifiers.include?(:italic)
end

Returns true if the cell has the italic modifier.

rapid_blink? ()

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 161
def rapid_blink?
  modifiers.include?(:rapid_blink)
end

Returns true if the cell has the rapid_blink modifier.

reversed? ()

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 166
def reversed?
  modifiers.include?(:reversed)
end

Returns true if the cell has the reversed modifier.

slow_blink? ()

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 156
def slow_blink?
  modifiers.include?(:slow_blink)
end

Returns true if the cell has the slow_blink modifier.

to_s ()

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 201
def to_s
  symbol
end

Returns the cell’s character.

underlined? ()

Source

# File lib/ratatui_ruby/buffer/cell.rb, line 151
def underlined?
  modifiers.include?(:underlined)
end

Returns true if the cell has the underlined modifier.