Saltar al contenido principal
Neural UIv2.0.0Documentación
Ver v1 GitHub

Toolbar

Organiza acciones de la aplicación en zonas de contenido adaptables.

Categoría
Acciones
Import
@neural-ui/core/toolbar
Selector
neu-toolbar
import { NeuToolbarComponent } from '@neural-ui/core/toolbar';

Uso

Proyecta contenido en las zonas start, center, end y secondary. Usa wrap="wrap" cuando las acciones necesiten pasar a otras líneas en pantallas estrechas. size controla las dimensiones, density ajusta el espaciado y tone junto con variant elige la superficie. Toolbar no proporciona eventos de acción ni navegación mediante flechas.

Ejemplos

Prueba el comportamiento y consulta el código ejecutable en Código.

Ejemplos
Pedidos
Listos para procesar
6 pedidos · Actualizado hoy

Exportaciones: 0

Prueba y configura

Cambia las opciones, prueba el resultado y consulta su template generado. Abre Código para ver la implementación completa.

Prueba y configura
Pedidos
Listos para procesar

Exportaciones: 0

template.html
<neu-toolbar
  size="md"
  density="normal"
  tone="neutral"
  variant="soft"
  wrap="wrap"
  [shadow]="false"
  [bordered]="false"
>
  <strong neu-toolbar-start>Pedidos</strong>
  <span neu-toolbar-center>Listos para procesar</span>
  <div neu-toolbar-end>
    <button
      neu-button
      size="sm"
      variant="solid"
      tone="brand"
      (neuClick)="count.update(increment)"
    >
      Exportar
    </button>
  </div>
</neu-toolbar>

Datos y contenido

Sus siete Inputs configuran el layout y la apariencia. Toolbar no tiene Outputs; los controles proyectados gestionan sus eventos. density utiliza compact, normal o relaxed, no los valores de data-neu-density global.

Accesibilidad y teclado

Usa botones nativos con etiquetas significativas para las acciones. El contenido sigue el orden normal de Tab. Este layout no implementa el patrón ARIA de toolbar con foco móvil; no añadas ese rol sin implementar su comportamiento de teclado.

Tecla
Acción
Tab Sigue el orden normal de foco de enlaces, campos y acciones del contenido; el contenedor no añade un modelo de foco móvil.
Enter Activa un botón nativo enfocado o sigue un enlace enfocado dentro del contenido.
Space Activa un botón nativo enfocado dentro del contenido; los campos mantienen la edición normal de texto.

API

Los Inputs y Outputs corresponden al paquete Core fijado. Los tipos con nombre enlazan a sus definiciones. Templates incluye ejemplos ejecutables de cada zona disponible.

Inputs

Configura el componente con [propiedad]="valor". Tu aplicación proporciona estos valores; el componente no debe reemplazar el estado que le pasas.

Nombre
Tipo
Por defecto
Uso en el template
Descripción
borderedbooleanfalse[bordered]Dibuja un separador inferior.
densityNeuDensity'normal'[density]Densidad espacial: compact, normal o relaxed.
shadowbooleanfalse[shadow]Añade una sombra suave a la superficie.
sizeNeuToolbarSize'md'[size]Escala dimensional: sm, md o lg.
toneNeuToolbarTone'neutral'[tone]Intención de la superficie: neutral o brand.
variantNeuToolbarVariant'soft'[variant]Tratamiento de la superficie: solid, soft o ghost.
wrapNeuToolbarWrap'nowrap'[wrap]nowrap mantiene una línea; wrap permite que las zonas pasen a otras líneas.

Templates

ng-content proyecta contenido dentro del componente. Los inputs TemplateRef reciben un template; las directivas ng-template identifican templates con un contexto tipado. Una directiva compartida en el entrypoint no es necesariamente un slot de este componente.

Nombre
Mecanismo
Contrato
[neu-toolbar-start]

Zona inicial

Ver ejemplo
Proyección de contenido

Coloca el título o las acciones iniciales.

<ng-content select="[neu-toolbar-start]" />

Contexto utilizado: —

[neu-toolbar-center]

Zona central

Ver ejemplo
Proyección de contenido

Coloca contexto entre las zonas inicial y final.

<ng-content select="[neu-toolbar-center]" />

Contexto utilizado: —

[neu-toolbar-end]

Zona final

Ver ejemplo
Proyección de contenido

Coloca las acciones principales de la aplicación.

<ng-content select="[neu-toolbar-end]" />

Contexto utilizado: —

[neu-toolbar-secondary]

Zona secundaria

Ver ejemplo
Proyección de contenido

Usa wrap="wrap" para colocar contenido complementario en otra fila.

<ng-content select="[neu-toolbar-secondary]" />

Contexto utilizado: —

*

Contenido adicional

Ver ejemplo
Proyección de contenido

Proyecta contenido fuera de las zonas con nombre.

<ng-content />

Contexto utilizado: —

Cada ejemplo muestra un template diferente. Alterna entre Demo y Código para consultar su implementación, imports y estado.

start

[neu-toolbar-start]

start
Pedidos

center

[neu-toolbar-center]

center
6 resultados

end

[neu-toolbar-end]

end

Exportaciones: 0

secondary

[neu-toolbar-secondary]

secondary
Actualizado hoy

Contenido adicional

*

Contenido adicional
Contenido proyectado adicional

Public Types

Abre un tipo para consultar su definición y los campos de sus interfaces.

Estilos y tokens

Utiliza los tokens públicos de superficie, texto, espaciado y foco. Comprueba el contenido en ambos temas y con anchos reducidos.

Tokens específicos

Token
Efecto
Estado / variante
Valor / origen
Alternativa
--neu-toolbar-bg Valor del tema heredado que utiliza este componente Superficie del campo var(--neu-surface-1)Declaración raíz--neu-surface-1
--neu-toolbar-color Valor del tema heredado que utiliza este componente Superficie del campo var(--neu-text)Declaración raíz--neu-text
--neu-toolbar-primary-bg Valor del tema heredado que utiliza este componente Superficie del campo var(--neu-primary-dark)Declaración raíz--neu-primary-dark
--neu-toolbar-primary-color Valor del tema heredado que utiliza este componente Superficie del campo var(--neu-primary-fg)Declaración raíz--neu-primary-fg

Tokens compartidos utilizados

Sobrescríbelos en un contenedor local para afectar a este ejemplo. Una modificación en :root afecta a los demás componentes que utilizan el mismo token.

Token
Efecto aquí
Otros efectos
Valor / alternativa
--neu-primary Color de marca en controles activos y énfasis Compartido con otros consumidores de Core; limita el cambio a un ámbito. #007aff
--neu-primary-soft Superficie tenue de selección o estado activo Compartido con otros consumidores de Core; limita el cambio a un ámbito. var(--neu-primary-50)
--neu-primary-solid Fondo de las acciones de marca sólidas Compartido con otros consumidores de Core; limita el cambio a un ámbito. #006ee6
--neu-primary-solid-fg Contenido de las acciones de marca sólidas Compartido con otros consumidores de Core; limita el cambio a un ámbito. #ffffff
--neu-surface Superficie principal del campo, cabecera o control Compartido con otros consumidores de Core; limita el cambio a un ámbito. #ffffff
--neu-text Color del texto principal y de los iconos que lo heredan Compartido con otros consumidores de Core; limita el cambio a un ámbito. #0f172a
--neu-border-color Valor del tema heredado que utiliza este componente Compartido con otros consumidores de Core; limita el cambio a un ámbito. var(--neu-border)
--neu-surface-1 Valor del tema heredado que utiliza este componente Compartido con otros consumidores de Core; limita el cambio a un ámbito. var(--neu-surface)