diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
commit | 33058f2b292b3a581333bdfb21b8f671898c5060 (patch) | |
tree | 51c3e392513ec574331b2d3f85c394445ea803c6 /files/ja/web/css/css_values_and_units/index.html | |
parent | 8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff) | |
download | translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2 translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip |
initial commit
Diffstat (limited to 'files/ja/web/css/css_values_and_units/index.html')
-rw-r--r-- | files/ja/web/css/css_values_and_units/index.html | 499 |
1 files changed, 499 insertions, 0 deletions
diff --git a/files/ja/web/css/css_values_and_units/index.html b/files/ja/web/css/css_values_and_units/index.html new file mode 100644 index 0000000000..3b8916285b --- /dev/null +++ b/files/ja/web/css/css_values_and_units/index.html @@ -0,0 +1,499 @@ +--- +title: CSS 値と単位 +slug: Web/CSS/CSS_Values_and_Units +tags: + - CSS + - Guide + - Reference + - values and units +translation_of: Web/CSS/CSS_Values_and_Units +--- +<div>{{CSSRef}}</div> + +<p class="summary">CSS 宣言はすべて、プロパティと値の組を含みます。プロパティによって、値は単純な整数やキーワードから、一連のキーワードや単位つき・単位なしの値などを含みます。CSS プロパティには受け付けるデータ型の組み合わせ -- 値と単位 -- があります。以下ではデータ型の大部分を概観します。より詳しい情報は、それぞれのデータ型のページを参照してください。</p> + +<h2 id="Textual_data_types" name="Textual_data_types">テキストのデータ型</h2> + +<ul> + <li>{{cssxref("<custom-ident>")}}</li> + <li><code><ident></code> として定義済みのキーワード</li> + <li>{{cssxref("<string>")}}</li> + <li>{{cssxref("<url>")}}</li> +</ul> + +<p>テキストデータ型は、引用符で囲まれた文字の並びである <code><string></code> と、引用符で囲まれていない文字列、すなわち「CSS 識別子」である <code><ident></code> のどちらかです。 <code><string></code> は単一引用符か二重引用符のどちらかで囲まれます。仕様書で <code><ident></code> または <code><custom-ident></code> として挙げられている CSS 識別子は、引用符で囲んではいけません。</p> + +<p>CSS の仕様では、ウェブ開発者が定義できる値には、アニメーションのキーフレームやフォントファミリーの名前、グリッドエリアなどがあり、これらは {{cssxref("<custom-ident>")}} または {{cssxref("<string>")}} またはその両方の形式で記述します。</p> + +<p>ユーザーが定義するテキスト値のうち、引用符があってもなくてもよい箇所では、仕様書には <code><custom-ident> | <string></code> のように記してあります。これは、例えばアニメーション名のように、引用符が任意だということです。</p> + +<pre class="brush: css notranslate">@keyframe validIdent { + /* ここにキーフレーム */ +} +@keyframe 'validString' { + /* ここにキーフレーム */ +}</pre> + +<p>引用符で囲んではいけないテキスト値もあります。たとえば {{cssxref("grid-area")}} の値は <code><custom-ident></code> なので、もし <code>content</code> という名前のグリッドエリアがあれば、それは引用符なしで書きます。</p> + +<pre class="brush: css notranslate">.item { + grid-area: content; +} +</pre> + +<p>いっぽう、 {{cssxref("<string>")}} のデータ型、たとえば {{cssxref("content")}} プロパティの文字列値には引用符が必要です。</p> + +<pre class="brush: css notranslate">.item::after { + content: "This is my content."; +} +</pre> + +<p>どんな名前でも (絵文字を含んでいるものでも) 一般的には作れますが、識別子については <code>none</code>、<code>unset</code>、 <code>initial</code>、<code>inherit</code> にはできず、先頭を数字や二重ダッシュにすることもできません。また、一般的に CSS のそのほかの定義済みキーワードを使用することは避けるのが好ましいです。詳しくは {{cssxref("<custom-ident>")}} と {{cssxref("<string>")}} のリファレンスページを参照してください。</p> + +<h3 id="Pre-defined_keywords" name="Pre-defined_keywords">定義済みキーワード値</h3> + +<p>定義済みキーワードは、特定のプロパティ用に仕様で定義されているテキスト値です。これらのキーワードは CSS 識別子でもあるので、引用符なしで使用します。</p> + +<p>CSS の仕様書や MDN のプロパティページで、CSS プロパティの値の構文を見ると、そこに書けるキーワードは次のような形式で列挙されているでしょう。以下の値は、{{cssxref("float")}} で使用できる定義済みキーワードです。</p> + +<pre class="syntaxbox notranslate">left <a href="/ja/docs/Web/CSS/Value_definition_syntax#Single_bar" title="Single bar: exactly one of the entities must be present">|</a> right <a href="/ja/docs/Web/CSS/Value_definition_syntax#Single_bar" title="Single bar: exactly one of the entities must be present">|</a> none <a href="/ja/docs/Web/CSS/Value_definition_syntax#Single_bar" title="Single bar: exactly one of the entities must be present">|</a> inline-start <a href="/ja/docs/Web/CSS/Value_definition_syntax#Single_bar" title="Single bar: exactly one of the entities must be present">|</a> inline-end</pre> + +<p>こうした値は引用符なしで使用します。</p> + +<pre class="brush: css notranslate"><code>.box { + float: left; +} +</code></pre> + +<h3 id="CSS-wide_values" name="CSS-wide_values">CSS 全般の値</h3> + +<p>プロパティ用に仕様で定められている定義済みキーワードのほかに、すべての CSS プロパティで使える CSS 全般のプロパティ値として、{{cssxref("initial")}}、{{cssxref("inherit")}}、{{cssxref("unset")}} があります。これらは既定値への戻し方を明示するために使用します。</p> + +<p><code>initial</code> キーワードは、そのプロパティの初期値として指定された値を表します。<code>inherit</code> キーワードは、その要素の親要素のプロパティで計算された値を表し、親の値を継承します。</p> + +<p><code>unset</code> キーワードは、そのプロパティが継承されているか否かによって、<code>inherit</code> または <code>initial</code> のいずれかと同じ動きになります。</p> + +<p>{{cssxref("revert")}} という 4 つめの値が Cascade Level 4 の仕様で追加されましたが、いまのところブラウザーの対応状況は好ましくありません。</p> + +<h3 id="URLs" name="URLs">URL</h3> + +<p>{{cssxref("<url>")}} 型は関数ノテーションのように使用します。これは URL である <code><string></code> を受け取ります。渡すのは絶対 URL か相対 URL です。例えば、背景画像を読み込みたいときには以下のどちらの使い方でもできます。</p> + +<pre class="brush: css notranslate"><code>.box { + background-image: url("images/my-background.png"); +}</code> + +<code>.box { + background-image: url("https://www.exammple.com/images/my-background.png"); +}</code> +</pre> + +<p><code>url()</code> の引数は引用符があってもなくてもかまいません。引用符をつけない場合には、<code><url-token></code> と同様に読み込まれます。そのため、その場合は <code><url-token></code> のように特定の文字のエスケープなどを行う必要があります。詳しくは {{cssxref("<url>")}} を参照してください。</p> + +<h2 id="Numeric_data_types" name="Numeric_data_types">数値データ型</h2> + +<ul> + <li>{{cssxref("<integer>")}}</li> + <li>{{cssxref("<number>")}}</li> + <li>{{cssxref("<dimension>")}}</li> + <li>{{cssxref("<percentage>")}}</li> +</ul> + +<h3 id="Integers" name="Integers">整数</h3> + +<p>整数は 1 桁以上の <code>0</code> から <code>9</code> の十進数で、<code>1024</code>、<code>-55</code> など該当します。整数は <code>+</code> や <code>-</code> を先頭に付けることができますが、記号と整数の間に空白を開けないでください。</p> + +<h3 id="Numbers" name="Numbers">数値</h3> + +<p>{{cssxref("<number>")}} は実数をあらわします。小数点以下の小数部がなくても構いません。例えば <code>0.255</code>、<code>128</code>、<code>-1.2</code> が該当します。数値にも <code>+</code> や <code>-</code> の記号を先頭に付けることができます。</p> + +<h3 id="Dimensions" name="Dimensions">寸法</h3> + +<p>{{cssxref("<dimension>")}} は、<code><number></code> に単位が付いたものです。例えば <code>45deg</code>、<code>100ms</code>、<code>10px</code> が該当します。付けた単位の識別子は大文字小文字が区別されません。数値と単位の間には、空白やその他の文字を入れないでください。例えば、<code>1 cm</code> は無効です。</p> + +<p>CSS では、以下のものをあらわすために寸法を使います。</p> + +<ul> + <li>{{cssxref("<length>")}} (距離の単位)</li> + <li>{{cssxref("<angle>")}}</li> + <li>{{cssxref("<time>")}}</li> + <li>{{cssxref("<frequency>")}}</li> + <li>{{cssxref("<resolution>")}}</li> +</ul> + +<p>以下の節で、これらについて説明します。</p> + +<h4 id="Distance_units" name="Distance_units">距離の単位</h4> + +<p>長さのような距離の単位がプロパティの値として使用できるとき、これを {{cssxref("<length>")}} 型と呼びます。CSS の長さには、相対的な長さと絶対的な長さの 2 種類があります。</p> + +<p>相対的な長さの単位は、他のものを基準に長さを表します。例えば、<code>em</code> はその要素のフォントサイズを基準とする値で、<code>vh</code> はビューポートの高さを基準とする値です。</p> + +<table class="standard-table"> + <caption> + <h4 id="Relative_length_units" name="Relative_length_units">相対的な長さの単位</h4> + </caption> + <thead> + <tr> + <th scope="col">単位</th> + <th scope="col">基準</th> + </tr> + </thead> + <tbody> + <tr> + <td><code>em</code></td> + <td>その要素のフォントサイズ</td> + </tr> + <tr> + <td><code>ex</code></td> + <td>その要素のフォントの x-height</td> + </tr> + <tr> + <td><code>cap</code></td> + <td>その要素のフォントの Cap height (大文字の名目上の高さ)</td> + </tr> + <tr> + <td><code>ch</code></td> + <td>その要素のフォントにおける narrow グリフの平均文字送り幅で、“0” (ZERO, U+0030) のグリフを表す</td> + </tr> + <tr> + <td><code>ic</code></td> + <td>その要素のフォントにおける full width グリフの平均文字送り幅で、“水” (CJK water ideograph, U+6C34) のグリフを表す</td> + </tr> + <tr> + <td><code>rem</code></td> + <td>ルート要素のフォントサイズ</td> + </tr> + <tr> + <td><code>lh</code></td> + <td>その要素の行の高さ</td> + </tr> + <tr> + <td><code>rlh</code></td> + <td>ルート要素の行の高さ</td> + </tr> + <tr> + <td><code>vw</code></td> + <td>ビューポートの幅の 1%</td> + </tr> + <tr> + <td><code>vh</code></td> + <td>ビューポートの高さの 1%</td> + </tr> + <tr> + <td><code>vi</code></td> + <td>ルート要素のインライン軸におけるビューポートの大きさの 1%。</td> + </tr> + <tr> + <td><code>vb</code></td> + <td>ルート要素のブロック軸におけるビューポートの大きさの 1%。</td> + </tr> + <tr> + <td><code>vmin</code></td> + <td>ビューポートの小さい側の 1%。</td> + </tr> + <tr> + <td><code>vmax</code></td> + <td>ビューポートの大きい側の 1%。</td> + </tr> + </tbody> +</table> + +<p>絶対的な長さの単位は物理的な長さであり、インチやセンチメートルなどと決まっています。そのため、これらの単位の多くは、印刷などの固定サイズの媒体への出力に向いています。たとえば、 <code>mm</code> は物理的なミリメートルで、センチメートルの 1/10 です。</p> + +<table class="standard-table"> + <caption> + <h4 id="Absolute_length_units" name="Absolute_length_units">絶対的な長さの単位</h4> + </caption> + <thead> + <tr> + <th scope="col">単位</th> + <th scope="col">名称</th> + <th scope="col">換算</th> + </tr> + </thead> + <tbody> + <tr> + <td><code>cm</code></td> + <td>センチメートル</td> + <td>1cm = 96px/2.54</td> + </tr> + <tr> + <td><code>mm</code></td> + <td>ミリメートル</td> + <td>1mm = 1cm の 1/10</td> + </tr> + <tr> + <td><code>Q</code></td> + <td>1/4 ミリメートル</td> + <td>1Q = 1cm の 1/40</td> + </tr> + <tr> + <td><code>in</code></td> + <td>インチ</td> + <td>1in = 2.54cm = 96px</td> + </tr> + <tr> + <td><code>pc</code></td> + <td>パイカ</td> + <td>1pc = 1in の 1/16</td> + </tr> + <tr> + <td><code>pt</code></td> + <td>ポイント</td> + <td>1pt = 1in の 1/72</td> + </tr> + <tr> + <td><code>px</code></td> + <td>ピクセル</td> + <td>1px = 1in の 1/96</td> + </tr> + </tbody> +</table> + +<p>長さの値を使用する場合、その長さが <code>0</code> なら単位をつける必要はありません。そうでないときには、単位は必須で、大文字小文字は区別せず、値の数値部分の直後に空白をはさむことなく付けなければなりません。</p> + +<h4 id="Angle_units" name="Angle_units">角度の単位</h4> + +<p>角度の値は {{cssxref("<angle>")}} 型で表され、以下の値を受け付けます。</p> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">単位</th> + <th scope="col">名前</th> + <th scope="col">説明</th> + </tr> + </thead> + <tbody> + <tr> + <td><code>deg</code></td> + <td>角度</td> + <td>完全な円は 360 度です。</td> + </tr> + <tr> + <td><code>grad</code></td> + <td>グラディアン</td> + <td>完全な円は 400 グラディアンです。</td> + </tr> + <tr> + <td><code>rad</code></td> + <td>ラジアン</td> + <td>完全な円は 2π ラジアンです。</td> + </tr> + <tr> + <td><code>turn</code></td> + <td>周</td> + <td>完全な円は 1 周です。</td> + </tr> + </tbody> +</table> + +<h4 id="Time_units" name="Time_units">時間の単位</h4> + +<p>時間の値は {{cssxref("<time>")}} 型で表されます。時間の値を含めるときは、単位 -- the <code>s</code> か <code>ms</code> -- の指定が必要です。以下の値を受け付けます。</p> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">単位</th> + <th scope="col">名前</th> + <th scope="col">説明</th> + </tr> + </thead> + <tbody> + <tr> + <td><code>s</code></td> + <td>秒</td> + <td></td> + </tr> + <tr> + <td><code>ms</code></td> + <td>ミリ秒</td> + <td>1000 ミリ秒で 1 秒です。</td> + </tr> + </tbody> +</table> + +<h4 id="Frequency_units" name="Frequency_units">周期の単位</h4> + +<p>周期の値は {{cssxref("<frequency>")}} 型で表されます。以下の値を受け付けます。</p> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">単位</th> + <th scope="col">名前</th> + <th scope="col">説明</th> + </tr> + </thead> + <tbody> + <tr> + <td><code>Hz</code></td> + <td>ヘルツ</td> + <td>一秒間に発生する回数を表します。</td> + </tr> + <tr> + <td><code>kHz</code></td> + <td>キロヘルツ</td> + <td>1 キロヘルツは 1000 ヘルツです。</td> + </tr> + </tbody> +</table> + +<p><code>1Hz</code> は <code>1hz</code> や <code>1HZ</code> とも表記でき、一秒あたり一周となります。</p> + +<h4 id="Resolution_unit" name="Resolution_unit">解像度の単位</h4> + +<p>解像度の単位は {{cssxref("<resolution>")}} 型で表されます。これらは、CSS のインチ、センチメートル、ピクセルに収まるドット数を示すことで、画面などの視覚表現におけるドット 1 つの大きさを表します。以下の値を受け付けます。</p> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">単位</th> + <th scope="col">説明</th> + </tr> + </thead> + <tbody> + <tr> + <td><code>dpi</code></td> + <td>インチ毎ドット。</td> + </tr> + <tr> + <td><code>dpcm</code></td> + <td>センチメートル毎ドット。</td> + </tr> + <tr> + <td><code>dppx</code>、<code>x</code></td> + <td>ピクセル単位毎ドット。</td> + </tr> + </tbody> +</table> + +<h3 id="Percentages" name="Percentages">パーセント</h3> + +<p>{{cssxref("<percentage>")}} は他の値の割合を表す型です。</p> + +<p>パーセント値は、常に長さなどの他の量に対する相対的な値です。パーセントにできるプロパティごとに、パーセントが参照する量も定義されています。この量は、同じ要素の別のプロパティの値であったり、祖先要素のプロパティの値であったり、包含ブロックの測定値であったり、何か他のものであったりします。</p> + +<p>例えば、ボックスの {{cssxref("width")}} をパーセントで指定した場合、ボックスの親要素で計算された幅を参照するパーセントになります。</p> + +<pre class="brush: css notranslate">.box { + width: 50%; +}</pre> + +<h3 id="パーセントと寸法の混合">パーセントと寸法の混合</h3> + +<p>一部のプロパティでは、2 つの型のいずれかの寸法を受け入れることがあります。<code><length></code> <strong>または</strong> <code><percentage></code> といった具合です。この場合の許容値は、{{cssxref("<length-percentage>")}} のように組合わせ単位として仕様書で詳解しています。他に取りうる組み合わせは以下の通りです。</p> + +<ul> + <li>{{cssxref("<frequency-percentage>")}}</li> + <li>{{cssxref("<angle-percentage>")}}</li> + <li>{{cssxref("<time-percentage>")}}</li> +</ul> + +<h3 id="特殊データ型_他の仕様書で定義">特殊データ型 (他の仕様書で定義)</h3> + +<ul> + <li>{{cssxref("<color>")}}</li> + <li>{{cssxref("<image>")}}</li> + <li>{{cssxref("<position>")}}</li> +</ul> + +<h4 id="色">色</h4> + +<p>{{cssxref("<color>")}} の値は要素機能 (背景色など) の色を指定します。これは <a href="https://drafts.csswg.org/css-color-3/">CSS カラーモジュール</a> で定義されています。</p> + +<h4 id="画像">画像</h4> + +<p>{{cssxref("<image>")}} の値は、CSS で使用できる各種すべての画像を指定します。これは <a href="https://www.w3.org/TR/css-images-4/">CSS 画像の値と置換要素モジュール</a> で定義されています。</p> + +<h4 id="位置">位置</h4> + +<p>{{cssxref("<position>")}} 型は位置取りできる領域内におけるオブジェクトの 2D 位置を定義します。例えば、コンテナ要素内の背景画像がこれにあたります。この型は {{cssxref("background-position")}} として解釈されるために、<a href="https://www.w3.org/TR/css-backgrounds-3/">CSS の背景と縁の仕様書</a> で定義されています。</p> + +<h3 id="関数ノテーション">関数ノテーション</h3> + +<ul> + <li>{{cssxref("calc()")}}</li> + <li>{{cssxref("min", "min()")}}</li> + <li>{{cssxref("max", "max()")}}</li> + <li>{{cssxref("clamp", "clamp()")}}</li> + <li>{{cssxref("toggle", "toggle()")}}</li> + <li>{{cssxref("attr", "attr()")}}</li> +</ul> + +<p>関数ノテーションは、より複雑な型を表現したり、特殊な処理を呼び出すことが CSS でできるものです。この構文は、関数名の直後に左括弧 <code>(</code> の後、ノテーションの引数、右括弧 <code>)</code> が続きます。関数は複数の引数を取ることができ、CSS のプロパティ値と同様の形式になっています。</p> + +<p>括弧内の空白は許容されますが、任意です。(ただし、<code>min()</code>、<code>max()</code>、<code>clamp()</code> 関数については、各ページ内の空白に関する注意事項を参照してください。)</p> + +<p><code>rgba()</code> のように、レガシーな関数ノテーションの中にはカンマを使用するものもあります。しかし、カンマは一般的にリスト内の項目を区切るためにのみ使用されます。引数の区切りにカンマを使用するとき、カンマの前後に空白を入れるのは任意です。</p> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + <th scope="col">状態</th> + <th scope="col">備考</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName("CSS4 Values")}}</td> + <td>{{Spec2("CSS4 Values")}}</td> + <td><code>vi</code>, <code>vb</code>, <code>ic</code>, <code>cap</code>, <code>lh</code>, <code>rlh</code> 単位の追加。<br> + <code>min()</code>, <code>max()</code>, <code>clamp()</code> 関数ノテーションの追加<br> + <code>toggle()</code> の追加</td> + </tr> + <tr> + <td>{{SpecName("CSS3 Values")}}</td> + <td>{{Spec2("CSS3 Values")}}</td> + <td><code>calc()</code>, <code>ch</code>, <code>rem</code>, <code>vw</code>, <code>vw</code>, <code>vmin</code>, <code>vmax</code>, <code>Q</code> の追加</td> + </tr> + <tr> + <td>{{SpecName("CSS4 Colors")}}</td> + <td>{{Spec2("CSS4 Colors")}}</td> + <td> + <p><code>rgb()</code>, <code>rgba()</code>, <code>hsl()</code>, <code>hsla()</code> 関数のカンマ無し構文の追加。<code>rgb()</code> と <code>hsl()</code> にアルファ値を追加し、<code>rgba()</code> と <code>hsla()</code> をこれらへの (非推奨の) エイリアスに変更。<br> + <code>rebeccapurple</code> カラーキワードを追加。<br> + 4 と 8 桁の 16 進カラー値を追加、最後の桁はアルファ値を表します。<code>hwb()</code>, <code>device-cmyk()</code>, <code>color()</code> 関数の追加。</p> + </td> + </tr> + <tr> + <td>{{SpecName("CSS3 Colors")}}</td> + <td>{{Spec2("CSS3 Colors")}}</td> + <td>システム色を非推奨化。SVG カラーを追加。<code>rgba()</code>, <code>hsl()</code>, <code>hsla()</code> 関数の追加。</td> + </tr> + <tr> + <td>{{SpecName("CSS4 Images")}}</td> + <td>{{Spec2("CSS4 Images")}}</td> + <td> + <p><code>element()</code>, <code>image()</code>, <code>image-set()</code>, <code>conic-gradient()</code> の追加。</p> + </td> + </tr> + <tr> + <td>{{SpecName("CSS3 Images")}}</td> + <td>{{Spec2("CSS3 Images")}}</td> + <td>画像の初回定義。</td> + </tr> + <tr> + <td>{{SpecName("CSS2.1")}}</td> + <td>{{Spec2("CSS2.1")}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName("CSS1")}}</td> + <td>{{Spec2("CSS1")}}</td> + <td>初回定義。</td> + </tr> + </tbody> +</table> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/Web/CSS/CSS_Types">CSS 基本データ型</a></li> + <li><a href="/ja/docs/Learn/CSS/Introduction_to_CSS/Values_and_units">CSS 導入: 値と単位</a></li> +</ul> |