ime-mode

Overview table

Initial value
:

Applies to

All elements

Inherited

Yes

Media

visual

Computed value
:

Animatable

No

CSS Object Model Property
:

Syntax

• ime-mode: active
• ime-mode: auto
• ime-mode: disabled
• ime-mode: inactive

Values

auto

Default. IME is not affected. This is the same as not specifying the -ms-ime-mode attribute.

active

All characters are entered through the IME. Users can still deactivate the IME.

inactive

All characters are entered without IME. Users can still activate the IME.

disabled

IME is completely disabled. Users cannot activate the IME if the control has focus.

Examples

This example uses the -ms-ime-mode attribute.

<INPUT TYPE = text STYLE = "ime-mode:active" >

Notes

Remarks

Windows Internet Explorer 8. The -ms-ime-mode attribute is an extension to CSS, and can be used as a synonym for ime-mode in IE8 Standards mode. An IME allows users to enter and edit Chinese, Japanese, and Korean characters. The IME is an essential component for writing Chinese, Japanese, and Korean scripts. These writing systems have more characters than can be encoded for a regular keyboard. The IMEs for these languages use sequences of base characters that describe an individual character or group of characters to enter a larger set of characters. Base characters can be component letters from Hangul syllables, phonetic components for Japanese Kanji characters, or various combinations for Chinese characters. To compose text with an IME, the user generally uses dictionary lookup and contextual analysis, especially in languages where homonyms are frequent, as in Japanese. A user typically starts by entering a few component characters, optionally selecting from various choices, and a confirmation command. Input Method Editors have two principle states:

• Inactive mode. The keyboard acts like a regular keyboard and input is limited to a small set of characters.
• Active mode. The IME accepts component characters or processing commands.

HTML authors can provide users with some control by specifying an IME mode for a specific text entry. For example, if Japanese users enter information in a registration form, they might be required to enter their names in Kanji and Roman characters. By default, the users would have to make sure that the IME is inactive when entering their names in the Latin alphabet. The user would activate the IME to enter Kanji letters, then deactivate the IME to complete the form in the Latin alphabet. By controlling the IME mode, the HTML author prevents the user from having to activate and deactivate the IME.

Syntax

-ms-ime-mode: auto | active | inactive | disabled

See also

Related articles

Text

• block-progression

• font-language-override

• font-size

• hyphenate-limit-chars

• hyphenate-limit-lines

• hyphenate-limit-zone

• hyphens

• ime-mode

• layout-grid

• layout-grid-char

• layout-grid-line

• layout-grid-mode

• layout-grid-type

• letter-spacing

• text-overflow-ellipsis

• text-overflow-mode

• text-rendering

• user-modify

• Text

• size

• b

• b

• br

• br

• caption

• cite

• code

• del

• dfn

• em

• font

• hr

• i

• ins

• kbd

• mark

• samp

• strong

• Achieving typographic effects with the canvas tag

Related pages

• CSSStyleDeclarationCSSStyleDeclaration
• currentStylecurrentStyle
• runtimeStyleruntimeStyle
• stylestyle

Attributions

• Microsoft Developer Network: [Windows Internet Explorer API reference Article]