メインコンテンツへスキップ
@capgo/capacitor-home-indicator UI & システム オープンソース

インジケーター Capacitor プラグイン

フルスクリーンや没入型アプリ体験向けに、iOSのホームインジケーターを表示/非表示にします

インストール

bun add @capgo/capacitor-home-indicator bunx cap sync
npm、pnpm、または yarn
  • npm install @capgo/capacitor-home-indicator
  • pnpm add @capgo/capacitor-home-indicator
  • yarn add @capgo/capacitor-home-indicator

ガイド

Capacitor で Indicator を使用する方法

実機でテストする

Capgo アプリをダウンロードして、QR code をスキャンしてください。

インジケータープラグインのプレビューQR code

@capgo/capacitor-home-indicator の使用方法

iOSのホームインジケーターの表示を制御するCapacitor Home Indicator Plugin。ホームインジケーターは、物理的なホームボタンがないiOSデバイスの下部にある水平バーです。

インストール

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

bunx cap sync プラグインのネイティブcodeをネイティブプロジェクトにコピーします。プラグインをアップグレードするたびに再度実行してください。

インポート

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

API の概要

メソッド 説明
hide 画面下部のホームインジケーターを非表示にします。
show 画面下部のホームインジケーターを表示します。
isHidden ホームインジケーターが現在非表示になっているかを確認します。

例

hide()

画面下部のホームインジケーターを非表示にします。

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

await HomeIndicator.hide();

show()

画面下部のホームインジケーターを表示します。

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

await HomeIndicator.show();

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

完全なリファレンス

「@capgo/capacitor-home-indicator の使用方法」から続ける

使用している場合 @capgo/capacitor-home-indicator の使用方法 ネイティブプラグインの作業を計画するには、次と連携してください: @capgo/capacitor-home-indicator @capgo/capacitor-home-indicator の実装の詳細については、 スタートガイド スタートガイドの実装詳細については、 Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor Plugins の実装詳細、および プラグインの追加または更新 プラグインの追加または更新に関する実装詳細についてはこちら。

よくある質問

IndicatorプラグインのFAQ

CapacitorアプリにIndicatorプラグインをインストールするにはどうすればよいですか?

"bun add @capgo/capacitor-home-indicator"(または"npm install @capgo/capacitor-home-indicator")を実行した後、"bunx cap sync"を実行して、iOSおよびAndroidプロジェクトにネイティブのcodeを反映させてください。その後、アプリのcodeで"@capgo/capacitor-home-indicator"からインポートします。

@capgo/capacitor-home-indicatorはReact、Vue、Angularで動作しますか?

はい。IndicatorはCapacitorパッケージであるため、Ionic、React、Vue、Angular、Svelte、およびプレーンなJavaScriptを含む、Capacitor内で動作するあらゆるWebフレームワークで使用可能です。

@capgo/capacitor-home-indicatorはどのCapacitorバージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-home-indicatorは無料のオープンソースですか?

はい。codeのソースコードはGitHubの https://github.com/Cap-go/capacitor-home-indicator/ で公開されており、パッケージはnpmから無料でインストールできます。バグ報告やプルリクエストをお待ちしています。

App Storeの審査なしで、Indicatorを使用しているcodeをアップデートできますか?

プラグインのインストールやアップグレードはネイティブの code を変更するため、新しいストアビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo Live Updates で即座に配信できます。

アプリの審査を待たずにインジケーターの変更を配信

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める