steipete/swiftui-view-refactor

Refactorisation/révision de vues SwiftUI : mise en page, injection de dépendances, Observation, modèles de vue.

Qu'est-ce que swiftui-view-refactor ?

Cette compétence fournit un guide structuré pour refactoriser les vues SwiftUI selon un ensemble cohérent de règles de conception et de patterns. Elle est particulièrement utile pour les développeurs qui souhaitent maintenir une base de code propre, maintenable et performante en appliquant un ordre de déclaration strict, en favorisant les patterns MV (Model-View) légers, et en gérant correctement l'Observation et les modèles de vue. La compétence s'applique à tout projet SwiftUI, que ce soit dans Xcode, des éditeurs compatibles ou des assistants IA comme Claude Code ou Cursor. Elle repose sur des principes éprouvés : les vues doivent rester légères, les modèles et services gèrent la logique métier, et les injections de dépendances passent par `@Environment`. En divisant les grandes vues en sous-vues et en utilisant `@State` et `@Observable` de manière cohérente, elle aide à éviter les modèles de vue superflus et à améliorer la lisibilité, la testabilité et les performances.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/swiftui-view-refactor

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Refactorisation de vues SwiftUI

Attribution : copié depuis Dimillian/Skills de @Dimillian (2025-12-31).

Présentation

Appliquer une structure et un modèle de dépendance cohérents aux vues SwiftUI, en mettant l'accent sur l'ordre, les patterns Model-View (MV), la gestion minutieuse des modèles de vue et l'utilisation correcte d'Observation.

Directives principales

1) Ordre des vues (du haut vers le bas)

  • Environment
  • private/public let
  • @State / autres propriétés stockées
  • var calculées (hors vue)
  • init
  • body
  • Constructeurs de vues calculés / autres aides de vue
  • Fonctions d'aide / asynchrones

2) Privilégier les patterns MV (Model-View)

  • Par défaut, utiliser MV : les vues sont des expressions d'état légères ; les modèles/services possèdent la logique métier.
  • Favoriser @State, @Environment, @Query et task/onChange pour l'orchestration.
  • Injecter les services et modèles partagés via @Environment ; garder les vues petites et composables.
  • Diviser les grandes vues en sous-vues plutôt que d'introduire un modèle de vue.

3) Diviser les grands corps et les propriétés de vue

  • Si body dépasse un écran ou comporte plusieurs sections logiques, le diviser en sous-vues plus petites.
  • Extraire les grandes propriétés de vue calculées (var header: some View { ... }) dans des types View dédiés lorsqu'elles portent un état ou une ramification complexe.
  • Il est acceptable de conserver les sous-vues connexes en tant que propriétés de vue calculées dans le même fichier ; n'extraire dans une structure View autonome que lorsque cela a un sens structurel ou que la réutilisation est souhaitée.
  • Préférer passer de petites entrées (données, liaisons, rappels) plutôt que de réutiliser l'état complet de la vue parente.

Exemple (extraction d'une section) :

var body: some View {
    VStack(alignment: .leading, spacing: 16) {
        HeaderSection(title: title, isPinned: isPinned)
        DetailsSection(details: details)
        ActionsSection(onSave: onSave, onCancel: onCancel)
    }
}

Exemple (long body → body plus court + vues calculées dans le même fichier) :

var body: some View {
    List {
        header
        filters
        results
        footer
    }
}

private var header: some View {
    VStack(alignment: .leading, spacing: 6) {
        Text(title).font(.title2)
        Text(subtitle).font(.subheadline)
    }
}

private var filters: some View {
    ScrollView(.horizontal, showsIndicators: false) {
        HStack {
            ForEach(filterOptions, id: \.self) { option in
                FilterChip(option: option, isSelected: option == selectedFilter)
                    .onTapGesture { selectedFilter = option }
            }
        }
    }
}

Exemple (extraction d'une vue calculée complexe) :

private var header: some View {
    HeaderSection(title: title, subtitle: subtitle, status: status)
}

private struct HeaderSection: View {
    let title: String
    let subtitle: String?
    let status: Status

    var body: some View {
        VStack(alignment: .leading, spacing: 4) {
            Text(title).font(.headline)
            if let subtitle { Text(subtitle).font(.subheadline) }
            StatusBadge(status: status)
        }
    }
}

4) Gestion des modèles de vue (uniquement s'ils existent déjà)

  • Ne pas introduire de modèle de vue sauf si la demande ou le code existant le nécessite clairement.
  • Si un modèle de vue existe, le rendre non-optionnel lorsque c'est possible.
  • Passer les dépendances à la vue via init, puis les passer au modèle de vue dans l'init de la vue.
  • Éviter les patterns bootstrapIfNeeded.

Exemple (basé sur Observation) :

@State private var viewModel: SomeViewModel

init(dependency: Dependency) {
    _viewModel = State(initialValue: SomeViewModel(dependency: dependency))
}

5) Utilisation d'Observation

  • Pour les types de référence @Observable, les stocker avec @State dans la vue racine.
  • Transmettre explicitement les observables vers le bas si nécessaire ; éviter les états optionnels sauf si requis.

Flux de travail

  1. Réorganiser la vue pour correspondre aux règles d'ordre.
  2. Favoriser MV : déplacer l'orchestration légère dans la vue en utilisant @State, @Environment, @Query, task et onChange.
  3. Si un modèle de vue existe, remplacer les modèles de vue optionnels par un modèle de vue @State non optionnel initialisé dans init en passant les dépendances depuis la vue.
  4. Confirmer l'utilisation d'Observation : @State pour les modèles de vue @Observable racines, pas d'encapsulateurs redondants.
  5. Maintenir le comportement intact : ne pas modifier la mise en page ou la logique métier sauf demande explicite.

Remarques

  • Préférer des aides petites et explicites plutôt que de grands blocs conditionnels.
  • Placer les constructeurs de vues calculés après body et les var calculées non liées à la vue avant init.
  • Pour des conseils et la justification du MV-first, voir references/mv-patterns.md.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Skills associés