Interruptor Blazor

    El componente Ignite UI for Blazor Switch es un componente de selección de opciones binarias que se comporta de manera similar al componente Switch en iOS.

    Blazor Switch Example

    EXAMPLE
    MODULES
    RAZOR
    CSS

    Like this sample? Get access to our complete Ignite UI for Blazor toolkit and start building your own apps in minutes. Download it for free.

    Usage

    En esencia, el componente IgbSwitch permite alternar entre estados de encendido y apagado. El estilo predeterminado se realiza de acuerdo con la especificación de controles de selección en las pautas de Material Design.

    Antes de utilizar el IgbSwitch, debe registrarlo de la siguiente manera:

    // in Program.cs file
    
    builder.Services.AddIgniteUIBlazor(typeof(IgbSwitchModule));
    razor

    También deberá vincular un archivo CSS adicional para aplicar el estilo al componente IgbSwitch. Es necesario colocar lo siguiente en el archivo wwwroot/index.html de un proyecto Blazor Web Assembly o en el archivo Pages/_Host.cshtml de un proyecto Blazor Server:

    <link href="_content/IgniteUI.Blazor/themes/light/bootstrap.css" rel="stylesheet" />
    razor
    <IgbSwitch />
    razor

    The IgbSwitch component doesn't work with the standard <form> element. Use Form instead.

    Examples

    Label

    Para proporcionar una etiqueta significativa para el cambio, simplemente coloque algo de texto entre las etiquetas de apertura y cierre:

    <IgbSwitch>Label</IgbSwitch>
    razor

    Puede especificar si la etiqueta debe colocarse antes o después del interruptor configurando el atributo LabelPosition del interruptor. Los valores permitidos son before y after (predeterminado):

    <IgbSwitch LabelPosition="@CheckboxBaseLabelPosition.Before">Label</IgbSwitch>
    razor

    El interruptor también puede estar etiquetado por elementos externos al interruptor. En este caso, el usuario tiene control total para colocar y diseñar la etiqueta de acuerdo con sus necesidades.

    <span id="switch-label>Label</span>
    <IgbSwitch AriaLabelledBy="switch-label" />
    razor

    EXAMPLE
    MODULES
    RAZOR
    CSS

    Checked

    Puede utilizar el atributo checked para activar el interruptor.

    <IgbSwitch Checked="true" />
    razor

    EXAMPLE
    MODULES
    RAZOR
    CSS

    Required

    Puede utilizar el atributo required para marcar el cambio como requerido.

    <IgbSwitch Required="true" />
    razor

    Invalid

    Puede utilizar el atributo invalid para marcar el cambio como no válido.

    <IgbSwitch Invalid="true" />
    razor

    Disabled

    Puede utilizar el atributo disabled para deshabilitar el interruptor.

    <IgbSwitch Disabled="true" />
    razor

    EXAMPLE
    MODULES
    RAZOR
    CSS

    Forms

    Puede utilizar los name atributos y value cuando utilice el modificador con Form.

    <IgbSwitch Name="wifi" Value="enabled" />
    razor

    Styling

    El componente de cambio expone varias partes CSS (base, control, thumb y label) para brindarle control total sobre su estilo.

    igc-switch::part(control) {
      background: beige;
      border-radius: 0;
    }
    
    igc-switch::part(thumb) {
      background: olive;
      border-radius: 2px;
      box-shadow: none;
    }
    css

    API References

    Additional Resources