Border (`border`)

The border accepts only a single child.

Example

border
    text "What a border!"

┌──────────────┐
│What a border!│
└──────────────┘

Attributes

`width`

The fixed width of the border

`height`

The fixed height of the border

`min_width`

The minimum width of the border

`min_height`

The minimum height of the border

`sides`

Valid values:

"top"
"right"
"bottom"
"left"

Sides specifies which sides of the border should be drawn.

This can be written as an individual side:

border [sides: "left"]
    text "What a border!"

│What a border!

border [sides: "top"]
    text "What a border!"

──────────────
What a border!

It can also be written as a list:

border [sides: ["left", "top"]]
    text "What a border!"

┌──────────────
│What a border!

`border_style`

The default border style is "thin".

For a thicker border style the value "tick" can be used:

border [border_style: "thick"]
    text  "What a border!"

╔══════════════╗
║What a border!║
╚══════════════╝

It's also possible to customise the border style by providing an eight character string as input, where each character represents a section of the border in the following order:

top left
top
top right
right
bottom right
bottom
bottom left
left

See the following example:

border [border_style: "12345678"]
    text  "What a border!"

1222222222222223
8What a border!4
7666666666666665

Anathema