# Usar componentes **Objetivo:** construir la interfaz con los componentes que trae PageTop: crearlos, configurarlos, anidarlos y ajustar sus clases y atributos sin tocar su código. Un **componente** es una pieza de interfaz con su propio HTML (y, si los necesita, sus estilos y *scripts*). Se crea con un constructor, se configura con métodos `with_*()` encadenados y se añade a una página o a otro componente. ```rust,no_run # use pagetop::prelude::*; async fn home(request: HttpRequest) -> Result { Page::new(request) .with_child( Block::new() .with_title(Lc::n("What's new")) .with_child(Html::with(|_| html! { p { "Version 2 is here." } })) .with_child(Button::anchor(Lc::n("Download"), "/downloads")), ) .render() .await } ``` Los componentes **no se pintan al crearlos**, sino al renderizar la página. Por eso pueden adaptarse al idioma de cada visitante, al tema activo o al usuario conectado. ## El catálogo básico PageTop trae un conjunto de componentes que funcionan con cualquier tema. La lista completa, con sus constructores, está en el [catálogo de componentes](../reference/components.md). | Componente | Para qué sirve | |---|---| | `Html` | Marcado puntual con `html!` | | `Container` | Agrupa componentes en un `
`, `
`, `
`... | | `Block` | Bloque con título y contenido | | `Intro` | Portada de bienvenida con título, eslogan y botón | | `Button` | Botones y enlaces con aspecto de botón | | `Badge` | Etiquetas pequeñas de estado | | `Image` | Imágenes, también *responsive* | | `Brand` | Logotipo y nombre del sitio | | `Breadcrumb` | Migas de pan | | `Messages` | Avisos al usuario | | `Dialog` | Ventanas de diálogo | | `Flex`, `Grid` | [Maquetación](layout.md) | | `Nav`, `Navbar`, `Dropdown` | [Navegación](navigation.md) | | `Form` y sus campos | [Formularios](forms.md) | | `Table`, `Pager` | [Tablas y paginación](tables.md) | | `PoweredBy` | Pie con el crédito «Funciona con PageTop» | ## Contenedores `Container` agrupa varios componentes. Elige la etiqueta con el constructor: ```rust,no_run # use pagetop::prelude::*; # fn f() -> Container { Container::section() .with_id("team") .with_child(Html::with(|_| html! { h2 { "The team" } })) .with_child(Block::new().with_title(Lc::n("Ana"))) .with_child(Block::new().with_title(Lc::n("Luke"))) # } ``` `Container::new()` genera un `
`; también están `header()`, `main()`, `section()`, `article()` y `footer()`. ## Botones ```rust,no_run # use pagetop::prelude::*; # fn f() -> Vec