Another Vue of NativeScript Webinar is now on YouTube
ActionItem

This is an overview of the most common usage of ActionItem. For more information about the available properties, methods, or events, head over to the complete API documentation for ActionItem.

El componente ActionItem es utilizado para agregar botones (con acciones) al componente ActionBar.


Uso básico

<ActionBar title="My App">
  <ActionItem @tap="onTapShare"
    ios.systemIcon="9" ios.position="left"
    android.systemIcon="ic_menu_share" android.position="actionBar" />
  <ActionItem @tap="onTapDelete"
    ios.systemIcon="16" ios.position="right"
    text="delete" android.position="popup" />
</ActionBar>

Mostrando elementos con condicionales

Los elementos <ActionItem> pueden ser representados usando condiciones con la directiva v-show.

<ActionBar title="My App">
  <ActionItem @tap="onTapEdit"
    v-show="!isEditing"
    ios.systemIcon="2" ios.position="right"
    android.systemIcon="ic_menu_edit" />
  <ActionItem @tap="onTapSave"
    v-show="isEditing"
    ios.systemIcon="3" ios.position="right"
    android.systemIcon="ic_menu_save" />
  <ActionItem @tap="onTapCancel"
    v-show="isEditing"
    ios.systemIcon="1"
    android.systemIcon="ic_menu_close_clear_cancel" />
</ActionBar>

Propiedades

NombreTipoDescripcioón
ios.systemIconNumberObtiene o establece el ícono para iOS. El valor debe ser un número de la enumeración UIBarButtonSystemItem.
android.systemIconStringObtiene o Establece el ícono para Android. El valor debe ser el nombre de un recurso drawable
ios.positionStringEstabelece la posición del item en iOS.
Valores posibles:
- left (valor por defecto): Coloca el item en el lado izquierdo del componente ActionBar.
- right: Coloca el item en el lado derecho del componente ActionBar.
android.positionStringEstabelece la posición del item en Android.
Valores posibles:
- actionBar (valor por defecto): Coloca el item en el componente ActionBar.
- popup: Coloca el item en el menú de opciones (el item será mostrado como texto)
- actionBarIfRoom: Coloca el item en el componente ActionBar, siempre y cuando haya espacio suficiente. De lo contrario, coloca el item en el menú de opciones.

Eventos

NombreDescripción
tapEmitido cada vez que el item es presionado.

Componente nativo

AndroidiOS
android.widget.ToolbarUINavigationItem
Contributors