Guida rapida

Copia un prompt di setup con i passaggi di installazione e la guida markdown completa per questo 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.

Installazione

Puoi usare il nostro Setup assistito dall'AI per installare il plugin. Aggiungi le skill Capgo al tuo tool AI con il comando seguente:

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

Poi usa questo prompt:

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

Se preferisci il Setup manuale, installa il plugin eseguendo i comandi seguenti e segui le istruzioni specifiche per piattaforma qui sotto:

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

Importa

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

Avvio rapido

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

await HomeIndicator.hide();

Esempio: show

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

await HomeIndicator.show();

Esempio: 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');
}

Errori comuni

Sync nativo: esegui npx cap sync dopo gli aggiornamenti dei plugin.
Fonte di verità: fidati src/definitions.ts nel repo GitHub.

API Panoramica

`hide`

Nascondi l'home indicator in fondo allo schermo.

Nasconde visivamente la barra dell'home indicator di iOS, offrendo un'esperienza full-screen più immersiva. Gli utenti possono comunque scorrere verso l'alto per tornare alla home, ma l'indicatore non sarà visibile finché non iniziano il gesto.

Solo iOS. Nessun effetto su Android o web.

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

await HomeIndicator.hide();

`show`

Mostra l'home indicator in fondo allo schermo.

Ripristina la visibilità predefinita dell'home indicator di iOS, rendendolo tuttora visibile all'utente. Questo è il comportamento di default.

Solo iOS. Nessun effetto su Android o web.

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

await HomeIndicator.show();

`isHidden`

Verifica se l'home indicator è attualmente nascosto.

Restituisce lo stato di visibilità attuale dell'home indicator di iOS.

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

Fonte di verità

Questa pagina è generata dal src/definitions.ts. Riesegui la sync quando il API pubblico cambia upstream.

Continua da Getting Started

Se stai usando Guida rapida per pianificare dashboard e operazioni API, collegalo a Utilizzo di @capgo/capacitor-home-indicator per la funzionalità nativa in Utilizzo di @capgo/capacitor-home-indicator, API Panoramica per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli implementativi nell'Introduzione, Chiavi API per i dettagli implementativi in API Keys, e Dispositivi per i dettagli implementativi in Dispositivi.