208b9c5cc0
Huge overhaul. Includes all new dev guides about how resources are used on Android and how to provide alternatives, including how to handle runtime configuration changes (restarts). Plus all new reference docs for all the resource types (drawables, strings, menus, etc.). Change-Id: Icf079f5f45b1745a8d54f504e28dbbb52c6f7c96
129 lines
3.8 KiB
Plaintext
129 lines
3.8 KiB
Plaintext
page.title=Style Resource
|
|
parent.title=Resource Types
|
|
parent.link=available-resources.html
|
|
@jd:body
|
|
|
|
<div id="qv-wrapper">
|
|
<div id="qv">
|
|
<h2>See also</h2>
|
|
<ol>
|
|
<li><a href="{@docRoot}guide/topics/ui/themes.html">Applying Styles and Themes</a></li>
|
|
</ol>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
<p>A style resource defines the format and look for a UI.
|
|
A style can be applied to an individual {@link android.view.View} (from within a layout file) or to
|
|
an entire {@link android.app.Activity} or application (from within the manifest file).</p>
|
|
|
|
<p>For more information about creating and applying styles, please read
|
|
<a href="{@docRoot}guide/topics/ui/themes.html">Applying Styles and Themes</a>.</p>
|
|
|
|
<p class="note"><strong>Note:</strong> A style is a simple resource that is referenced
|
|
using the value provided in the {@code name} attribute (not the name of the XML file). As
|
|
such, you can combine style resources with other simple resources in the one XML file,
|
|
under one {@code <resources>} element.</p>
|
|
|
|
<dl class="xml">
|
|
|
|
<dt>file location:</dt>
|
|
<dd><code>res/values/<em>filename</em>.xml</code><br/>
|
|
The filename is arbitrary. The element's {@code name} will be used as the resource ID.</dd>
|
|
|
|
<dt>resource reference:</dt>
|
|
<dd>
|
|
In XML: <code>@[package:]style/<em>style_name</em></code>
|
|
</dd>
|
|
|
|
<dt>syntax:</dt>
|
|
<dd>
|
|
<pre class="stx">
|
|
<?xml version="1.0" encoding="utf-8"?>
|
|
<<a href="#resources-element">resources</a>>
|
|
<<a href="#style-element">style</a>
|
|
name="<em>style_name</em>"
|
|
parent="@[package:]style/<em>style_to_inherit</em>">
|
|
<<a href="#item-element">item</a>
|
|
name="<em>[package:]style_property_name</em>"
|
|
><em>style_value</em></item>
|
|
</style>
|
|
</resources>
|
|
</pre>
|
|
</dd>
|
|
|
|
<dt>elements:</dt>
|
|
<dd>
|
|
<dl class="tag-list">
|
|
|
|
<dt id="resources-element"><code><resources></code></dt>
|
|
<dd><strong>Required.</strong> This must be the root node.
|
|
<p>No attributes.</p>
|
|
</dd>
|
|
<dt id="style-element"><code><style></code></dt>
|
|
<dd>Defines a single style. Contains {@code <item>} elements.
|
|
<p class="caps">attributes:</p>
|
|
<dl class="atn-list">
|
|
<dt><code>name</code></dt>
|
|
<dd><em>String</em>. <strong>Required</strong>. A name for the style, which is used as the
|
|
resource ID to apply the style to a View, Activity, or application.
|
|
</dd>
|
|
<dt><code>parent</code></dt>
|
|
<dd><em>Style resource</em>. Reference to a style from which this
|
|
style should inherit style properties.
|
|
</dd>
|
|
</dl>
|
|
|
|
</dd>
|
|
<dt id="item-element"><code><item></code></dt>
|
|
<dd>Defines a single property for the style. Must be a child of a
|
|
<code><style></code> element.</p>
|
|
<p class="caps">attributes:</p>
|
|
<dl class="atn-list">
|
|
<dt><code>name</code></dt>
|
|
<dd><em>Attribute resource</em>. <strong>Required</strong>. The name of the style property
|
|
to be defined, with a package prefix if necessary (for example {@code android:textColor}).
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
|
|
</dl>
|
|
</dd> <!-- end elements and attributes -->
|
|
|
|
<dt>example:</dt>
|
|
<dd>
|
|
<dl>
|
|
|
|
<dt>XML file for the style (saved in <code>res/values/</code>):</dt>
|
|
<dd>
|
|
<pre>
|
|
<?xml version="1.0" encoding="utf-8"?>
|
|
<resources>
|
|
<style name="CustomText" parent="@style/Text">
|
|
<item name="android:textSize">20sp</item>
|
|
<item name="android:textColor">#008</item>
|
|
</style>
|
|
</resources>
|
|
</pre>
|
|
</dd>
|
|
|
|
<dt>XML file that applies the style to a {@link android.widget.TextView}
|
|
(saved in <code>res/layout/</code>):</dt>
|
|
<dd>
|
|
<pre>
|
|
<?xml version="1.0" encoding="utf-8"?>
|
|
<EditText
|
|
style="@style/CustomText"
|
|
android:layout_width="fill_parent"
|
|
android:layout_height="wrap_content"
|
|
android:text="Hello, World!" />
|
|
</pre>
|
|
</dd>
|
|
|
|
</dl>
|
|
</dd> <!-- end example -->
|
|
|
|
</dl>
|
|
|
|
|