Diktat: Einrichtung und JavaScript-API

Opt-in

Die Funktion ist absichtlich optional – selbst in unterstützten Browsern bleibt die Schaltfläche in der Symbolleiste verborgen, solange Sie das Plugin nicht aktivieren. Die Mikrofonberechtigung ist sensibel; ein Mikrofonsymbol soll nicht standardmäßig erscheinen.

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

Im ASP.NET Core Tag Helper:

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

JavaScript API

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

Browserunterstützung

• Chrome, Edge, Opera – unterstützt (verwendet den Cloud-Sprachdienst von Google)
• Safari 14.1+ (macOS), iOS 14.5+ – unterstützt (auf dem Gerät oder in der Cloud, je nach Betriebssystem)
• Firefox – kein SpeechRecognition; das Plugin erkennt das und blendet die Schaltfläche aus.

Beim ersten Klick wird nach der Mikrofonberechtigung gefragt. Benutzer können sie jederzeit über die Website-Einstellungen des Browsers widerrufen. Der Handler onerror zeigt bei not-allowed eine verständliche Meldung an.

Optionen