À l'aide de l'API AJAXLanguage, vous pouvez traduire et détecter la langue d'une certaine zone d'une page Web en utilisant uniquement JavaScript.
L'API est nouvellement développée, il peut donc y avoir quelques bugs et déficiences mineures par rapport à une documentation parfaite. Nous allons corriger ces vulnérabilités, alors comprenez que vous pouvez rejoindre le forum des développeurs d'API AJAX pour nous faire part de vos commentaires et discuter de cette API.
Public visé Ce document a été préparé pour les personnes ayant une certaine familiarité avec la programmation JavaScript et les concepts de programmation orientée objet. Il existe de nombreux didacticiels JavaScript sur Internet.
Introduction au programme "Hello, World" sur l'API Google Ajax Language Le moyen le plus simple de commencer à apprendre cette API est de regarder un exemple simple qui détectera une langue donnée et la traduira en anglais.
<html>
<tête>
<script type="text/javascript" src=" http://www.google.com/jsapi"></script >
<script type="text/javascript">
google.load("langue", "1");
function initialize() {
var texte = document.getElementById("text").innerHTML;
google.langue.detect(texte, fonction(résultat) {
if (!result.error && result.langue) {
google.langue.translate(texte, résultat.langue, "en",
fonction (résultat) {
var traduit = document.getElementById("translation");
si (résultat. traduction) {
traduit.innerHTML = result.translation;
}
});
}
});
}
google.setOnLoadCallback(initialize);
</script>
</tête>
<corps>
<div id="text">Bonjour, ravi de vous rencontrer. </div>
<div id="translation"></div>
</corps>
</html>
Vous pouvez voir l'exemple ici, le modifier et l'exécuter à votre guise.
Incluez Ajax LanguageAPI dans vos pages Web
Afin d'ajouter l'API AJAXLanguage à votre page Web, vous devez utiliser le chargeur d'API Google AJAX. Cette classe de chargement publique vous permet de charger toutes les API AJAX dont vous avez besoin, y compris l'API du langage ici. Vous devez également inclure la balise de script des API Google AJAX et appeler google.load("langue","1");.
<script type="text/javascript" src=" http://www.google.com/jsapi"></script >
<script type="text/javascript">
google.load("langue", "1");
</script>
La première balise de script charge la fonction google.load, qui permet de charger une API Google spécifique. google.load("langue","1") charge la première version de l'API Language. Actuellement, l'API AJAXLanguage est en version 1, mais une nouvelle version sera bientôt disponible. Voir la discussion sur les versions ci-dessous pour plus d'informations.
Mises à jour des API
Le deuxième paramètre de la fonction google.load est en fait la version de l'API AJAXLanguage que vous utilisez. Actuellement, l'API du langage AJAX est en version 1, mais une nouvelle version sera bientôt disponible.
Si nous apportons des mises à jour importantes à l'API à l'avenir, nous modifierons le numéro de version et publierons un avis dans la discussion Google Code et AJAX APIS. Lorsque cet événement se produit, nous prévoyons de continuer à prendre en charge toutes les versions pendant au moins un mois afin de vous donner suffisamment de temps pour migrer votre code.
L'équipe API AJAXLanguage fournit des mises à jour régulières sur les récentes corrections de bugs et les optimisations de la plateforme. Ces corrections de bugs ne devraient qu'améliorer les performances et corriger les bugs, mais il est possible que nous puissions accidentellement casser certains utilisateurs de l'API, veuillez utiliser le groupe de discussion des API AJAX pour signaler ces problèmes.
Exemple de traduction de langage Ce cas montre un processus simple de traduction d'une variable de chaîne JavaScript.
google.langue.translate("Bonjour tout le monde", "fr", "es", function(result) {
si (!result.error) {
var conteneur = document.getElementById("translation");
conteneur.innerHTML = result.translation;
}
});
Afficher le cas (translate.html)
Détection de langue Ce cas montre la détection de langue pour une chaîne JavaScript. Le code de langue sera renvoyé.
var text = "¿Dónde está el baño?"$$
google.langue.detect(texte, fonction(résultat) {
si (!result.error) {
var langue = 'inconnu';
pour (l ingoogle.langue.Languages) {
if (google.langue.Languages[l] == résultat.langue) {
langue = l;
casser;
}
}
var conteneur = document.getElementById("détection");
conteneur.innerHTML = texte + " est : " + langue + ""$$
}
});
Afficher le cas (detection.html)
Détection de source pendant la traduction Le cas suivant est similaire au cas de traduction de base, mais il montre comment traduire un texte lorsque la langue source n'est pas connue. En passant une chaîne vide pour représenter une langue source inconnue, le système la détectera et la traduira automatiquement en un seul appel.
google.langue.translate("Bonjour tout le monde", "", "es", function(result) {
si (!result.error) {
var conteneur = document.getElementById("translation");
conteneur.innerHTML = result.translation;
}
});
Voir les exemples (autotranslate.html)
pour plus d'exemples. Voici deux exemples supplémentaires d'interactions. Le premier cas effectue une détection de langue sur une chaîne de texte pré-saisie, tout en permettant également la saisie d'un autre texte. Il montre également les facteurs de confiance et de fiabilité (Note du traducteur).
Afficher le cas (detect.html)
Deuxième cas supplémentaire pour la traduction. Cela permet également des interactions similaires à celles décrites ci-dessus.
Afficher le cas (translate.html)
Détails de l'API Langues prises en charge
L'API GoogleAJAXLanguage prend désormais en charge les langues suivantes. La technologie s'améliore constamment et notre équipe travaille dur pour élargir cette liste, alors revenez souvent. Vous pouvez également visiter Google Translate pour afficher la liste récemment mise à jour.
arabe
Chinois (simplifié et traditionnel)
Néerlandais
Anglais
Français
Allemand
grec
italien
japonais
coréen
portugais
russe
Espagnol
Paires de traduction de langues prises en charge
L'API GoogleAJAXLanguage prend désormais en charge les paires de traduction de langues suivantes. La technologie s'améliore constamment et notre équipe travaille dur pour élargir cette liste, alors revenez souvent. Vous pouvez également visiter Google Translate pour afficher la liste récemment mise à jour.
Arabe vers anglais
Chinois vers anglais
Chinois (simplifié à traditionnel)
Chinois (traditionnel à simplifié)
Néerlandais vers anglais (néerlandais vers anglais)
Anglais vers arabe
Anglais vers chinois (simplifié)
Anglais vers chinois (traditionnel)
Anglais vers Néerlandais
Anglais vers français
Anglais vers Allemand
Anglais vers grec
Anglais vers italien
Anglais vers japonais
Anglais vers coréen
Anglais vers Portugais
Anglais vers russe
Anglais vers espagnol
Français vers anglais (Français vers anglais)
Français vers Allemand
Allemand vers anglais
Allemand vers Français
Grec vers anglais
Italien vers anglais (italien vers anglais)
Japonais vers anglais
Coréen vers anglais (coréen vers anglais)
Portugais vers anglais (Portugais vers anglais)
Russe vers anglais (russe vers anglais)
Espagnol vers anglais
Résolution de problèmes Si vous rencontrez un problème dans votre code :
Vérifiez le code. N'oubliez pas que JavaScript est un langage sensible à la casse.
Pour utiliser le débogueur JavaScript, dans Firefox, vous pouvez utiliser la console JavaScript ou l'extension FireBug. Dans IE, vous pouvez utiliser le débogueur Microsoft Script.
Recherchez dans le groupe de discussion AJAXAPI. Si vous ne trouvez pas de message répondant à votre question, postez votre question dans le groupe de discussion et incluez un lien vers la page sur laquelle vous avez posé la question.