Saltar al contenido

Estructura de página

Page, PageHeader, Header y Footer: el armazón de una web, con HTML nativo y un único main.

UIPage

Pinta un único main enfocable y el enlace para saltar a él, y coloca sidebar y aside en columnas fijas al desplazarse. A 75rem oculta aside y a 54rem oculta sidebar y muestra bar, donde va el UIDrawer. Esta misma guía es su ejemplo: un UIPage no se puede anidar, porque una página sólo tiene un main.

meeko
<UIPage layout="docs">
  <snippet name="header">
    <UIHeader bind:brand="brand" bind:items="items">
      <snippet name="actions"><UIThemeToggle /></snippet>
    </UIHeader>
  </snippet>
  <snippet name="bar">
    <UIDrawer title="Contenidos" triggerLabel="Contenidos">
      <UINavigationTree bind:groups="groups" />
    </UIDrawer>
  </snippet>
  <snippet name="sidebar"><UINavigationTree bind:groups="groups" /></snippet>
  <snippet name="aside"><UITableOfContents bind:entries="toc" /></snippet>
  <UIPageHeader title="Instalación" description="Añade el paquete a tu aplicación." />
  <UIProse as="article" bind:html="doc.html" />
  <UIPageNavigation bind:next="{ label: 'Rutas', to: '/routes' }" />
  <snippet name="footer"><UIFooter bind:brand="brand" /></snippet>
</UIPage>
Propiedades de UIPage
Nombre Tipo / valor inicial Descripción
layout docs | dashboard | landing docs Reparto de las columnas.
mainId string contenido id del main, destino del enlace de salto.
mainLang string lang del main, si su contenido está en otro idioma.
skipLabel string Texto del enlace de salto. El valor por defecto sigue el idioma del documento.
class / lang / dir atributos HTML Llegan a la raíz.

Sus snippets son default, header, notices, bar, sidebar, aside y footer. notices va bajo la cabecera, con el ancho de la página, y no ocupa sitio si su contenido no pinta nada.

El título de una página, con su descripción, sus migas y sus acciones. Es el único h1: el de esta guía es uno.

Propiedades de UIPageHeader
Nombre Tipo / valor inicial Descripción
title string Obligatoria. El h1.
description string Texto bajo el título.
layout docs | dashboard | landing docs Tamaño del título.
class string Clases adicionales.

Admite los snippets breadcrumb, actions y default.

La cabecera tiene una altura fija, --ui-header-height. En pantallas estrechas sus enlaces pasan a un menú con popover, que flota y no mueve la página. Una imagen de brand declara width y height para reservar su espacio.

meeko
<UIHeader bind:sticky="false" bind:brand="{ name: 'Meeko', href: '/' }"
  bind:items="[{ label: 'Guía', href: '/guide' }, { label: 'API', href: '/api' }]" current="/guide">
  <snippet name="actions"><UIButton size="sm">Entrar</UIButton></snippet>
</UIHeader>
<UIFooter bind:brand="{ name: 'Meeko', href: '/' }" description="Componentes tipados."
  bind:groups="[{ title: 'Producto', items: [{ label: 'Guía', href: '/guide' }] }]" />
Propiedades de UIHeader
Nombre Tipo / valor inicial Descripción
brand UIBrand name, product, image y destino de la marca.
items readonly UINavigationLink[] Los enlaces: label y href o to.
current string El enlace actual, cuando van con href.
label / menuLabel string Nombre de la navegación y del botón del menú.
sticky boolean true Fija la cabecera al desplazarse.
size UIContainerSize 2xl Ancho máximo.
class string Clases adicionales.

Admite los snippets brand, nav, actions y menu.

Propiedades de UIFooter
Nombre Tipo / valor inicial Descripción
brand / description UIBrand / string La marca y su texto.
groups readonly UIFooterGroup[] Columnas de enlaces: title e items.
items readonly UINavigationLink[] Enlaces sueltos.
label string Nombre de la navegación.
size UIContainerSize 2xl Ancho máximo.
class string Clases adicionales.

Admite los snippets brand, about, actions y legal. Los tipos UIPageProps, UIPageHeaderProps, UIHeaderProps, UIFooterProps y UIBrand se exportan desde @meekojs/ui/runtime.

¿Te sirvió esta página?

Añadir un comentario

Se envía al elegir «Sí» o «No». Solo se guardan la página, tu respuesta y el comentario: ni cookies ni datos tuyos.

0 de 2000 caracteres