Barra de herramientasToolbar

La barra de herramientas es un componente de barra de acción que proporciona más flexibilidad que la barra de acción predeterminada: puede colocarse en cualquier lugar en la aplicación, se puede cambiar su tamaño y puede usar una combinación de colores que es diferente del tema de la aplicación. Además, cada pantalla de la aplicación puede tener varias barras de herramientas.The Toolbar is an action bar component that provides more flexibility than the default action bar: it can be placed anywhere in the app, its size can be changed, and it can use a color scheme that is different from the app's theme. Also, each app screen can have multiple Toolbars.

Información generalOverview

Un elemento clave en el diseño de cualquier actividad de Android es un barra de acciones.A key design element of any Android activity is an action bar. La barra de acciones es el componente de interfaz de usuario que se usa para navegación, búsqueda, menús y personalización de marca en una aplicación de Android.The action bar is the UI component that is used for navigation, search, menus, and branding in an Android app. En las versiones Android anteriores a Android 5.0 Lollipop, la barra de acciones (también conocido como el barra de la aplicación) era el componente recomendado para proporcionar esta funcionalidad.In Android versions before Android 5.0 Lollipop, the action bar (also known as the app bar) was the recommended component for providing this functionality.

El Toolbar widget (introducida en Android 5.0 Lollipop) puede considerarse una generalización de la interfaz de la barra de acción – está diseñado para reemplazar la barra de acciones.The Toolbar widget (introduced in Android 5.0 Lollipop) can be thought of as a generalization of the action bar interface – it is intended to replace the action bar. El Toolbar se pueden usar en cualquier lugar en un diseño de la aplicación y es mucho más personalizable que una barra de acciones.The Toolbar can be used anywhere in an app layout, and it is much more customizable than an action bar. Captura de pantalla siguiente ilustra la personalizada Toolbar creado en esta guía de ejemplo:The following screenshot illustrates the customized Toolbar example created in this guide:

Captura de pantalla de ejemplo de una barra de herramientas con Editar, guardar y elementos de menú de desbordamientoExample screenshot of a Toolbar with edit, save, and overflow menu items

Hay algunas diferencias importantes entre el Toolbar y la barra de acciones:There are some important differences between the Toolbar and the action bar:

  • Un Toolbar puede colocarse en cualquier lugar en la interfaz de usuario.A Toolbar can be placed anywhere in the user interface.

  • Varias barras de herramientas se pueden mostrar en la misma pantalla.Multiple toolbars can be displayed on the same screen.

  • Si se usan fragmentos, cada fragmento puede tener su propio Toolbar.If fragments are used, each fragment can have its own Toolbar.

  • Un Toolbar puede configurarse para abarcar sólo un ancho parcial de la pantalla.A Toolbar can be configured to span only a partial width of the screen.

  • Dado que el Toolbar no está enlazado a la combinación de colores de decoración de la ventana de la actividad, puede tener una combinación de colores distingan visualmente.Because the Toolbar is not bound to the color scheme of the Activity's window decor, it can have a visually distinct color scheme.

  • A diferencia de la barra de acciones, el Toolbar no incluye un icono de la izquierda.Unlike the action bar, the Toolbar does not include an icon on the left. Los menús de la derecha usar menos espacio.Its menus on the right use less space.

  • El Toolbar alto es ajustable.The Toolbar height is adjustable.

  • Otras vistas pueden incluirse dentro del Toolbar.Other views can be included inside the Toolbar.

Un Toolbar puede contener uno o varios de los siguientes elementos:A Toolbar can contain one or more of the following elements:

  • Botón de navegaciónNavigation button

  • Una imagen de logotipoA branded logo image

  • Título y subtítuloTitle and subtitle

  • Vistas personalizadasCustom views

  • Menú AcciónAction menu

  • Menú de desbordamientoOverflow menu

Google directrices de Material Design recomienda sacar provecho de estos elementos para proporcionar a las aplicaciones un aspecto distinto (en lugar de confiar únicamente en un icono de la aplicación y el título).Google's Material Design guidelines recommends taking advantage of these elements to give apps a distinct look (rather than relying solely on an application icon and title).

Esta guía explica la usa con más frecuencia Toolbar escenarios:This guide covers the most commonly-used Toolbar scenarios:

  • Reemplazar la barra de acción predeterminada de la actividad con un Toolbar.Replacing an Activity's default action bar with a Toolbar.

  • Agregar un segundo Toolbar a una actividad.Adding a second Toolbar to an Activity.

  • Mediante el biblioteca de compatibilidad de Android v7 AppCompat biblioteca (denominados AppCompat en el resto de esta guía) para implementar Toolbar en versiones anteriores de Android.Using the Android Support Library v7 AppCompat library (referred to as AppCompat in the rest of this guide) to deploy Toolbar on earlier versions of Android.

RequisitosRequirements

Toolbar está disponible en Android 5.0 Lollipop (API 21) y versiones posteriores.Toolbar is available on Android 5.0 Lollipop (API 21) and later. Cuando el objetivo es Android versiones anteriores a Android 5.0, utilice el biblioteca admite Android v7 AppCompat, que proporciona compatible Toolbar admitir en un paquete de NuGet.When targeting Android releases earlier than Android 5.0, use the Android Support Library v7 AppCompat, which provides backwards-compatible Toolbar support in a NuGet package. Compatibilidad de la barra de herramientas se explica cómo usar esta biblioteca.Toolbar Compatibility explains how to use this library.