Componentes
Blockstudio incluye 59 UI componentes en cada compilación. Se registran automáticamente, se diseñan con tokens de diseño y se crean con la misma sintaxis de etiquetas que cualquier otro bloque.
Blockstudio 7.3 incluye un conjunto integrado de bloques UI sin interfaz propia, impulsados por WordPress Interactivity API. Están registrados en el espacio de nombres bsui/* y se pueden combinar en plantillas, páginas basadas en archivos, patrones y contenido de entradas.
Nota
Los componentes UI están en fase beta mientras recopilamos comentarios sobre el conjunto de componentes, su nomenclatura, comportamiento y patrones de uso en proyectos. Ya se pueden probar en 7.3, pero es posible que la interfaz de API se ajuste antes de declararse estable.
Activar los componentes UI
Los componentes UI incluidos están desactivados de forma predeterminada. Actívalos en el blockstudio.json de tu tema:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
O actívalos con un filtro:
add_filter('blockstudio/settings/ui/enabled', '__return_true');
Al activarlo, Blockstudio registra la biblioteca de componentes incluida desde includes/ui/blocks.
Inventario público y ejemplos
Los bloques de implementación incluidos siguen siendo registros normales de bsui/*, pero quienes los usan deben consultar el inventario público de familias al crear una galería de componentes:
use Blockstudio\Ui;
$families = Ui::inventory();
$examples = Ui::examples();
Ui::inventory() agrupa cada componente compuesto bajo su raíz pública y enumera los registros de implementación que requiere esa familia.
Ui::examples() añade una declaración normalizada determinista con datos predeterminados e ilustrativos. Conserva las relaciones necesarias entre la raíz y sus elementos secundarios, por lo que el resultado se puede pasar directamente a Blockstudio\Render::document().
El inventario público de Canvas expone estos ejemplos con el tipo ui y omite los registros de implementación incluidos del tipo normal blocks. Así se obtiene un ejemplo completo por cada familia de componentes pública, en lugar de una galería de fragmentos internos de raíz, activador, ventana emergente y capa.
Al ensamblar un documento ya renderizado, Ui::global_assets($block_names, $html) devuelve el estilo y el script globales incluidos exactos solo cuando la salida seleccionada utiliza realmente un componente UI.
Renderizado
Usa la sintaxis normal de etiquetas de bloque:
<block name="bsui/button" label="Save" variant="default"></block>
También funciona la sintaxis abreviada <bs:>:
<bs:bsui-button label="Save" variant="default" />
En las plantillas Blockstudio, las etiquetas de bloque se renderizan automáticamente. En las páginas basadas en archivos y los patrones, se sincronizan como bloques nativos de WordPress. Si quieres renderizar componentes UI directamente desde el contenido de las entradas o las áreas de widgets, activa las etiquetas de bloque a nivel de página:
{
"ui": {
"enabled": true
},
"blockTags": {
"enabled": true,
"allow": ["bsui/*", "app/*"]
}
}
Componentes básicos
Los componentes simples se renderizan como un único bloque:
<block name="bsui/button" label="Continue" variant="default"></block>
<block name="bsui/badge" label="Beta"></block>
<block
name="bsui/input"
nameAlt="email"
type="email"
placeholder="Email"
></block>
<block name="bsui/textarea" name="message" placeholder="Message"></block>
<block name="bsui/spinner"></block>
Los atributos se asignan directamente a los atributos block.json de cada componente. Por ejemplo, bsui/button admite label, icon, iconPosition, href, variant, size y disabled.
bs_render_block([
'name' => 'bsui/button',
'data' => [
'label' => 'Continue',
'icon' => [
'set' => 'heroicons',
'subSet' => 'outline',
'icon' => 'arrow-right',
],
'iconPosition' => 'right',
],
]);
Componentes compuestos
Muchos componentes UI son bloques compuestos. El bloque raíz administra el estado y los bloques secundarios declaran cuál es su elemento principal.
Pestañas
<block name="bsui/tabs" defaultValue="tab1">
<block name="bsui/tabs-list">
<block name="bsui/tabs-trigger" value="tab1" title="Features"></block>
<block name="bsui/tabs-trigger" value="tab2" title="Pricing"></block>
<block name="bsui/tabs-trigger" value="tab3" title="FAQ"></block>
</block>
<block name="bsui/tabs-panel" value="tab1">
<p>Features content.</p>
</block>
<block name="bsui/tabs-panel" value="tab2">
<p>Pricing content.</p>
</block>
<block name="bsui/tabs-panel" value="tab3">
<p>FAQ content.</p>
</block>
</block>
Diálogo
<block name="bsui/dialog">
<block name="bsui/dialog-trigger" label="Open Dialog"></block>
<block name="bsui/dialog-backdrop"></block>
<block name="bsui/dialog-popup">
<p>Dialog content.</p>
<block name="bsui/dialog-close" label="Close"></block>
</block>
</block>
Selector
<block name="bsui/select" placeholder="Choose a fruit" nameAlt="fruit">
<block name="bsui/select-trigger"></block>
<block name="bsui/select-popup">
<block name="bsui/select-option" value="apple" label="Apple"></block>
<block name="bsui/select-option" value="banana" label="Banana"></block>
<block name="bsui/select-option" value="cherry" label="Cherry"></block>
</block>
</block>
Campos de formulario
<block name="bsui/form" block="contact/form" successMessage="Thank you!">
<block name="bsui/field">
<block name="bsui/field-label" text="Email"></block>
<block name="bsui/input" nameAlt="email" type="email"></block>
<block name="bsui/field-error"></block>
</block>
</block>
Bloques disponibles
La biblioteca UI incluida contiene:
| Área | Bloques |
|---|---|
| Diseño | bsui/aspect-ratio, bsui/card, bsui/separator, bsui/stack, bsui/table |
| Acciones | bsui/button, bsui/button-group, bsui/toggle, bsui/toggle-group, bsui/toolbar |
| Entradas | bsui/checkbox, bsui/color-picker, bsui/date-input, bsui/file-upload, bsui/input, bsui/number-field, bsui/otp-input, bsui/password-input, bsui/phone-input, bsui/radio-group, bsui/rating, bsui/select, bsui/slider, bsui/switch, bsui/textarea, bsui/time-picker |
| Superposiciones | bsui/alert-dialog, bsui/dialog, bsui/drawer, bsui/menu, bsui/menubar, bsui/popover, bsui/preview-card, bsui/tooltip |
| Navegación | bsui/accordion, bsui/breadcrumb, bsui/carousel, bsui/collapsible, bsui/context-menu, bsui/navigation-menu, bsui/pagination, bsui/tabs |
| Comentarios | bsui/badge, bsui/kbd, bsui/meter, bsui/progress, bsui/skeleton, bsui/spinner, bsui/text, bsui/toast |
| Formularios | bsui/field, bsui/field-group, bsui/form |
Los componentes compuestos también exponen bloques secundarios como bsui/dialog-trigger, bsui/dialog-popup, bsui/tabs-list, bsui/tabs-trigger, bsui/tabs-panel, bsui/select-trigger, bsui/select-popup y bsui/select-option.
Estilos
Los componentes UI incluyen sus propias propiedades personalizadas de CSS con el prefijo --bs-ui-*. Puedes sobrescribirlas desde el CSS de tu tema:
:root {
--bs-ui-radius: 0.5rem;
--bs-ui-primary: oklch(0.45 0.18 260);
--bs-ui-primary-foreground: white;
}
Los componentes no incluyen una interfaz predeterminada, pero tienen opiniones suficientes para poder usarse desde el primer momento. Sobrescribe primero los tokens y luego añade CSS específicos de cada componente cuando sea necesario.
El CSS de los componentes incluidos se emite en la capa de cascada bsui indicada. El CSS del tema que no esté en una capa puede sobrescribir las reglas de los componentes sin !important:
.button-brand {
background: var(--brand-primary);
}
Para añadir una variante personalizada de bsui/button, agrega la opción del selector con el filtro de atributos existente y proporciona el CSS de la variante con blockstudio/ui/button/variants-style:
add_filter('blockstudio/blocks/attributes', function($attribute, $block) {
if (($block['name'] ?? '') === 'bsui/button' && ($attribute['id'] ?? '') === 'variant') {
$attribute['options'][] = [
'label' => 'Brand',
'value' => 'brand',
];
}
return $attribute;
}, 10, 2);
add_filter('blockstudio/ui/button/variants-style', function($css) {
return $css . '
[data-bsui-button][data-variant="brand"] {
background: var(--brand-primary);
color: white;
}';
});
Relacionado
- UI Composición, incluidos los campos controlados, las tarjetas de campos y los separadores de la barra de herramientas
- Renderizado programático
- Componentes
- Interactividad API