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

Commit 061cf70d authored by Roman Nurik's avatar Roman Nurik
Browse files

Update widget design guidelines for padding and 8dp. 

Instead of using layout_margin for widget margins, the recommendation is to
now use padding. Additionally, update all docs to mention an example default
padding of 8dp instead of 15 or 16dp.

Change-Id: I330aedc56986dbb31a70260279ad2f6668c67c92
parent fe464a76

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>