Aller au contenu

La barre de navigation

Configurer le titre de l'application

Il est intéressant d'ajouter un titre dans la bare de navigation, dans le haut de la fenêtre d'une application mobile. Cette barre peut contenir le titre de l'application et possiblement des icônes ou du texte qui donnent accès à des fonctionnalités de votre choix.

Dans cette fiche :

Avec SwiftUI, il est possible d'ajouter un titre en englobant le contenu de la vue dans un NavigationStack, qui est disponible depuis iOS 16.

Dans sa forme la plus simple, le titre de l'application sera fourni à l'aide de la méthode navigationTitle().

Notez que la vue NavigationView et sa méthode navigationBarTitle() sont obsolètes.

Voici donc comment définir le titre de l'application à l'aide de NavigationStack et navigationTitle().

SwiftUI
struct ContentView: View {
  var body: some View {
    NavigationStack {
      Text("Hello, world!")
        .navigationTitle("Le titre")
    }
  }
}

Application avec barre de titre

Dans les faits, une vue est rarement composée d'un seul élément.

Tout le contenu de la vue doit être à l'intérieur du NavigationStack.

On retrouvera généralement quelque chose du genre :

SwiftUI
struct ContentView: View {
  var body: some View {
    NavigationStack {
      VStack {
        Text("Hello, world!")
        // ...
      }
      .navigationTitle("Le titre")
    }
  }
}

Titre plus petit

Si vous préférez un titre plus petit et centré, il est possible d'ajuster le code comme ceci :

SwiftUI
struct ContentView: View {
  var body: some View {
    NavigationStack {
      VStack {
        Text("Hello, world!")
        // ...
      }
      .navigationTitle("Le titre")
      .navigationBarTitleDisplayMode(.inline)
    }
  }
}

Application avec barre de titre

Visuellement, on obtiendra le même résultat en définissant un ToolbarItem avec l'emplacement .principal.

SwiftUI
struct ContentView: View {
  var body: some View {
    NavigationStack {
      VStack {
        Text("Hello, world!")
        // ...
      }
      .toolbar(content: {
        ToolbarItem(placement: .principal, content: {
          Text("Le titre")
        })
      })
    }
  }
}

Où placer le .navigationTitle?

Il est important de placer le titre de l'application après le contrôle d'empilement principal, à l'intérieur du NavigationStack.

SwiftUI
struct ContentView: View {
  var body: some View {
    NavigationStack {
      VStack {
        Text("Hello, world!")
        // ...
      }
      .navigationTitle("Le titre")
    }   // fin NavigationStack
  }
}

Notez que la vue principale devra être entièrement incluse dans le NavigationStack. Ceci ne fonctionnera pas :

SwiftUI
struct ContentView: View {
  var body: some View {
    NavigationStack {
      Text("Hello, world!")
        .navigationTitle("Le titre")
    }
    VStack {
      Text("Hello, world!")
        .padding()
      Image("bonjour")
    }
  }
}

Pour plus d'information

« Working with Toolbar in SwiftUI ». AppCoda. https://www.appcoda.com/swiftui-toolbar/

Configurer les barres d'outils

Dans cette fiche :

Deux barres d'outils

Il est possible d'ajouter du texte ou des icônes dans la barre de navigation (navigation bar) située dans le haut complètement de l'application. Cette barre est aussi appelée barre d'outils (toolbar). Sur macOS, elle s'appelle barre de titre (title bar).

Une seconde barre d'outils est disponible dans le bas de l'écran.

C'est la structure ToolbarItem qui permet de définir le contenu des barres d'outils.

Pour chaque ajout, on précisera la position à l'aide d'une de ces valeurs.

Emplacements sémantiques :

  • automatic
  • principal
  • status

Emplacements selon le type d'action :

  • primaryAction
  • secondaryAction
  • confirmationAction
  • cancellationAction
  • desctructiveAction
  • navigation

Emplacements avec une position explicite :

  • topBarLeading
  • topBarTrailing
  • bottomBar
  • bottomOrnament
  • keyboard
  • accessoryBar

L'emplacement exact dépendra des options utilisées puisque certains se placent par exemple au centre par défaut mais se déplacent à gauche lorsqu'une autre option est centrée.

SwiftUI
struct ContentView: View {
  var body: some View {
    NavigationStack {
      // contenu de la vue
      // ...
      .toolbar(content: {
        ToolbarItem(placement: .principal, content: {
          Text("Le titre")
        })
        ToolbarItem(placement: .topBarLeading, content: {
          //...
        })
        ToolbarItem(placement: .topBarTrailing, content: {
          //...
        })
        ToolbarItem(placement: .bottomBar, content: {
          //...
        })
        ToolbarItem(placement: .status, content: {
          //...
        })
        ToolbarItem(placement: .bottomBar, content: {
          //...
        })
      })   // fin .toolbar
    }   // fin NavigationStack
  }   // fin body
}   // fin ContentView

ToolbarItem

Code des barres d'outils dans son propre fichier

Afin de rendre le tout plus lisible, il est possible de placer le code des barres d'outils dans son propre fichier.

Le nom de la structure doit respecter LaCassePascal.
Le code sera placé dans un fichier qui porte le même nom que la structure, dans un dossier nommé Views.

Fichier Views/ToolbarPrincipal.swift
struct ToolbarPrincipal: ToolbarContent {

  ...   // on pourrait ici déclarer des propriétés requises pour la barre d'outils

  var body: some ToolbarContent {
    ToolbarItem(placement: .principal, content: {
      Text("Le titre")
    })
    ToolbarItem(placement: .topBarLeading, content: {
      //...
    })
    ToolbarItem(placement: .topBarTrailing, content: {
      //...
    })
    ToolbarItem(placement: .bottomBar, content: {
      //...
    })
    ToolbarItem(placement: .status, content: {
      //...
    })
    ToolbarItem(placement: .bottomBar, content: {
      //...
    })
  }
}

Chaque vue pourra utiliser les barres d'outils ainsi codées et, si désiré, ajouter leurs propres barres d'outils.

Fichier de la vue (ex : ContentView.swift)
NavigationStack {
  // contenu de la vue
  //...
  .toolbar {
    // texte ou icône propre à cette vue (si requis)
    ToolbarItem(... {
      //...
    })
    // textes ou icônes communs à plusieurs vues
    ToolbarPrincipal()
  }
}

Pour plus d'information

« Navigation bar swiftui ». Eon's swift blog. https://eon.codes/blog/2023/11/18/navigation-bar-swiftui/