Erste Schritte

Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-home-indicator`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/home-indicator/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Installieren

Du kannst unser KI-gestütztes Setup nutzen, um das Plugin zu installieren. Füge deinem KI-Tool die Capgo Skills mit folgendem Befehl hinzu:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Nutze anschließend diesen Prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-home-indicator` plugin in my project.

Wenn du ein manuelles Setup bevorziehst, installiere das Plugin mit den folgenden Befehlen und befolge die plattformspezifischen Anweisungen unten:

bun add @capgo/capacitor-home-indicator
npx cap sync

Importieren

import { HomeIndicator } from '@capgo/capacitor-home-indicator';

Quickstart

import { HomeIndicator } from '@capgo/capacitor-home-indicator';

await HomeIndicator.hide();

Beispiel: anzeigen

import { HomeIndicator } from '@capgo/capacitor-home-indicator';

await HomeIndicator.show();

Beispiel: isHidden

import { HomeIndicator } from '@capgo/capacitor-home-indicator';

const { hidden } = await HomeIndicator.isHidden();
if (hidden) {
  console.log('Home indicator is hidden');
} else {
  console.log('Home indicator is visible');
}

Häufige Fehlerquellen

Native Sync: ausführen npx cap sync nach Plugin-Upgrades.
Single Source of Truth: vertraue src/definitions.ts im GitHub Repo.

API Übersicht

`hide`

Blendet den Home-Indicator am unteren Bildschirmrand aus.

Dies blendet die iOS-Home-Indicator-Leiste visuell aus und sorgt für ein immersiveres Full-Screen-Erlebnis. Nutzer können weiterhin nach oben wischen, um zum Home-Bildschirm zu gelangen, aber der Indicator wird erst sichtbar, wenn sie die Geste starten.

Nur für iOS. Hat keine Auswirkungen auf Android oder Web.

import { HomeIndicator } from '@capgo/capacitor-home-indicator';

await HomeIndicator.hide();

`show`

Zeigt den Home-Indicator am unteren Bildschirmrand an.

Dies stellt die Standard-Sichtbarkeit des iOS-Home-Indicators wieder her, sodass er für den Nutzer immer sichtbar ist. Dies ist das Standardverhalten.

Nur für iOS. Hat keine Auswirkungen auf Android oder Web.

import { HomeIndicator } from '@capgo/capacitor-home-indicator';

await HomeIndicator.show();

`isHidden`

Prüfen, ob der Home Indicator aktuell ausgeblendet ist.

Gibt den aktuellen Sichtbarkeitsstatus des iOS Home Indicators zurück.

import { HomeIndicator } from '@capgo/capacitor-home-indicator';

const { hidden } = await HomeIndicator.isHidden();
if (hidden) {
  console.log('Home indicator is hidden');
} else {
  console.log('Home indicator is visible');
}

Source of Truth

Diese Seite wird aus dem Plugin- src/definitions.ts. Führe den Sync erneut aus, wenn sich der öffentliche API upstream ändert.

Weiter mit Getting Started

Wenn Sie ... verwenden Erste Schritte Um Dashboard- und API-Operationen zu planen, verbinde es mit Mit @capgo/capacitor-home-indicator arbeiten für die native Funktion bei der Nutzung von @capgo/capacitor-home-indicator, API Übersicht für Details zur Implementierung in der Übersicht zu API, Einführung für das Implementierungsdetail in der Einleitung, API Keys für die Implementierungsdetails in den API Keys und Geräte für die Implementierungsdetails bei Devices.