aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/manifest/icons/index.md
blob: d94edad8917892d8c9414ffa54c7879dcedc5933 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
---
title: icons
slug: Web/Manifest/icons
tags:
  - Icons
  - Manifest
  - Web
  - マニフェスト
translation_of: Web/Manifest/icons
---
<div>{{QuickLinksWithSubpages("/ja/docs/Web/Manifest")}}</div>

<table class="properties">
 <tbody>
  <tr>
   <th scope="row">型</th>
   <td>配列 (<code>Array</code>)</td>
  </tr>
  <tr>
   <th scope="row">必須</th>
   <td>はい</td>
  </tr>
 </tbody>
</table>

<p><code>icons</code> メンバーは、様々なコンテキストでアプリケーションアイコンとして機能する画像ファイルを表すオブジェクトの配列を指定します。例えば、他のアプリケーションのリストの中でウェブアプリケーションを表現したり、ウェブアプリケーションを <abbr title="operating system">OS</abbr> のタスクマネージャーやシステム環境設定と統合したりするために使用することができます。</p>

<h2 id="Examples" name="Examples">例</h2>

<pre class="brush: json">"icons": [
  {
    "src": "icon/lowres.webp",
    "sizes": "48x48",
    "type": "image/webp"
  },
  {
    "src": "icon/lowres",
    "sizes": "48x48"
  },
  {
    "src": "icon/hd_hi.ico",
    "sizes": "72x72 96x96 128x128 256x256"
  },
  {
    "src": "icon/hd_hi.svg",
    "sizes": "72x72"
  }
]</pre>

<h2 id="Values" name="Values">値</h2>

<p>画像オブジェクトには、次の値を入れることができます。</p>

<table class="fullwidth-table standard-table">
 <thead>
  <tr>
   <th scope="col">メンバー</th>
   <th scope="col">説明</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td><code>sizes</code></td>
   <td>画像の寸法を空白区切りで指定する文字列です。</td>
  </tr>
  <tr>
   <td><code>src</code></td>
   <td>画像ファイルへのパスです。 <code>src</code> が相対 URL である場合、基準 URL はマニフェストの URL です。</td>
  </tr>
  <tr>
   <td><code>type</code></td>
   <td>画像のメディア種別のヒントです。このメンバーは、ユーザーエージェントが対応していないメディア種別の画像を素早く無視することができるようにするためのものです。</td>
  </tr>
  <tr>
   <td><code>purpose</code></td>
   <td>
   <p>画像の目的を定義します。例えば、画像がホスト OS の特定の場面で、特別な目的を果たすことを意図している場合などです (すなわち、よりよく統合するため)。</p>

   <p><a href="https://w3c.github.io/manifest/#purpose-member"><code>purpose</code></a> は以下の値を1つ以上、空白で区切って指定することができます。</p>

   <ul>
    <li><code>badge</code>: ユーザーエージェントは、アプリケーションアイコンと異なるスペースの制約や色の要件がある場合に、このアイコンを表示することができます。</li>
    <li><code>maskable</code>:  画像が<a href="https://w3c.github.io/manifest/#icon-masks">アイコンのマスクと安全領域</a>に配慮して設計されており、画像の安全領域外の部分をユーザーエージェントが無視したりマスクしたりしても安全になるようになっています。</li>
    <li><code>any</code>: ユーザーエージェントはどのような場合でも、自由にこのアイコンを表示することができます (これが既定値です)。</li>
   </ul>
   </td>
  </tr>
 </tbody>
</table>

<h2 id="Specification" name="Specification">仕様書</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">仕様書</th>
   <th scope="col">状態</th>
   <th scope="col">備考</th>
   <th scope="col">フィードバック</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>
    <p>{{SpecName('Manifest', '#icons-member', 'icons')}}</p>
   </td>
   <td>
    <p>{{Spec2('Manifest')}}</p>
   </td>
   <td>
    <p>初回定義</p>
   </td>
   <td>
    <p><a href="https://github.com/w3c/manifest/issues/">Web App Manifest Working Group drafts</a></p>
   </td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>

<p>{{Compat("html.manifest.icons")}}</p>