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

    El componente Ignite UI for Web Components cuadro de diálogo se utiliza para mostrar cierta 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.

    Ejemplo de diálogo Ignite UI for Web Components

    En este ejemplo se muestra cómo crear un componente de diálogo en Web Components.

    EXAMPLE
    TS
    HTML
    CSS

    ¿Te gusta esta muestra? Obtenga acceso a nuestro kit de herramientas de Ignite UI for Web Components completo y comience a crear sus propias aplicaciones en minutos. Descárgalo gratis.

    Uso

    En primer lugar, debe instalar el Ignite UI for Web Components ejecutando el siguiente comando:

    npm install igniteui-webcomponents
    cmd
    import { defineComponents, IgcDialogComponent } from 'igniteui-webcomponents';
    
    defineComponents(IgcDialogComponent);
    ts

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

    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>
    html

    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.

    Clausura

    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.

    EXAMPLE
    TS
    HTML
    CSS

    Forma

    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.

    EXAMPLE
    TS
    HTML
    CSS

    Estilo

    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;
    }
    css

    EXAMPLE
    TS
    HTML
    DialogStyling.css
    index.css

    Ignite UI for Web Components | CTA Banner

    Referencias de API

    Recursos adicionales