Blazor Checkbox (チェックボックス) の概要

Blazor Checkbox は、Blazor アプリにチェックボックスを追加できるコンポーネントです。これは標準の HTML チェックボックスとして動作し、ユーザーが基本的なチェック状態とチェックなし状態、または追加の不確定状態を選択できるようにします。また、Blazor Checkbox コンポーネントのスタイルと、フォームで使用する機能を完全に制御できます。

Checkbox の例

使用方法

IgbCheckbox は、選択された状態と選択されていない状態のどちらかを選択できることです。デフォルトのスタイル設定はマテリアルデザインガイドラインの選択コントロールの仕様に基づきます。

IgbCheckbox を使用する前に、次のように登録する必要があります:

// in Program.cs file

builder.Services.AddIgniteUIBlazor(typeof(IgbCheckboxModule));

また、追加の CSS ファイルをリンクして、スタイルを IgbCheckbox コンポーネントに適用する必要があります。以下は、Blazor Web Assembly プロジェクトの wwwroot/index.html ファイルまたは Blazor Server プロジェクトの Pages/_Host.cshtml ファイルに配置する必要があります:

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

IgbCheckbox の使用を開始する最も簡単な方法は次のとおりです:

<IgbCheckbox />

[!WARNING] IgbCheckbox コンポーネントは標準の <form> 要素では機能しません。代わりに Form を使用してください。

例

ラベル

チェックボックスに意味のあるラベルを付けるには、開始タグと終了タグの間にテキストを配置するだけです。

<IgbCheckbox>Label</IgbCheckbox>

チェックボックスの label-position 属性を設定することにより、チェックボックスの切り替えの前または後にラベルを配置するかどうかを指定できます。許可される値は、before と after (デフォルト) です。

<IgbCheckbox LabelPosition="@CheckboxBaseLabelPosition.Before">Label</IgbCheckbox>

チェックボックスは、チェックボックスの外部の要素でラベル付けすることもできます。この場合、ユーザーはニーズに応じてラベルの位置とスタイルを完全に制御できます。

<span id="checkbox-label">Label</span>
<IgbCheckbox AriaLabelledby="checkbox-label" />

チェック済み

コンポーネントの Checked 属性を使用して、チェックボックスをデフォルトでオンにするかオフにするかを決定できます。

<IgbCheckbox Checked="true" />

不確定

コンポーネントの Indeterminate プロパティを使用して、チェックボックスの値を true にも false にも設定しません。

<IgbCheckbox Indeterminate="true" />

必須

Required プロパティを使用して、チェックボックスを必須としてマークできます。

<IgbCheckbox Required="true" />

無効

Invalid 属性を使用して、チェックボックスを無効としてマークすることができます。

<IgbCheckbox Invalid="true" />

オフ

チェックボックスをオフにするには、Disabled 属性を使用します。

<IgbCheckbox Disabled="true" />

フォーム

Form でチェックボックスを使用する場合は、name と value の属性を使用できます。

<IgbCheckbox Name="wifi" Value="enabled" />

スタイル設定

チェックボックスコンポーネントは、いくつかの CSS パーツ (base、control、indicator、および label) を公開して、スタイルを完全に制御できるようにします。

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