跳过主要内容

指示器 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中使用指示器

在设备上测试

下载 Capgo 应用,扫描二维码 code

指示器插件预览二维码 code

使用 @capgo/capacitor-home-indicator

Capacitor iOS 主屏幕指示器插件,用于控制 iOS 主屏幕指示器的可见性。主屏幕指示器是 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_KEEP_0__/__CAPGO_KEEP_1__-home-indicator 使用@capgo/capacitor-home-indicator @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-home-indicator 查看 @capgo/capacitor-home-indicator 的实现细节 为@capgo/capacitor-home-indicator的实现细节 查看开始的实现细节 计划原生插件工作,连接它与 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-home-indicator Capgo 插件目录 为 Capgo 产品工作流程在 Capgo 插件目录中 Capacitor 插件由 Capgo 为 Capacitor 插件由 Capgo 的实现细节 添加或更新插件 为添加或更新插件的实现细节

常见问题

指示器插件常见问题

如何在 Capacitor 应用中安装指示器插件?

运行 "bun add @capgo/capacitor-home-indicator" (或 "npm install @capgo/capacitor-home-indicator"),然后运行 "bunx cap sync" 以便 iOS 和 Android 项目捕获 native code。从 "@capgo/capacitor-home-indicator" 导入您的应用 code。

@capgo/capacitor-home-indicator 与 React、Vue 和 Angular 是否兼容?

是的。指示器是一个 Capacitor 包,因此它与任何运行在 Capacitor 内的 Web 框架兼容,包括 Ionic、React、Vue、Angular、Svelte 和普通 JavaScript。

@Capacitor 的哪个版本支持 @capgo/capacitor-home-indicator?

Capgo 插件遵循 Capacitor 的主要版本:使用与您的 Capacitor 主要版本匹配的插件主要版本(例如插件 v8 与 Capacitor 8)。在 GitHub README 中的兼容性表中列出了维护的版本。

@capgo/capacitor-home-indicator 是否免费和开源?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-home-indicator/ and the package is free to install from npm. Bug reports and pull requests are welcome.

是否可以在不经过 App Store 审核的情况下更新使用 Indicator 的 code?

安装或升级插件会改变原生 code, 因此需要重新构建 App Store。之后,JavaScript、HTML 和 CSS 调用插件的更改可以立即通过 Capgo 实时更新。

不必等待应用审核即可将指示器更新

一旦插件在您的商店构建中,Capgo 的实时更新将将您的 JavaScript、HTML 和 CSS 更改推送给用户,仅需几分钟。

从 Capgo 开始