Descripción general del cuadro de diálogo Web Components

    El componente de diálogo Ignite UI for Web Components se utiliza para mostrar información o solicitar al usuario una acción o confirmación. Se muestra en una ventana modal, lo que significa que el usuario no puede interactuar con la aplicación principal hasta que se realice una determinada acción que cierre el cuadro de diálogo.

    Ignite UI for Web Components Dialog Example

    Este ejemplo demuestra cómo crear un componente de diálogo en Web Components.

    Usage

    Primero, debe instalar la Ignite UI for Web Components ejecutando el siguiente comando:

    npm install igniteui-webcomponents

    import { defineComponents, IgcDialogComponent } from 'igniteui-webcomponents';

defineComponents(IgcDialogComponent);

    Para obtener una introducción completa a Ignite UI for Web Components, lea el tema Introducción.

    La forma más sencilla de mostrar el componente de diálogo es utilizar su método show y llamarlo al hacer clic en un botón.

    <igc-button onclick="dialog.show()" variant="contained">Show Dialog</igc-button>

<igc-dialog id="dialog" title="Confirmation">
    <p>Are you sure you want to delete the Annual_Report_2016.pdf and Annual_Report_2017.pdf files?</p>
    <igc-button slot="footer" onclick="dialog.close()" variant="flat">Cancel</igc-button>
    <igc-button slot="footer" onclick="dialog.close()" variant="flat">OK</igc-button>
</igc-dialog>

    El componente Diálogo proporciona una propiedad open, que le brinda la posibilidad de configurar su estado según el escenario de su aplicación.

    Utilice la propiedad title para establecer el título del diálogo. Sin embargo, si se proporciona algún contenido en el espacio title, tendrá prioridad sobre la propiedad.

    Se pueden colocar botones de acción o información adicional en la parte inferior del cuadro de diálogo a través de la ranura del pie footer. Si no se agrega ningún contenido allí, se mostrará un botón OK predeterminado que cierra el cuadro de diálogo al hacer clic. En caso de que no desee que se muestre este botón, puede establecer la propiedad hideDefaultAction en verdadero. El valor predeterminado es falso.

    Closing

    De forma predeterminada, el cuadro de diálogo se cierra automáticamente cuando el usuario presiona ESC. Puede evitar este comportamiento utilizando la propiedad keepOpenOnEscape. El valor predeterminado es falso. Si hay un menú desplegable abierto (o cualquier otro elemento que deba manejar ESC internamente) en el cuadro de diálogo, presionar ESC una vez cerrará el menú desplegable y presionarlo nuevamente cerrará el cuadro de diálogo.

    Utilice la propiedad closeOnOutsideClick para configurar si el cuadro de diálogo debe cerrarse al hacer clic fuera de él. El valor predeterminado es falso.

    Form

    Los elementos del formulario pueden cerrar un cuadro de diálogo si tienen el atributo method="dialog". Al enviar el formulario se cerrará el cuadro de diálogo.

    Styling

    El componente de diálogo expone varias partes CSS (base, title, content y footer) para brindarle control total sobre su estilo.

    igc-dialog::part(content) {
    background: #011627;
    color: white;
}

igc-dialog::part(title),
igc-dialog::part(footer) {
    background: #011627;
    color: #ECAA53;
}

    API References

    Additional Resources