# SplitButton

The SplitButton is a composite control that combines a primary button with a default value and a secondary button displaying a drop-down list of mutually exclusive options.

{% hint style="info" %}
For a full list of properties, methods and events see the [API documentation.](http://docs.wisej.com/api)
{% endhint %}

## Features

### Menu Items

The SplitButton features a dropdown that displays a list of selectable options.

![SplitButton control showing dropdown menu with selectable options](https://553579532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MF1D11gPs_az3xaKusw%2Fuploads%2Fgit-blob-92ad1d51c38e2b2f2f789238aa55259027b581c5%2Fimage.png?alt=media)

### Orientation

The SplitButton control can be configured to show the dropdown button horizontally or vertically.

![SplitButton control demonstrating horizontal and vertical orientations](https://553579532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MF1D11gPs_az3xaKusw%2Fuploads%2Fgit-blob-4ad9e7abd085f07ed3455fbed38e7b4e1e4ea8b1%2Fimage.png?alt=media)

### Repeat

The Repeat functionality allows a SplitButton to raise its `Click` event repeatedly from the time it is pressed until released.

![Animated demonstration of SplitButton repeat functionality](https://553579532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MF1D11gPs_az3xaKusw%2Fuploads%2Fgit-blob-47de5af7ae60244b2d63e446652e0d65c2f5d86b%2FSplitButtonRepeat.gif?alt=media)

## Advanced

### JavaScript Widget

| Item             | Description                                                                                                                           |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Class name       | "wisej.web.SplitButton"                                                                                                               |
| Theme appearance | "splitbutton", see [Themes](https://docs.wisej.com/theme-builder/theme-elements/elements).                                            |
| Child components | "button", "arrow" is the dropdown icon on the button. See [JavaScript](https://docs.wisej.com/docs/concepts/javascript-object-model). |
| Source code      | [https://github.com/iceteagroup/wisej-js](https://github.com/iceteagroup/wisej-js/blob/master/wisej.web.TextBox.js)                   |