diff --git a/docs/input/widgets/columns.md b/docs/input/widgets/columns.md new file mode 100644 index 0000000..26ebba6 --- /dev/null +++ b/docs/input/widgets/columns.md @@ -0,0 +1,54 @@ +Title: Columns +Description: "Use **Columns** to render widgets in vertical columns to the console." +Highlights: + - Custom colors + - Labels + - Use your own data with a converter. +Reference: T:Spectre.Console.Columns + +--- + +Use `Columns` to render widgets in vertical columns to the console. + + + +## Usage + +### Basic usage + +```csharp +// Render two items on separate columns to Console +AnsiConsole.Write(new Columns( + new Text("Item 1"), + new Text("Item 2") + )); +``` + +### Add items from an IEnumerable + +```csharp +// Create a list of Items +var columns = new List(){ + new Text("Item 1"), + new Text("Item 2"), + new Text("Item 3") + }; + +// Render each item in list on separate line +AnsiConsole.Write(new Columns(columns)); +``` + +### Apply custom styles to each column + +```csharp +// Create a list of Items, apply separate styles to each +var columns = new List(){ + new Text("Item 1", new Style(Color.Red, Color.Black)), + new Text("Item 2", new Style(Color.Green, Color.Black)), + new Text("Item 3", new Style(Color.Blue, Color.Black)) +}; + +// Renders each item with own style +AnsiConsole.Write(new Columns(columns)); +``` +