The Translator Web Widget API

Web Widget Customization API

The Web Widget Customization API enables you to customize the Translator Web Widget for your specific needs. You can programmatically call the Translator Web Widget’s functions and listen on its events.

For example, you can create a custom “Translate” button that blends well with your site’s UI or even define a certain trigger for the Translator Web Widget. You may also want to define actions that occur after translation of your page is complete.


<script src="**" type="text/javascript"></script>


Name Description


Launches the Widget which translates the current page to the desired language. A callback function provides translation progress information.


Restores the original text in every HTML element that has been translated. It also stops the translation if in progress.


Returns a list of Language objects with localized names according to the locale parameter provided.


Returns a list of Language objects in which each language name is localized in its own locale. E.g. English, Deutsch, العربية,…


The Widget can auto-detect the language of the page – this method returns a string containing the last automatically-detected language.

© 2015 Microsoft