Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update widget design guidelines for padding and 8dp.

Browse Source 
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
This commit is contained in:
Roman Nurik
2011-11-29 10:02:19 -08:00
parent fe464a76d8
commit 061cf70da9
2 changed files with 9 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
docs/html/guide/practices/ui_guidelines/widget_design.jd
View File

@@ -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>

4
docs/html/guide/topics/appwidgets/index.jd
View File

@@ -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>