diff options
Diffstat (limited to 'docs/html/training/basics/fragments/creating.jd')
| -rw-r--r-- | docs/html/training/basics/fragments/creating.jd | 37 |
1 files changed, 26 insertions, 11 deletions
diff --git a/docs/html/training/basics/fragments/creating.jd b/docs/html/training/basics/fragments/creating.jd index b5df4e1..377adfc 100644 --- a/docs/html/training/basics/fragments/creating.jd +++ b/docs/html/training/basics/fragments/creating.jd @@ -6,7 +6,7 @@ trainingnavtop=true <div id="tb-wrapper"> <div id="tb"> - + <h2>This lesson teaches you to</h2> <ol> <li><a href="#Create">Create a Fragment Class</a></li> @@ -19,7 +19,7 @@ trainingnavtop=true </ul> <h2>Try it out</h2> - + <div class="download-box"> <a href="http://developer.android.com/shareables/training/FragmentBasics.zip" class="button">Download the sample</a> @@ -32,21 +32,30 @@ class="button">Download the sample</a> <p>You can think of a fragment as a modular section of an activity, which has its own lifecycle, receives its own input events, and which you can add or remove while the activity is running (sort of like a "sub activity" that you can reuse in different activities). This lesson shows how to -extend the {@link android.support.v4.app.Fragment} class using the Support Library so your app -remains compatible with devices running system versions as old as Android 1.6.</p> +extend the {@link android.support.v4.app.Fragment} class using the <a +href="{@docRoot}tools/support-library/index.html">Support Library</a> so your app +remains compatible with devices running system versions as low as Android 1.6.</p> -<p class="note"><strong>Note:</strong> If you decide for other reasons that the minimum +<p class="note"><strong>Note:</strong> If you decide that the minimum API level your app requires is 11 or higher, you don't need to use the Support Library and can instead use the framework's built in {@link android.app.Fragment} class and related APIs. Just be aware that this lesson is focused on using the APIs from the Support Library, which use a specific package signature and sometimes slightly different API names than the versions included in the platform.</p> +<p>Before you begin this lesson, you must set up your Android project to use the Support Library. +If you have not used the Support Library before, set up your project to use the <strong>v4</strong> +library by following the <a href="{@docRoot}tools/support-library/setup.html">Support Library +Setup</a> document. However, you can also include the <a href= +"{@docRoot}guide/topics/ui/actionbar.html">action bar</a> in your activities by instead using the +<strong>v7 appcompat</strong> library, which is compatible with Android 2.1 (API level 7) +and also includes the {@link android.support.v4.app.Fragment} APIs.</p> + <h2 id="Create">Create a Fragment Class</h2> -<p>To create a fragment, extend the {@link android.support.v4.app.Fragment} class, then override +<p>To create a fragment, extend the {@link android.support.v4.app.Fragment} class, then override key lifecycle methods to insert your app logic, similar to the way you would with an {@link android.app.Activity} class.</p> @@ -63,7 +72,7 @@ import android.view.ViewGroup; public class ArticleFragment extends Fragment { @Override - public View onCreateView(LayoutInflater inflater, ViewGroup container, + public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { // Inflate the layout for this fragment return inflater.inflate(R.layout.article_view, container, false); @@ -82,7 +91,7 @@ href="{@docRoot}guide/components/fragments.html">Fragments</a> developer guide.< -<h2 id="AddInLayout">Add a Fragment to an Activity using XML</h2> +<h2 id="AddInLayout">Add a Fragment to an Activity using XML</h2> <p>While fragments are reusable, modular UI components, each instance of a {@link android.support.v4.app.Fragment} class must be associated with a parent {@link @@ -98,7 +107,7 @@ regular {@link android.app.Activity}.</p> screen is considered "large" (specified by the <code>large</code> qualifier in the directory name).</p> -<p><code>res/layout-large/news_articles.xml:</code></p> +<p class="code-caption">res/layout-large/news_articles.xml</p> <pre> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="horizontal" @@ -120,11 +129,11 @@ name).</p> </LinearLayout> </pre> -<p class="note"><strong>Tip:</strong> For more information about creating layouts for different +<p class="note"><strong>Tip:</strong> For more about creating layouts for different screen sizes, read <a href="{@docRoot}training/multiscreen/screensizes.html">Supporting Different Screen Sizes</a>.</p> -<p>Here's how an activity applies this layout:</p> +<p>Then apply the layout to your activity:</p> <pre> import android.os.Bundle; @@ -139,6 +148,12 @@ public class MainActivity extends FragmentActivity { } </pre> +<p>If you're using the <a href="{@docRoot}tools/support-library/features.html#v7-appcompat">v7 +appcompat library</a>, your activity should instead extend {@link +android.support.v7.app.ActionBarActivity}, which is a subclass of {@link +android.support.v4.app.FragmentActivity} (for more information, +read <a href="{@docRoot}training/basics/actionbar/index.html">Adding the Action Bar</a>).</p> + <p class="note"><strong>Note:</strong> When you add a fragment to an activity layout by defining the fragment in the layout XML file, you <em>cannot</em> remove the fragment at runtime. If you plan |