Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit a7d825dd authored by Roman Nurik's avatar Roman Nurik Committed by Android Git Automerger
Browse files

am c3998ced: Merge "Update widget design guidelines for padding and 8dp." into ics-mr0 

* commit 'c3998ced':
  Update widget design guidelines for padding and 8dp.
parents 1a1be44c c3998ced

docs/html/guide/practices/ui_guidelines/widget_design.jd

+7 −5
Original line number Diff line number Diff line
@@ -250,13 +250,15 @@ android.widget.FrameLayout}. Just as your activity layouts must adapt to differe 
sizes, widget layouts must adapt to different Home screen grid cell sizes.</p>



<p>Below is an example layout that a music widget showing text information and two buttons can use.

It builds upon the previous discussion of adding margins depending on OS version.</p>

It builds upon the previous discussion of adding margins depending on OS version. Note that the

most robust and resilient way to add margins to the widget is to wrap the widget frame and contents

in a padded {@link android.widget.FrameLayout}.</p>



<pre>

&lt;FrameLayout

  android:layout_width="match_parent"

  android:layout_height="match_parent"

  android:layout_margin="@dimen/widget_margin"&gt;

  android:padding="@dimen/widget_margin"&gt;



  &lt;LinearLayout

    android:layout_width="match_parent"
@@ -295,16 +297,16 @@ use flexible layouts attributes like so:</p> 




<p>When a user adds the widget to their home screen, on an example Android 4.0 device where each

grid cell is 80dp &times; 100dp in size and 16dp of margins are automatically applied on all sizes,

grid cell is 80dp &times; 100dp in size and 8dp of margins are automatically applied on all sizes,

the widget will be stretched, like so:</p>





<img src="{@docRoot}images/widget_design/music_example_stretched.png"

  alt="Music widget sitting on an example 80dp x 100dp grid with 16dp of automatic margins

  alt="Music widget sitting on an example 80dp x 100dp grid with 8dp of automatic margins

  added by the system" id="music_example_stretched">



<p class="img-caption"><strong>Figure 7.</strong> Music widget sitting on an example 80dp x 100dp

grid with 16dp of automatic margins added by the system.</p>

grid with 8dp of automatic margins added by the system.</p>





<h2 id="templates">Using the App Widget Templates Pack</h2>

docs/html/guide/topics/appwidgets/index.jd

+2 −2
Original line number Diff line number Diff line
@@ -346,7 +346,7 @@ following layout classes:</p> 
&lt;FrameLayout

  android:layout_width="match_parent"

  android:layout_height="match_parent"

  <strong>android:layout_margin="@dimen/widget_margin"&gt;</strong>

  <strong>android:padding="@dimen/widget_margin"&gt;</strong>



  &lt;LinearLayout

    android:layout_width="match_parent"
@@ -363,7 +363,7 @@ following layout classes:</p> 
  <li>Create two dimensions resources, one in <code>res/values/</code> to provide the pre-Android 4.0 custom margins, and one in <code>res/values-v14/</code> to provide no extra padding for Android 4.0 widgets:



    <p><strong>res/values/dimens.xml</strong>:<br>

    <pre>&lt;dimen name="widget_margin"&gt;15dp&lt;/dimen&gt;</pre></p>

    <pre>&lt;dimen name="widget_margin"&gt;8dp&lt;/dimen&gt;</pre></p>



    <p><strong>res/values-v14/dimens.xml</strong>:<br>

    <pre>&lt;dimen name="widget_margin"&gt;0dp&lt;/dimen&gt;</pre></p>