Plugin

Configuration de la dictée et API JavaScript

Reconnaissance vocale via la Web Speech API. Un bouton micro dans la barre d’outils active ou désactive l’écoute ; les transcriptions provisoires s’affichent en direct sous le curseur. Aucun service externe — l’audio est traité par le fournisseur de reconnaissance vocale qu’utilise le navigateur.

Ouvrir la démo en direct

Activation explicite

La fonctionnalité doit être activée explicitement, et c’est voulu — même sur les navigateurs compatibles, le bouton de la barre d’outils reste masqué tant que vous n’activez pas le plugin. L’autorisation du micro est sensible ; nous ne voulons pas qu’une icône de micro apparaisse par défaut.

var cfg = {
    dictationEnabled: true,
    dictationLang: "en-US",              // BCP-47
    dictationContinuous: true,
    dictationInterimResults: true,
    dictationAutoPunctuation: true
};
new RichTextEditor("#editor", cfg);

Dans le Tag Helper ASP.NET Core :

<richtextbox asp-for="Body" toolbar="default"
             enable-dictation="true"
             dictation-lang="en-US"
             dictation-continuous="true"
             dictation-auto-punctuation="true" />

API JavaScript

editor.dictation.start();
editor.dictation.stop();
editor.dictation.toggle();
editor.dictation.isListening();     // boolean
editor.dictation.isSupported();     // false on Firefox

Navigateurs pris en charge

Chrome, Edge, Opera — pris en charge (utilise le service de reconnaissance vocale cloud de Google)
Safari 14.1+ (macOS), iOS 14.5+ — pris en charge (sur l’appareil ou dans le cloud selon le système)
Firefox — pas de SpeechRecognition ; le plugin le détecte et masque le bouton.

Le premier clic demande l’autorisation d’utiliser le micro. Les utilisateurs peuvent la révoquer à tout moment dans les paramètres du site de leur navigateur. Le gestionnaire onerror affiche un message compréhensible en cas de not-allowed.

Options

Option	Valeur par défaut	Remarques
`dictationEnabled`	false	Active la fonctionnalité. Sans cette option, le plugin reste inactif.
`dictationLang`	`navigator.language`	Balise de langue BCP-47 : `en-US`, `es-ES`, `zh-CN`, `ja-JP`, etc.
`dictationContinuous`	true	Avec false, s’arrête après un seul énoncé.
`dictationInterimResults`	true	Affiche un aperçu estompé de ce que le navigateur est encore en train d’entendre.
`dictationAutoPunctuation`	true	Met une majuscule au début de chaque segment final et ajoute un point s’il n’y en a pas.