Tabelle
Mehrfachauswahl (bulkeditchange)
BulkEditCheckbox setzt eine Auswahlspalte davor. Das Grid steht dafür in einem Formular; im Browser meldet das Ereignis bulkeditchange jede Änderung der Auswahl.
@model IReadOnlyList<KursZeile>
@* Das Grid steht in einem Formular: Die Auswahlkästchen sind ganz gewöhnliche Formularfelder und
werden beim Absenden unter dem Namen der Spalte aus BulkEditCheckbox übertragen – hier «Id».
NestedForm() sorgt dafür, dass die Dialoge des Grids kein zweites Formular aufspannen. *@
<form method="post" asp-area="Tabelle" asp-controller="TabelleBeispiel" asp-action="Auswahl">
@Html.Fmh(Fmh<KursZeile>.Grid
.Id("kurse-mehrfachauswahl")
.BindTo(Model)
.NestedForm()
.DeleteConfirmMessage("Soll dieser Kurs wirklich entfernt werden?")
.EnableSorting(nameof(KursZeile.Datum), SortDirection.Ascending)
.Columns(spalten =>
{
@* Die Auswahlspalte steht immer zuvorderst – das Kästchen im Kopf wählt alle Zeilen. *@
spalten.BulkEditCheckbox(x => x.Id);
spalten.For(x => x.Bezeichnung)
.Named("Kurs")
.IsSortable();
spalten.For(x => x.Datum)
.Named("Datum")
.Format("{0:dd.MM.yyyy}")
.IsSortable();
@* YesNo macht aus dem Wahrheitswert «Ja»/«Nein» statt «True»/«False». *@
spalten.For(x => x.Bestanden)
.Named("Bestanden")
.Format(GridValueFormat.YesNo)
.IsSortable();
spalten.Button(x => FmhGrid.DeleteButton("Entfernen", "TabelleBeispiel", new { area = "Tabelle", id = x.Id }));
spalten.Button(x => FmhGrid.EditButton("Bearbeiten", "TabelleBeispiel", new { area = "Tabelle", id = x.Id }));
}))
<p class="small mt-3 mb-2" data-auswahl-ausgabe>Noch nichts ausgewählt.</p>
<button type="submit" class="btn btn-primary" id="btnAuswahlUebernehmen" disabled>Auswahl übernehmen</button>
</form>
@* Der Listener steht im Tab «JavaScript» (wwwroot/js/demos/tabelle-mehrfachauswahl.js). *@
<script src="~/js/demos/tabelle-mehrfachauswahl.js" asp-append-version="true"></script>
using System;
using System.Collections.Generic;
namespace FMH.Komponente.WebUI.Areas.Tabelle.Models
{
/// <summary>
/// Eine Zeile der Demo-Tabelle. Die Eigenschaften decken die Fälle ab, die im Grid
/// unterschiedlich behandelt werden: Text, Zahl, Datum, Wahrheitswert und ein leerer Wert.
/// </summary>
public class KursZeile
{
public int Id { get; set; }
public string Bezeichnung { get; set; }
public string Anbieter { get; set; }
public DateTime Datum { get; set; }
public decimal Punkte { get; set; }
public bool IstAnerkannt { get; set; }
/// <summary>
/// Bewusst teilweise leer: zeigt, was EmptyColumnChar aus einer leeren Zelle macht.
/// </summary>
public string Bemerkung { get; set; }
/// <summary>
/// Fachliche Sperre der Zeile: Ein abgeschlossener Kurs darf nicht mehr entfernt werden.
/// Grundlage für <c>Disabled(...)</c> und <c>Visible(...)</c> an den Zeilen-Aktionen.
/// </summary>
public bool IstAbgeschlossen { get; set; }
/// <summary>
/// Zustand des Umschalters. Wird über die Demo-Aktion «Bestanden» tatsächlich gekippt —
/// deshalb veränderlich und nicht nur lesend.
/// </summary>
public bool Bestanden { get; set; }
/// <summary>
/// Unterzeilen der Tabelle. Bewusst bei einigen Kursen leer: Ohne Einträge rendert das Grid
/// statt der Aufklapp-Schaltfläche das Zeichen aus EmptyColumnChar.
/// </summary>
public IReadOnlyList<KursDokument> Dokumente { get; set; } = new List<KursDokument>();
/// <summary>
/// Nur für den Tooltip der Aufklapp-Spalte — der Standardtext nennt sonst dieselbe Zahl
/// ohne Bezug zum Kurs.
/// </summary>
public int AnzahlDokumente => this.Dokumente.Count;
/// <summary>
/// Fertig formatierte Punktzahl für die Gruppe «Datasource (Ajax)». Auf dem Ajax-Weg wirkt
/// <c>Format(...)</c> nicht — der Wert geht so an den Browser, wie ihn der Endpunkt liefert.
/// </summary>
public string PunkteText => $"{this.Punkte:0.0} Punkte";
/// <summary>
/// Ersatz für <c>Format(GridValueFormat.YesNo)</c> auf dem Ajax-Weg. Sortiert wird über
/// <c>SortByKey(x => x.Bestanden)</c> weiterhin nach dem Wahrheitswert.
/// </summary>
public string BestandenText => this.Bestanden ? "Ja" : "Nein";
/// <summary>
/// Kontaktadresse des Anbieters — Grundlage der Mail-Schaltfläche im Beispiel «Aktionen ohne
/// Seitenwechsel». Sie setzt diesen Wert über <c>ClientDataKey("row.KontaktMail")</c> hinter
/// das <c>mailto:</c> ihrer Adresse, statt wie sonst die Id der Zeile.
/// </summary>
public string KontaktMail => $"kurse@{Kuerzel(this.Anbieter)}.example.ch";
/// <summary>
/// Ersatz für eine <c>Custom</c>-Spalte auf dem Ajax-Weg: Das Markup entsteht im Endpunkt
/// und nicht im Razor-Ausdruck, weil die Zeilen dort gar nicht vorliegen.
/// </summary>
public string StatusHtml => this.IstAbgeschlossen
? "<span class=\"badge text-bg-secondary\">abgeschlossen</span>"
: "<span class=\"badge text-bg-success\">offen</span>";
// Aus «Universität Zürich» wird «universitaet-zuerich»: Umlaute und Leerzeichen haben in
// einer Mailadresse nichts verloren.
private static string Kuerzel(string anbieter)
{
return (anbieter ?? string.Empty).ToLowerInvariant()
.Replace("ä", "ae")
.Replace("ö", "oe")
.Replace("ü", "ue")
.Replace(" ", "-");
}
}
}
using System;
using System.Collections.Generic;
using System.Linq;
namespace FMH.Komponente.WebUI.Areas.Tabelle.Models
{
/// <summary>
/// Die Testdaten der Demo. Statisch und ohne Datenbank — jede Seite arbeitet auf derselben
/// Liste, damit sich die Beispiele untereinander vergleichen lassen.
/// </summary>
/// <remarks>
/// Die Liste ist prozessweit dieselbe Instanz. Die Beispiele «Umschalt-Aktion» und
/// «Unterzeilen» verändern sie bewusst (Umschalten, Umbenennen), damit die Wirkung sichtbar
/// wird; nach einem Neustart der Anwendung steht wieder der Ausgangszustand.
/// </remarks>
public static class KursDaten
{
private static readonly IReadOnlyList<KursZeile> Alle = new List<KursZeile>
{
Zeile(
1,
"Grundkurs Notfallmedizin",
"FMH Bildung",
"2026-01-14",
12.5m,
true,
"Präsenzkurs",
istAbgeschlossen: true,
bestanden: true,
dokumente: new[] { Dokument(101, "Anmeldebestaetigung.pdf", 184320), Dokument(102, "Teilnahmebeleg.pdf", 96256) }),
Zeile(2, "Refresher Innere Medizin", "SIWF Akademie", "2026-02-03", 8m, true, null, istAbgeschlossen: true, bestanden: false),
Zeile(
3,
"Workshop Gesprächsführung",
"Kantonsspital Bern",
"2026-02-19",
4m,
false,
"Wartet auf Beleg",
istAbgeschlossen: false,
bestanden: false,
dokumente: new[] { Dokument(103, "Programm.pdf", 512000) }),
Zeile(4, "Fortbildung Radiologie", "Universität Zürich", "2026-03-07", 16m, true, null, istAbgeschlossen: true, bestanden: true),
Zeile(5, "Seminar Qualitätssicherung", "FMH Bildung", "2026-03-22", 6.5m, false, null, istAbgeschlossen: false, bestanden: false),
Zeile(
6,
"Kongress Kardiologie",
"Swiss Heart",
"2026-04-11",
20m,
true,
"Zweitägig",
istAbgeschlossen: false,
bestanden: true,
dokumente: new[]
{
Dokument(104, "Kongressprogramm.pdf", 1258291),
Dokument(105, "Hotelbestaetigung.pdf", 71680),
Dokument(106, "Quittung.pdf", 40960),
}),
Zeile(7, "Kurs Strahlenschutz", "Bundesamt für Gesundheit", "2026-04-28", 9m, true, null, istAbgeschlossen: true, bestanden: true),
Zeile(
8,
"Update Pädiatrie",
"Kinderspital Zürich",
"2026-05-15",
7.5m,
false,
"Anmeldung offen",
istAbgeschlossen: false,
bestanden: false,
dokumente: new[] { Dokument(107, "Anmeldung.pdf", 65536) }),
Zeile(
9,
"Fallseminar Onkologie",
"SIWF Akademie",
"2026-06-02",
11m,
true,
null,
istAbgeschlossen: true,
bestanden: false,
dokumente: new[] { Dokument(110, "Fallsammlung.pdf", 327680), Dokument(111, "Auswertungsbogen.pdf", 88064) }),
Zeile(10, "Praxiskurs Sonografie", "Universität Basel", "2026-06-24", 14m, true, null, istAbgeschlossen: false, bestanden: true),
Zeile(11, "Kurs Palliative Care", "FMH Bildung", "2026-07-09", 10m, false, null, istAbgeschlossen: false, bestanden: false),
Zeile(
12,
"Symposium Neurologie",
"Inselspital",
"2026-08-18",
18m,
true,
"Mit Poster-Session",
istAbgeschlossen: true,
bestanden: true,
dokumente: new[] { Dokument(108, "Posterabstract.pdf", 245760), Dokument(109, "Zertifikat.pdf", 133120) }),
};
public static IReadOnlyList<KursZeile> Laden()
{
return Alle;
}
public static KursZeile Laden(int id)
{
return Alle.FirstOrDefault(zeile => zeile.Id == id);
}
/// <summary>
/// Leere Liste für das Beispiel «Ohne Daten».
/// </summary>
public static IReadOnlyList<KursZeile> Leer()
{
return new List<KursZeile>();
}
/// <summary>
/// Kippt den Zustand für das Beispiel «Umschalt-Aktion» und liefert den neuen Wert.
/// </summary>
public static bool Umschalten(int id)
{
var zeile = Laden(id);
if (zeile == null)
{
return false;
}
zeile.Bestanden = !zeile.Bestanden;
return zeile.Bestanden;
}
public static KursDokument LadeDokument(int id)
{
return Alle.SelectMany(zeile => zeile.Dokumente)
.FirstOrDefault(dokument => dokument.Id == id);
}
/// <summary>
/// Umbenennen für das Beispiel «Unterzeilen». Der Aufruf kommt aus dem Umbenennen-Dialog
/// des Grids und erwartet eine Antwort im JSON-Format.
/// </summary>
public static KursDokument BenenneDokumentUm(int id, string dateiname)
{
var dokument = LadeDokument(id);
if (dokument == null || string.IsNullOrWhiteSpace(dateiname))
{
return null;
}
dokument.Dateiname = dateiname;
return dokument;
}
private static KursDokument Dokument(int id, string dateiname, int dateigroesse)
{
return new KursDokument
{
Id = id,
Dateiname = dateiname,
Dateigroesse = dateigroesse,
};
}
private static KursZeile Zeile(
int id,
string bezeichnung,
string anbieter,
string datum,
decimal punkte,
bool istAnerkannt,
string bemerkung,
bool istAbgeschlossen = false,
bool bestanden = false,
IReadOnlyList<KursDokument> dokumente = null)
{
return new KursZeile
{
Id = id,
Bezeichnung = bezeichnung,
Anbieter = anbieter,
Datum = DateTime.Parse(datum),
Punkte = punkte,
IstAnerkannt = istAnerkannt,
Bemerkung = bemerkung,
IstAbgeschlossen = istAbgeschlossen,
Bestanden = bestanden,
Dokumente = dokumente ?? new List<KursDokument>(),
};
}
}
}
using System.Linq;
using FMH.Komponente.Basis.Erweiterungen;
using FMH.Komponente.Basis.Ui.Feedback.Alert;
using FMH.Komponente.WebUI.Areas.Tabelle.Models;
using Microsoft.AspNetCore.Mvc;
namespace FMH.Komponente.WebUI.Areas.Tabelle.Controllers.Beispiele
{
// Die Ziele der Zeilen-Aktionen. In einem Projekt stehen hier die fachlichen Endpunkte; für die
// Demo genügt eine Rückmeldung, aus der hervorgeht, welche Zeile und welche Aktion es war.
//
// Welche HTTP-Methode eine Aktion braucht, bestimmt der Schaltflächen-Typ:
// Ansehen/Bearbeiten/Custom/Toggle rendern einen Link (GET), Entfernen und Dialog laufen über
// den Bestätigungsdialog des Grids und kommen als POST an.
[Area("Tabelle")]
public class TabelleBeispielController : Controller
{
public IActionResult Anbieter(int id)
{
return this.Zurueck(id, "Anbieter angezeigt");
}
public IActionResult Ansehen(int id)
{
return this.Zurueck(id, "Angesehen");
}
[HttpPost]
public IActionResult Auswahl(int[] id)
{
// Das Auswahlkästchen postet unter dem Namen der Spalte aus BulkEditCheckbox — hier
// also "Id". Ohne Auswahl kommt gar kein Wert an, das Feld bleibt leer.
if (id == null || id.Length == 0)
{
this.AddAlert("Kein Kurs ausgewählt.", AlertType.Warning, autoHide: true);
return this.RedirectToAction("Mehrfachauswahl", "Demo", new { area = "Tabelle" });
}
var bezeichnungen = id.Select(
kursId => KursDaten.Laden(kursId)
?.Bezeichnung ?? $"Id {kursId}")
.ToArray();
this.AddAlert($"{bezeichnungen.Length} ausgewählt: {string.Join(", ", bezeichnungen)}", AlertType.Info, autoHide: true);
return this.RedirectToAction("Mehrfachauswahl", "Demo", new { area = "Tabelle" });
}
public IActionResult Bearbeiten(int id)
{
return this.Zurueck(id, "Bearbeiten geöffnet");
}
/// <summary>
/// Ziel des Umschalters. Der aktuelle Zustand kommt als Parameter mit — das Grid hängt ihn
/// unter dem Namen «is» + Eigenschaft aus <c>ToggleStatus(...)</c> an die Adresse an.
/// </summary>
public IActionResult Bestanden(int id, bool isBestanden)
{
var neu = KursDaten.Umschalten(id);
var zeile = KursDaten.Laden(id);
var bezeichnung = zeile?.Bezeichnung ?? $"Id {id}";
this.AddAlert(
$"{bezeichnung}: {(isBestanden ? "war bestanden" : "war offen")} → {(neu ? "bestanden" : "offen")}",
AlertType.Info,
autoHide: true);
return this.Herkunft("Umschalten");
}
[HttpPost]
public IActionResult Dialog(int id)
{
return this.Zurueck(id, "Im Dialog bestätigt");
}
public IActionResult Dokument(int id)
{
var dokument = KursDaten.LadeDokument(id);
this.AddAlert($"Dokument geöffnet: {dokument?.Dateiname ?? $"Id {id}"}", AlertType.Info, autoHide: true);
return this.Herkunft("Unterzeilen");
}
/// <summary>
/// Ziel des Umbenennen-Dialogs. Die Schaltfläche aus <c>FmhGrid.RenameDocumentButton</c>
/// arbeitet fest über Ajax — die Antwort muss deshalb JSON sein, eine Weiterleitung
/// verarbeitet der Dialog nicht.
/// </summary>
[HttpPost]
public IActionResult DokumentUmbenennen(int id, string dateiname)
{
var dokument = KursDaten.BenenneDokumentUm(id, dateiname);
if (dokument == null)
{
// Auch der Fehlerfall geht als JSON zurück: Der Dialog liest responseJSON aus.
return this.BadRequest("Das Dokument konnte nicht umbenannt werden.");
}
return this.Json($"Dokument umbenannt: {dokument.Dateiname}");
}
[HttpPost]
public IActionResult Entfernen(int id)
{
// Nur Rückmeldung: Die Demo-Daten sind statisch und werden nicht verändert.
return this.Zurueck(id, "Entfernen ausgelöst");
}
/// <summary>
/// Ziel des umschliessenden Formulars im Beispiel «Grid in einem Formular». Zeigt, dass die
/// Eingaben des Formulars ankommen – die Schaltfläche der Zeile schickt dasselbe Formular.
/// </summary>
[HttpPost]
public IActionResult FormularSpeichern(string bemerkung)
{
this.AddAlert($"Formular abgeschickt. Bemerkung: «{bemerkung}»", AlertType.Info, autoHide: true);
return this.Herkunft("Formular");
}
/// <summary>
/// Ziel der Zeilen-Schaltfläche mit <c>RenderAsFormAction</c>. Sie ist ein Submit-Button mit
/// formaction: Es kommt die Zeilen-Id aus der Adresse an und zusätzlich der Inhalt des
/// Formulars – anders als bei einer Zeilen-Aktion, die als Link gerendert wird.
/// </summary>
[HttpPost]
public IActionResult FormularZeile(int id, string bemerkung)
{
var zeile = KursDaten.Laden(id);
var bezeichnung = zeile?.Bezeichnung ?? $"Id {id}";
this.AddAlert($"Zeile «{bezeichnung}» abgeschickt. Bemerkung: «{bemerkung}»", AlertType.Info, autoHide: true);
return this.Herkunft("Formular");
}
private IActionResult Zurueck(int id, string aktion)
{
var zeile = KursDaten.Laden(id);
var bezeichnung = zeile?.Bezeichnung ?? $"Id {id}";
this.AddAlert($"{aktion}: {bezeichnung}", AlertType.Info, autoHide: true);
return this.Herkunft("Index");
}
// Zurück auf die Seite, von der die Aktion kam – sonst landet man auf einer leeren Seite.
private IActionResult Herkunft(string ersatzAktion)
{
var herkunft = this.Request.Headers.Referer.ToString();
if (string.IsNullOrEmpty(herkunft))
{
return this.RedirectToAction(ersatzAktion, "Demo", new { area = "Tabelle" });
}
return this.Redirect(herkunft);
}
}
}
// Demo "Tabelle › Ui › Grid › Mehrfachauswahl": Auswertung der Auswahl im Browser.
//
// Jede Änderung an einem Auswahlkästchen löst das Ereignis "bulkeditchange" aus. Es steigt vom
// Kästchen bis zum document auf, ein Listener auf document genügt also – auch für Zeilen, die erst
// beim Blättern in den DOM kommen.
//
// Im detail stehen:
// name Feldname der Kästchen (der Spaltenname aus BulkEditCheckbox)
// id Id des ausgelösten Kästchens, beim Kästchen im Tabellenkopf der Wert "header"
// checked Zustand des ausgelösten Kästchens
// totalChecked Anzahl aktuell ausgewählter Zeilen
document.addEventListener('bulkeditchange', function (event) {
// Auf der Seite steht nur ein Grid; die Prüfung hält das Beispiel trotzdem übertragbar.
if (event.target.closest('#kurse-mehrfachauswahl') === null) {
return;
}
var detail = event.detail;
var ausgabe = document.querySelector('[data-auswahl-ausgabe]');
var schaltflaeche = document.getElementById('btnAuswahlUebernehmen');
if (ausgabe !== null) {
if (detail.totalChecked === 0) {
ausgabe.textContent = 'Noch nichts ausgewählt.';
} else if (detail.id === 'header') {
ausgabe.textContent = 'Über den Tabellenkopf ausgewählt: ' + detail.totalChecked + ' Zeilen.';
} else {
ausgabe.textContent = detail.totalChecked + ' Zeile(n) ausgewählt (Feldname «' + detail.name + '»).';
}
}
// Typischer Anwendungsfall: Die Sammelaktion bleibt gesperrt, solange nichts ausgewählt ist.
if (schaltflaeche !== null) {
schaltflaeche.disabled = detail.totalChecked === 0;
}
});
// jQuery-Variante zum Beispiel «Mehrfachauswahl» – dasselbe wie im Tab "JavaScript", nur mit
// jQuery geschrieben. Diese Datei wird von der Demo-Seite NICHT geladen; sonst liefe der Listener
// doppelt. Sie ist als Vorlage zum Übernehmen gedacht.
$(document).on('bulkeditchange', '#kurse-mehrfachauswahl input[type="checkbox"]', function (event) {
// jQuery 3 kopiert detail vom nativen Event auf sein eigenes Event-Objekt; bei älteren
// Versionen führt der Weg über originalEvent.
var detail = event.detail || event.originalEvent.detail;
if (detail.totalChecked === 0) {
$('[data-auswahl-ausgabe]').text('Noch nichts ausgewählt.');
} else if (detail.id === 'header') {
$('[data-auswahl-ausgabe]').text('Über den Tabellenkopf ausgewählt: ' + detail.totalChecked + ' Zeilen.');
} else {
$('[data-auswahl-ausgabe]').text(detail.totalChecked + ' Zeile(n) ausgewählt (Feldname «' + detail.name + '»).');
}
// Typischer Anwendungsfall: Die Sammelaktion bleibt gesperrt, solange nichts ausgewählt ist.
$('#btnAuswahlUebernehmen').prop('disabled', detail.totalChecked === 0);
});
Darstellung
BulkEditCheckbox setzt eine Auswahlspalte vor die Daten. Das Kästchen im Tabellenkopf wählt alle
Zeilen der Seite aus.
<form method="post" asp-area="Tabelle" asp-controller="TabelleBeispiel" asp-action="Auswahl">
@Html.Fmh(Fmh<KursZeile>.Grid
.NestedForm()
.Columns(spalten =>
{
spalten.BulkEditCheckbox(x => x.Id);
…
}))
<button type="submit">Auswahl übernehmen</button>
</form>
Das Grid gehört in ein Formular
Die Kästchen sind gewöhnliche Formularfelder. Ihr Feldname ist der Spaltenname aus
BulkEditCheckbox — bei x => x.Id also Id, ihr Wert die Id der Zeile. Auf der Serverseite
genügt deshalb ein Parameter int[] id. Ohne Auswahl kommt gar kein Wert an.
.NestedForm() ist dabei Pflicht. Die Dialoge des Grids spannen sonst ein eigenes Formular im
Formular auf — verschachtelte Formulare sind ungültiges HTML, und der Browser wirft das innere weg.
Auswahl im Browser auswerten
Jede Änderung löst das Ereignis bulkeditchange aus. Es steigt vom Kästchen bis zum document
auf, ein Listener dort genügt also auch für Zeilen, die erst beim Blättern erscheinen.
Feld in detail |
Bedeutung |
|---|---|
name |
Feldname der Kästchen (der Spaltenname) |
id |
Id des ausgelösten Kästchens; beim Kästchen im Tabellenkopf der Wert "header" |
checked |
Zustand des ausgelösten Kästchens |
totalChecked |
Anzahl aktuell ausgewählter Zeilen |
Die Tabs «JavaScript» und «jQuery» zeigen dieselbe Auswertung in beiden Schreibweisen; geladen wird nur die JavaScript-Fassung.
Was zu beachten ist
- Mehrfachauswahl und gesperrte Zeilen vertragen sich nicht. Bei einer über
DisableRowgesperrten Zeile wird der Feldname des Kästchens verändert; die Auswahl käme unter einem falschen Namen an. Beides deshalb nicht kombinieren. - Die Auswahl gilt nur für die angezeigte Seite. Wer über Seitengrenzen hinweg auswählen lassen will, muss die Ids selbst mitführen.
- Zeilenklick und Mehrfachauswahl vertragen sich nur bedingt: Wo Kästchen stehen, erwartet der Anwender vom Klick eine Auswahl, keine Navigation.