|
| 1 | +--- |
| 2 | +title: Page |
| 3 | +apiRef: https://docs.nativescript.org/api-reference/classes/_ui_page_.page |
| 4 | +contributors: [msaelices] |
| 5 | +--- |
| 6 | + |
| 7 | +`<Page>` es un componente de UI que representa una pantalla de una aplicación. Las apps NativeScript típicamente consisten en una o más `<Page>` que incluyen contenido como un [`<ActionBar>`](/es/docs/elements/action-bar/action-bar) y otros elementos. |
| 8 | + |
| 9 | +--- |
| 10 | + |
| 11 | +#### Una página única |
| 12 | + |
| 13 | +```html |
| 14 | +<Page> |
| 15 | + <ActionBar title="My App" /> |
| 16 | + <GridLayout> |
| 17 | + <Label text="My Content"/> |
| 18 | + </GridLayout> |
| 19 | +</Page> |
| 20 | +``` |
| 21 | + |
| 22 | +#### Usando el evento `loaded` para disparar cambios en UI |
| 23 | + |
| 24 | +Un escenario típico es realizar cambios en la interfaz después de que la página se ha cargado. La forma recomendada de hacer esto es usando el evento `loaded`, disparado por NativeScript cuando la página está totalmente cargada: |
| 25 | + |
| 26 | +```html |
| 27 | +<Page @loaded="greet"> |
| 28 | + <ActionBar title="My App" /> |
| 29 | + <GridLayout> |
| 30 | + <Label text="My Content"/> |
| 31 | + </GridLayout> |
| 32 | +</Page> |
| 33 | +``` |
| 34 | + |
| 35 | +```js |
| 36 | +export default { |
| 37 | + methods: { |
| 38 | + greet() { |
| 39 | + alert('Hello!').then(() => { |
| 40 | + console.log('Dialog closed') |
| 41 | + }) |
| 42 | + } |
| 43 | + } |
| 44 | +} |
| 45 | +``` |
| 46 | + |
| 47 | +> **NOTA**: Los desarrolladores que vienen de un entorno web generalmente usarían el hook de ciclo de vida `mounted` que Vue proporciona, sin embargo en NativeScript la aplicación, y ciertos elementos podrían no estar cargados aún cuando el hook `mounted` es disparado, de ahí que ciertas acciones como mostrar ventanas de diálogo, navegaciones, etc. no son posible dentro del hook `mounted`. Para solucionar esta limitación, se puede usar el evento `loaded`, el cual sólo se dispara después de que la aplicación está lista. En este caso, estamos usando el evento `loaded` del elemento [`<Page>`](/es/docs/elements/components/page), pero este evento está disponible en todos los elementos NativeScript. |
| 48 | +
|
| 49 | +## Props |
| 50 | + |
| 51 | +| Nombre | Tipo | Descripción | |
| 52 | +|--------|------|-------------| |
| 53 | +| `actionBarHidden` | `Boolean` | Muestra u oculta el `<ActionBar>` para la página.<br/>Valor por defecto: `false`. |
| 54 | +| `backgroundSpanUnderStatusBar` | `Boolean` | Obtiene o establece si el fondo de la pantalla Gets or sets whether the background of the page sitúa también bajo la barra de estado.<br/>Valor por defecto: `false`. |
| 55 | +| `androidStatusBarBackground` | `Color` | (Sólo para Android) Obtiene o establece el color de la barra de estado en dispositivos Android. |
| 56 | +| `enableSwipeBackNavigation` | `Boolean` | (Sólo para iOS) Obtiene o establece si la página puede ser deslizado (swiped) en iOS para volver atrás.<br/>Valor por defecto: `true`. |
| 57 | +| `statusBarStyle` | `String` | Obtiene o establece el estilo de la barra de estado.<br/>Valid values:<br/>`light`,<br/>`dark`. |
| 58 | + |
| 59 | +## Eventos |
| 60 | + |
| 61 | +| Nombre | Descripción | |
| 62 | +|--------|-------------| |
| 63 | +| `loaded` | Emitido después de que la página ha sido cargada. |
| 64 | +| `navigatedFrom` | Emitido después de que la app haya navegado a otra página desde la página actual. |
| 65 | +| `navigatedTo` | Emitido después de que la app haya navegado a la página actual. |
| 66 | +| `navigatingFrom` | Emitido justo antes de que la app haya navegado a otra página desde la página actual. |
| 67 | +| `navigatingTo` | Emitido justo antes de que la app haya navegado a la página actual. |
| 68 | + |
| 69 | +## Componente Nativo |
| 70 | + |
| 71 | +| Android | iOS | |
| 72 | +|---------|-----| |
| 73 | +| [`org.nativescript.widgets.GridLayout`](https://github.com/NativeScript/tns-core-modules-widgets/blob/master/android/widgets/src/main/java/org/nativescript/widgets/GridLayout.java) | [`UIViewController`](https://developer.apple.com/documentation/uikit/uiviewcontroller) |
0 commit comments