このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

quotes

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年9月⁩.

CSSquotes プロパティは、HTML の <q> 要素に自動的に追加される引用符、または CSS の content プロパティの open-quotes または close-quotes 値を使用して追加される引用符(no-open-quote および no-close-quote を使用して省略される場合もあります)を、ブラウザーがどのようにレンダリングするかを設定します。

試してみましょう

quotes: none;
quotes: initial;
quotes: "'" "'";
quotes: "„" "“" "‚" "‘";
quotes: "«" "»" "‹" "›";
<section id="default-example">
  <q id="example-element"
    >Show us the wonder-working <q>Brothers,</q> let them come out publicly—and
    we will believe in them!</q
  >
</section>
q {
  font-size: 1.2rem;
}

ブラウザーは、 <q> 要素の開始と終了、および content プロパティの open-quote および close-quote 値に引用符を挿入します。開始引用符および終了引用符は、入れ子の深さに基づいて quotes の値から 1 つの文字列に置き換えられます。または、quotes が明示的に auto に設定されているか、auto に解決される場合、使用される引用符は言語に依存します。

構文

css
/* キーワード値 */
quotes: none;
quotes: auto;

/* <string> 値 */
quotes: "«" "»"; /* open-quote および close-quote をフランス語の引用符に設定 */
quotes: "«" "»" "‹" "›"; /* 2 レベルの引用符を設定 */

/* グローバル値 */
quotes: inherit;
quotes: initial;
quotes: revert;
quotes: revert-layer;
quotes: unset;

none

content プロパティの open-quote および close-quote の値で、 no-open-quoteno-close-quote が設定されていた時のように、引用符を生成しません。

auto

選択された要素に設定された言語の値(すなわち、 lang 属性)で使用される適切な引用符が使用されます。

<string>

引用符の開始と終了の引用符の値のペアを 1 つ以上定義します。各ペアでは、各ペアの最初の引用符は open-quote の値として使用され、2 つ目の引用符は close-quote となります。

最初のペアは引用符の外側のレベルを表します。 2 つ目のペアが存在する場合、それは最初の内側レベルを表します。次のペアは 2 つ目の内側レベルに使用される、といった具合に続きます。引用符の入れ子の深さがペアの数よりも大きい場合、 quotes 値の最後のペアが繰り返されます。

どの引用符のペアが使用されるかは、引用符の深さ、つまり入れ子レベルによって決まります。これは、現在の出現箇所までの、生成されたテキスト全体における <q> 引用符または open-quote (または no-open-quote) の出現回数から、</q>close-quoteno-close-quote として出現する閉じ引用符の出現回数を引いたものです。深さが 0 の場合は最初のペアが使用され、深さが 1 の場合は 2 つ目のペアが使用されます。

メモ: The CSS content property value open-quote increments and no-close-quote decrements the quoting level, but does not insert a quotation marks.

公式定義

初期値ユーザエージェントに依存
適用対象すべての要素
継承あり
計算値指定通り
アニメーションの種類離散値

形式文法

quotes = 
auto |
none |
match-parent |
[ <string> <string> ]+

既定の引用符と上書き

この例では、セマンティック HTML の <q> 要素によって提供される既定の引用符を、 CSS の quotes プロパティを使用して定義した引用符と比較しています。

quotes の既定値は auto です。この例では、最初のリスト項目には quotes: auto が設定されているため、指定された言語の既定の引用符が使用されます。これは、 quotes プロパティが設定されていない場合と同じです。2 番目のリスト項目は、引用符およびネストされた引用符に使用する引用符を定義します。これらの引用符は、言語に関係なく(lang 属性の値が設定されている場合と同様)、 specialQuotes クラスを持つ要素の子孫に使用されます。

HTML

html
<ul>
  <li>
    既定の引用符:
    <p lang="ru">
      <q
        >Митч Макконнелл - это человек, который знает о России и ее влиянии
        меньше, чем даже Дональд Трамп, и <q>я ничего не знаю</q>, сказал
        Трамп</q
      >, - писал Раджу.
    </p>
  </li>
  <li class="specialQuotes">
    <code>quotes</code> プロパティで指定されたもの:
    <p lang="ru">
      <q
        >Митч Макконнелл - это человек, который знает о России и ее влиянии
        меньше, чем даже Дональд Трамп, и <q>я ничего не знаю</q>, сказал
        Трамп</q
      >, - писал Раджу.
    </p>
  </li>
  <ul></ul>
</ul>

CSS

css
li {
  quotes: auto;
}

.specialQuotes {
  quotes: "“" "”" "‘" "’";
}

結果

既定では、 <q> 要素が使用されると、ブラウザーは言語に応じた引用符を提供します。 quotes プロパティが定義されている場合、指定された値がブラウザーの既定値を上書きします。 quotes プロパティは継承されることに注意してください。 quotes プロパティは、specialQuotes クラスを持つ <li> で設定されますが、引用符は <q> 要素に適用されます。

それぞれの開始引用符と終了引用符は、は、入れ子の深さに基づいて、引用符の値から 1 つの文字列に置き換えられます。

auto の引用符

quotes の既定値は auto です。この例では、明示的に設定しなくても動作します。

HTML

html
<ul>
  <li lang="ja">
    <q>これは日本語の引用です。</q>
  </li>
  <li lang="ru">
    <q>Это русская цитата</q>
  </li>
  <li lang="de">
    <q>Dies ist ein deutsches Zitat</q>
  </li>
  <li lang="en">
    <q>This is an English quote.</q>
  </li>
</ul>

CSS

css
q {
  quotes: auto;
}
li:not(:last-of-type) {
  border-bottom: 1px solid;
}

結果

lang 属性は、 <q> 自体ではなく、 <q> の親要素に配置されていることに注意してください。引用が周囲のテキストとは異なる言語で書かれている場合、その引用は、引用自体の言語ではなく、周囲のテキストの言語の引用符で引用するのが慣例です。

生成コンテンツによる方法

この例では、 <q> 要素を使用する代わりに、特定のクラス名を持つ各要素のコンテンツの前後に、 ::before および ::after 擬似要素に引用符を追加しています。

HTML

html
<p>
  <span class="quote">I should be using quotes</span>, I thought,
  <span class="quote"
    >But why use semantic HTML elements when I can add classes to
    <span class="quote">ALL THE THINGS!</span>?
  </span>
</p>

CSS

css
.quote {
  quotes: '"' '"' "'" "'";
}
.quote::before {
  content: open-quote;
}
.quote::after {
  content: close-quote;
}

結果

引用文および空の引用符としてのテキスト

この例では、 <string> 値として引用符以外の文字を使用しています。開始引用符は話者を示し、開始引用符がないため、終了引用符は空です。(<string> と列挙キーワードを混在させてペアを作成することには対応していません)。入れ子になった引用符には auto を設定します。これらの入れ子になった引用符は、その言語で入れ子になった引用符として通常使用される文字で囲まれます。

HTML

html
<ul>
  <li><q data-speaker="karen">Hello</q></li>
  <li><q data-speaker="chad">Hi</q></li>
  <li><q data-speaker="karen">this conversation is not interesting</q></li>
  <li>
    <q data-speaker="pat"
      >OMG! <q>Hi</q>? Seriously? at least <q>hello</q> is five letters long.</q
    >
  </li>
</ul>

CSS

css
[data-speaker="karen" i] {
  quotes: "She said: " "";
}
[data-speaker="chad" i] {
  quotes: "He said: " "";
}
[data-speaker="pat" i] {
  quotes: "They said: " "";
}
[data-speaker] q {
  quotes: auto;
}

結果

仕様書

Specification
CSS Generated Content Module Level 3
# quotes

ブラウザーの互換性

関連情報