ion-item-group verwenden

Das meiste Ionic-Markup funktioniert unverändert. Wenn eine ion-list mit inset="true" verwendet wird, umschließen Sie ihre Elemente mit ion-item-group und belassen Sie ion-list-header außerhalb der Gruppe.

Die Beispiele verwenden frameworkunabhängiges Web-Component-Markup. Verwenden Sie in React oder Vue die entsprechende Komponenten- und Property-Syntax.

<ion-list inset="true">
  <ion-list-header><ion-label>Connections</ion-label></ion-list-header>
  <ion-item-group>
    <ion-item>...</ion-item>
    <ion-item>...</ion-item>
  </ion-item-group>
</ion-list>

Für Listen ohne inset="true" ist kein Wrapper erforderlich.

Die Listenstruktur mit ESLint prüfen.

Warum der Wrapper erforderlich ist

Ionic weist normalerweise ion-list den Hintergrund zu. Dadurch erscheint ion-list-header auf derselben Fläche wie die Listenelemente. Das iOS-26-Layout behandelt die Überschrift und die Elementfläche getrennt.

Das Theme führt deshalb folgende Änderungen durch:

• Es macht den Hintergrund der eingerückten ion-list transparent;
• es weist ion-item-group die Fläche für die Elemente zu; und
• es belässt ion-list-header außerhalb dieser Fläche.

Dasselbe Markup für Material Design verwenden

@rdlabo/ionic-theme-md3 unterstützt dasselbe gruppierte Markup, sodass sich eine Vorlage für beide Ionic-Modi verwenden lässt.

Wenn eine Anwendung dieses Paket ohne @rdlabo/ionic-theme-md3 verwendet, importieren Sie das optionale Stylesheet, um dieselbe gruppierte Anordnung im Material-Modus anzuwenden:

@import '@rdlabo/ionic-theme-ios26/dist/css/md-ion-list-inset.css';

Zweizeilige Elemente und Gruppen mit Abschnittsüberschriften finden Sie unter Spezielles Markup und Klassen.