# SpeechToTextButton

## Example

```
<kendo-speechtotextbutton>
    <icon />
    <messages />
    <stop-icon />
</kendo-speechtotextbutton>
```

## ChildTags

| Tag Name  | Details                                                                                                                                                                  |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| icon      | [SpeechToTextButtonIconSettingsTagHelper](https://www.telerik.com/aspnet-core-ui/documentation/api/kendo.mvc.taghelpers/speechtotextbuttoniconsettingstaghelper)         |
| messages  | [SpeechToTextButtonMessagesSettingsTagHelper](https://www.telerik.com/aspnet-core-ui/documentation/api/kendo.mvc.taghelpers/speechtotextbuttonmessagessettingstaghelper) |
| stop-icon | [SpeechToTextButtonStopIconSettingsTagHelper](https://www.telerik.com/aspnet-core-ui/documentation/api/kendo.mvc.taghelpers/speechtotextbuttonstopiconsettingstaghelper) |

## Attributes

| Attribute             | Type                                                                                                     | Description                                                                                                                                                                                                                                                                                          |
| --------------------- | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| name                  | String                                                                                                   | Sets the name of the component.                                                                                                                                                                                                                                                                      |
| as-module             | Boolean                                                                                                  | Specifies whether the initialization script of the component will be rendered as a JavaScript module.                                                                                                                                                                                                |
| is-in-client-template | Boolean                                                                                                  | When placing a Tag Helper within a Kendo Template, set the type to text/html and add the is-in-client-template="true" attribute.                                                                                                                                                                     |
| continuous            | Boolean                                                                                                  | Controls whether continuous results are returned for each recognition, or only a single result once recognition stops.                                                                                                                                                                               |
| fill-mode             | [ButtonFillMode](https://www.telerik.com/aspnet-core-ui/documentation/api/kendo.mvc.ui/buttonfillmode)   | Sets a value controlling how the color is applied.                                                                                                                                                                                                                                                   |
| deferred              | Boolean                                                                                                  | Suppress initialization script rendering. Note that this options should be used in conjunction with DeferredScripts method.                                                                                                                                                                          |
| enable                | Boolean                                                                                                  | Indicates whether the button must be enabled or disabled. By default, it is enabled, unless a disabled="disabled" attribute is detected.                                                                                                                                                             |
| icon                  | String                                                                                                   | The name of the Kendo UI font icon to be displayed in the button when it is not active (not listening).Set this option to an icon descriptor such as { name: "gear", variant: "outline" }. The variant can be outline, solid, or duotone; it applies to SVG rendering and is ignored for font icons. |
| integration-mode      | [IntegrationMode](https://www.telerik.com/aspnet-core-ui/documentation/api/kendo.mvc.ui/integrationmode) | Specifies which speech recognition engine or integration the component should use.                                                                                                                                                                                                                   |
| interim-results       | Boolean                                                                                                  | Controls whether interim results should be returned (true) or not (false). Interim results are results that are not yet final.                                                                                                                                                                       |
| lang                  | String                                                                                                   | Specifies a BCP 47 language tag (e.g., 'en-US', 'fr-FR') used for speech recognition.                                                                                                                                                                                                                |
| max-alternatives      | Double                                                                                                   | Represents the maximum number of alternative transcriptions to return for each result.                                                                                                                                                                                                               |
| on-click              | String                                                                                                   | The name of the JavaScript function that will handle the click event. Fires when the Button is clicked with the mouse, touched on a touch device, or ENTER (or SPACE) is pressed while the Button is focused.                                                                                        |
| on-end                | String                                                                                                   | The name of the JavaScript function that will handle the end event. Fires when the speech recognition service has disconnected.                                                                                                                                                                      |
| on-error              | String                                                                                                   | The name of the JavaScript function that will handle the error event. Fires when a speech recognition error occurs.                                                                                                                                                                                  |
| on-kendo-keydown      | String                                                                                                   | The name of the JavaScript function that will handle the kendoKeydown event. Triggered when the user presses a keyboard key while the Button is focused.The event handler function context (available via the this keyword) will be set to the widget instance.                                      |
| on-result             | String                                                                                                   | The name of the JavaScript function that will handle the result event. Fires when the speech recognition service returns a result - a word or phrase has been positively recognized.                                                                                                                 |
| on-start              | String                                                                                                   | The name of the JavaScript function that will handle the start event. Fires when the speech recognition service has begun listening to incoming audio.                                                                                                                                               |
| rounded               | [Rounded](https://www.telerik.com/aspnet-core-ui/documentation/api/kendo.mvc.ui/rounded)                 | Sets a value controlling the border radius.                                                                                                                                                                                                                                                          |
| script-attributes     | IDictionary\<String,Object>                                                                              | Sets the attributes that will be added to the script tag of the component's initialization script.                                                                                                                                                                                                   |
| size                  | [ComponentSize](https://www.telerik.com/aspnet-core-ui/documentation/api/kendo.mvc.ui/componentsize)     | Sets the size of the component.                                                                                                                                                                                                                                                                      |
| stop-icon             | String                                                                                                   | The name of the Kendo UI font icon to be displayed in the button when it is active (listening).Set this option to an icon descriptor such as { name: "gear", variant: "outline" }. The variant can be outline, solid, or duotone; it applies to SVG rendering and is ignored for font icons.         |
| theme-color           | [ThemeColor](https://www.telerik.com/aspnet-core-ui/documentation/api/kendo.mvc.ui/themecolor)           | Sets the color of the component according to the applied theme.                                                                                                                                                                                                                                      |
