<custom-ident>
<custom-ident> は CSS のデータ型で、識別子として使われるユーザー定義の任意の文字列を意味します。これは大文字と小文字を区別し、曖昧さを避けるため、いくつかの値は様々なコンテキストで禁止されています。
構文
<custom-ident> の構文は CSS の識別子 (プロパティ名など) に似ていますが、大文字と小文字を区別する点が異なります。これは 1 文字以上の下記の文字のから成ります。
- 任意のアルファベット (
A-Z,a-z) - 任意の数字 (
0-9) - ハイフン (
-) - アンダースコア (
_) - [エスケープ文字] (バックスラッシュ
\に続く) - Unicode 文字 (バックスラッシュ
\と、それに続く 1 - 6 桁の 16 進数の形式で Unicode コードポイントを表す)
なお、 id1、Id1、iD1、ID1 は大文字と小文字を区別するため、すべて異なった識別子として扱われます。
エスケープ文字
あらゆる Unicode コードポイントを <custom-ident> や引用 <string> の一部として、エスケープすることで含めることができます。
CSS では、文字をエスケープする方法がいくつかあります。エスケープシーケンスはバックスラッシュ (\) で始まり、以下のものが続きます。
- 1~6 桁の 16 進数 (
ABCDEF0123456789)。 16 進数にはオプションで空白が続くこともあります。 16 進のエスケープシーケンスは、この数字で指定された値の Unicode コードポイントに置き換わります。空白は、シーケンスの後に実際の 16 進数を(置き換えることなく)続けることを可能にします。 - 16 進数でも改行文字でもない Unicode コードポイント。
例:
- "&B" は
\26 Bまたは\000026Bと書くことができます。 - "hi.there" は
hi\.thereまたはhi\002Ethereと書くことができます。 - "toto?" は
toto\?,toto\3F,toto\00003Fのように書くことができます。
エスケープシーケンスの後に実際のホワイトスペースを含める場合は、エスケープシーケンスに 2 つのホワイトスペースを入れてください。
禁止されている値
<custom-ident> を引用符または二重引用符の間に置いてはいけません。こうすると、 <string> として識別されてしまいます。さらに、先頭の文字は、数字や、ハイフン (-) に数字が続いたものであってはなりません。
曖昧さを避けるため、 <custom-ident> を使用する各プロパティでは、特定の値の使用が禁止されています。
animation-name-
グローバル CSS 値 (
unset,initial,inherit) を禁止し、noneも禁止しています。 counter-reset,counter-increment-
グローバル CSS 値 (
unset,initial,inherit) を禁止し、noneも禁止しています。 @counter-style,list-style-type-
グローバル CSS 値 (
unset,initial,inherit) と、次の値を禁止しています。noneinlineoutside
また、さまざまなブラウザーで、いくつかの定義済みの値が実装されています。
disccirclesquaredecimalcjk-decimaldecimal-leading-zerolower-romanupper-romanlower-greeklower-alphalower-latinupper-alphaupper-latinarabic-indicarmenianbengalicambodiancjk-earthly-branchcjk-heavenly-stemcjk-ideographicdevanagariethiopic-numericgeorgiangujaratigurmukhihebrewhiraganahiragana-irohajapanese-formaljapanese-informalkannadakatakanakatakana-irohakhmerkorean-hangul-formalkorean-hanja-formalkorean-hanja-informallaolower-armenianmalayalammongolianmyanmaroriyapersiansimp-chinese-formalsimp-chinese-informaltamilteluguthaitibetantrad-chinese-formaltrad-chinese-informalupper-armeniandisclosure-opendisclosure-close
grid-row-start,grid-row-end,grid-column-start,grid-column-end,grid-template-rows,grid-template-columns-
span値およびauto値を禁止しています。 view-transition-name-
グローバル CSS 値 (
unset,initial,inherit) およびnoneの値を禁止しています。 will-change-
グローバル CSS 値 (
unset,initial,inherit) およびwill-change,auto,scroll-position,contentsの値を禁止しています。
例
>有効な識別子
nono79 アルファベットと数字の組み合わせ ground-level アルファベットとダッシュの組み合わせ -test ダッシュとそれに続くアルファベット _internal アンダースコアとそれに続くアルファベット \22 toto Unicode 文字とそれに続くアルファベット scooby\.doo ピリオドが正しくエスケープされている
無効な識別子
34rem 数字で始まってはいけない -12rad ダッシュで始まって数字が続いてはいけない scooby.doo アルファベットと数字以外でエスケープせずに使えるのは _ と - だけ 'scoobyDoo' <string> になります "scoobyDoo" <string> になります
仕様書
ブラウザーの互換性
このデータ型は実際の型ではありませんが、許可された値をシンプルに記述するのに役立つ便利な型です。ブラウザーの互換性についての情報はありません。