Maren Transliteration JavaScript
Add Maren Transliteration to your Website
You can now add the Web Version of Microsoft Maren Transliteration to your website so that your visitors can enter Arabic text on the site, facilitating easy search, form-filling and discussions in Arabic.
Adding the Web Version of Microsoft Maren Transliteration to your website is as easy as copying and pasting a small fragment of HTML into your page source code. You can use it in one of two modes:
-
Default On Mode: Transliteration will be enabled in all supported text input fields on your page unless otherwise specified. To prevent transliteration within an input field, you will need to set an attribute on it. This is the default mode and is recommended if you want most or all of your page to be Arabic input-enabled.
Instructions for Default On Mode
-
Copy and paste the following code within the body element of your page or site template.
<!-- Microsoft Maren Transliteration embed code -->
<input type="hidden" id="Hidden1" attachMode="optout" value="" />
<script type="text/javascript" src="http://afkar.microsoft.com/TransliterationService//script/Arabic.js"
defer="defer"></script>
-
If you wish to prevent opt out of transliteration in a particular input field, add the attribute declaration MicrosoftILITWebAttach="false" to the opening tag as follows.
For a textarea
<textarea ... MicrosoftILITWebAttach="false">
For an input tag (of type text, search or unspecified but NOT password)
<div contentEditable="true" ... MicrosoftILITWebAttach="false">
For a rich text input div (using contentEditable)
iframe ... MicrosoftILITWebAttach="false">
-
You are required to attribute the transliteration feature to Microsoft. Copy and paste the following code at the appropriate place in your page or site template.
<!-- Microsoft Arabic Language Input Tool attribution image link -->
<a style="text-decoration: none" href="http://go.microsoft.com/fwlink/?LinkID=184201&clcid=0x409"/>
This will result in the following image appearing on your page. This image links to the Microsoft Arabic Language Input Tool site.
-
Default Off Mode: Transliteration will be disabled in all supported text input fields on your page unless otherwise specified. To allow transliteration within an input field, you will need to set an attribute on it. This is recommended if you want only a few input fields on your page to be Arabic input-enabled.
Instructions for Default Off Mode
-
Copy and paste the following code within the body element of your page or site template.
<!-- Microsoft Arabic Language Input Tool embed code -->
<input type="hidden" id="MicrosoftILITWebEmbedInfo" attachMode="optin"
value="" /> <script type="text/javascript" src="http://ilit.microsoft.com/bookmarklet/script/Arabic.js"
defer="defer"></script>
-
If you wish to prevent opt out of transliteration in a particular input field, add the attribute declaration MicrosoftILITWebAttach="false" to the opening tag as follows.
For a textarea
<textarea ... MicrosoftILITWebAttach="true">
For an input tag (of type text, search or unspecified but NOT password)
<input ... MicrosoftILITWebAttach="true">
For a rich text input div (using contentEditable)
<div contentEditable="true" ... MicrosoftILITWebAttach="true">
For a rich text input within an iframe using contentEditable or designMode on contained
document
<iframe ... MicrosoftILITWebAttach="true">
-
You are required to attribute the transliteration feature to Microsoft. Copy and paste the following code at the appropriate place in your page or site template.
<!-- Microsoft Arabic Language Input Tool attribution image link -->
<a style="text-decoration: none" href="http://go.microsoft.com/fwlink/?LinkID=184201&clcid=0x409
"> <img style="border: 0px" alt="Transliteration by Microsoft"
src="http://afkar.microsoft.com/bookmarklet/images/attribution.png" />
</a>
This will result in the following image appearing on your page. This image links to the Microsoft Arabic Language Input Tool site.
By implementing the code provided above into your website or application, you agree to the License Agreement and agree to obtain the informed consent of your users for the transmission to and use of data by Microsoft as described in the Microsoft Maren Transliteration Privacy Statement.
Browser Support
The Web Version of Microsoft Maren Transliteration has full support for Microsoft Internet Explorer, Mozilla Firefox™ and Google Chrome™. In the fully supported browsers, all input fields are supported, i.e. plain text fields as well as rich text fields.