跳至主要内容
版本:v8

平台

isPlatform

isPlatform 方法可用于测试您的应用程序是否在特定平台上运行

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

isPlatform('ios'); // returns true when running on a iOS device

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

getPlatforms

getPlatforms 方法可用于确定您的应用程序当前正在运行的平台。

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

getPlatforms(); // returns ["iphone", "ios", "mobile", "mobileweb"] from an iPhone

根据您所在的设备,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 作为参数,并返回一个布尔值。

createApp(App).use(IonicVue, {
platform: {
/** The default `desktop` function returns false for devices with a touchscreen.
* This is not always wanted, so this function tests the User Agent instead.
**/
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;
};