本セクションでは、すべてのシンプルなカスタマイズタイプについて説明します。これらのカスタマイズタイプのうちいくつかについては、カスタマイズウィジェットが C-M-i または M-TAB によるインライン補完を提供します。
sexp値には、出力および再読み込みが可能な任意のLispオブジェクトを指定できます。より具体的な型を検討する手間を省きたい場合は、どのオプションにおいてもフォールバックとして
sexp を使用できます。
integer値は整数である必要があります。
natnum値は非負の整数である必要があります。
number値は数値(浮動小数点数または整数)である必要があります。
float値は浮動小数点数である必要があります。
string値は文字列である必要があります。カスタマイズバッファには、‘"’文字や‘\’クォートで区切ることなく、文字列が表示されます。
regexpstringと同様ですが、文字列は有効な正規表現である必要があります。
character値は文字コードである必要があります。文字コードは実際には整数ですが、この型では数値を表示するのではなく、バッファに文字を挿入することで値を表示します。
file値はファイル名である必要があります。ウィジェットは補完機能を提供します。
(file :must-match t)値は、既存ファイルのファイル名である必要があります。ウィジェットは補完機能を提供します。
directory値はディレクトリである必要があります。ウィジェットは補完機能を提供します。
hook値は関数のリストである必要があります。このカスタマイズタイプはフック変数に使用されます。フック変数のdefcustomで:optionsキーワードを使用すると、そのフックでの使用が推奨される関数のリストを指定できます。カスタマイズ変数の定義を参照してください。
symbol値はシンボルである必要があります。カスタマイズバッファにはシンボル名として表示されます。ウィジェットは補完機能を提供します。
function値はラムダ式または関数名のいずれかである必要があります。ウィジェットは関数名の補完機能を提供します。
buffer-predicate値は、buffer-match-p 関数の condition 引数に適した形式である必要があります(バッファリスト を参照)。これは、値が buffer-match-p に渡されて適切なバッファを選択するオプションに便利です。
variable値は変数名である必要があります。ウィジェットは補完機能を提供します。
face値は、フェイス名であるシンボルである必要があります。このウィジェットは補完機能を提供します。
boolean値はブール型で、nil または t
のいずれかとなります。なお、choice と const を併用することで(次節参照)、値が nil
または t
でなければならないと指定できるほか、各値を説明するテキストを、選択肢の具体的な意味に合わせて指定することも可能です。
keyこの値は key-valid-p に準拠した有効なキーであり、例えば keymap-set での使用に適しています。
key-sequence値はキーシーケンスです。カスタマイズバッファには、kbd
関数と同じ構文を用いてキーシーケンスが表示されます。キーシーケンスを参照してください。これはレガシーな型です。代わりに key を使用してください。
coding-system値はコーディングシステム名である必要があり、M-TAB で補完できます。
color値は有効な色名である必要があります。このウィジェットは、色名の補完機能に加え、サンプルと、*Colors*バッファに表示される色名リストから色名を選択するためのボタンを提供します。
fringe-bitmap値は有効なフリンジビットマップ名である必要があります。ウィジェットは補完機能を提供します。