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

BottomSheet

Presenta una tarea breve en una hoja modal anclada a la parte inferior.

Categoría
Capas y diálogos
Import
@neural-ui/core/bottom-sheet
Selector
neu-bottom-sheet
import { NeuBottomSheetComponent } from '@neural-ui/core/bottom-sheet';

Uso

La aplicación gestiona open. Conéctalo y acepta closeRequested aplicando false cuando proceda cerrar. opened y closed informan de transiciones, no sustituyen open. Proyecta el contenido y los espacios de cabecera o pie disponibles. Mantén un activador con nombre para recuperar el foco. Bloquear el cierre automático no debe eliminar una acción explícita para terminar.

Ejemplos

Prueba esta interacción gestionada por la aplicación. Código incluye los eventos y los datos iniciales.

Ejemplos

Eventos: 0

Prueba y configura

Cambia las opciones públicas, prueba el resultado y consulta el template actualizado. Código contiene la implementación ejecutable completa.

Prueba y configura

Eventos: 0

template.html
<button neu-button (neuClick)="open.set(true)">
  {{ t("Open example", "Abrir ejemplo") }}</button
><neu-bottom-sheet
  [open]="open()"
  [size]="'md'"
  [disableClose]="false"
  (closeRequested)="open.set(false); record('closeRequested', $event)"
  (opened)="record('opened')"
  (closed)="record('closed')"
  [closeLabel]="'Cerrar'"
  [title]="'Revisar cambios'"
><p>
    {{
      t(
        "Review the content, then close to return to the trigger.",
        "Revisa el contenido y cierra para regresar al activador."
      )
    }}
  </p>
  <button neu-button variant="outline" (neuClick)="open.set(false)">
    {{ t("Done", "Terminar") }}
  </button></neu-bottom-sheet
>

Estado y eventos

La aplicación gestiona open. Conéctalo y acepta closeRequested aplicando false cuando proceda cerrar. opened y closed informan de transiciones, no sustituyen open. Proyecta el contenido y los espacios de cabecera o pie disponibles. Mantén un activador con nombre para recuperar el foco. Bloquear el cierre automático no debe eliminar una acción explícita para terminar.

Accesibilidad y teclado

Tab permanece en la superficie modal. Escape solicita cerrar cuando está habilitado. El cierre devuelve el foco al activador; Sidebar persistente es navegación de la página, no una tarea modal.

Tecla
Acción
Tab En modo modal, recorre los controles de la superficie. Una Sidebar persistente sigue el orden normal de la página.
Shift + Tab Recorre el foco en sentido inverso; en modo modal permanece dentro de la superficie.
Escape Solicita cerrar cuando está habilitado; al cerrar, el foco vuelve al activador.

API

Inputs, modelos y Outputs se extraen del paquete Core instalado. Los tipos públicos enlazan a sus definiciones. Los Templates incluyen ejemplos ejecutables.

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
ariaLabelstring''[ariaLabel]Nombre accesible del control o región.
backdropbooleantrue[backdrop]Muestra el fondo de la hoja detrás de la superficie modal.
closeLabelstring'Close'[closeLabel]Etiqueta de cerrar vista previa. Tradúcela para tu aplicación.
disableClosebooleanfalse[disableClose]Impide cerrar automáticamente con Escape o el fondo; conserva una acción explícita para terminar.
initialFocusstring'first'[initialFocus]Elige la estrategia o selector de foco inicial al abrir la hoja.
openbooleanfalse[open]Visibilidad gestionada por la aplicación. Aplica false al aceptar una solicitud de cierre.
sizeNeuBottomSheetSize'md'[size]Tamaño del control. El tipo indica la escala o unidad numérica admitida.
titlestring''[title]Título visible opcional sobre el contenido proyectado.

Outputs

Escucha un evento con (evento)="handler($event)". La tabla indica qué datos recibe tu función y cómo utilizarlos.

Nombre
Valor emitido
Uso en el template
Descripción
closedvoid(closed)="onClosed($event)"Informa del cierre de este componente. El tipo indica los datos emitidos.
closeRequestedNeuCloseRequest(closeRequested)="onCloseRequested($event)"Solicita cerrar con el motivo y evento original. La aplicación acepta aplicando open=false.
openedvoid(opened)="onOpened($event)"Informa de la apertura de este componente. El tipo indica los datos emitidos.

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
*

Contenido proyectado

Ver ejemplo
Proyección de contenido

Contenido proporcionado por la aplicación.

<ng-content />

Contexto utilizado: —

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

Contenido proyectado

*

Contenido proyectado

Eventos: 0

Public Types

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

Estilos y tokens

Usa los tokens públicos de la referencia. El diseño del contenedor pertenece a tu aplicación; comprueba el resultado en modo claro y oscuro y en espacios estrechos.

Tokens específicos

Este componente utiliza tokens compartidos del tema en lugar de tokens específicos.

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-border Bordes normales de controles y celdas Compartido con otros consumidores de Core; limita el cambio a un ámbito. rgba(15, 23, 42, 0.08)
--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-overlay-bg Valor del tema heredado que utiliza este componente Compartido con otros consumidores de Core; limita el cambio a un ámbito. rgba(15, 23, 42, 0.45)
--neu-shadow-lg Elevación de la superficie o capa Compartido con otros consumidores de Core; limita el cambio a un ámbito. 0 10px 30px rgba(15, 23, 42, 0.1), 0 4px 8px rgba(15, 23, 42, 0.04)
--neu-z-modal Valor del tema heredado que utiliza este componente Compartido con otros consumidores de Core; limita el cambio a un ámbito. 200