Descripción general de Web Components botones

    The Web Components Button Component lets you enable clickable elements that trigger actions in your Web Components app. You get full control over how you set button variants, configure styles for the wrapped element, and define sizes. The Button Component also gives flexibility through the Web Components Button OnClick event, toggle the Web Components button, disable the Web Components button, and more.

    Web Components Button Example

    Usage

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

    npm install igniteui-webcomponents

    Luego necesitarás importar IgcButtonComponent, su CSS necesario y registrar su módulo, así:

    import { defineComponents, IgcButtonComponent } from "igniteui-webcomponents";
import 'igniteui-webcomponents/themes/light/bootstrap.css';

defineComponents(IgcButtonComponent);

    Para una introducción completa al Ignite UI for Web Components, lee el tema Empezar.

    La forma más sencilla de empezar a utilizarlo IgcButtonComponent es la siguiente:

    <igc-button>Click me</igc-button>

    Prefix / Suffix

    Con las ranuras prefix y suffix del componente IgcButtonComponent, podemos agregar contenido diferente antes y después del contenido principal del botón.

    <igc-button type="button" variant="contained">
    <span slot="prefix">+</span>Click me<span slot="suffix">-</span>
</igc-button>

    Type

    El componente del botón cambiará su estructura interna de un <button> a un elemento de tipo <a> cuando se establezca el atributo href. En ese caso, el botón puede considerarse como un enlace normal. Configurar el atributo href le permitirá configurar también los atributos rel, target y download. En el caso de que el componente del botón utilice un elemento <button> real internamente, podemos especificar su Type estableciendo la propiedad en cualquiera de los siguientes valores:

    • Submit: cuando queremos enviar los datos del formulario.
    • reset- cuando queremos restablecer los datos del formulario a sus valores iniciales
    • button: cuando queremos agregar un botón con una funcionalidad personalizada en cualquier lugar de una página web

    Button Variants

    Contained Button

    Utilice el variant atributo para agregar un botón contenido simple en la plantilla de componentes. Tenga en cuenta que si no establece variant, de forma predeterminada se establecerá en contenido.

    <igc-button variant="contained">Contained</igc-button>

    Outlined Button

    Todo lo que tiene que hacer para crear un outlined botón es cambiar el valor de la variant propiedad:

    <igc-button variant="outlined">Outlined</igc-button>

    Flat Button

    Analógicamente podemos pasar a la variante flat.

    <igc-button variant="flat">Flat</igc-button>

    Floating Action Button

    Podemos crear un botón de acción flotante configurando la variant propiedad en fab:

    <igc-button variant="fab">Fab</igc-button>

    Button Sizing

    Los usuarios pueden cambiar el tamaño de la IgcButtonComponent variable--ig-size CSS. En el siguiente ejemplo, agregaremos algunos botones de opción para mostrar todos los valores de tamaño. De esta manera, cada vez que se seleccione uno, cambiaremos el tamaño del botón.

    import { defineComponents, IgcButtonComponent, IgcRadioComponent, IgcRadioGroupComponent } from 'igniteui-webcomponents';
defineComponents(IgcButtonComponent, IgcRadioComponent, IgcRadioGroupComponent);

    <igc-radio-group id="radio-group" alignment="horizontal">
    <igc-radio name="size" value="small" label-position="after">Small</igc-radio>
    <igc-radio name="size" value="medium" label-position="after" checked>Medium</igc-radio>
    <igc-radio name="size" value="large" label-position="after">Large</igc-radio>
</igc-radio-group>

    this.radioGroup = document.getElementById('radio-group') as IgcRadioGroupComponent;
this.outlinedButton = document.getElementById('outlined-btn') as IgcButtonComponent;
this.flatButton = document.getElementById('flat-btn') as IgcButtonComponent;
this.containedButton = document.getElementById('contained-btn') as IgcButtonComponent;
this.fabButton = document.getElementById('fab-btn') as IgcButtonComponent;

this.radioGroup.addEventListener('click', (radio: any) => {
    this.outlinedButton.style.setProperty('--ig-size', `var(--ig-size-${radio.target.value})`);
    this.flatButton.style.setProperty('--ig-size', `var(--ig-size-${radio.target.value})`);
    this.containedButton.style.setProperty('--ig-size', `var(--ig-size-${radio.target.value})`);
    this.fabButton.style.setProperty('--ig-size', `var(--ig-size-${radio.target.value})`);
});

    El resultado de implementar el código anterior debería verse similar al siguiente:

    Download

    Al establecer la download propiedad, se pedirá al usuario que guarde la URL vinculada en lugar de navegar a ella.

    <igc-button
    href=""
    variant="contained"
    download="url_to_content"
    target="_blank">
    Download
</igc-button>

    Styling

    Expone IgcButtonComponent tres partes CSS que podemos usar para el estilo:

    Nombre Descripción
    base El elemento button nativo del componente igc-button.
    prefix Contenedor de prefijos del componente igc-button.
    suffix Contenedor de sufijos del componente igc-button.

    La base parte CSS nos permite estilizar el elemento envuelto (<button> o <a>).

    igc-button::part(base) {
  background-color: var(--ig-primary-500);
  color: var(--ig-primary-500-contrast);
  padding: 18px;
}

    API References

    Additional Resources