# Blazor Splitter Overview

The <a href="https://www.telerik.com/blazor-ui/splitter" target="_blank">Blazor Splitter component</a> lets you divide a portion of the page into several pieces that the user can resize and collapse. This provides real estate management for the app and the end user so they can focus on the content that is important in their current task. You can also [save and load its state](https://www.telerik.com/blazor-ui/documentation/components/splitter/state), and respond to [events](https://www.telerik.com/blazor-ui/documentation/components/splitter/events).

## Creating Blazor Splitter

1. Add the `<TelerikSplitter>` tag.
2. Set the `Width` and `Height` parameters in any valid CSS unit. See [Splitter Parameters](https://www.telerik.com/blazor-ui/documentation/components/splitter/overview#splitter-parameters) for more information about the component behavior when dimensions are not set.
3. Inside the `<SplitterPanes>` child tag, add the desired `<SplitterPane>` tags to create sections of content.
4. Inside each `<SplitterPane>`, add the desired content as HTML markup or other components.
5. Configure the panes. For example, [set their `Size`, `Min`, `Max`, `Collapsible`, and `Resizable` parameters](https://www.telerik.com/blazor-ui/documentation/components/splitter/panes#pane-parameters). By default, Splitter panes are resizable, but not collapsible.

> caption Basic Splitter

<demo metaUrl="client/splitter/overview/example-2/" height="420"></demo>

> tip The following sample app shows how to create a 100%-high page layout with a Splitter that includes a header, footer, and sidebar: <a href="https://github.com/telerik/blazor-ui/tree/master/splitter/use-100-percent-viewport" target="_blank">How to make the Splitter take up 100% of the viewport</a>.

## Panes

Тhe Panes are the building blocks of the Splitter. Each pane controls its own behaviors such as the ability to change its size and collapse. [Read more about the Splitter Panes...](https://www.telerik.com/blazor-ui/documentation/components/splitter/panes)

## Orientation

The Splitter panes can stack horizontally or vertically. [Read more about how to configure the Splitter orientation...](https://www.telerik.com/blazor-ui/documentation/components/splitter/orientation)

## State

The Splitter allows you to save its state and programmatically control it. [Read more about the Splitter state...](https://www.telerik.com/blazor-ui/documentation/components/splitter/state)

## Events

The Splitter fires events that you can handle to further customize the component behavior and respond to the user actions. [Read more about the Blazor Splitter events...](https://www.telerik.com/blazor-ui/documentation/components/splitter/events)

## Splitter Parameters

The Blazor Splitter provides various parameters for its configuration. The following table lists Splitter parameters on component level. Explore the [Splitter Panes](https://www.telerik.com/blazor-ui/documentation/components/splitter/panes) article for details on the individual Panes configuration.

Check the [Splitter API Reference ](https://www.telerik.com/blazor-ui/documentation/api/telerik.blazor.components.teleriksplitter) for a full list of properties, methods and events.

<style>
    .article table {
        table-layout: auto;
        word-break: normal;
    }
</style>

| Parameter     | Type                                                                | Description                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------- | ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AriaLabel`   | `string`                                                            | The `aria-label` attribute of the splitbars elements (`<div class="k-splitbar">`).                                                                                                                                                                                                                                                                                                                    |
| `Class`       | `string`                                                            | The CSS class that renders on the Splitter element (`<div class="k-splitter">`).                                                                                                                                                                                                                                                                                                                      |
| `Height`      | `string`                                                            | The height style of the Splitter. See the [Dimensions](https://www.telerik.com/blazor-ui/documentation/common-features/dimensions) article for details on what units you can use and how percentage dimensions work. If not set, the Splitter will shrink and expand, according to the [pane sizes](https://www.telerik.com/blazor-ui/documentation/components/splitter/panes#pane-size) and content. |
| `Orientation` | `SplitterOrientation` enum <br/> (`SplitterOrientation.Horizontal`) | Whether the content will be split up (how the panes will stack) horizontally or vertically.                                                                                                                                                                                                                                                                                                           |
| `Width`       | `string`                                                            | The width style of the Splitter in any [valid CSS unit](https://www.telerik.com/blazor-ui/documentation/common-features/dimensions). If not set, the Splitter will expand horizontally to 100%.                                                                                                                                                                                                       |

## Splitter Reference and Methods

Add a reference to the component instance to use the [Splitter methods](https://www.telerik.com/blazor-ui/documentation/api/telerik.blazor.components.teleriksplitter#methods).

| Method     | Description                                                                                                          |
| ---------- | -------------------------------------------------------------------------------------------------------------------- |
| `GetState` | Gets the current [state](https://www.telerik.com/blazor-ui/documentation/components/splitter/state) of the Splitter. |
| `SetState` | Sets the current [state](https://www.telerik.com/blazor-ui/documentation/components/splitter/state) of the Splitter. |

<demo metaUrl="client/splitter/overview/example-1/" height="420"></demo>

## Next Steps

* [Explore the Splitter pane settings](https://www.telerik.com/blazor-ui/documentation/components/splitter/panes)
* [Set the Splitter orientation](https://www.telerik.com/blazor-ui/documentation/components/splitter/orientation)
* [Manage the Splitter state](https://www.telerik.com/blazor-ui/documentation/components/splitter/state)
* [Handle Splitter events](https://www.telerik.com/blazor-ui/documentation/components/splitter/events)

## See Also

* [Live Demo: Splitter](https://demos.telerik.com/blazor-ui/splitter/overview)
* [Splitter API Reference](https://www.telerik.com/blazor-ui/documentation/api/telerik.blazor.components.teleriksplitter)
* [SplitterPane API Reference](https://www.telerik.com/blazor-ui/documentation/api/telerik.blazor.components.splitterpane)
