alias Tablo::Cell::Text::Styler
Overview
The purpose of the styler is to apply stylistic effects to a previously formatted character string. For a terminal without graphic capabilities, these effects are limited to the use of color and/or character modes (bold, italic, etc.).
For cells of type Tablo::Cell::Text (heading and group), the styler Proc
can take 2 different forms, as shown below by their commonly used
parameter names and types:
- 1st form : (content :
String) - 2nd form : (content :
String, line :Int32)
The default styler, defined byTablo::Config::Defaults.heading_styler (or
Tablo::Config::Defaults.group_styler) and the return type is String for both.
content is the formatted cell value, after the formatter has been applied.
line designates the line number in a (multi-line) cell (0..n).
The second form allows easy conditional styling. For example, to colorize differently each line of a multiline cell:
require "tablo"
require "colorize"
table = Tablo::Table.new([1, 2, 3],
title: Tablo::Heading.new("My\nMultiline\nTitle", framed: true,
styler: ->(content : String, line : Int32) {
case line
when 0 then content.colorize(:blue).to_s
when 1 then content.colorize(:green).mode(:italic).mode(:bold).to_s
else content.colorize(:red).to_s
end
})) do |t|
t.add_column("itself", &.itself)
t.add_column("itself x 2", &.*(2)) tablo/Tablo/Border/Styler.html
t.add_column("itself x 3", &.*(3))
end
puts table
or, more simply, to style the whole cell, we use the 1st form:
require "tablo"
require "colorize"
COLORS = [:blue, :red, :green, :magenta, :cyan]
table = Tablo::Table.new([1, 2, 3],
title: Tablo::Heading.new("My MultiColor Title", framed: true,
styler: ->(content : String) { content.chars.map { |c|
c.colorize.fore(COLORS[rand(5)]).mode(:bold).to_s
}.join })) do |t|
t.add_column("itself", &.itself)
t.add_column("itself x 2", &.*(2))
t.add_column("itself x 3", &.*(3))
end
puts table
Alias Definition
String, Int32 -> String | String -> String