|
| 1 | +--- |
| 2 | +title: ActionItem |
| 3 | +apiRef: https://docs.nativescript.org/api-reference/classes/_ui_action_bar_.actionitem |
| 4 | +contributors: [ianaya89] |
| 5 | +--- |
| 6 | + |
| 7 | +El componente ActionItem es utilizado para agregar botones (con acciones) al componente `ActionBar`. |
| 8 | + |
| 9 | +--- |
| 10 | + |
| 11 | +```html |
| 12 | +<ActionBar title="My App"> |
| 13 | + <ActionItem @tap="onTapShare" |
| 14 | + ios.systemIcon="9" ios.position="left" |
| 15 | + android.systemIcon="ic_menu_share" android.position="actionBar" /> |
| 16 | + <ActionItem @tap="onTapDelete" |
| 17 | + ios.systemIcon="16" ios.position="right" |
| 18 | + text="delete" android.position="popup" /> |
| 19 | +</ActionBar> |
| 20 | +``` |
| 21 | + |
| 22 | +#### Mostrando items con condicionales |
| 23 | + |
| 24 | +Los elementos `ActionItems` pueden ser represantados usando condiciones con la directiva `v-show`. |
| 25 | + |
| 26 | +```html |
| 27 | +<ActionBar title="My App"> |
| 28 | + <ActionItem @tap="onTapEdit" |
| 29 | + v-show="!isEditing" |
| 30 | + ios.systemIcon="2" ios.position="right" |
| 31 | + android.systemIcon="ic_menu_edit" /> |
| 32 | + <ActionItem @tap="onTapSave" |
| 33 | + v-show="isEditing" |
| 34 | + ios.systemIcon="3" ios.position="right" |
| 35 | + android.systemIcon="ic_menu_save" /> |
| 36 | + <ActionItem @tap="onTapCancel" |
| 37 | + v-show="isEditing" |
| 38 | + ios.systemIcon="1" |
| 39 | + android.systemIcon="ic_menu_close_clear_cancel" /> |
| 40 | +</ActionBar> |
| 41 | +``` |
| 42 | + |
| 43 | +## Propiedades |
| 44 | + |
| 45 | +| Nombre | Tipo | Descripcioón | |
| 46 | +|------|------|-------------| |
| 47 | +| `ios.systemIcon` | `String` | Estabelece el ícono para iOS. |
| 48 | +| `android.systemIcon` | `String` | Estabelece ícono para Android. |
| 49 | +| `ios.position` | `String` | Estabelece la posición del item en iOS.<br>Valores posibles:<br>- `left` (valor por defecto): Coloca el item en el lado izquierdo del componente ActionBar.<br>- `right`: Coloca el item en el lado derecho del componente ActionBar. |
| 50 | +| `android.position` | `String` | Estabelece la posición del item en Android.<br>Valores posibles:<br>- `actionBar` (valor por defecto): Coloca el item en el componente `ActionBar`.<br>- `popup`: Coloca el item en el menú de opciones (el item será mostrado como texto)<br>- `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. |
| 51 | + |
| 52 | +## Eventos |
| 53 | + |
| 54 | +| Nombre | Descripción | |
| 55 | +|------|-------------| |
| 56 | +| `tap`| Emitido cada vez que el item es presionado. |
0 commit comments