Customization

English | Español | Tiếng Việt

By default, the Mixed input method accepts both the Telex and VNI input methods. You can change this behavior, as well as several other options, using AVIM’s preferences dialog box, accessible through about:addons.

The available options are:

Enable AVIM for Vietnamese input

If checked, AVIM is enabled. Otherwise, it’s disabled, so that typing proceeds as if the extension has not been installed. By default, it’s checked (enabled). This option is equivalent to the extensions.avim.enabled preference.

Exceptions

This button opens the Blacklist dialog, which contains a case-insensitive list of field IDs. Textboxes with these IDs are ignored by AVIM. By default, the list consists of the following IDs:

• colorzilla-textbox-hex – hexadecimal color textbox, ColorZilla extension
• email and e-mail
  E-mail addresses rarely contain non-ASCII characters
• TextboxEval – the Code bar, Error Console
• tx_tagName – Tag Name box, Insert Node dialog, DOM Inspector
  Tag names very rarely contain non-ASCII characters.

Here are some commonly-used IDs in Firefox’s user interface:

• urlbar – Location Bar
  Ignoring the Location Bar is not recommended, because AVIM is useful when entering URLs of Vietnamese Wikipedia articles, for instance. However, you should ignore it if you’ve enabled the network.IDN_show_punycode option in about:config.
• searchbar – Web Search Bar
• FindToolbar – Find in Page Bar

And in Thunderbird:

• ColorInput – custom color textbox, Text Color and Block Background Color dialogs, Compose window
  If you use Telex, you may want to prevent yourself from accidentally entering diacritics instead of a hexadecimal code (for example, #èfe instead of #efefef).

This option is equivalent to the extensions.avim.ignoredFieldIds preference.

Input method

Selects the input method that is applied to your keyboard input. By default, it’s set to Mixed. This option is equivalent to the extensions.avim.method preference, which accepts the following values:

1. Mixed
2. Telex
3. VNI
4. VIQR
5. VIQR*

Customize

When the Mixed input method is selected, the Customize button is enabled. A separate dialog appears when you click the button. If any of the options in this dialog is checked, that input method’s keystrokes are accepted by the Mixed input method. By default, Telex and VNI contribute to the Mixed input method. These options are equivalent to the preferences beginning with extensions.avim.auto.

When a word breaks Vietnamese spelling rules…

If “Insert characters literally” is selected, AVIM works as a spell checker of sorts. Consider a word that doesn’t conform to Vietnamese spelling rules – which typically means it’s a foreign word or name. If you have chosen the Telex input method, as normally comes out as “á”, but if this option is checked and you type in Washington, you’ll get “Washington”; if “Apply diacritics to the word anyways” is selected, you’ll get “Wáhington”. By default, characters are inserted literally. This option is equivalent to the extensions.avim.ignoreMalformed preference.

Except after informal spelling patterns

If checked, AVIM allows you to place accent marks on words that start with “dz” (equivalent to “d”) or “f” (equivalent to “ph”), even when spelling rules are being enforced. Such spellings aren’t acceptable in formal writing but are common in online forums. This option also allows the abbreviation “Ng̃” for “Nguyễn”. By default, it’s unchecked (not allowed). It’s equivalent to the extensions.avim.informal preference.

When a word ends in two vowels, apply diacritics to…

If “The first vowel” is selected, AVIM ensures that you place tone marks on diphthongs the traditional way, so that both xo'a and xoa' produce “xóa” (using the VIQR input method). If “The second vowel” is selected, AVIM uses the newer style, so that both produce “xoá”. By default, the tone mark would be placed on the first vowel. This option is equivalent to the extensions.avim.oldAccents preference.

Turn off input method editors embedded in Web pages

If checked, the script monitor is enabled. As soon as you type into a webpage, the extension automatically disables any IME scripts on that page that could interfere with AVIM. By default, this option is checked, so the AVIM/HIM, Google Virtual Keyboard, Mudim, MViet, VietTyping, and VietUni scripts are disabled. This option is equivalent to the extensions.avim.scriptMonitor.enabled preference.

Configure

This button opens a separate dialog that allows you to choose which scripts to disable automatically. The script monitor is capable of disabling the following scripts: AVIM/HIM, CHIM, Google Virtual Keyboard, Mudim, MViet, VietIMEW, VietTyping, VietUni, and Vinova. They correspond to the preferences beginning with extensions.avim.scriptMonitor.

Ignore password boxes

If left unchecked, AVIM allows you to add diacritics to passwords, both on webpages and in the application’s user interface. By default, it’s checked (unaccented passwords). This option is equivalent to the extensions.avim.passwords preference. Use caution when using accented passwords on a website: the website may not handle Unicode passwords properly; additionally, you might not be able to enter your password correctly when you use a different computer.

Show in Add-on Bar

If checked, the Add-on Bar button is displayed; otherwise, it’s hidden. By default, it’s checked (displayed). This option is equivalent to the extensions.avim.statusBarPanel preference.

Volume

This slider controls the volume of the audio cue played when toggling AVIM by pressing Ctrl twice (⌃⌃ on the Mac). Drag the slider to the left to mute the cue or to the right to make it louder. By default, it’s set to 20%. This option is equivalent to the extensions.avim.volume preference.