<custom-ident>

<custom-ident> は CSS のデータ型で、識別子として使われるユーザー定義の任意の文字列を意味します。これは大文字と小文字を区別し、曖昧さを避けるため、いくつかの値は様々なコンテキストで禁止されています。

構文

<custom-ident> の構文は CSS の識別子 (プロパティ名など) に似ていますが、大文字と小文字を区別する点が異なります。これは 1 文字以上の下記の文字のから成ります。

  • 任意のアルファベット (A-Z, a-z)
  • 任意の数字 (0-9)
  • ハイフン (-)
  • アンダースコア (_)
  • エスケープ文字 (バックスラッシュ \ に続く)
  • Unicode 文字 (バックスラッシュ \ と、それに続く 1 - 6 桁の 16 進数の形式で Unicode コードポイントを表す)

なお、このデータ型では id1、Id1、iD1、ID1 は大文字と小文字を区別するため、すべて異なった識別子として扱われます。逆に、toto\? と toto\3F は文字をエスケープする方法が異なりますが、同じ識別子として扱われます。

禁止されている値

<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) および none, inline, outside の値を禁止しています。また、disc, circle, square, decimal, cjk-decimal, decimal-leading-zero, lower-roman, upper-roman, lower-greek, lower-alpha, lower-latin, upper-alpha, upper-latin, arabic-indic, armenian, bengali, cambodian, cjk-earthly-branch, cjk-heavenly-stem, cjk-ideographic, devanagari, ethiopic-numeric, georgian, gujarati, gurmukhi, hebrew, hiragana, hiragana-iroha, japanese-formal, japanese-informal, kannada, katakana, katakana-iroha, khmer, korean-hangul-formal, korean-hanja-formal, korean-hanja-informal, lao, lower-armenian, malayalam, mongolian, myanmar, oriya, persian, simp-chinese-formal, simp-chinese-informal, tamil, telugu, thai, tibetan, trad-chinese-formal, trad-chinese-informal, upper-armenian, disclosure-open, and disclosure-close といった定義済みの値が、様々なブラウザーで実装されています。

grid-row-start, grid-row-end, grid-column-start, grid-column-end

span 値を禁止しています。

will-change

グローバル CSS 値 (unset, initial, inherit) および will-change, auto, scroll-position, contents の値を禁止しています。

例

有効な識別子

nono79            アルファベットと数字の組み合わせ
ground-level      アルファベットとダッシュの組み合わせ
-test             ダッシュとそれに続くアルファベット
_internal         アンダースコアとそれに続くアルファベット
\22 toto          Unicode 文字とそれに続くアルファベット
bili\.bob         ピリオドが正しくエスケープされている

無効な識別子

34rem             数字で始まってはいけない
-12rad            ダッシュで始まって数字が続いてはいけない
bili.bob          アルファベットと数字以外でエスケープせずに使えるのは _ と - だけ
--toto            2 つのダッシュで始まってはいけない
'bilibob'         <string> になります
"bilibob"         <string> になります

仕様書

Specification
CSS Values and Units Module Level 4
# custom-idents
CSS Will Change Module Level 1
# valdef-will-change-custom-ident
CSS Counter Styles Level 3
# typedef-counter-style-name
CSS Lists and Counters Module Level 3
# counter-properties

ブラウザーの互換性

このデータ型は実際の型ではありませんが、許可された値をシンプルに記述するのに役立つ便利な型です。ブラウザーの互換性についての情報はありません。

関連情報