Aller au contenu

Gestuelle (gesture)

Gestuelle (TapGesture, GragGesture, MagnificationGesture, etc.)

Il est possible de faire réagir notre application SwiftUI à différentes gestuelles.

Parmi les gestes les plus courants, on retrouve :

Certaines gestuelles peuvent être utilisées à l'aide d'une méthode qui débute par « on » suivi du nom de la gestuelle. Il s'agit de raccourcis qui simplifient l’utilisation des gestes les plus courants mais qui ne donnent pas accès à toutes les options.

Voici un exemple avec une méthode qui débute par « on » :

SwiftUI
List(items) { item in
  Text(item.titre)
    .onTapGesture {
      selection = item   // selection permet de retenir l'item sur lequel l'usager a tapé
      print("Vous avez tapé sur l'item \(item.code)")
    }
 }

Et voici un autre exemple qui travaille directement avec la gestuelle :

SwiftUI
Circle()
  .frame(width: 50)
  .position(positionCercle)
  .gesture(
    DragGesture()
      .onChanged { value in
        positionCercle = value.location
      }
  )

Si c'est MagnifyGesture qui vous intéresse :

SwiftUI
struct ContentView: View {
  @State private var zoomEnCours: CGFloat = 0.0
  @State private var zoomTotal: CGFloat = 1.0

  var body: some View {
    Image("...")
      .resizable()
      .scaledToFit()
      .frame(width: 300)
      .scaleEffect(zoomTotal + zoomEnCours)
      .gesture(
        MagnifyGesture()
          .onChanged { value in
            zoomEnCours = value.magnification - 1
          }
          .onEnded { value in
            zoomTotal += zoomEnCours
            zoomEnCours = 0
          }
      )
  }
}

Pour plus d'information

« How to use gestures in SwiftUI ». Hacking with Swift. https://www.hackingwithswift.com/books/ios-swiftui/how-to-use-gestures-in-swiftui

Déplacer une vue à l'aide de DragGesture

La gestuelle DragGesture permet de déplacer une vue, par exemple un cercle, à l'aide de la souris sur l'ordinateur ou à l'aide d'un doigt sur un appareil mobile.

Le secret, c'est de donner une position fixe à la vue dès le départ à l'aide du modifieur .position().

Cette position sera une variable d'état afin de forcer le rafraîchissement de la vue dès qu'elle est modifiée.

Lorsque la valeur du DragGesture est modifiée (.onChanged), la nouvelle position est assignée à cette variable.

Optionnellement, il est possible d'effectuer une tâche lorsque le mouvement se termine (.onEnded). Ceci serait utile, par exemple, si on doit vérifier si la vue a atteint un but.

SwiftUI
struct ContentView: View {
  @State private var positionCercle: CGPoint = CGPoint(x: 100, y: 100)

  var body: some View {
    Circle()
      .frame(width: 50)
      .position(positionCercle)
      .gesture(
        DragGesture()
          .onChanged { value in
            positionCercle = value.location
          }
          .onEnded { value in
            ...
          }
      )
  }
}

Ce simple code (sans le .onEnded) permet de faire ceci à l'aide d'un doigt :

Reproduire des gestuelles sur le simulateur

Lorsqu'on teste une application sur le simulateur, certaines gestuelles peuvent être réalisées simplement avec la souris, par exemple le clic ou le déplacement (drag).

Pour d'autres gestuelles, par exemple celles qui nécessitent deux doigts, c'est moins évident.

Heureusement, Xcode a prévu quelques trucs pour s'en sortir.

MagnifyGesture

Pour simuler le mouvement des doigts pour agrandir ou pour rapetisser une image (en anglais, on parlera de pinch) :

  • Appuyez sur la touche ⌥ Option. Deux cercles gris gris apparaîtront pour simuler deux doigts.

Option - Avec la souris, faites glisser l'un des cercles pour le rapprocher ou pour l'éloigner de l'autre.

Notez que ceci n'aura d'effet que si l'application est codée pour réagir à cette gestuelle.

Pour plus d'information

« Interacting with your app in the iOS and iPadOS simulator ». Apple. https://developer.apple.com/documentation/xcode/interacting-with-your-app-in-the-ios-or-ipados-simulator