Utilisation du correcteur orthographique dans XUL

Une nouvelle fonction de correction orthographique est disponible dans Firefox 2. Ce document explique comment utiliser le composant mozISpellCheckingEngine pour permettre à vos extensions Firefox d'en bénéficier.

Consultez Contrôle du correcteur d'orthographe dans les formulaires HTML pour des détails sur l'activation du correcteur orthographique dans les formulaires HTML de vos sites Web.

Vérification de l'orthographe d'un mot

Pour vérifier l'orthographe d'un mot, vous devez d'abord créer une interface vers le composant mozISpellCheckingEngine en utilisant @mozilla.org/spellchecker/myspell;1 comme ID de contrat, et appeler ensuite la méthode check() avec la chaine à vérifier. Cette méthode renvoie true si le mot est correctement orthographié, ou false dans le cas contraire.

gSpellCheckEngine = Components.classes["@mozilla.org/spellchecker/myspell;1"]
                    .getService(Components.interfaces.mozISpellCheckingEngine); 
gSpellCheckEngine.dictionary = 'en-US';

if (gSpellCheckEngine.check("kat")) {
    // Le mot est correctement écrit    
}
else {
    // Le mot n'est pas correctement écrit
}

Obtention d'une liste de suggestions

Pour obtenir une liste de suggestions pour un mot incorrect, appelez la méthode suggest() en spécifiant le mot et un objet pouvant être rempli d'un tableau de suggestions possibles.

var suggestions = {};
gSpellCheckEngine.suggest("kat", suggestions); 

if (suggestions.value) {
   // suggestions.value est un tableau JavaScript (objet Array) de chaines
   // suggestions.value.length compte le nombre de suggestions trouvées
}