Charts Swift : guide complet avec exemples pratiques

Introduction à Charts pour Swift

Charts est une bibliothèque open source puissante et flexible pour la visualisation de données sur les plateformes Apple (iOS, tvOS, macOS, watchOS). Écrite en Swift, elle propose une large gamme de types de graphiques : des simples courbes et barres aux graphiques combinés et à bulles complexes. Cette bibliothèque est un fork de la célèbre bibliothèque iOS ios-charts, elle-même portée de la bibliothèque Java MPAndroidChart.

Pourquoi utiliser Charts ?

• Visualisation des données : Transformez des chiffres bruts en graphiques et diagrammes clairs et percutants.
• Fonctionnalités riches : Animations, interactions tactiles, sélection, légendes, axes, marqueurs de données et bien plus encore.
• Performances natives : Développée en Swift, elle utilise Core Graphics et Core Animation pour un rendu fluide, même avec de grands ensembles de données.
• Intégration facile : Installation simple via Swift Package Manager, CocoaPods ou Carthage.
• Communauté active : Mise à jour régulière, documentation complète et nombreux exemples disponibles.

Installation de la bibliothèque Charts

Charts peut être installé de trois manières principales. La méthode recommandée est Swift Package Manager (SPM).

1. Swift Package Manager (SPM) — Méthode recommandée

1. Dans Xcode, ouvrez votre projet.
2. Sélectionnez File → Add Packages...
3. Dans le champ de recherche, saisissez l'URL du dépôt : https://github.com/danielgindi/Charts.git
4. Choisissez la version souhaitée (généralement la dernière version stable).
5. Cliquez sur Add Package.
6. Vérifiez que le paquet est bien ajouté à votre cible (target).

2. CocoaPods

Ajoutez ceci à votre Podfile :

platform :ios, '13.0'
use_frameworks!

target 'YourApp' do
  pod 'Charts'
end

Exécutez ensuite la commande dans le terminal :

pod install

3. Carthage

Ajoutez ceci à votre Cartfile :

github "danielgindi/Charts"

Exécutez ensuite :

carthage update

Démarrage rapide : Créez votre premier graphique

Créons un graphique linéaire simple pour afficher l'évolution de la température sur une semaine.

1. Importez la bibliothèque dans votre contrôleur :

   import UIKit
   import Charts

2. Ajoutez une vue dans le Storyboard ou créez-la par code :

   Dans le storyboard, faites glisser une UIView et modifiez sa classe en LineChartView dans l'inspecteur d'identité. Créez un IBOutlet :

   @IBOutlet weak var lineChartView: LineChartView!

3. Configurez les données :

   func setupLineChart() {
       // 1. Créez les points de données
       let dataEntries: [ChartDataEntry] = [
           ChartDataEntry(x: 1.0, y: 20.0),
           ChartDataEntry(x: 2.0, y: 22.0),
           ChartDataEntry(x: 3.0, y: 19.0),
           ChartDataEntry(x: 4.0, y: 25.0),
           ChartDataEntry(x: 5.0, y: 23.0),
           ChartDataEntry(x: 6.0, y: 21.0),
           ChartDataEntry(x: 7.0, y: 26.0)
       ]
   
       // 2. Créez le jeu de données
       let lineDataSet = LineChartDataSet(entries: dataEntries, label: "Température (°C)")
       lineDataSet.colors = [.systemBlue] // Couleur de la ligne
       lineDataSet.circleColors = [.systemRed] // Couleur des points
       lineDataSet.circleRadius = 4.0
       lineDataSet.lineWidth = 2.0
   
       // 3. Créez l'objet de données
       let lineData = LineChartData(dataSet: lineDataSet)
   
       // 4. Assignez les données au graphique
       lineChartView.data = lineData
   
       // 5. Paramètres supplémentaires
       lineChartView.xAxis.labelPosition = .bottom
       lineChartView.rightAxis.enabled