概要

ime-mode プロパティは、テキストフィールドで Input Method Editor (以下 IME) をコントロールします。仕様によれば:

"ime-mode" は、問題がありこの仕様によって公式に廃止される、一部のブラウザーで多少実装されたプロパティです...

ユーザーエージェントは、ime-mode をサポートしないように仕様で指示されており、以前にレガシーコードで設定されていた場合は、プロパティを元に戻すことができない限り、ページ制作者は使用しないことをお勧めします。これは、Microsoft が独自の拡張機能として Internet Explorer 5 で導入したものです。-ms-ime-mode Attribute | imeMode Property

初期値auto
適用対象テキストフィールド
継承不可
メディアinteractive
計算値指定値
Animation typediscrete
正規順序形式文法で定義される一意のあいまいでない順序

構文

ime-mode: auto;
ime-mode: normal;
ime-mode: active;
ime-mode: inactive;
ime-mode: disabled;

/* Global values */
ime-mode: inherit;
ime-mode: initial;
ime-mode: unset;

auto
現在の IME の状態を変更しません。これはデフォルトの設定です。
normal
IME の状態を通常の状態に変更します。この値はユーザースタイルシートでウェブページが指定した値を上書きするために用意されました。 この値は Internet Explorer ではサポートされていません。
active
コンテンツがフォーカスを得た時に IME は自動的にオンになります。ユーザーがオフにしない限りテキスト入力には IME が使用されます。 Linux ではサポートされていません。
inactive
コンテンツがフォーカスを得た時に IME は自動的にオフに設定されますが、ユーザーは任意で IME をオンにする事ができます。 Linux ではサポートされていません。
disabled
IME は無効にされます。ユーザーによって IME をオンにする事はできません。

註: 一般に、公開されているウェブサイトが IME モードを変更することは適切ではありません。このプロパティは、内部のウェブアプリケーションなど、非公開のものにのみ使用する必要があります。

公式の構文

auto | normal | active | inactive | disabled

<input type="text" name="name" value="initial value" style="ime-mode: disabled">

この例は、フィールドの IME のサポートを無効にします。これは、たとえば、拡張文字セットをサポートしていないデータベースにデータを入力するフィールドの一般的なプラクティスでした。しかしながら:

註: 拡張文字がフォームを通過しないように IME を無効にすることに依存しないでください。 IME を無効にしても、拡張文字をフォームのフィールドに貼り付けることはできます。

注記

Firefox の ime-mode は Internet Explorer と異なり、<input type="password"> にも適用できます。しかしこれはユーザーの使い勝手にはマイナスの影響を与えます。パスワードフィールドでは IME は有効にされるべきではありません。ユーザーは以下の CSS をユーザースタイルシートに挿入する事で推奨された設定に従わないサイトの動作を修正する事ができます:

input[type=password] {
	ime-mode: auto!important;
}

Gecko 1.9 の Mac 版では、disabled に設定されたエディターがフォーカスを失う際に、IME の状態をフォーカスを得る直前の状態には戻りません。そのため、Mac ユーザーは disabled 値を利用したフォームの利用に苛立ちを覚えるかもしれません。

註: IME を無効にすることで、非 ASCII 文字が入力されることはない、と考えないでください。たとえ IME が無効になっていたとしても、ユーザーは「貼り付け」等によってあらゆる文字をその要素に入力することができます。

仕様書

仕様 状態 コメント
CSS Basic User Interface Module Level 3
ime-mode の定義
勧告案 初期の定義

ブラウザー互換性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

機能 Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
基本サポート 未サポート (有) 3.0 (1.9) 5.0 [1] 未サポート 未サポート
機能 Android Edge Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
基本サポート ? (有) ? ? ? ?

[1] IE8 は ime-mode に対してベンダープレフィックスとして -ms-ime-mode を導入しました。 -ms- プレフィックスを使用してはいけません。

ドキュメントのタグと貢献者

タグ: 
このページの貢献者: momdo, ethertank, fscholz, Potappo, Miho, Mgjbot, Masayuki, Norah
最終更新者: momdo,