Search docs/

Plateforme

Le service Platform peut être utilisé pour obtenir des informations sur votre appareil actuel. Vous pouvez obtenir toutes les plateformes associées à l'appareil en utilisant la méthode platforms , y compris si l'application est vue depuis une tablette, si elle est sur un appareil mobile ou un navigateur, et sur la plateforme exacte (iOS, Android, etc). Vous pouvez également obtenir l'orientation de l'appareil, s'il utilise la direction du langage de droite à gauche, et bien plus encore. Avec ces informations, vous pouvez personnaliser complètement votre application pour s'adapter à n'importe quel appareil.

Utilisation

import { Platform } from '@ionic/angular';

@Component({...})
export class MyPage {
  constructor(public platform: Platform) {

  }
}
CopyCopied

Méthodes

is(platformName: Platforms) => boolean

Selon la plateforme sur laquelle l'utilisateur est, is(platformName) retournera vrai ou faux. Notez que la même application peut retourner vrai pour plus d'un nom de plateforme. Par exemple, une application fonctionnant depuis un iPad retournerait vrai pour les noms de plateformes suivants : mobile, ios, ipad, et tablet. En outre, si l'application fonctionnait à partir de Cordova, cordova serait alors vrai.

Paramètres

Nom Type Description
platformName Platforms Nom de la plateforme. Les options disponibles sont : android, capacitor, cordova, desktop, electron, hybrid, ios, ipad, iphone, mobile, phablet, pwa, tablet

Platformes

Vous trouverez ci-dessous une liste de toutes les valeurs possibles pour la plateforme ainsi que les descriptions correspondantes.

Nom de la plateforme Description
android un appareil fonctionnant sous Android
capacitor un appareil exécutant Capacitor
cordova un appareil exécutant Cordova
desktop un appareil de bureau
electron un appareil de bureau exécutant Electron
hybrid un appareil exécutant Capacitor ou Cordova
ios un appareil fonctionnant sous iOS
ipad un iPad
iphone un iPhone
mobile un appareil mobile
mobileweb un navigateur Web fonctionnant sur un appareil mobile
phablet une phablette
pwa une application web progressive
tablet une tablette

platforms() => string[]

Selon le périphérique sur lequel vous êtes, platforms peut renvoyer plusieurs valeurs. Chaque valeur possible est une hiérarchie de plateformes. Par exemple, sur un iPhone, il renvoie mobile, ios, et iphone.

ready() => Promise<string>

Renvoie une promesse lorsque la plateforme est prête et que des fonctionnalités natives peuvent être appelées. Si l'application fonctionne à partir d'un navigateur Web, alors la promesse sera résolue lorsque le DOM sera prêt. Lorsque l'application est en cours d'exécution à partir d'un moteur d'application tel que Cordova, alors la promesse se résoudra quand Cordova déclenchera l'événement deviceready. La valeur résolue est readySource, qui indique la plateforme qui a été utilisée.

Par exemple, lorsque Cordova est prêt, la source prête qui est résolue est cordova. La valeur de source prête par défaut sera dom. Le readySource est utile si une logique différente doit s'exécuter en fonction de la plateforme depuis laquelle l'application est en cours d'exécution. Par exemple, seul Capacitor et Cordova peuvent exécuter le plugin de la barre d'état, de sorte que le Web ne doit pas exécuter la logique du plugin de la barre d'état.

isRTL() => boolean

Retourne si cette application utilise la direction de la langue de droite à gauche ou non. Nous recommandons le fichier index.html de l'application qui a déjà le jeu de valeur d'attributs dir correct, tel que <html dir="ltr"> ou <html dir="rtl">. W3C : Marquage structurel et texte de droite à gauche en HTML

isLandscape() => boolean

Renvoie true si l'application est en mode paysage.

isPortrait() => boolean

Renvoie true si l'application est en mode portrait.

width() => number

Récupère la largeur de la fenêtre d'affichage de la plateforme en utilisant window.innerWidth.

height() => number

Récupère la hauteur de la fenêtre d'affichage de la plateforme en utilisant window.innerHeight.

url() => string

Récupère l'url actuelle.

testUserAgent(expression: string) => boolean

Retourne true si l'expression est incluse dans la chaîne user agent.

Paramètres

Nom Type Description
expression string La chaîne qui vérifie l'agent utilisateur

Évènements

pause

L'évènement pause se déclenche lorsque la plateforme native met l'application en arrière-plan, généralement lorsque l'utilisateur bascule vers une autre application. Cet événement se déclanche quand une application Cordova/Capacitor est mise en arrière-plan mais ne se déclenche pas dans un navigateur web standard.

Utilisation

this.platform.pause.subscribe(async () => {
  alert('Pause event detected');
});
CopyCopied

resize

L'événement redimensionner se déclenche lorsque la fenêtre du navigateur a changé de dimensions. Cela peut être dû à un redimensionnement physique d'une fenêtre du navigateur, ou à un changement d'orientation du périphérique.

Utilisation

this.platform.resize.subscribe(async () => {
  alert('Resize event detected');
});
CopyCopied

resume

L'évènement resume se déclenche lorsque la plate-forme native sort l'application de l'arrière-plan. Cet événement se déclenche quand une application Cordova/Capacitor est sortie de l'arrière-plan mais ne se déclenche pas dans un navigateur web standard.

Utilisation

this.platform.resume.subscribe(async () => {
  alert('Resume event detected');
});
CopyCopied
Previous
Configuration
Next
Test