# Create a `wa-button` component

Generated wrapper for the Web Awesome `wa-button` component. When used
as a Shiny input, the component exposes action semantics through
`input$<input_id>`. The Shiny input invalidates on each committed action
rather than publishing a durable value payload. Each committed action
publishes a numeric action value. Generated from Web Awesome metadata.

## Usage

``` r
wa_button(
  input_id,
  ...,
  class = NULL,
  style = NULL,
  value = NULL,
  disabled = NULL,
  name = NULL,
  appearance = NULL,
  custom_error = NULL,
  dir = NULL,
  download = NULL,
  formaction = NULL,
  formenctype = NULL,
  formmethod = NULL,
  formnovalidate = NULL,
  formtarget = NULL,
  href = NULL,
  lang = NULL,
  loading = NULL,
  pill = NULL,
  rel = NULL,
  size = NULL,
  target = NULL,
  title = NULL,
  type = NULL,
  variant = NULL,
  with_caret = NULL,
  with_end = NULL,
  with_start = NULL,
  end = NULL,
  start = NULL
)
```

## Arguments

- input_id:

  Shiny input id for the component. This is also used as the rendered
  DOM `id` attribute.

- ...:

  Child content for the component's default slot.

- class:

  Optional CSS class string.

- style:

  Optional inline CSS style string.

- value:

  String. The value of the button, submitted as a pair with the button's
  name as part of the form data, but only when this button is the
  submitter. This attribute is ignored when `href` is present.

- disabled:

  Boolean. Default: `FALSE`. Disables the button.

- name:

  String. Default: `null`. The name of the button, submitted as a
  name/value pair with form data, but only when this button is the
  submitter. This attribute is ignored when `href` is present.

- appearance:

  Enumerated string. Allowed values: `accent`, `filled`,
  `filled-outlined`, `outlined`, `plain`. Default: `accent`. The
  button's visual appearance.

- custom_error:

  String. Default: `null`. Optional Web Awesome attribute.

- dir:

  String. Optional Web Awesome attribute.

- download:

  String. Tells the browser to download the linked file as this
  filename. Only used when `href` is present.

- formaction:

  String. Used to override the form owner's `action` attribute. This
  wrapper argument sets the HTML `formaction` attribute, which maps to
  the component's `formAction` field/property.

- formenctype:

  Enumerated string. Allowed values:
  `application/x-www-form-urlencoded`, `multipart/form-data`,
  `text/plain`. Used to override the form owner's `enctype` attribute.
  This wrapper argument sets the HTML `formenctype` attribute, which
  maps to the component's `formEnctype` field/property.

- formmethod:

  Enumerated string. Allowed values: `get`, `post`. Used to override the
  form owner's `method` attribute. This wrapper argument sets the HTML
  `formmethod` attribute, which maps to the component's `formMethod`
  field/property.

- formnovalidate:

  Boolean. Default: `FALSE`. Used to override the form owner's
  `novalidate` attribute. This wrapper argument sets the HTML
  `formnovalidate` attribute, which maps to the component's
  `formNoValidate` field/property.

- formtarget:

  Used to override the form owner's `target` attribute. This wrapper
  argument sets the HTML `formtarget` attribute, which maps to the
  component's `formTarget` field/property.

- href:

  String. When set, the underlying button will be rendered as an `<a>`
  with this `href` instead of a `<button>`.

- lang:

  String. Optional Web Awesome attribute.

- loading:

  Boolean. Default: `FALSE`. Draws the button in a loading state.

- pill:

  Boolean. Default: `FALSE`. Draws a pill-style button with rounded
  edges.

- rel:

  String. When using `href`, this attribute will map to the underlying
  link's `rel` attribute.

- size:

  Enumerated string. Allowed values: `large`, `medium`, `small`.
  Default: `medium`. The button's size.

- target:

  Enumerated string. Allowed values: `_blank`, `_parent`, `_self`,
  `_top`. Tells the browser where to open the link. Only used when
  `href` is present.

- title:

  String. Default: `""`. Optional Web Awesome attribute.

- type:

  Enumerated string. Allowed values: `button`, `reset`, `submit`.
  Default: `button`. The type of button. Note that the default value is
  `button` instead of `submit`, which is opposite of how native
  `<button>` elements behave. When the type is `submit`, the button will
  submit the surrounding form.

- variant:

  Enumerated string. Allowed values: `brand`, `danger`, `neutral`,
  `success`, `warning`. Default: `neutral`. The button's theme variant.
  Defaults to `neutral` if not within another element with a variant.

- with_caret:

  Boolean. Default: `FALSE`. Draws the button with a caret. Used to
  indicate that the button triggers a dropdown menu or similar behavior.

- with_end:

  Boolean. Default: `FALSE`. Only required for SSR. Set to `TRUE` if
  you're slotting in an `end` element so the server-rendered markup
  includes the end slot before the component hydrates on the client.

- with_start:

  Boolean. Default: `FALSE`. Only required for SSR. Set to `TRUE` if
  you're slotting in a `start` element so the server-rendered markup
  includes the start slot before the component hydrates on the client.

- end:

  An element, such as `<wa-icon>`, placed after the label.

- start:

  An element, such as `<wa-icon>`, placed before the label.

## Value

An HTML tag for the component.

## Shiny Bindings

`input$<input_id>` uses action semantics and invalidates on each
committed action rather than publishing a durable value payload. The
Shiny action value is returned as a numeric action value.