Skip to content

Commit c26ccb9

Browse files
kendo-botkendo-bot
committed
Sync with Kendo UI Professional
1 parent 3d21902 commit c26ccb9

File tree

8 files changed

+370
-8
lines changed

8 files changed

+370
-8
lines changed

‎docs/api/javascript/ui/grid.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10974,7 +10974,7 @@ Specifies the distance (in pixels) the toolbar scrolls when a scroll button is c
1097410974

1097510975
### toolbar.name `String`
1097610976

10977-
The name of the toolbar command. Either a built-in ("cancel", "create", "save", "excel", "pdf") or custom. The `name` is reflected in one of the CSS classes, which is applied to the button - `k-grid-name`.
10977+
The name of the toolbar command. Either a built-in ("cancel", "create", "save", "excel", "pdf") or custom. When a custom command is added the `name` is reflected in one of the CSS classes, which is applied to the button - `k-grid-name`.
1097810978
This class can be used to obtain reference to the button after Grid initialization and attach click handlers.
1097910979

1098010980
#### Example - specify the name of the command

‎docs/api/javascript/ui/speechtotextbutton.md‎

Lines changed: 291 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,291 @@
1+
---
2+
title: SpeechToTextButton
3+
page_title: Configuration, methods and events of Kendo UI SpeechToTextButton
4+
description: How to initialize a SpeechToTextButton UI component and configure its API.
5+
res_type: api
6+
---
7+
8+
# kendo.ui.SpeechToTextButton
9+
10+
Represents the Kendo UI SpeechToTextButton component. Inherits from [Button](/api/javascript/ui/button).
11+
12+
The SpeechToTextButton is an extension of the Kendo UI Button that provides a user-friendly interface for capturing audio and converting it to text. It can be configured to use the browser's built-in Web Speech API or integrated with other third-party speech recognition services.
13+
14+
As the SpeechToTextButton inherits from the Kendo UI Button, it supports the common button configuration options like `size`, `rounded`, `themeColor`, `fillMode`, and `disabled`.
15+
16+
## Configuration
17+
18+
### integrationMode `String` *(default: "webSpeech")*
19+
Specifies which speech recognition engine or integration the component should use.
20+
- `webSpeech` - Utilizes the browser's native Web Speech API.
21+
- `none` - Disables the built-in speech recognition. Use this when integrating with a custom or third-party speech recognition service.
22+
23+
#### Example
24+
<button id="speechButton"></button>
25+
<script>
26+
$("#speechButton").kendoSpeechToTextButton({
27+
integrationMode: "none"
28+
});
29+
</script>
30+
31+
### icon `String` *(default: "microphone-outline")*
32+
The name of the Kendo UI font icon to be displayed in the button when it is not active (not listening).
33+
34+
#### Example
35+
36+
<button id="speechButton"></button>
37+
<script>
38+
$("#speechButton").kendoSpeechToTextButton({
39+
icon: "headset"
40+
});
41+
</script>
42+
43+
### stopIcon `String` *(default: "stop-sm")*
44+
The name of the Kendo UI font icon to be displayed in the button when it is active (listening).
45+
46+
#### Example
47+
<button id="speechButton"></button>
48+
<script>
49+
$("#speechButton").kendoSpeechToTextButton({
50+
stopIcon: "stop-outline"
51+
});
52+
</script>
53+
54+
### lang `String` *(default: 'en-US')*
55+
Specifies a BCP 47 language tag (e.g., 'en-US', 'fr-FR') used for speech recognition.
56+
57+
#### Example
58+
<button id="speechButton"></button>
59+
<script>
60+
$("#speechButton").kendoSpeechToTextButton({
61+
lang: 'fr-FR'
62+
});
63+
</script>
64+
65+
### continuous `Boolean` *(default: false)*
66+
Controls whether continuous results are returned for each recognition, or only a single result once recognition stops.
67+
68+
#### Example
69+
<button id="speechButton"></button>
70+
<script>
71+
$("#speechButton").kendoSpeechToTextButton({
72+
continuous: true
73+
});
74+
</script>
75+
76+
### interimResults `Boolean` *(default: false)*
77+
Controls whether interim results should be returned (true) or not (false). Interim results are results that are not yet final.
78+
79+
#### Example
80+
<button id="speechButton"></button>
81+
<script>
82+
$("#speechButton").kendoSpeechToTextButton({
83+
interimResults: true
84+
});
85+
</script>
86+
87+
### maxAlternatives `Number` *(default: 1)*
88+
Represents the maximum number of alternative transcriptions to return for each result.
89+
90+
#### Example
91+
<button id="speechButton"></button>
92+
<script>
93+
$("#speechButton").kendoSpeechToTextButton({
94+
maxAlternatives: 5
95+
});
96+
</script>
97+
98+
### messages `Object`
99+
Allows customization of the messages displayed by the widget.
100+
101+
### messages.unsupported `String` *(default: "Speech recognition is not supported in this browser.")*
102+
The message shown when speech recognition is not supported by the browser.
103+
104+
#### Example
105+
<button id="speechButton"></button>
106+
<script>
107+
$("#speechButton").kendoSpeechToTextButton({
108+
messages: {
109+
unsupported: "Your browser does not support speech recognition."
110+
}
111+
});
112+
</script>
113+
114+
### messages.notInitialized `String` *(default: "Speech recognition engine not initialized.")*
115+
The message for when the speech recognition engine is not initialized.
116+
117+
#### Example
118+
<button id="speechButton"></button>
119+
<script>
120+
$("#speechButton").kendoSpeechToTextButton({
121+
messages: {
122+
notInitialized: "The speech engine is not ready yet."
123+
}
124+
});
125+
</script>
126+
127+
### messages.start `String` *(default: "Start speech recognition")*
128+
The aria-label for the button when it is not active (not listening).
129+
130+
#### Example
131+
<button id="speechButton"></button>
132+
<script>
133+
$("#speechButton").kendoSpeechToTextButton({
134+
messages: {
135+
start: "Click to start talking"
136+
}
137+
});
138+
</script>
139+
140+
### messages.stop `String` *(default: "Stop speech recognition")*
141+
The aria-label for the button when it is active (listening).
142+
143+
#### Example
144+
<button id="speechButton"></button>
145+
<script>
146+
$("#speechButton").kendoSpeechToTextButton({
147+
messages: {
148+
stop: "Click to stop listening"
149+
}
150+
});
151+
</script>
152+
153+
## Methods
154+
155+
### startRecognition
156+
Starts the speech recognition service.
157+
158+
#### Example
159+
<button id="speechButton"></button>
160+
<script>
161+
var speechButton = $("#speechButton").kendoSpeechToTextButton().data("kendoSpeechToTextButton");
162+
speechButton.startRecognition();
163+
</script>
164+
165+
### stopRecognition
166+
Stops the speech recognition service.
167+
168+
#### Example
169+
<button id="speechButton"></button>
170+
<script>
171+
var speechButton = $("#speechButton").kendoSpeechToTextButton().data("kendoSpeechToTextButton");
172+
speechButton.startRecognition();
173+
setTimeout(function() {
174+
speechButton.stopRecognition();
175+
}, 5000);
176+
</script>
177+
178+
### abortRecognition
179+
Aborts the speech recognition service immediately, discarding any current recognition results.
180+
181+
#### Example
182+
<button id="speechButton"></button>
183+
<script>
184+
var speechButton = $("#speechButton").kendoSpeechToTextButton().data("kendoSpeechToTextButton");
185+
speechButton.startRecognition();
186+
// Abort recognition before it completes
187+
speechButton.abortRecognition();
188+
</script>
189+
190+
### isListening
191+
Returns `true` if the speech recognition is active (listening), otherwise `false`.
192+
193+
#### Returns
194+
`Boolean` `true` if the widget is currently listening for speech input.
195+
196+
#### Example
197+
<button id="speechButton"></button>
198+
<script>
199+
var speechButton = $("#speechButton").kendoSpeechToTextButton().data("kendoSpeechToTextButton");
200+
speechButton.start();
201+
console.log(speechButton.isListening()); // logs true
202+
</script>
203+
204+
### destroy
205+
Prepares the SpeechToTextButton for safe removal from DOM.
206+
207+
#### Example
208+
<button id="speechButton"></button>
209+
<script>
210+
var speechButton = $("#speechButton").kendoSpeechToTextButton().data("kendoSpeechToTextButton");
211+
speechButton.destroy();
212+
</script>
213+
214+
## Events
215+
216+
### start
217+
Fires when the speech recognition service has begun listening to incoming audio.
218+
219+
#### Event Data
220+
No event data.
221+
222+
#### Example
223+
<button id="speechButton"></button>
224+
<script>
225+
$("#speechButton").kendoSpeechToTextButton({
226+
start: function() {
227+
console.log("Speech recognition started.");
228+
}
229+
});
230+
</script>
231+
232+
### end
233+
Fires when the speech recognition service has disconnected.
234+
235+
#### Event Data
236+
No event data.
237+
238+
#### Example
239+
<button id="speechButton"></button>
240+
<script>
241+
$("#speechButton").kendoSpeechToTextButton({
242+
end: function() {
243+
console.log("Speech recognition ended.");
244+
}
245+
});
246+
</script>
247+
248+
### result
249+
Fires when the speech recognition service returns a result - a word or phrase has been positively recognized.
250+
251+
#### Event Data
252+
##### e.isFinal `Boolean`
253+
A boolean indicating if the result is final.
254+
##### e.alternatives `Array`
255+
An array of alternative transcripts. Each object in the array has `transcript` and `confidence` fields.
256+
257+
#### Example
258+
<button id="speechButton"></button>
259+
<p id="result"></p>
260+
<script>
261+
$("#speechButton").kendoSpeechToTextButton({
262+
interimResults: true,
263+
result: function(e) {
264+
var transcript = e.alternatives[0].transcript;
265+
if (e.isFinal) {
266+
$("#result").text("Final: " + transcript);
267+
} else {
268+
$("#result").text("Interim: " + transcript);
269+
}
270+
}
271+
});
272+
</script>
273+
274+
### error
275+
Fires when a speech recognition error occurs.
276+
277+
#### Event Data
278+
##### e.error `String|Object`
279+
The error itself, which may be a string message or an error object depending on the browser and speech recognition engine.
280+
281+
#### Example
282+
283+
<button id="speechButton"></button>
284+
<script>
285+
$("#speechButton").kendoSpeechToTextButton({
286+
error: function(e) {
287+
console.log(e.error);
288+
}
289+
});
290+
</script>
291+

‎docs/controls/grid/grouping/group-paging.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ The grid data source will send the following additional parameters: `take`, `ski
6060
- If the currently expanded row does not have subgroups, only one request is sent with the `filter` parameter containing the group and subgroup value for which the items are requested.
6161
- If the currently expanded row has subgroups, an additional request is sent with the `includeSubGroupCount` parameter prompting that the response must include the total of items in the sub group
6262

63-
For more information about the response when using server grouping, check the [`schema.groups`](/api/javascript/data/datasource/configuration/schema#schemagroups) and the article for the data source grouping [here](/framework/datasource/basic-usage#server-grouping).
63+
For more information about the response when using server grouping, check the [`schema.groups`](/api/javascript/data/datasource/configuration/schema#schemagroups) and the article for the data source grouping [here](https://www.telerik.com/kendo-jquery-ui/documentation/framework/datasource/datasource-operations#server-grouping).
6464

6565
Alternatively, you can use the ASP.NET MVC or Core server-side extensions which perform all the data operations and group paging out of the box when used with the `aspnetmvc-ajax` and `webapi` transport type.
6666

@@ -78,3 +78,4 @@ The expanded state of groups is preserved during paging only, but not if sort or
7878

7979
* [JavaScript API Reference of the Grid](/api/javascript/ui/grid)
8080
* [Virtual Scrolling of the Grid]({% slug virtual_scrolling_kendoui_grid_widget %})
81+
* [Grid Group Paging of Remote Data (Demo)](https://demos.telerik.com/kendo-ui/grid/grouppaging)

‎docs/controls/spreadsheet/globalization/localization.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -348,6 +348,16 @@ The following list provides the messages and their namespaces under the `toolbar
348348
"duration": "Duration",
349349
"moreFormats": "More formats..."
350350
},
351+
formatTypesSamples: {
352+
number: "1,499.99",
353+
percent: "14.50%",
354+
financial: "(1,000.12)",
355+
currency: "$1,499.99",
356+
date: "4/21/2012",
357+
time: "5:49:00 PM",
358+
dateTime: "4/21/2012 5:49:00",
359+
duration: "168:05:00"
360+
},
351361
"formatDecreaseDecimal": "Decrease decimal",
352362
"formatIncreaseDecimal": "Increase decimal",
353363
"freeze": "Freeze panes",

‎src/messages/kendo.messages.bg-BG.js‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -347,7 +347,10 @@ $.extend(true, kendo.spreadsheet.messages.view,{
347347
"tabs": {
348348
"home": "Начало",
349349
"insert": "Вмъкване",
350-
"data": "Данни"
350+
"data": "Данни",
351+
"file": "Файл",
352+
"format": "Форматиране",
353+
"view": "Изглед",
351354
}
352355
});
353356
}

‎src/messages/kendo.messages.en-US.js‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1432,6 +1432,16 @@ $.extend(true, kendo.spreadsheet.messages.toolbar,{
14321432
"duration": "Duration",
14331433
"moreFormats": "More formats..."
14341434
},
1435+
formatTypesSamples: {
1436+
"number": "1,499.99",
1437+
"percent": "14.50%",
1438+
"financial": "(1,000.12)",
1439+
"currency": "$1,499.99",
1440+
"date": "4/21/2012",
1441+
"time": "5:49:00 PM",
1442+
"dateTime": "4/21/2012 5:49:00",
1443+
"duration": "168:05:00"
1444+
},
14351445
"formatDecreaseDecimal": "Decrease decimal",
14361446
"formatIncreaseDecimal": "Increase decimal",
14371447
"freeze": "Freeze panes",

‎src/messages/kendo.messages.zh-CN.js‎

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1647,10 +1647,6 @@
16471647
"noData": "无相关数据",
16481648
"clear": "清空"
16491649
});
1650-
kendo.ui.DropDownList.prototype.options =
1651-
$.extend(true, kendo.ui.DropDownList.prototype.options, {
1652-
"noDataTemplate": "无相关数据"
1653-
});
16541650
}
16551651

16561652
/* ComboBox messages */

0 commit comments

Comments
 (0)