Merge "Docs: Update to Japanese localization of Material Design docs." into mnc-docs (066b4acf) · Commits · e / os / android_frameworks_base

docs/html-intl/intl/ja/design/material/index.jd

+35 −35

Original line number	Diff line number	Diff line
		page.title=マテリアルデザイン
		page.title=Android のマテリアルデザイン
		page.tags=Material,design
		page.type=design
		page.image=design/material/images/MaterialLight.png
		page.type=デザイン
		page.image=images/cards/design-material-for-android_2x.jpg

		@jd:body

		<!-- developer docs box -->
		<a class="notice-developers right" href="{@docRoot}training/material/index.html">
		<div>
		<h3>デベロッパー文書</h3>
		<p>マテリアルデザインを使ったアプリの作成</p>
		<h3>デベロッパードキュメント</h3>
		<p>マテリアルデザインを使用したアプリの作成</p>
		</div>
		</a>

		@@ -39,27 +39,27 @@ page.image=design/material/images/MaterialLight.png



		<p itemprop="description">マテリアルデザインは、視覚や動作と、複数のプラットフォームや端末間でのインタラクションデザインに関する包括的な指針です。
		<p itemprop="description">マテリアルデザインは、複数のプラットフォームや端末の視覚、モーション、インタラクションデザインの包括的な指針です。
		Android はマテリアルデザインアプリに対応するようになりました。
		Android アプリでマテリアルデザインを使うには、<a href="http://www.google.com/design/spec">マテリアルデザインの仕様</a>で説明されているガイドラインに従い、Android 5.0（API レベル 21）以降の新しいコンポーネントや機能を使用します。
		Android アプリでマテリアルデザインを使うには、<a href="http://www.google.com/design/spec">マテリアルデザインの仕様</a>で定義されているガイドラインに従い、Android 5.0（API レベル 21）以降の新しいコンポーネントや機能を使用します。

		</p>

		<p>Android にはマテリアルデザインの作成に使うことができる次の要素が用意されています。</p>
		<p>Android にはマテリアルデザインのアプリのビルドに使用できる次の要素が用意されています。</p>

		<ul>
		<li>新しいテーマ</li>
		<li>複雑なビュー用の新しいウィジェット</li>
		<li>複雑なビューに対応した新しいウィジェット</li>
		<li>カスタムのシャドウとアニメーション用の新しい API</li>
		</ul>

		<p>Android でのマテリアルデザインの実装については、<a href="{@docRoot}training/material/index.html">マテリアルデザインを使ったアプリの作成</a>をご覧ください。
		<p>Android でのマテリアルデザインの実装については、<a href="{@docRoot}training/material/index.html">マテリアルデザインを使用したアプリの作成</a>をご覧ください。
		</p>


		<h3>マテリアルテーマ</h3>

		<p>マテリアルテーマはアプリの新しいスタイルである、システムウィジェットを提供します。システムウィジェットを使ってカラーパレット、タッチフィードバックやアクティビティ遷移のためのデフォルトのアニメーションを指定できます。
		<p>マテリアルテーマには、アプリの新しいスタイルであるシステムウィジェットがあります。このシステムウィジェットを使うと、システムウィジェットのカラーパレットを設定したり、タッチフィードバックやアクティビティ遷移のためのデフォルトのアニメーションを設定したりできます。
		</p>

		<!-- two columns -->
		@@ -67,13 +67,13 @@ Android アプリでマテリアルデザインを使うには、<a href="http:
		<div style="float:left;width:250px;margin-left:40px;margin-right:60px;">
		<img src="{@docRoot}design/material/images/MaterialDark.png" width="500" height="238" />
		<div style="width:140px;margin:0 auto">
		<p style="margin-top:8px">暗色マテリアルテーマ</p>
		<p style="margin-top:8px">暗い色のマテリアルテーマ</p>
		</div>
		</div>
		<div style="float:left;width:250px;margin-right:0px;">
		<img src="{@docRoot}design/material/images/MaterialLight.png" width="500" height="238" />
		<div style="width:140px;margin:0 auto">
		<p style="margin-top:8px">明色マテリアルテーマ</p>
		<p style="margin-top:8px">明るい色のマテリアルテーマ</p>
		</div>
		</div>
		<br style="clear:left"/>
		@@ -85,19 +85,19 @@ Android アプリでマテリアルデザインを使うには、<a href="http:

		<h3>リストとカード</h3>

		<p>Android はマテリアルデザインのスタイルとアニメーションを含むカードとリストを表示する新しい 2 つのウィジェットを提供しています。
		<p>Android はマテリアルデザインのスタイルとアニメーションを含むカードとリストを表示する、次のような新しい 2 つのウィジェットを提供しています。
		</p>

		<!-- two columns -->
		<div style="width:700px;margin-top:25px;margin-bottom:20px">
		<div style="float:left;width:250px;margin-left:40px;margin-right:60px;">
		<img src="{@docRoot}design/material/images/list_mail.png" width="500" height="426" />
		<p><code>RecyclerView</code> ウィジェットは <code>ListView</code> のさらに柔軟なバージョンで、さまざまなレイアウトタイプをサポートしてパフォーマンスを向上します。
		</p>
		<p>新しい <code>RecyclerView</code> ウィジェットは <code>ListView</code>
		に比べてさらに柔軟に機能を追加できるようになっており、さまざまなレイアウトタイプをサポートしてパフォーマンスを向上させます。</p>
		</div>
		<div style="float:left;width:250px;margin-right:0px;">
		<img src="{@docRoot}design/material/images/card_travel.png" width="500" height="426" />
		<p>新しい <code>CardView</code> ウィジェットでは、外観や使用感が一貫しているカード内に重要な情報を表示できます。
		<p>新しい <code>CardView</code> ウィジェットではカードの外観や操作性が統一され、カード内の重要な情報を表示できるようになりました。
		</p>
		</div>
		<br style="clear:left"/>
		@@ -109,12 +109,12 @@ Android アプリでマテリアルデザインを使うには、<a href="http:

		<h3>シャドウの表示</h3>

		<p>X と Y プロパティに加え、Android のビューに Z プロパティが追加されました。
		この新しいプロパティはビューのエレベーションを表し、次を指定します。</p>
		<p>Android のビューに、X と Y のプロパティに加えて Z プロパティが追加されました。
		この新しいプロパティはビューのエレベーションを表し、次の要素を指定します。</p>

		<ul>
		<li>シャドウのサイズ: Z 値が高いビューほどキャストするシャドウのサイズが大きくなります。</li>
		<li>表示される順序: Z 値が高いビューほど他のビューより上位に表示されます。</li>
		<li>シャドウのサイズ: ビューの Z 値が高いほどシャドウのサイズが大きくなります。</li>
		<li>描画順序: ビューの Z 値が高いほど他のビューの前面に表示されます。</li>
		</ul>

		<div style="width:290px;margin-left:35px;float:right">
		@@ -136,33 +136,33 @@ Android アプリでマテリアルデザインを使うには、<a href="http:

		<h3>アニメーション</h3>

		<p>新しいアニメーション API を使って UI コントロールのタッチフィードバック、ビューの状態遷移、アクティビティ遷移のカスタムアニメーションを作成できます。
		<p>新しいアニメーション API を使って、UI コントロールのタッチフィードバック、ビューの状態変化、アクティビティ間の遷移時のカスタムアニメーションを作成できます。
		</p>

		<p>これらの API で次の操作を実行できます。</p>
		<p>この API で次のようなことができます。</p>

		<ul>
		<li style="margin-bottom:15px">
		<strong>タッチフィードバック</strong> アニメーションを使ってビューのタップイベントに応答します。
		<strong>タッチフィードバック</strong> アニメーションでビューのタップイベントに応答する。
		</li>
		<li style="margin-bottom:15px">
		<strong>円形状の出現</strong>アニメーションを使ってビューを表示 / 非表示にします。
		<strong>円形状の出現</strong>アニメーションを使ってビューを表示したり、非表示にしたりする。
		</li>
		<li style="margin-bottom:15px">
		カスタムの<strong>アクティビティ遷移</strong>アニメーションを使ってアクティビティを切り替えます。
		カスタムの<strong>アクティビティ遷移</strong>アニメーションを使ってアクティビティを切り替える。
		</li>
		<li style="margin-bottom:15px">
		<strong>曲線モーション</strong>を使ってより自然なアニメーションを作成します。
		<strong>曲線モーション</strong>を使ってより自然なアニメーションを作成する。
		</li>
		<li style="margin-bottom:15px">
		<strong>ビューの状態遷移</strong>アニメーションを使って 1 つ以上のビュープロパティの遷移を表現します。
		<strong>ビューの状態変化</strong>アニメーションを使って 1 つ以上のビュープロパティを変化させるアニメーションを作成する。
		</li>
		<li style="margin-bottom:15px">
		ビューの状態遷移間のアニメーションを<strong>状態リストドローアブル</strong>で表示します。
		ビューの状態を変化させるアニメーションを<strong>状態リストドローアブル</strong>で表示します。
		</li>
		</ul>

		<p>タッチフィードバックアニメーションはボタンなどの複数の標準ビューに組み込まれます。新しい API を使ってこれらのアニメーションをカスタマイズし、それらをカスタムビューに追加できます。
		<p>タッチフィードバックアニメーションはボタンなどの複数の標準ビューに組み込まれています。新しい API を使うと、これらのアニメーションをカスタマイズして、カスタムビューに追加できます。
		</p>

		<p>詳細については、<a href="{@docRoot}training/material/animations.html">カスタムアニメーションの定義</a>をご覧ください。
		@@ -171,12 +171,12 @@ Android アプリでマテリアルデザインを使うには、<a href="http:

		<h3>ドローアブル</h3>

		<p>次の新しいドローアブル機能を使ってマテリアルデザインアプリを実装できます。</p>
		<p>次の新しいドローアブル機能を使用してマテリアルデザインアプリを実装できます。</p>

		<ul>
		<li><strong>ベクター型ドローアブル</strong>は鮮明度を失わずに拡張でき、単色のアプリ内アイコンに最適です。
		<li><strong>ベクター型ドローアブル</strong>は定義を失わずにスケールできるので、単色のアプリアイコンに最適です。
		</li>
		<li><strong>ドローアブルによる着色</strong>を使ってビットマップをアルファマスクとして定義し、実行時にそれらのビットマップに色付けすることができます。
		<li><strong>ドローアブルによる着色</strong>を使ってビットマップをアルファマスクとして定義し、実行時にそのビットマップに色付けできます。
		</li>
		<li><strong>色の抽出</strong>を使ってビットマップ画像から代表色を自動的に抽出できます。
		</li>

docs/html-intl/intl/ja/training/material/animations.jd

+149 −54

File changed.

Preview size limit exceeded, changes collapsed.

docs/html-intl/intl/ja/training/material/compatibility.jd

+55 −21

Original line number	Diff line number	Diff line
		@@ -20,42 +20,63 @@ page.title=互換性の維持
		</div>


		<p>マテリアルテーマやカスタムのアクティビティ遷移など、マテリアルデザインの一部の機能は Android5.0（API レベル21）以降でのみ利用できます。ただし、マテリアルデザインをサポートし、以前のバージョンの Android を実行している端末と互換性がある端末でこれらの機能が実行されている場合は、機能を使用できるようにアプリを設計することが可能です。</p>
		<p>マテリアルテーマやカスタムのアクティビティ遷移など、マテリアルデザインの一部の機能は Android5.0（API レベル21）以降のみで利用できます。
		ただし、マテリアルデザインをサポートし、以前のバージョンの Android を実行している端末と互換性がある端末でこれらの機能が実行されている場合は、機能を使用できるようにアプリを設計することが可能です。

		</p>


		<h2 id="Theme">別のスタイルを定義する</h2>

		<p>マテリアルテーマをサポートしている端末ではマテリアルテーマを使用するようにアプリを構成できますが、同時に次のようにして以前のバージョンの Android を実行する端末向けに以前のテーマに戻すことができます。</p>
		<p>マテリアルテーマをサポートしている端末ではマテリアルテーマを使用するようにアプリを構成できますが、同時に次のようにして以前のバージョンの Android を実行する端末向けに以前のテーマに戻すことができます。
		</p>

		<ol>
		<li><code>res/values/styles.xml</code> で、以前のテーマ（Holo など）から継承するテーマを定義します。</li>
		<li><code>res/values-v21/styles.xml</code> で、マテリアルテーマから継承するテーマを上記と同じ名前で定義します。</li>
		<li>
		<code>res/values/styles.xml</code> で、以前のテーマ（Holo など）から継承するテーマを定義します。</li>
		<li>
		<code>res/values-v21/styles.xml</code> で、マテリアルテーマから継承するテーマを上記と同じ名前で定義します。</li>
		<li>マニフェストファイルでこのテーマをアプリのテーマとして設定します。</li>
		</ol>

		<p class="note"><strong>注:</strong> この方法で別のテーマを用意せずマテリアルテーマだけを使う場合、そのアプリは以前のバージョンの Android では実行できません。
		<p class="note"><strong>注:</strong> この方法で別のテーマを用意せずマテリアルテーマだけを使う場合、そのアプリは 5.0 よりも前のバージョンの Android では実行できません。


		</p>


		<h2 id="Layouts">別のレイアウトを提供する</h2>

		<p>マテリアルデザインのガイドラインに沿って設計したレイアウトでも、Android 5.0（API レベル 21）で導入された新しい XML 属性を一切使用していない場合は、以前のバージョンの Android でも問題なく表示されます。新しい XML 属性を使用している場合は、別のレイアウトを用意できます。以前のバージョンの Android でアプリが表示される方法をカスタマイズする目的で別のレイアウトを用意することも可能です。</p>
		<p>マテリアルデザインのガイドラインに沿って設計したレイアウトでも、Android 5.0（API レベル 21）で導入された新しい XML 属性を一切使用していない場合は、以前のバージョンの Android でも問題なく表示されます。

		<p>Android 5.0（API レベル 21）向けのレイアウトファイルを <code>res/layout-v21/</code> に作成し、以前のバージョンの Android 向けの別のレイアウトファイルを <code>res/layout/</code> に作成します。たとえば、<code>res/layout/my_activity.xml</code> は <code>res/layout-v21/my_activity.xml</code> の代替レイアウトになります。</p>
		新しい XML 属性を使用している場合は、別のレイアウトを用意できます。以前のバージョンの Android でアプリが表示される方法をカスタマイズする目的で別のレイアウトを用意することも可能です。
		</p>

		<p>Android 5.0（API レベル 21）向けのレイアウトファイルを <code>res/layout-v21/</code> に作成し、以前のバージョンの Android 向けの別のレイアウトファイルを
		<code>res/layout/</code> に作成します。
		たとえば、<code>res/layout/my_activity.xml</code> は <code>res/layout-v21/my_activity.xml</code> の代替レイアウトになります。
		</p>

		<p>コードの重複を避けるには、<code>res/values/</code> でスタイルを定義して <code>res/values-v21/</code> で新しい API 用にスタイルを修正します。それからスタイル継承を用いて、基本スタイルを <code>res/values/</code> で定義してそのスタイルを <code>res/values-v21/</code> で継承します。</p>
		<p>コードの重複を避けるには、<code>res/values/</code> でスタイルを定義して <code>res/values-v21/</code> で新しい API 用にスタイルを修正します。それからスタイル継承を用いて、基本スタイルを <code>res/values/</code> で定義して、そのスタイルを <code>res/values-v21/</code> で継承します。

		</p>


		<h2 id="SupportLib">サポートライブラリを使用する</h2>

		<p><a href="{@docRoot}tools/support-library/features.html#v7">v7 サポートライブラリ</a> r21 以降には、次のマテリアルデザイン機能が含まれています。</p>
		<p><a href="{@docRoot}tools/support-library/features.html#v7">v7 サポートライブラリ</a> r21 以降には、次のマテリアルデザイン機能が含まれています。
		</p>

		<ul>
		<li><code>Theme.AppCompat</code> テーマのいずれかを適用した場合の、システムウィジェット用の<a href="{@docRoot}training/material/theme.html">マテリアルデザインのスタイル</a>。</li>
		<li><code>Theme.AppCompat</code> テーマの<a href="{@docRoot}training/material/theme.html#ColorPalette">カラーパレットテーマ属性</a>。</li>
		<li><a href="{@docRoot}training/material/lists-cards.html#RecyclerView">データコレクションを表示する</a> {@link android.support.v7.widget.RecyclerView} ウィジェット。</li>
		<li><code>Theme.AppCompat</code> テーマのいずれかを適用した場合の、システムウィジェット用の<a href="{@docRoot}training/material/theme.html">マテリアルデザインのスタイル</a>。
		</li>
		<li><code>Theme.AppCompat</code> テーマの<a href="{@docRoot}training/material/theme.html#ColorPalette">カラーパレットテーマ属性</a>。
		</li>
		<li><a href="{@docRoot}training/material/lists-cards.html#RecyclerView">データコレクションを表示する</a> {@link android.support.v7.widget.RecyclerView} ウィジェット。
		</li>
		<li><a href="{@docRoot}training/material/lists-cards.html#CardView">カードを作成する</a> {@link android.support.v7.widget.CardView} ウィジェット。</li>
		<li><a href="{@docRoot}training/material/drawables.html#ColorExtract">画像から代表色を抽出する</a>{@link android.support.v7.graphics.Palette} クラス。</li>
		<li><a href="{@docRoot}training/material/drawables.html#ColorExtract">画像から代表色を抽出する</a> {@link android.support.v7.graphics.Palette} クラス。
		</li>
		</ul>

		<h3>システムウィジェット</h3>
		@@ -73,7 +94,8 @@ page.title=互換性の維持

		<h3>カラーパレット</h3>

		<p>Android v7 サポートライブラリでマテリアルデザインのスタイルを入手し、カラーパレットをカスタマイズするには、次のように <code>Theme.AppCompat</code> テーマのいずれかを適用します。</p>
		<p>Android v7 サポートライブラリでマテリアルデザインのスタイルを入手し、カラーパレットをカスタマイズするには、次のように <code>Theme.AppCompat</code> テーマのいずれかを適用します。
		</p>

		<pre>
		<!-- extend one of the Theme.AppCompat themes -->
		@@ -87,16 +109,21 @@ page.title=互換性の維持

		<h3>リストとカード</h3>

		<p>{@link android.support.v7.widget.RecyclerView} ウィジェットや{@link android.support.v7.widget.CardView} ウィジェットは Android v7 サポートライブラリを通じて以前のバージョンの Android でも使用できますが、次のような制限があります。</p>
		<p>{@link android.support.v7.widget.RecyclerView} ウィジェットや {@link
		android.support.v7.widget.CardView} ウィジェットは Android v7 サポートライブラリを通じて以前のバージョンの Android でも使用できますが、次のような制限があります。
		</p>
		<ul>
		<li>{@link android.support.v7.widget.CardView} は、付加的なパディングを使い、プログラムでシャドウを実装するものになります。</li>
		<li>{@link android.support.v7.widget.CardView} によって、丸い角と交差する子ビューがクリップされることはありません。</li>
		<li>{@link android.support.v7.widget.CardView} は、付加的なパディングを使い、プログラムでシャドウを実装するものになります。
		</li>
		<li>{@link android.support.v7.widget.CardView} によって、丸い角と交差する子ビューがクリップされることはありません。
		</li>
		</ul>


		<h3>依存関係</h3>

		<p>5.0（API レベル 21）より前のバージョンの Android でこれらの機能を使用するには、Android v7 サポートライブラリを <a href="{@docRoot}/sdk/installing/studio-build.html#dependencies">Gradle dependency</a> としてプロジェクトに含めます。</p>
		<p>5.0（API レベル 21）より前のバージョンの Android でこれらの機能を使用するには、Android v7 サポートライブラリを <a href="{@docRoot}/sdk/installing/studio-build.html#dependencies">Gradle 依存関係</a>としてプロジェクトに含めます。
		</p>

		<pre>
		dependencies {
		@@ -120,7 +147,9 @@ dependencies {
		<li>ドローアブルによる着色</li>
		</ul>

		<p>以前のバージョンの Android との互換性を維持するには、上記の機能に対する API を起動する前に、システム {@link android.os.Build.VERSION#SDK_INT version} を実行時に確認します。</p>
		<p>以前のバージョンの Android との互換性を維持するには、上記の機能に対する API を起動する前に、システム {@link
		android.os.Build.VERSION#SDK_INT version} を実行時に確認します。
		</p>

		<pre>
		// Check if we're running on Android 5.0 or higher
		@@ -131,4 +160,9 @@ if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
		}
		</pre>

		<p class="note"><strong>注:</strong> アプリがサポートする Android のバージョンを指定するには、マニフェストファイルで <code>android:minSdkVersion</code> 属性と <code>android:targetSdkVersion</code> 属性を使用します。Android 5.0 でマテリアルデザインの機能を使用するには、<code>android:targetSdkVersion</code> 属性を <code>21</code> に設定します。詳細については、<a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html"><uses-sdk> API ガイド</a>をご覧ください。</p>
		No newline at end of file
		<p class="note"><strong>注: </strong>アプリがサポートする Android のバージョンを指定するには、マニフェストファイルで <code>android:minSdkVersion</code> 属性と <code>android:targetSdkVersion</code>
		属性を使用します。
		Android 5.0 でマテリアルデザインの機能を使用するには、<code>android:targetSdkVersion</code> 属性を <code>21</code> に設定します。
		詳細については、<a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html"><uses-sdk> API ガイド</a>をご覧ください。

		</p>

docs/html-intl/intl/ja/training/material/drawables.jd

+34 −13

File changed.

Preview size limit exceeded, changes collapsed.

docs/html-intl/intl/ja/training/material/get-started.jd

+41 −17

File changed.

Preview size limit exceeded, changes collapsed.