CSS プロパティページのテンプレート

メモ: この説明文全体を削除してから公開してください。

訳注: このテンプレートは翻訳記事用です。新たな記事を執筆する場合は、英語版を参照してください。日本語の単独記事を立項することはできません。）

ページのフロントマター:

ページ上部のフロントマターは「ページのメタデータ」を定義するために使用します。値は具体的なプロパティに応じて適切に更新してください。

---
title: NameOfTheProperty
slug: Web/CSS/NameOfTheProperty
l10n:
  sourceCommit: 翻訳元コミットID
---

title: title の値はページの先頭に表示されます。タイトルの書式は NameOfTheProperty です。例えば、 background-color プロパティのタイトルは background-color です。
slug: slug の値はhttps://developer.mozilla.org/ja/docs/ の後にくる URL の末尾です。これは Web/CSS/NameOfTheProperty のような書式です。例えば、 background-color プロパティのスラッグは Web/CSS/background-color です。スラッグ内の Getting_started のような複数単語の成分の場合、スラッグは /ja/docs/Learn/HTML/Getting_started のようにアンダースコアを使用します。
sourceCommit: （翻訳記事のみ）この記事の翻訳元となる英語版記事を GitHub にコミットした際のコミット ID を記述します。 GitHub 上で英語版記事のコミット ID を確認してください。

ページ先頭のマクロ

コンテンツ部の上部（ページのフロントマターのすぐ下）には、いくつかのマクロ呼び出しが現れます。 訳注: 英語版では以下のマクロは自動的に更新されますが、翻訳記事では更新されませんので、翻訳時に手動で英語版のマクロに合わせてください。

{{SeeCompatTable}} — これは これは実験的な機能です。 のバナーを生成し、この技術が実験的であることを示します。実験的なもので、その技術が Firefox の設定で隠されている場合は、 Firefox での実験的な機能ページにもそのためのエントリーを記入する必要があります。
{{Deprecated_Header}} — これは 非推奨 バナーを生成し、この技術の使用を避けるべきであることを示します。
{{Non-standard_Header}} — これは 標準外 バナーを生成し、この機能がどの仕様書にもないことを示します。

下記のアドバイスに従って、以下のマクロを更新または削除してください。

{{CSSRef}}: このマクロはすべての CSS プロパティページに置く必要があります。ページに記載したタグに応じて、適切な CSS サイドバーを生成します。
このページをコピーする際には、 {{MDNSidebar}} マクロを外すのを忘れないでください。

訳注: 英語版では状態ヘッダーマクロは自動的に更新されますが、翻訳記事では更新されません。翻訳時に英語版に合わせて手動で更新してください。

実験的、非推奨、標準外 の各バナーは、このメモブロックの直後に表示しています。

ページ内のその他のマクロ

形式文法の節の内容は {{CSSSyntax}} マクロを使用して生成します。このマクロは @webref/css npm パッケージを使用して仕様書からデータを取得します。
公式定義の節の内容は {{CSSInfo}} マクロを使用して生成します。この節のデータは、 mdn/data リポジトリーの properties.json データファイルの対応するプロパティに、確実に適切な項目が記入されている必要があります。詳細はプロパティのページを参照してください。
仕様書とブラウザーの互換性の節: ビルドツールは自動的にページのフロントマターから browser-compat のキーと値のペアを用いて、仕様書とブラウザーの互換性の節にデータを挿入します（それぞれこれらの節の {{Specifications}} および {{Compat}} マクロを置き換えます）。

なお、最初の段階で Browser compat data リポジトリーに、プロパティとその仕様書の項目を作成/更新する必要があるかもしれません。項目の追加や編集の情報については、互換性一覧表のガイドを参照してください。

この説明文全体を削除してから公開してください。

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

非推奨;: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

非標準: この機能は標準ではなく、標準化の予定もありません。公開されているウェブサイトには使用しないでください。ユーザーによっては使用できないことがあります。実装ごとに大きな差があることもあり、将来は振る舞いが変わるかもしれません。

ページのコンテンツは導入段落から始めましょう。プロパティ名から始め、それが何をするのかを買いてください。これはできれば 1 つか 2 つの短い文章にしてください。

試してみましょう

このタイトルは {{EmbedInteractiveExample}} マクロで自動生成されます。

この節は {{EmbedInteractiveExample}} マクロを使用して追加したインタラクティブサンプルのためのものです。この例は mdn/interactive-examples リポジトリーに作成します。詳しくはガイドラインのインタラクティブサンプルの節を参照してください。

構成要素のプロパティ

この節は、 animation のような一括指定のプロパティにのみ追加し、関連する個別指定プロパティをすべて列挙します。

構文

一般的な用途をコードブロックとして記載し、完全な値を構成する成分のサブ値を記述します。

css

/* よくある用途を示すまたは値のカテゴリーを示す */
/* コードブロックを挿入します */

値

サブ値それぞれに 1 つずつ用語と定義を記載します。

subvalue1: サブ値の説明、データ型、何を表すかを記載します。
subvalue2: サブ値の説明、データ型、何を表すかを記載します。

解説

これは、このプロパティについての解説と、これがどのように動作するのかを説明するオプションの節です。この節を使用して、関連の用語を説明したり、プロパティの用途を追加したりします。

公式定義

{{CSSInfo}}

このマクロを使用するには、 Markdown ファイルの逆引用符とバックスラッシュを除去してください。

形式文法

{{CSSSyntax}}

このマクロを使用するには、 Markdown ファイルの逆引用符とバックスラッシュを除去してください。

例

英語版では、ページ内に例が 1 つしかない場合でも、複数形の "Examples" を使用していることに留意してください。

説明的な見出し

それぞれの例には、その例を説明する H3 見出し (###) がなければなりません。見出しは例が何を行っているかを説明するものであるべきです。例えば、「単純な例」というのは例について何も説明していないので、良い見出しとは言えません。見出しは簡潔であるべきです。より詳しい説明をする場合は、見出しの後の段落を使用してください。

詳しくは、サンプルコードを追加する方法のガイドをご覧ください。

メモ: 他のページで紹介されている例にリンクしたい場合もあるでしょう。

シナリオ 1: このページにいくつかの例があり、別のページにさらにいくつかの例がある場合。

このページのそれぞれの例に H3 見出し (###) を記載し、最後に H3 見出し (###) に「その他の例」というテキストを入れ、その下に他のページの例へのリンクを貼ることができます。例えば次のようにします。

## 例

### Fetch API の使用

Fetch の例

### その他の例

他のページにある他の例へのリンク

シナリオ 2: このページには何も例がなく、他のページにだけある場合。

H3 の見出しは追加せず、 H2 の見出し「例」の下に直接リンクを追加してください。例えば次のようにします。

## 例

この API の例については、[fetch() のページ](https://example.org)を参照してください。