Render (Custom Widget) Example

Demonstrates how to build Custom Widgets using absolute coordinates.

Sometimes standard widgets aren’t enough. You need to draw custom shapes, games, or graphs. This example shows how to implement the render(area) contract to draw anything you want while respecting layout boundaries.

Features Demonstrated

• Custom Widget Contract: Implementing a class with render(area).

• Coordinate Offsets: Creating drawing logic that works regardless of where the widget is placed on screen (using area.x + offset).

• Composability: Wrapping custom widgets in standard Blocks with borders.

Hotkeys

• n: Next Widget (Diagonal -> Checkerboard -> Border)

• p: Previous Widget

• q: Quit

Usage

ruby examples/widget_render/app.rb

Learning Outcomes

Use this example if you need to… - Build a game (Snake, Tetris) inside the terminal. - Create a specialized visualization (Network topology graph). - Draw custom UI elements not provided by the library.