Descripción general de la casilla de verificación Blazor
Blazor Checkbox es un componente que le permite agregar casillas de verificación a sus aplicaciones Blazor. Se comporta como una casilla de verificación HTML estándar, lo que permite a los usuarios seleccionar estados básicos marcados y no marcados o un estado indeterminado adicional. También obtiene control total sobre el estilo del componente de casilla de verificación Blazor y la posibilidad de usarlo con formularios.
Checkbox Example
Usage
En esencia, IgbCheckbox
permite elegir entre el estado seleccionado o no seleccionado. 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 IgbCheckbox
, debe registrarlo de la siguiente manera:
// in Program.cs file
builder.Services.AddIgniteUIBlazor(typeof(IgbCheckboxModule));
También deberá vincular un archivo CSS adicional para aplicar el estilo al componente IgbCheckbox
. 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" />
La forma más sencilla de empezar a utilizar IgbCheckbox
es la siguiente:
<IgbCheckbox />
[!WARNING] The
IgbCheckbox
component doesn't work with the standard<form>
element. UseForm
instead.
Examples
Label
Para proporcionar una etiqueta significativa para la casilla de verificación, simplemente coloque algo de texto entre las etiquetas de apertura y cierre:
<IgbCheckbox>Label</IgbCheckbox>
Puede especificar si la etiqueta debe colocarse antes o después de la casilla de verificación configurando el atributo label-position
de la casilla de verificación. Los valores permitidos son before
y after
(predeterminado):
<IgbCheckbox LabelPosition="@CheckboxBaseLabelPosition.Before">Label</IgbCheckbox>
La casilla de verificación también puede estar etiquetada por elementos externos a la casilla de verificación. En este caso, el usuario tiene control total para colocar y diseñar la etiqueta de acuerdo con sus necesidades.
<span id="checkbox-label">Label</span>
<IgbCheckbox AriaLabelledby="checkbox-label" />
Checked
Puede utilizar el atributo Checked
del componente para determinar si la casilla de verificación debe activarse o desactivarse de forma predeterminada.
<IgbCheckbox Checked="true" />
Indeterminate
Puede utilizar la propiedad Indeterminate
del componente para establecer el valor de la casilla de verificación en verdadero ni falso.
<IgbCheckbox Indeterminate="true" />
Required
Puede utilizar la propiedad Required
para marcar la casilla de verificación según sea necesario.
<IgbCheckbox Required="true" />
Invalid
Puede utilizar el atributo Invalid
para marcar la casilla de verificación como no válida.
<IgbCheckbox Invalid="true" />
Disabled
Puede utilizar el atributo Disabled
para desactivar la casilla de verificación.
<IgbCheckbox Disabled="true" />
Forms
Puede utilizar los name
atributos y value
cuando utilice la casilla de verificación con Form
.
<IgbCheckbox Name="wifi" Value="enabled" />
Styling
El componente de casilla de verificación expone varias partes CSS (base
, control
, indicator
y label
) para brindarle control total sobre su estilo.
igc-checkbox::part(indicator) {
&::after {
padding: 12px;
border-radius: 14px;
}
}
igc-checkbox::part(indicator checked) {
border-radius: 0;
&::after {
background: olive;
border-color: olive;
stroke: beige;
}
}
API References
IgbCheckbox
Checked
Disabled
Form