From d9f3b1168a5e1ccfd158652587d647538b244a85 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 23 Aug 2021 13:22:14 +0900 Subject: Web/HTML/Element/meta/name を更新 (#2075) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 2021/06/01 時点の英語版に同期 --- files/ja/web/html/element/meta/name/index.html | 199 +++++++++++-------------- 1 file changed, 88 insertions(+), 111 deletions(-) (limited to 'files/ja/web/html') diff --git a/files/ja/web/html/element/meta/name/index.html b/files/ja/web/html/element/meta/name/index.html index 0986662e6d..898b88c7bb 100644 --- a/files/ja/web/html/element/meta/name/index.html +++ b/files/ja/web/html/element/meta/name/index.html @@ -7,13 +7,14 @@ tags: - HTML document metadata - Reference - metadata +browser-compat: html.elements.meta.name translation_of: Web/HTML/Element/meta/name ---
{{HTMLRef}}
-

{{htmlelement("meta")}} 要素を使用して、文書のメタデータを名前と値の組み合わせで提供することができ、 {{htmlattrxref("name", "meta")}} 属性はメタデータ名を指定し、 {{htmlattrxref("content", "meta")}} 属性は値を指定します。

+

{{htmlelement("meta")}} 要素を使用すると、文書のメタデータを名前と値の組み合わせで提供することができます。 {{htmlattrxref("name", "meta")}} 属性でメタデータ名を指定し、 {{htmlattrxref("content", "meta")}} 属性で値を指定します。

-

HTML 仕様書で定義されている標準メタデータ名

+

HTML 仕様書で定義されている標準メタデータ名

HTML 仕様書は、以下の一連の標準メタデータ名を定義しています。

@@ -21,7 +22,7 @@ translation_of: Web/HTML/Element/meta/name

  • application-name: ウェブページで動作しているアプリケーションの名前です。

    -
    注: +
    メモ:
    • ブラウザーはアプリケーションを識別するためにこれを使用することがあります。これはふつうアプリケーション名が含まれるものの、文書名や状態などの情報も含まれる {{HTMLElement("title")}} 要素とは異なります。
      • @@ -72,198 +73,193 @@ translation_of: Web/HTML/Element/meta/name -
      注: +
      メモ:
        -
      • Dynamically inserting <meta name="referrer"> (with {{domxref("Document.write", "document.write()")}} or {{domxref("Node.appendChild", "appendChild()")}}) makes the referrer behaviour unpredictable.
        • -
      • When several conflicting policies are defined, the no-referrer policy is applied.
        • +
      • <meta name="referrer"> を ({{domxref("Document.write", "document.write()")}} または {{domxref("Node.appendChild", "appendChild()")}} で) 動的に挿入すると、リファラーの動作が予測不能になります。
        • +
      • 相反する複数のポリシーが定義されている場合は、 no-referrer ポリシーが適用されます。
      -
    • theme-color: indicates a suggested color that user agents should use to customize the display of the page or of the surrounding user interface. The content attribute contains a valid CSS {{cssxref("<color>")}}.
      • -
    - -

    他の仕様書で定義されている標準メタデータ名

    - -

    The CSS Color Adjustment specification defines the following metadata name:

    - -
      +
    • theme-color: ユーザーエージェントがページの表示や周辺のユーザーインターフェースをカスタマイズするために使用すべき推奨色を示します。 content 属性には、有効な CSS の {{cssxref("<color>")}} が含まれます。
    • -

      color-scheme: specifies one or more color schemes with which the document is compatible.

      +

      color-scheme: 文書と互換性のある 1 つ以上の複数のカラースキームを指定します。

      -

      The browser will use this information in tandem with the user's browser or device settings to determine what colors to use for everything from background and foregrounds to form controls and scrollbars. The primary use for <meta name="color-scheme"> is to indicate compatibility with—and order of preference for—light and dark color modes.

      +

      ブラウザーは、この情報をユーザーのブラウザーや端末の設定と合わせて使用し、背景や前景、フォームコントロールやスクロールバーなど、あらゆるものに使用する色を決定します。 <meta name="color-scheme"> の主な用途は、ライトモードとダークモードの互換性と優先順位を示すことです。

      -

      The value of the {{htmlattrxref("content", "meta")}} property for color-scheme may be one of the following:

      +

      color-scheme の {{htmlattrxref("content", "meta")}} プロパティは次のうちの一つになります。

      normal
      -
      The document is unaware of color schemes and should simply be rendered using the default color palette.
      +
      この文書は配色を意識していないので、既定のカラーパレットを使って描画する必要があります。
      [light | dark]+
      -
      One or more color schemes supported by the document. Specifying the same color scheme more than once has the same effect as specifying it only once. Indicating multiple color schemes indicates that the first scheme is preferred by the document, but that the second specified scheme is acceptable if the user prefers it.
      +
      この文書で対応している 1 つ以上の配色。同じ配色を 2 回以上指定しても、 1 回だけ指定した場合と同じ効果が得られる。複数の配色を指定すると、この文書では最初の配色が優先されるが、ユーザーが好む場合は 2 番目に指定された配色でもよいことを示す。
      only light
      -
      Indicates that the document only supports light mode, with a light background and dark foreground colors. By specification, only dark is not valid, because forcing a document to render in dark mode when it isn't truly compatible with it can result in unreadable content; all major browsers default to light mode if not otherwise configured.
      +
      この文書がライトモードのみに対応していることを示します。背景色が明るく、前景色が暗い色です。仕様書によれば、 only dark は有効ではありません。ダークモードに対応していない文書を強制的にダークモードで描画すると、コンテンツが読めなくなる可能性があるからです。主要なブラウザーは、特に設定されていなければ既定でライトモードになります。
      -

      For example, to indicate that a document prefers dark mode but does render functionally in light mode as well:

      +

      例えば、この文書はダークモードを推奨するが、ライトモードでも機能的にはレンダリングできることを示すためには、次のようにします。

      - 
      <meta name="color-scheme" content="dark light">
      + 
      <meta name="color-scheme" content="dark light">
      -

      This works at the document level in the same way that the CSS {{cssxref("color-scheme")}} property lets individual elements specify their preferred and accepted color schemes. Your styles can adapt to the current color scheme using the {{cssxref("@media/prefers-color-scheme", "prefers-color-scheme")}} CSS media feature.

      +

      これは、CSS の {{cssxref("color-scheme")}} プロパティで個々の要素が好みの配色と受け入れられる配色を指定できるのと同じように、文書レベルで機能します。スタイルは、 {{cssxref("@media/prefers-color-scheme", "prefers-color-scheme")}} という CSS メディア機能を使って、現在の配色に合わせることができます。

    -

    The CSS Device Adaptation specification defines the following metadata name:

    +

    他の仕様書で定義されている標準メタデータ

    + +

    CSS Device Adaptation 仕様書は、以下のメタデータ名を定義しています。

    • -

      viewport: gives hints about the size of the initial size of the {{glossary("viewport")}}. Used by mobile devices only.

      +

      viewport: この{{glossary("viewport", "ビューポート")}}の初期の寸法の大きさについてのヒントを指定します。モバイル端末でのみ使用されます。

      - + - + - - + + - - + + - - + + - - + + - - + + - - + + - +
      Values for the content of <meta name="viewport"><meta name="viewport"> の content の値
      値Possible subvalues使用可能なサブ値 解説
      widthA positive integer number, or the text device-widthDefines the pixel width of the viewport that you want the web site to be rendered at.正の整数値、または device-width のテキストウェブサイトを表示させるビューポートのピクセル単位の幅を定義します。
      heightA positive integer, or the text device-heightDefines the height of the viewport. Not used by any browser.正の整数値、または device-height のテキストビューポートの高さを定義します。どのブラウザーでも使用されていません。
      initial-scaleA positive number between 0.0 and 10.0Defines the ratio between the device width (device-width in portrait mode or device-height in landscape mode) and the viewport size.0.0 と 10.0 の間の正の実数端末の幅 (縦長画面で device-width、横長画面で device-height) とビューポートの寸法の比率を定義します。
      maximum-scaleA positive number between 0.0 and 10.0Defines the maximum amount to zoom in. It must be greater or equal to the minimum-scale or the behaviour is undefined. Browser settings can ignore this rule and iOS10+ ignores it by default.0.0 と 10.0 の間の正の実数拡大縮小インする最大値を定義します。 minimum-scale 以上でなければ、動作は未定義です。ブラウザーの設定でこの規則を無視することができ、iOS 10 以降では既定で無視されます。
      minimum-scaleA positive number between 0.0 and 10.0Defines the minimum zoom level. It must be smaller or equal to the maximum-scale or the behaviour is undefined. Browser settings can ignore this rule and iOS10+ ignores it by default.0.0 と 10.0 の間の正の実数拡大縮小レベルの最小値を定義します。 maximum-scale 以下でなければ、動作は未定義です。ブラウザーの設定でこの規則を無視することができ、iOS 10 以降では既定で無視されます。
      user-scalableyes or noIf set to no, the user is not able to zoom in the webpage. The default is yes. Browser settings can ignore this rule, and iOS10+ ignores it by default.yes または nono に設定された場合は、ユーザーがウェブページを拡大縮小することができなくなります。既定値は yes です。ブラウザーの設定でこの規則を無視することができ、iOS 10 以降では既定で無視されます。
      viewport-fitauto, contain or coverauto, contain, cover -

      The auto value doesn’t affect the initial layout viewport, and the whole web page is viewable.

      +

      auto の値は、初期レイアウトのビューポートに影響を与えず、ウェブページ全体が表示されます。

      -

      The contain value means that the viewport is scaled to fit the largest rectangle inscribed within the display.

      +

      contain の値は、ディスプレイに内接する最大の長方形に合わせてビューポートが拡大されることを意味します。

      -

      The cover value means that the viewport is scaled to fill the device display. It is highly recommended to make use of the safe area inset variables to ensure that important content doesn't end up outside the display.

      +

      cover の値は、ビューポートが端末のディスプレイいっぱいになるように縮小されることを意味します。重要なコンテンツがディスプレイの外に出てしまわないように、 safe-area-inset-* 変数を使用することを強くお勧めします。
      -
      Notes: +
      メモ:
        -
      • Though unstandardized, this declaration is respected by most mobile browsers due to de-facto dominance.
        • -
      • The default values may vary between devices and browsers.
        • -
      • To learn about this declaration in Firefox for Mobile, see this article.
        • +
      • この宣言は標準化されていませんが、事実上の優位性から、ほとんどのモバイルブラウザーで尊重されています。
        • +
      • 既定値は、端末やブラウザーによって異なる場合があります。
        • +
      • Firefox for Mobile でのこの宣言については、こちらの記事を参照してください。
      -
      ビューポートの拡大縮小についてのアクセシビリティの考慮
      +
      ビューポートの拡大縮小についてのアクセシビリティの考慮
      -
      Disabling zooming capabilities by setting user-scalable to a value of no prevents people experiencing low vision conditions from being able to read and understand page content.
      +
      user-scalable を no に設定して拡大縮小機能を無効にすると、弱視の人がページの内容を読んだり理解したりすることができなくなります。
      -
      関連情報
      +
      関連情報
      -

      The @viewport CSS at-rule.

      +

      CSS の @viewport アット規則

    -

    その他のメタデータ名

    +

    その他のメタデータ名

    -

    The WHATWG Wiki MetaExtensions page contains a large set of non-standard metadata names that have not been formally accepted yet; however, some of the names included there are already used quite commonly in practice — including the following:

    +

    WHATWG Wiki の MetaExtensions のページには、まだ正式に受け入れられていない標準外のメタデータの名前が多数掲載されています。しかし、ここに掲載されている名前の中には、以下のように、すでに実際によく使われているものもあります。

      -
    • creator: the name of the creator of the document, such as an organization or institution. If there are more than one, several {{HTMLElement("meta")}} elements should be used.
      • -
    • googlebot, a synonym of robots, is only followed by Googlebot (the indexing crawler for Google).
      • -
    • publisher: the name of the document's publisher.
      • -
    • robots: the behaviour that cooperative crawlers, or "robots", should use with the page. It is a comma-separated list of the values below: +
    • creator: この文書の作成者の名前で、組織や機関などです。複数ある場合は、複数の {{HTMLElement("meta")}} 要素を使用する必要があります。
      • +
    • googlebot: robots と同様ですが、Googlebot (Google のインデックス作成用クローラー) のみが従います。
      • +
    • publisher: この文書の発行者の名前です。
      • +
    • robots: 協力的なクローラー、つまり「ロボット」がページに対して使用すべき動作です。以下の値をカンマで区切ったリストです。 - + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +
      Values for the content of <meta name="robots">
      値 解説Used by使用者
      indexAllows the robot to index the page (default).Allロボットがこのページをインデックスすることを許可します (既定値)。すべて
      noindexRequests the robot to not index the page.Allロボットにこのページをインデックスしないよう要求します。すべて
      followAllows the robot to follow the links on the page (default).Allロボットがこのページ上のリンクをたどることを許可します (既定値)。すべて
      nofollowRequests the robot to not follow the links on the page.Allロボットにこのページ上のリンクをたどらないよう要求します。すべて
      allEquivalent to index, followGoogleindex, follow と同等です。Google
      noneEquivalent to noindex, nofollowGooglenoindex, nofollow と同等です。Google
      noarchiveRequests the search engine not to cache the page content.Google, Yahoo, Bing検索エンジンにこのページの内容をキャッシュしないよう要求します。Google, Yahoo, Bing
      nosnippetPrevents displaying any description of the page in search engine results.Google, Bing検索エンジンの結果でこのページの説明の表示を抑制します。Google, Bing
      noimageindexRequests this page not to appear as the referring page of an indexed image.Googleこのページをインデックスされた画像の参照ページとして表示しないよう要求します。Google
      nocacheSynonym of noarchive.Bingnoarchive と同等です。Bing
      @@ -271,40 +267,21 @@ translation_of: Web/HTML/Element/meta/name
      Notes:
        -
      • Only cooperative robots follow these rules. Do not expect to prevent e-mail harvesters with them.
        • -
      • The robot still needs to access the page in order to read these rules. To prevent bandwidth consumption, use a {{Glossary("robots.txt")}} file.
        • -
      • If you want to remove a page, noindex will work, but only after the robot visits the page again. Ensure that the robots.txt file is not preventing revisits.
        • -
      • Some values are mutually exclusive, like index and noindex, or follow and nofollow. In these cases the robot's behaviour is undefined and may vary between them.
        • -
      • Some crawler robots, like Google, Yahoo and Bing, support the same values for the HTTP header X-Robots-Tag; this allows non-HTML documents like images to use these rules.
        • +
      • 協力的なロボットだけがこのルールに従っています。メールアドレスの自動収集プログラムを抑制できるとは期待しないでください。
        • +
      • ロボットがこれらのルールを読むためには、ページにアクセスする必要があります。帯域幅の消費を防ぐには、 {{Glossary("robots.txt")}} ファイルを使用してください。
        • +
      • ページを削除したい場合、 noindex で行うことができますが、ロボットがそのページに再びアクセスした後のことになります。 robots.txt ファイルが再訪問を妨害していないことを確認してください。
        • +
      • 値によっては互いに排他的なものがあります。例えば index と noindex、 follow と nofollow などです。このような場合、ロボットの動作は未定義であり、ロボット間で異なる可能性があります。
        • +
      • Google、Yahoo、Bing など一部のクローラーロボットでは、 HTTP ヘッダーの X-Robots-Tag で提供された同じ値に対応しているものがあります。これにより、画像などの HTML 以外の文書でもこれらの規則を使用することができます。
    -

    仕様書

    - - - - - - - - - - - - - - - - - - - - - -
    仕様書
    {{SpecName('HTML WHATWG', '#standard-metadata-names', 'standard metadata names')}}
    {{SpecName('CSS Color Adjust', '#color-scheme-meta', 'the "color-scheme" metadata name')}}
    {{SpecName('CSS3 Device', '#viewport-meta', 'the "viewport" metadata name')}}
    {{SpecName('Referrer Policy', '#referrer-policy-delivery-meta', 'the "referrer" metadata name')}}
    - -

    ブラウザーの互換性

    - -

    {{Compat("html.elements.meta.name")}}

    +

    仕様書

    + +

    {{Specifications}}

    + +

    ブラウザーの互換性

    + +

    {{Compat}}

    + -- cgit v1.2.3-54-g00ecf