# Back button

<component-status cx-design="complete" ux="complete"></component-status>

## Usage

### Default

```html:preview
<oui-back-button href="#">Title</oui-back-button>
```

### Aria label

```html:preview
<oui-back-button aria-label="foo">
</oui-back-button>
```

### On-click callback

```html:preview
<oui-back-button on-click="$ctrl.myFunction()">
</oui-back-button>
```

## API

| Attribute                 | Type      | Binding   | One-time binding  | Values | Default   | Description
| ----                      | ----      | ----      | ----              | ----   | ----      | ----
| `id`                      | string    | @?        | yes               | n/a    | n/a       | id attribute of the button/link
| `name`                    | string    | @?        | yes               | n/a    | n/a       | name attribute of the button/link
| `aria-label`              | string    | @?        | yes               | n/a    | n/a       | accessibility label of the button/link
| `href`                    | string    | @?        | yes               | n/a    | n/a       | url of the return link
| `state`                   | string    | @?        | yes               | n/a    | n/a       | state of the return link
| `stateParams`             | object    | <?        | no                | n/a    | n/a       | state params of the return link
| `on-click`                | function  | &?        | no                | n/a    | n/a       | callback on component click

#### Deprecated

* `heading` &#124; `title`: Replaced by transclude value