graphix-stdlib 0.3.1

A dataflow language for UIs and network programming, standard library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

# The Paragraph Widget

The `paragraph` widget displays multi-line text with automatic word wrapping and scrolling support. It's ideal for displaying long text content, logs, or any content that needs to flow across multiple lines.

## Interface

```graphix
val paragraph: fn(
  ?#style: &Style,
  ?#alignment: &[Alignment, null],
  ?#scroll: &{x: i64, y: i64},
  ?#trim: &bool,
  &[Array<Line>, string]
) -> Tui;
```

## Parameters

- **scroll** - Record with `x` and `y` fields for scroll position
- **alignment** - `Left`, `Center`, or `Right`
- **wrap** - Enable/disable word wrapping (default: true)

## Examples

### Basic Usage

```graphix
{{#include ../../examples/tui/paragraph_basic.gx}}
```

![Basic Paragraph](./media/paragraph_basic.png)

### Scrollable Content

```graphix
{{#include ../../examples/tui/paragraph_scrollable.gx}}
```

![Scrollable Paragraph](./media/paragraph_scrollable.gif)

### Live Log Viewer

Display real-time updating content:

```graphix
{{#include ../../examples/tui/paragraph_log_viewer.gx}}
```

![Log Viewer](./media/paragraph_log_viewer.gif)

### Centered Message

```graphix
{{#include ../../examples/tui/paragraph_centered.gx}}
```

![Paragraph Centered](./media/paragraph_centered.png)

## Word Wrapping

The paragraph widget automatically wraps long lines to fit the available width. Word boundaries are respected, so words won't be split in the middle unless they're longer than the available width.

## See Also

- [text](text.md) - For creating styled text content
- [scrollbar](scroll.md) - For adding scrollbars
- [block](block.md) - For containing paragraphs with borders
- [list](list.md) - For line-by-line selectable content