Formation PUB900 : Développer une application pour iPhone avec SwiftUI, H-2024 Le canevas (fenêtre preview)

4.3 Prévisualiser dans différentes modes/orientations


Par défaut, Xcode affiche le canevas en mode clair et en position verticale. La taille du texte est fixée à l'aide du type dynamique large.

Différentes techniques permettent d'ajuster les options du canevas.

Dans cette fiche :

Icône au bas de la zone du canevas

Les icônes au bas de la zone du canevas permettent de modifier l'apparence du canevas sans avoir à modifier le code.

Icône Device Settings

L'icône Device Settings (en forme de deux commutateurs superposés) permet de modifier l'apparence du canevas présentement affiché.

Voici un aperçu de configurations possibles.

Color scheme Orientation

Dynamic type

Icône Variants

L'icône Variants (en forme de damier) permet d'afficher plusieurs canevas dans différentes variantes.

Notez que pour revenir à l'affichage d'un seul canevas, il faut cliquer sur l'icône Live (en forme de flèche), lui aussi au bas de la zone du canevas.

Voici un aperçu de configurations possibles.

Color scheme variants Orientation variants

Dynamic type variants

Combinaison

Il est possible de combiner différentes options dans Device Settings et dans Variants afin de répondre à nos besoins, comme dans cet exemple où on a choisi Orientation Variants, Dark appearance et Dynamic Type AX 4.

Combinaison

Section #Preview

La section #Preview, généralement présente juste après le code d'une vue, permet elle aussi de configurer comment le ou les canevas seront affichés.

Apparence claire ou sombre

Par défaut, le canevas est affiché en mode clair.

Pour passer au mode sombre :

SwiftUI

#Preview {
  ContentView().preferredColorScheme(.dark)
}

Dark

Orientation

Par défaut, le canevas est présenté en orientation portrait.

Pour modifier l'orientation, il faut ajouter un paramètre directement sur la ligne #Preview.

SwiftUI

#Preview(traits: .landscapeLeft) {
  ContentView()
}

Landscape

Types dynamiques

Le canevas peut vous montrer l'apparence de votre application avec différentes tailles de police à condition que vous ayez utilisé les types dynamiques, qui permettent à l’application de s’adapter automatiquement à la taille de texte choisie par l’usager dans les réglages de son appareil.

Pour modifier la taille de police dans le canevas :

SwiftUI

#Preview {
  ContentView().environment(\.dynamicTypeSize, .xxxLarge)
}

Plusieurs #Preview

Une option est intéressante : on peut définir plusieurs zones #Preview afin de permettre de choisir l'une ou l'autre par un simple clic sur un bouton.

SwiftUI

#Preview {
  ContentView().preferredColorScheme(.light)
}

#Preview {
  ContentView().preferredColorScheme(.dark)
}

Preview Preview

Si désiré, on peut donner un nom à chaque bouton.

SwiftUI

#Preview("Clair") {
  ContentView().preferredColorScheme(.light)
}


#Preview("Sombre") {
  ContentView().preferredColorScheme(.dark)
} 

Preview

Pour plus d'information

« Previewing your app’s interface in Xcode ». Apple Developer. https://developer.apple.com/documentation/xcode/previewing-your-apps-interface-in-xcode

▼Publicité

Veuillez noter que le contenu de cette fiche vous est partagé à titre gracieux, au meilleur de mes connaissances et sans aucune garantie.
Merci de partager !
Soumettre