Les images et icônes¶
Ajouter une image dans un projet SwiftUI¶
Aux yeux de votre application, une image est une ressource (en anglais : asset).
Ajouter l'image au projet¶
Pour utiliser une image dans une application SwiftUI, il faut d'abord l'ajouter dans Assets.xcassets :
- Dans Xcode, cliquez sur
Assets.xcassetsdans la zone de gauche. - À partir du Finder, faites glisser l'image dans la zone centrale qui liste les ressources du projet (au départ, elle ne contient que AccentColor et AppIcon).
ou
- Dans Xcode, cliquez sur Assets.xcassets dans la zone de gauche.
- Cliquez sur le + au bas de la zone centrale qui liste les ressources du projet, sélectionnez Import puis retrouvez dans vos dossiers l'image désirée.

Nom de l'image¶
Par défaut, le nom de l'image correspond au nom de son fichier sans son extension, ce qui peut poser problème.
Ce nom est important puisqu'il sera utilisé dans le code. Souvent, il faudra renommer les images.
Le nom doit être unique dans le projet.
Par convention, on utilisera la-casse-kebab.
Utiliser une image¶
Pour ajouter l'image dans une vue :
AsyncImage pour afficher une image à partir d'un URL¶
Dans une application SwiftUI, la structure AsyncImage permet d'afficher une image en provenance d'un URL.
Image de chargement en cours¶
Pour indiquer que l'image est en cours de chargement, il est d'usage d'afficher une petite animation (en anglais : spinner).
Ceci sera possible grâce au paramètre placeholder.
Notez qu'à ce moment, vous êtes obligés de fournir également le paramètre content.
AsyncImage(
url: URL(string: "https://mobile1.profinfo.ca/images/apple-touch-icon.png"),
content: { image in
image
},
placeholder: {
ProgressView()
}
)
Taille de l'image¶
La taille de l'image n'est connue que lorsque l'image est chargée. Ceci pourrait poser problème. Il est donc recommandé de fixer sa taille avec le modifieur .frame().
Afin que l'image soit correctement dimensionnée, il faudra prendre soin de la rendre redimensionnable dans le paramètre content.
AsyncImage(
url: URL(string: "https://mobile1.profinfo.ca/images/apple-touch-icon.png"),
content: { image in
image
.resizable()
.aspectRatio(contentMode: .fit)
},
placeholder: {
ProgressView()
}
)
.frame(width: 244, height: 72)
État du chargement¶
Le code sera plus complet si vous tenez compte de l'état du chargement.
AsyncImage(url: URL(string: "https://mobile1.profinfo.ca/images/apple-touch-icon.png")) { phase in
switch phase {
case .empty:
// l'image n'est pas encore chargée
ProgressView()
case .success(let image):
// l'image a été chargée avec succèes
image
.resizable()
.aspectRatio(contentMode: .fit)
case .failure(let error):
// l'image n'a pas pu être chargée
Image(systemName: "exclamationmark.icloud")
let _ = print(error.localizedDescription) // sans "let _ =", on aurait l'erreur "Type '()' cannot conform to 'View'"
@unknown default:
// au cas où des états supplémentaires seraient ajoutés dans une future version de SwiftUI
Image(systemName: "photo")
}
}
.frame(width: 244, height: 72)
Ajuster une image¶
Dans une application SwiftUI, une image peut être affichée à partir d'un fichier qui a été ajouté au projet ou encore directement à partir d'un URL.
Par défaut, l'image conserve sa taille originale sans tenir compte de la taille de l'écran ni de ce qui s'y trouve déjà.
Dans Xcode, on peut configurer le canevas pour que des lignes bleues entourent l'espace qu'une vue occupe effectivement à l'écran quand on clique sur cette vue dans le code.
Ici, il est clair que l'image est plus large que l'écran du iPhone.

Pour qu'elle soit ajustée à l'écran et à l'espace qui est disponible, il faut utiliser le modifieur .resizable().
Ce modifieur se charge de redimensionner l'image pour qu'elle remplisse l'espace disponible sans en déborder.
Le problème, c'est que ceci déforme généralement l'image.

Pour qu'elle conserve son ratio original, il faut ajouter le modifieur .scaledToFit().
Donc, .resizable() et .scaledToFit() appliqués à l'image font en sorte qu'elle prendra tout l'espace disponible sans en déborder et sans changer son aspect.

Si vous souhaitez imposer une taille à l'image, le modifieur .frame() est ce qu'il vous faut. Il permet de définir un cadre invisible qui force l'image à s'y adapter.
Pour obtenir le résultat souhaité, il faut d'abord appliquer .resizable() et .scaledToFit() à l'image.

Si désiré, on peut passer un troisième paramètre à .frame() pour spécifier comment aligner l'image dans son cadre.
Image("papier")
.resizable()
.scaledToFit()
.frame(width: 200, height: 200, alignment: .bottom)

Que la taille de l'image soit imposée par un cadre ou pas, il est possible de la déplacer par rapport à son emplacement original. Ceci est réalisé à l'aide du modifieur .offset(). Il permet d'effectuer un décallage en X, en Y ou les deux.
Je vous fais la démonstration ici avec un cadre puisque vous verrez mieux le résultat.

Lorsqu'une image sort d'un cadre, il est possible de cacher la partie qui dépasse en ajoutant le modificateur .clipped().
Image("papier")
.resizable()
.scaledToFit()
.frame(width: 200, height: 200)
.offset(x: 50)
.clipped()

Si vous préférez donner une forme à l'image, vous pouvez travailler avec le modifieur .clipShape().
Toute partie de l'image qui déborde la forme spécifiée sera cachée.
Différentes formes sont disponibles : Circle(), Ellipse(), Capsule(), RoundedRectangle(), Rectangle(), etc. Il est même possible de définir nos propres formes à l'aide de Path().

Lorsqu'on maîtrise bien les différents modifeurs, il est même possible de n'afficher qu'une partie précise de l'image.
Remarquez que j'ai retiré le modifieur .resizable() pour que l'image conserve sa pleine taille. Le modifieur .scaledToFit() n'est ainsi plus nécessaire.

Modifier la couleur d'une image par programmation¶
SwiftUI permet de modifier les couleurs d'une image par programmation grâce à différentes méthodes qui permettent de jouer sur les profils colorimétriques d'une image, par exemple :
- .renderingMode() (pour remplir complètement une image à l'aide d'une couleur)
- .brightness()
- .saturation()
- .contrast()
- .opacity()
- .colorMultiply()
- .hueRotation()
- .colorInvert()
- .colorMultiply()
Voici quelques exemples visuels.
Dans les impressions d'écrans, les images de gauches sont originales et celles de droites ont été ajustées par programmation.
struct ContentView: View {
var body: some View {
VStack {
Text(".renderingMode")
HStack {
Image("avril")
.resizable()
.scaledToFit()
Image("avril")
.renderingMode(.template)
.resizable()
.scaledToFit()
.foregroundColor(.blue)
}
Text(".brightness")
.padding(.top)
HStack {
Image("fond")
.resizable()
.scaledToFit()
Image("fond")
.resizable()
.scaledToFit()
.brightness(0.2)
}
Text(".saturation et .contrast")
.padding(.top)
HStack {
Image("coucher_soleil")
.resizable()
.scaledToFit()
Image("coucher_soleil")
.resizable()
.scaledToFit()
.saturation(1.5)
.contrast(1.9)
}
}
.padding()
}
}

Si vous travaillez avec une image dont les traits principaux sont en noir, voici une astuce pour transformer les traits noirs dans la couleur de votre choix.
HStack {
Image("oiseau")
.resizable()
.scaledToFit()
Image("oiseau")
.resizable()
.scaledToFit()
.colorInvert() // colorMultiply n’a aucun effet sur le noir. En inversant les couleurs, le fond devient noir (et reste donc inchangé), tandis que les traits, devenus blancs, seront affectés par le filtre
.colorMultiply(Color(red: 0, green: 1, blue: 1)) // laisser à 0 la couleur désirée au final car tout sera inversé
.colorInvert() // le noir redevient blanc et les traits prennent la couleur qui était à 0
}

Si vous avez en main une image colorée (clipart ou photo), il est possible d'utiliser .hueRotation() pour décaler toutes les couleurs de l'image le long du cercle chromatique.
HStack {
Image("ballon_plage")
.resizable()
.scaledToFit()
Image("ballon_plage")
.resizable()
.scaledToFit()
.hueRotation(.degrees(150)) // tester différentes valeurs jusqu'à l'obtention du rendu désiré
}

La bibliothèque d'icônes SF Symbols¶
Apple a créé pour vous la bibliothèque d'icônes SF Symbols. Ces icônes ont été spécialement conçus pour s'intégrer parfaitement avec les polices de la famille San Francisco utilisées par Apple.
Ajouter un symbole dans une vue¶
Pour ajouter un de ces symboles à votre application SwiftUI :
Les icônes SF Symbols peuvent également être utilisés avec les contrôles Label.
Il est possible de modifier la couleur d'une icône. Ici, je change la couleur selon la valeur d'une variable booléenne.
Image(systemName: "sun.max")
.foregroundColor(maVariableBooleenne ? Color.black : Color.gray)
Pour modifier la taille de l'icône :
ou encore :
Rechercher un symbole¶
Pour ajouter un symbole SF, il faut connaître son nom.
Voici quelques techniques pour voir la liste des symboles disponibles.
Application Symboles SF¶
La façon la plus efficace pour retrouver le symbole approprié dans la bibliothèque SF Symbols consiste à installer la dernière version de l'application Symboles SF.
Cette application est gratuite et peut être installée à partir du Web : https://developer.apple.com/sf-symbols/.

Bibliothèque d'objets dans Xcode¶
Les symboles peuvent également être consultés directement dans Xcode à partir de la bibliothèque d'objets.
Il suffit de cliquer sur le dernier icône (celui en forme d'étoile).

Symboles SF en ligne¶
Il existe des sites Web qui présentent les symboles SF disponibles, par exemple : https://hotpot.ai/free-icons.
Choisissez SF Symbols pour voir les symboles SF disponibles.

Pour plus d'information¶
« How to use SF Symbols in SwiftUI ». Simple Swift Guide. https://www.simpleswiftguide.com/how-to-use-sf-symbols-in-swiftui/
« How to get custom colors and transparency with SF Symbols ». Hacking with Swift. https://www.hackingwithswift.com/quick-start/swiftui/how-to-get-custom-colors-and-transparency-with-sf-symbols
Label : la combinaison icône et texte¶
Dans vos vues SwiftUI, il est facile d'intégrer une icône suivie d'un texte. Le contrôle Label est conçu exactement pour celà.
Il est possible de travailler avec la bibliothèque d'icônes SF Symbols.

Il est également possible d'utiliser une image que vous avez ajoutée dans votre projet.
