跳到主要内容
版本：v8

平台

isPlatform​

isPlatform 方法可用于测试你的应用是否在某个特定平台上运行：

import { isPlatform } from '@ionic/react';

isPlatform('ios'); // 在 iOS 设备上运行时返回 true

根据用户所在的平台，isPlatform(platformName) 将返回 true 或 false。请注意，同一个应用可能对多个平台名称返回 true。例如，在 iPad 上运行的应用将对以下平台名称返回 true：mobile、ios、ipad 和 tablet。此外，如果应用是从 Cordova 运行的，则 cordova 也会为 true。

getPlatforms​

getPlatforms 方法可用于确定你的应用当前正在哪些平台上运行。

import { getPlatforms } from '@ionic/react';

getPlatforms(); // 从 iPhone 返回 ["iphone", "ios", "mobile", "mobileweb"]

根据你所使用的设备，getPlatforms 可以返回多个值。每个可能的值都是一个平台层级结构。例如，在 iPhone 上，它将返回 mobile、ios 和 iphone。

平台列表​

以下表格列出了所有可能的平台值及其对应描述。

平台名称描述
android运行 Android 的设备
capacitor运行 Capacitor 的设备
cordova运行 Cordova 的设备
desktop桌面设备
electron运行 Electron 的桌面设备
hybrid运行 Capacitor 或 Cordova 的设备
ios运行 iOS 的设备
ipadiPad 设备
iphoneiPhone 设备
mobile移动设备
mobileweb在移动设备中运行的 Web 浏览器
phablet平板手机设备
pwaPWA 应用
tablet平板设备

自定义平台检测函数​

检测特定平台的函数可以通过在全局 Ionic 配置中提供替代函数来覆盖。每个函数以 window 作为参数并返回一个布尔值。

setupIonicReact({
  platform: {
    /** 默认的 `desktop` 函数对带有触摸屏的设备返回 false。
     * 这并不总是我们想要的，所以此函数改用 User Agent 进行检测。
     **/
    desktop: (win) => {
      const isMobile = /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(win.navigator.userAgent);
      return !isMobile;
    },
  },
});
type PlatformConfig = {
  android?: ((win: Window) => boolean) | undefined;
  capacitor?: ((win: Window) => boolean) | undefined;
  cordova?: ((win: Window) => boolean) | undefined;
  desktop?: ((win: Window) => boolean) | undefined;
  electron?: ((win: Window) => boolean) | undefined;
  hybrid?: ((win: Window) => boolean) | undefined;
  ios?: ((win: Window) => boolean) | undefined;
  ipad?: ((win: Window) => boolean) | undefined;
  iphone?: ((win: Window) => boolean) | undefined;
  mobile?: ((win: Window) => boolean) | undefined;
  mobileweb?: ((win: Window) => boolean) | undefined;
  phablet?: ((win: Window) => boolean) | undefined;
  pwa?: ((win: Window) => boolean) | undefined;
  tablet?: ((win: Window) => boolean) | undefined;
};

目录

编辑此页