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

Tokens de diseño

Cambia una propiedad visible, entiende su ámbito y explora los tokens públicos del paquete.

Cambia los radios en un ámbito

--neu-radius es un token compartido de fundamentos. Compara los bordes rectos con un radio de 6px en Input y Button de tamaño medio. Solo los descendientes de cada ámbito CSS reciben su cambio. Otros tamaños pueden consumir otro token de radio.

Utiliza tu propio prefijo para las variables de layout de aplicación; los tokens públicos --neu-* personalizan componentes Neural.

Cambia los radios en un ámbito

--neu-radius: 0

--neu-radius: 6px

Aplica un cambio global

Coloca el cambio en :root después del import SCSS de Core, en styles.scss. Afecta a los descendientes que consumen --neu-radius salvo que una declaración más específica lo sustituya. Un token compartido tiene más alcance que un componente concreto.

styles.scss
@use '@neural-ui/core/styles' as *;

:root {
  --neu-radius: 6px;
}

Personaliza el fondo de Button

El Button coloreado del primer ejemplo aplica cuatro tokens públicos de Button: fondo, texto, borde y fondo de hover. Se aplican al tratamiento solid de tono brand; no presupongas que cambian todas las variantes.

La expresión de fondo recurre al color semántico solid si falta un valor de componente usable. Una vez que el token tiene valor, cambiar su fallback semántico no lo sustituye. Define una pareja válida de texto y hover, no solo el fondo.

styles.scss · fragmento
/* Fragment: local styles for a solid brand Button. */
.custom-action {
  --neu-button-background: #175d95;
  --neu-button-foreground: #ffffff;
  --neu-button-border: #175d95;
  --neu-button-background-hover: #124c7d;
}

Entiende el valor efectivo

Los tokens de fundamentos describen escalas compartidas, como espaciado y radios. Los semánticos describen roles, como texto, superficie o color primario. Los de componente concretan un rol para un control.

El valor CSS final depende de modo, preset, ámbito, especificidad y resolución de fallbacks var(). La referencia muestra un valor declarado, no un valor calculado universal. Un valor var(--neu-surface) cambia cuando cambia la superficie heredada.

Todos los tokens públicos

Busca por token, propietario o descripción. La tabla permite acceder a todos los tokens públicos del paquete instalado: al inicio muestra 40 filas y Mostrar todos revela el resto e indica el total actual. Los resultados filtrados no están limitados.

El origen indica dónde se declara el valor. Fallback muestra los tokens referenciados; Consumido por identifica consumidores registrados, no garantiza que todos sus estados visuales usen el token. No se incluyen tokens privados.

Mostrando 40 de 262 · 262 en total
Token
Descripción
Categoría / propietario
Valor declarado / origen
Fallback
Consumido por
--neu-accent Ajuste compartido: acento. Consulta consumidores y fallback antes de cambiarlo. Semánticos
semantic
#5ac8fa
Declaración raíz
—
--neu-alert-danger-bg Ajuste de alert: peligro · fondo. Consulta consumidores y fallback antes de cambiarlo. Componente
alert
var(--neu-alert-error-bg)
Declaración raíz
--neu-alert-error-bg
--neu-alert-danger-border Ajuste de alert: peligro · borde. Consulta consumidores y fallback antes de cambiarlo. Componente
alert
var(--neu-alert-error-border)
Declaración raíz
--neu-alert-error-border
--neu-alert-danger-text Ajuste de alert: peligro · texto. Consulta consumidores y fallback antes de cambiarlo. Componente
alert
var(--neu-alert-error-text)
Declaración raíz
--neu-alert-error-text
--neu-alert-dismiss-hover-bg Ajuste de alert: dismiss · estado hover · fondo. Consulta consumidores y fallback antes de cambiarlo. Componente
alert
rgb(0 0 0 / 8%)
Declaración raíz
— chip
--neu-alert-error-bg Ajuste de alert: error · fondo. Consulta consumidores y fallback antes de cambiarlo. Componente
alert
var(--neu-error-bg)
Declaración raíz
--neu-error-bg alert
--neu-alert-error-border Ajuste de alert: error · borde. Consulta consumidores y fallback antes de cambiarlo. Componente
alert
rgba(239, 68, 68, 0.2)
Declaración raíz
— alert
--neu-alert-error-text Ajuste de alert: error · texto. Consulta consumidores y fallback antes de cambiarlo. Componente
alert
var(--neu-error-text)
Declaración raíz
--neu-error-text alert
--neu-alert-info-bg Ajuste de alert: info · fondo. Consulta consumidores y fallback antes de cambiarlo. Componente
alert
var(--neu-info-bg)
Declaración raíz
--neu-info-bg alert
--neu-alert-info-border Ajuste de alert: info · borde. Consulta consumidores y fallback antes de cambiarlo. Componente
alert
rgba(0, 122, 255, 0.2)
Declaración raíz
— alert
--neu-alert-info-text Ajuste de alert: info · texto. Consulta consumidores y fallback antes de cambiarlo. Componente
alert
var(--neu-info-text)
Declaración raíz
--neu-info-text alert
--neu-alert-success-bg Ajuste de alert: éxito · fondo. Consulta consumidores y fallback antes de cambiarlo. Componente
alert
var(--neu-success-bg)
Declaración raíz
--neu-success-bg alert
--neu-alert-success-border Ajuste de alert: éxito · borde. Consulta consumidores y fallback antes de cambiarlo. Componente
alert
rgba(16, 185, 129, 0.2)
Declaración raíz
— alert
--neu-alert-success-text Ajuste de alert: éxito · texto. Consulta consumidores y fallback antes de cambiarlo. Componente
alert
var(--neu-success-text)
Declaración raíz
--neu-success-text alert
--neu-alert-warning-bg Ajuste de alert: advertencia · fondo. Consulta consumidores y fallback antes de cambiarlo. Componente
alert
var(--neu-warning-bg)
Declaración raíz
--neu-warning-bg alert
--neu-alert-warning-border Ajuste de alert: advertencia · borde. Consulta consumidores y fallback antes de cambiarlo. Componente
alert
rgba(245, 158, 11, 0.2)
Declaración raíz
— alert
--neu-alert-warning-text Ajuste de alert: advertencia · texto. Consulta consumidores y fallback antes de cambiarlo. Componente
alert
var(--neu-warning-text)
Declaración raíz
--neu-warning-text alert
--neu-autocomplete-option-height Ajuste de autocomplete: option · altura. Consulta consumidores y fallback antes de cambiarlo. Componente
autocomplete
40px
Declaración raíz
— autocomplete
--neu-bg Color de fondo base de una página o superficie. Semánticos
semantic
#f8fafc
Declaración raíz
— select
--neu-block-ui-bg Ajuste de block-ui: fondo. Consulta consumidores y fallback antes de cambiarlo. Componente
block-ui
rgba(255, 255, 255, 0.6)
Declaración raíz
— block-ui
--neu-block-ui-radius Ajuste de block-ui: radio de borde. Consulta consumidores y fallback antes de cambiarlo. Componente
block-ui
var(--neu-radius-lg)
Declaración raíz
--neu-radius-lg block-ui
--neu-border Ajuste compartido: borde. Consulta consumidores y fallback antes de cambiarlo. Semánticos
semantic
rgba(15, 23, 42, 0.08)
Declaración raíz
— accordion, autocomplete, badge, bottom-sheet, calendar, card, carousel, cascade-select, chip, command-palette, confirm-popup, dashboard-grid, data-view, date-input, divider, dock, empty-state, gallery, inline-editor, input-mask, input-tags, input, kanban, listbox, mega-menu, menu, modal, nav, number-input, pagination, panel, password, pick-list, rich-text-editor, select, sidebar, speed-dial, spinner, split-button, stats-card, stepper, table, tabs, tag, textarea, timeline-grid, timeline, toggle-button-group, tree-select, tree-table, tree, uploader
--neu-border-color Ajuste compartido: borde · color. Consulta consumidores y fallback antes de cambiarlo. Semánticos
semantic
var(--neu-border)
Declaración raíz
--neu-border color-picker, confirm-dialog, context-menu, filter-bar, input-otp, knob, notification-center, popover, splitter, toolbar
--neu-border-focus Ajuste compartido: borde · foco. Consulta consumidores y fallback antes de cambiarlo. Semánticos
semantic
var(--neu-primary)
Declaración raíz
--neu-primary rich-text-editor, textarea
--neu-border-hover Ajuste compartido: borde · estado hover. Consulta consumidores y fallback antes de cambiarlo. Semánticos
semantic
rgba(15, 23, 42, 0.16)
Declaración raíz
— autocomplete, card, chip, date-input, input, modal, pagination, pick-list, radio, select, Estilos compartidos, table, uploader
--neu-border-subtle Ajuste compartido: borde · subtle. Consulta consumidores y fallback antes de cambiarlo. Semánticos
semantic
var(--neu-border)
Declaración raíz
--neu-border cascade-select
--neu-button-background Fondo del tratamiento solid de Button con tono brand. Componente
button
var(--neu-primary-solid)
component-fallback
--neu-primary-solid button
--neu-button-background-hover Fondo de hover/activo del tratamiento solid de Button con tono brand. Componente
button
var(--neu-primary-solid-hover)
component-fallback
--neu-primary-solid-hover button
--neu-button-border Color de borde asociado al fondo solid de Button con tono brand. Componente
button
var(--neu-primary-solid)
component-fallback
--neu-primary-solid button
--neu-button-foreground Color de texto e icono asociado al fondo solid de Button con tono brand. Componente
button
var(--neu-primary-solid-fg)
component-fallback
--neu-primary-solid-fg button
--neu-cmd-bg Ajuste de cmd: fondo. Consulta consumidores y fallback antes de cambiarlo. Componente
cmd
var(--neu-surface)
Declaración raíz
--neu-surface
--neu-cmd-highlight Ajuste de cmd: highlight. Consulta consumidores y fallback antes de cambiarlo. Componente
cmd
var(--neu-primary-50)
Declaración raíz
--neu-primary-50
--neu-cmd-radius Ajuste de cmd: radio de borde. Consulta consumidores y fallback antes de cambiarlo. Componente
cmd
var(--neu-radius-xl)
Declaración raíz
--neu-radius-xl
--neu-cmd-shadow Ajuste de cmd: sombra. Consulta consumidores y fallback antes de cambiarlo. Componente
cmd
var(--neu-shadow-lg)
Declaración raíz
--neu-shadow-lg command-palette
--neu-code-block-accent Ajuste de code-block: acento. Consulta consumidores y fallback antes de cambiarlo. Componente
code-block
#9ab8ff
Declaración raíz
— code-block
--neu-code-block-bar-bg Ajuste de code-block: bar · fondo. Consulta consumidores y fallback antes de cambiarlo. Componente
code-block
#16161e
Declaración raíz
— code-block
--neu-code-block-bg Ajuste de code-block: fondo. Consulta consumidores y fallback antes de cambiarlo. Componente
code-block
#1a1b26
Declaración raíz
— code-block
--neu-code-block-border Ajuste de code-block: borde. Consulta consumidores y fallback antes de cambiarlo. Componente
code-block
rgba(255, 255, 255, 0.14)
Declaración raíz
— code-block
--neu-code-block-copy-bg Ajuste de code-block: copy · fondo. Consulta consumidores y fallback antes de cambiarlo. Componente
code-block
rgba(255, 255, 255, 0.12)
Declaración raíz
— code-block
--neu-code-block-copy-border Ajuste de code-block: copy · borde. Consulta consumidores y fallback antes de cambiarlo. Componente
code-block
rgba(255, 255, 255, 0.22)
Declaración raíz
— code-block