`<dj-button>`

The foundational button.

npm install @dojo-ng/button

import "@dojo-ng/button";

Properties

Property	Attribute	Type	Default
`disabled`Whether the button is disabled.	`disabled` reflected	`boolean`	`false`
`kind`Visual kind: contained, outlined, or text.	`kind` reflected	`"contained""outlined""text"`	`"contained"`
`type`Native button behavior. `menu` renders as a plain button.	`type`	`"button""submit""reset""menu"`	`"button"`
`name`Form field name.	`name`	`string`	None
`value`Form field value.	`value`	`string`	None
`label`Optional label set via attribute; the default slot takes precedence.	`label`	`string`	None
`iconPosition`Where the icon sits relative to the label.	`icon-position` reflected	`"before""after"`	`"before"`
`title`Native title (tooltip) text.	`title`	`string`	`""`
`ariaLabel`Accessible name, forwarded to the native button inside the shadow root. A custom-element host is not the button in the accessibility tree, so an `aria-label` left on `<dj-button>` names nothing. IDREF attributes (`aria-labelledby`, `aria-describedby`, `aria-controls`) are deliberately NOT forwarded: an IDREF inside a shadow root cannot resolve to a light-DOM id, so forwarding one would create a dangling reference that reads as working.	`aria-label` reflected	`string \| null`	`null`
`ariaPressed`Toggle state for a button used as a toggle, forwarded alongside the name.	`aria-pressed` reflected	`string \| null`	`null`
`ariaExpanded`Disclosure state for a button that controls a panel, forwarded alongside the name.	`aria-expanded` reflected	`string \| null`	`null`

Slot	Description
Default slot	the button label
`icon`	an icon, placed per `icon-position`

Style these with dj-button::part(name).

Method	Description
`focus(options: FocusOptions)`	Move focus to the underlying native button.
`blur()`	Remove focus from the underlying native button.