Blazor Dropdown List (ドロップダウン リスト) コンポーネントの概要

    機能豊富な Blazor ドロップダウン リストは、すぐに使用できるフィルタリング、アクセシビリティ、事前選択された値、柔軟なデータ バインディング、グループ化、UI カスタマイズなどを提供します。このコンポーネントが実際に行うことは、HTML 選択タグを効果的かつ簡単に置き換えることであり、ユーザーは事前定義されたいくつかのオプションのセットから編集不可能な値をすばやく選択できます。

    Ignite UI for Blazor ドロップダウン コンポーネントは、事前定義された値のトグル リストを表示し、ユーザーが 1 つのオプション項目をクリックして簡単に選択できるようにします。Blazor ドロップダウン メニューとして機能するようにすばやく構成することも、データをグループ化してより有用な視覚情報を提供するために使用することもできます。また、グループ化を使用すると、フラット データと階層データの両方を使用できます。

    当社のコンポーネントを使用すると、プロジェクトに必要なすべての機能とカスタマイズ オプション (スタイルのカスタマイズ、Blazor ドロップダウン配置オプション、テンプレート、およびヘッダー、フッター、本文、リストなどに表示されるものと方法を変更する機能) を取得できます。

    Blazor Dropdown の例

    次の Blazor ドロップダウン リストの例は、3 つの基本的なオプションから選択できる単純なインタラクティブな Blazor ドロップダウン メニューを実際に使用する方法を示しています。この Blazor ドロップダウン リストの例で実際の動作をご覧ください。

    EXAMPLE
    MODULES
    RAZOR
    CSS

    このサンプルが気に入りましたか? 完全な Ignite UI for Blazorツールキットにアクセスして、すばやく独自のアプリの作成を開始します。無料でダウンロードできます。

    Ignite UI for Blazor で Dropdown List を使用する方法

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

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

    Target (ターゲット)

    Blazor ドロップダウン リストは、ターゲットに対して相対的に配置されます。target スロットを使用すると、クリック時に open プロパティを切り替える組み込みコンポーネントを提供できます。場合によっては、外部ターゲットを使用するか、別のイベントを使用してドロップダウンの開始を切り替えることができます。これは、ターゲットをパラメーターとして提供できる ShowHide、および Toggle メソッドを使用して実現できます。デフォルトでは、ドロップダウン リストは CSS の absolute 位置を使用します。ターゲット要素が固定コンテナー内にあるが、ドロップダウンがそうではない場合、Blazor ドロップダウンの IgbPositionStrategyfixed に設定する必要があります。ドロップダウン リストは、その内容に基づいて自動的にサイズ変更されます。リストの幅をターゲットと同じにする場合は、SameWidth プロパティを true に設定する必要があります。

    EXAMPLE
    MODULES
    RAZOR
    CSS

    位置

    Blazor ドロップダウンの優先配置は、Placement プロパティを使用して設定できます。ドロップダウンのデフォルトの配置は bottom-start です。Flip プロパティは、指定された配置でドロップダウンを表示するのに十分なスペースがない場合に配置を反転するかどうかを決定します。Blazor ドロップダウン リストからそのターゲットまでの距離は、Distance プロパティを使用して指定できます。

    EXAMPLE
    MODULES
    RAZOR
    CSS

    選択

    ユーザーが項目を選択すると、IgbDropdownChange イベントを発行します。ドロップダウンの Select メソッドを使用すると、インデックスまたは値で項目を選択できます。

    Item (項目)

    IgbDropdownItem は、ドロップダウン リストで選択可能な項目を表します。Selected プロパティを設定することにより、選択した項目を事前定義できます。Disabled プロパティを使用して、項目を無効にして選択できないようにすることもできます。IgbDropdownItem には、項目のコンテンツを指定できるデフォルトのスロットがあります。prefix スロットと suffix スロットを使用して、コンテンツの前後に描画されるカスタム コンテンツを提供することもできます。Value プロパティを使用すると、項目にカスタム値を提供できます。Value が設定されていない場合は、項目のテキスト コンテンツに解決されます。

    EXAMPLE
    MODULES
    RAZOR
    CSS

    Header (ヘッダー)

    IgbDropdownHeader を使用して、項目のグループのヘッダーを提供できます。

    EXAMPLE
    MODULES
    RAZOR
    CSS

    Group (グループ)

    Blazor ドロップダウンの項目は、IgbDropdownGroup を使用してグループ化することもできるため、ユーザーは個別のカテゴリを簡単に区別できます。この Blazor ドロップダウン リストの例で実際の動作をご覧ください。

    EXAMPLE
    MODULES
    RAZOR
    CSS

    Scroll Strategy (スクロール方法)

    ScrollStrategy プロパティは、ターゲット要素のコンテナーをスクロールする際のコンポーネントの動作を決定します。デフォルト値は scroll です。これは、ドロップダウンがターゲットとともにスクロールされることを意味します。プロパティを block に設定すると、ドロップダウンが開いている場合にスクロールがブロックされます。プロパティを close ように設定することもできます。これは、スクロール時にドロップダウンが自動的に閉じられることを意味します。

    Keep Open (開いたままにする)

    デフォルトでは、ユーザーがドロップダウンの外側をクリックするか項目を選択すると、ドロップダウンは自動的に閉じられます。KeepOpenOnOutsideClick プロパティと KeepOpenOnSelect プロパティを使用して、この動作を防ぐことができます。

    スタイル設定

    公開された CSS パーツを使用して、ドロップダウンとその項目の外観を変更できます。IgbDropdownbase パーツと list パーツを公開し、IgbDropdownItemprefixcontentsuffix パーツを公開し、IgbDropdownGrouplabel パーツを公開します。

    igc-dropdown::part(list) {
      height: 220px;
    }
    
    igc-dropdown-item[selected] {
      background: var(--ig-success-300);
    }
    
    igc-dropdown-group::part(label) {
      display: flex;
      justify-content: center;
    }
    css

    EXAMPLE
    MODULES
    RAZOR
    CSS

    API リファレンス

    その他のリソース