跳过主要内容
返回插件
@capgo/home-indicator
教程
由 github.com/Cap-go

指示器

隐藏或显示 iOS 全屏和沉浸式应用体验的主屏幕指示器

指南

指示器教程

使用@capgo/capacitor-home-indicator

Capacitor iOS Home 指示器插件,用于控制 iOS 设备的 Home 指示器可见性。Home 指示器是位于 iOS 设备底部的水平条。

安装

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

此插件暴露的内容

  • hide - 隐藏屏幕底部的 Home 指示器。
  • show - 在屏幕底部显示 Home 指示器。
  • isHidden - 检查当前是否隐藏了 Home 指示器。

示例用途

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

全局参考