1page.title=Usar el tema Material 2 3@jd:body 4 5<div id="tb-wrapper"> 6<div id="tb"> 7<h2>Esta lección te enseña a realizar lo siguiente:</h2> 8<ol> 9 <li><a href="#ColorPalette">Personalizar la paleta de colores</a></li> 10 <li><a href="#StatusBar">Personalizar la barra de estado</a></li> 11 <li><a href="#Inheritance">Cambiar el tema de vistas individuales</a></li> 12</ol> 13<h2>También deberías leer</h2> 14<ul> 15 <li><a href="http://www.google.com/design/spec">Especificación de Material Design</a></li> 16 <li><a href="{@docRoot}design/material/index.html">Material Design en Android</a></li> 17</ul> 18</div> 19</div> 20 21 22<p>El nuevo tema material proporciona:</p> 23 24<ul> 25 <li>Widgets del sistema que te permiten establecer la paleta de colores.</li> 26 <li>Animaciones para la respuesta táctil de los widgets del sistema.</li> 27 <li>Animaciones para transiciones de actividades</li> 28</ul> 29 30<p>Puedes personalizar la apariencia del tema material 31según la identidad de tu marca, con una paleta de colores que esté bajo tu control. Puedes cambiar el matiz de la barra de acción y 32la barra de estado mediante atributos de temas, como se muestra en la <a href="#fig3">figura 3</a>.</p> 33 34<p>Los widgets del sistema tienen un nuevo diseño y animaciones para respuesta táctil. Puedes personalizar tu aplicación cambiando su 35paleta de colores, las animaciones de la respuesta táctil y sus transiciones de actividades.</p> 36 37<p>El tema material se define como:</p> 38 39<ul> 40 <li><code>@android:style/Theme.Material</code> (versión oscura)</li> 41 <li><code>@android:style/Theme.Material.Light</code> (versión clara)</li> 42 <li><code>@android:style/Theme.Material.Light.DarkActionBar</code></li> 43</ul> 44 45<p>Para obtener una lista de estilos de Material, consulta la referencia de la API para 46{@link android.R.style R.style}.</p> 47 48<!-- two columns, dark/light material theme example --> 49<div style="width:700px;margin-top:25px;margin-bottom:10px"> 50<div style="float:left;width:250px;margin-left:40px;margin-right:60px;"> 51 <img src="{@docRoot}design/material/images/MaterialDark.png" width="500" height="238"> 52 <div style="width:170px;margin:0 auto"> 53 <p style="margin-top:8px;font-size:12px"><strong>Figura 1</strong>. Tema Material oscuro</p> 54 </div> 55</div> 56<div style="float:left;width:250px;margin-right:0px;"> 57 <img src="{@docRoot}design/material/images/MaterialLight.png" width="500" height="238"> 58 <div style="width:170px;margin:0 auto"> 59 <p style="margin-top:8px;font-size:12px"><strong>Figura 2</strong>. Tema Material claro</p> 60 </div> 61</div> 62<br style="clear:left"> 63</div> 64 65<p class="note"> 66<strong>Nota:</strong> El tema material solo está disponible en Android 5.0 (API nivel 21) y 67superior. Las <a href="{@docRoot}tools/support-library/features.html#v7">Bibliotecas de soporte v7</a> 68proporcionan temas con estilos de Material Design para algunos widgets y admiten la personalización de la paleta de 69colores. Para más información, consulta 70<a href="{@docRoot}training/material/compatibility.html">Mantener la compatibilidad</a>. 71</p> 72 73 74<h2 id="ColorPalette">Personalizar la paleta de colores</h2> 75 76<p style="margin-bottom:30px">Si deseas personalizar los colores base del tema para que se adapten a tu marca, define 77tus colores personalizados mediante los atributos de temas cuando heredes del tema material:</p> 78 79<pre> 80<resources> 81 <!-- inherit from the material theme --> 82 <style name="AppTheme" parent="android:Theme.Material"> 83 <!-- Main theme colors --> 84 <!-- your app branding color for the app bar --> 85 <item name="android:colorPrimary">@color/primary</item> 86 <!-- darker variant for the status bar and contextual app bars --> 87 <item name="android:colorPrimaryDark">@color/primary_dark</item> 88 <!-- theme UI controls like checkboxes and text fields --> 89 <item name="android:colorAccent">@color/accent</item> 90 </style> 91</resources> 92</pre> 93 94<div style="float:right;margin-left:25px;margin-top:20px;margin-bottom:10px" id="fig3"> 95<img src="{@docRoot}training/material/images/ThemeColors.png" width="250" height="445" /> 96<p class="img-caption" style="margin-bottom:0px"> 97<strong>Figura 3</strong>. Personalizar el tema material.</p> 98</div> 99 100 101<h2 id="StatusBar">Personalizar la barra de estado</h2> 102 103<p>El tema material te permite personalizar fácilmente la barra de estado, especifica un 104color que se adapte a tu marca y proporciona suficiente contraste para mostrar los íconos de estado en blanco. Si 105quieres establecer un color personalizado para la barra de estado, usa el atributo <code>android:statusBarColor</code> 106cuando extiendas el tema material. <code>android:statusBarColor</code> hereda el 107valor de <code>android:colorPrimaryDark</code> en forma predeterminada.</p> 108 109<p>También puedes dibujar por detrás de la barra de estado. Por ejemplo, si quieres que la barra de estado se 110muestre en forma transparente sobre una foto, aplica un sutil degradado oscuro para garantizar que los íconos 111de estado blancos sigan visibles. Para hacerlo, establece el atributo <code>android:statusBarColor</code> en 112<code>@android:color/transparent</code> y ajusta los indicadores de la ventana según lo requerido. También puedes 113usar el método {@link android.view.Window#setStatusBarColor Window.setStatusBarColor()} para 114las animaciones o el difuminado.</p> 115 116<p class="note"> 117<strong>Nota:</strong> La barra de estado casi siempre debe estar delimitada claramente de la 118barra de herramientas principal, excepto para los casos en donde muestres imágenes de un extremo a otro o contenido multimedia detrás 119de estas barras, y también cuando uses un degradado para garantizar que los íconos aún sean visibles. 120</p> 121 122<p>Cuando personalizas la barra de navegación y la barra de estado, haz que ambas sean transparentes o modifica 123solo la barra de estado. La barra de navegación debe permanecer de color negro en todos los otros casos.</p> 124 125 126<h2 id="Inheritance">Vistas individuales del tema</h3> 127 128<p>Los elementos en las definiciones de diseño XML pueden especificar el atributo <code>android:theme</code>, 129que hace referencia al recurso del tema. Este atributo modifica el tema para el elemento y cualquier 130elemento secundario, y esto es útil para modificar las paletas de colores de los temas en una porción específica 131de una interfaz.</p> 132