فهرست سرفصل‌های Swift
خانه (Swift HOME) معرفی (Swift Intro) شروع به کار (Swift Get Started) سینتکس (Swift Syntax) دستورات (Swift Statements) خروجی (Swift Output) چاپ اعداد (Print Numbers) کامنت ها (Swift Comments) متغیرها (Swift Variables) چاپ متغیرها (Print Variables) چند متغیره (Multiple Variables) شناسه ها (Identifiers) ثابت ها (Constants) نمونه های دنیای واقعی (Real-Life Examples) انواع داده (Swift Data Types) اعداد (Numbers) بولی ها (Booleans) کاراکترها (Characters) تبدیل نوع (Swift Type Casting) عملگرها (Swift Operators) عملگرهای حسابی (Arithmetic Operators) عملگرهای انتساب (Assignment Operators) عملگرهای مقایسه ای (Comparison Operators) عملگرهای منطقی (Logical Operators) اولویت عملگرها (Operator Precedence) رشته ها (Swift Strings) اتصال رشته ها (Concatenation) اعداد و رشته ها (Numbers and Strings) کاراکترهای ویژه (Special Characters) یونیکد و اسکالرها (Unicode & Scalars) آرایه ها (Swift Arrays) حلقه روی آرایه (Loop Through an Array) برش های آرایه (Array Slices) اندیس ها و کران ها (Indices & Bounds) آرایه های چندبعدی (Multidimensional Arrays) نمونه های دنیای واقعی (Real-Life Examples) بازه ها (Swift Ranges) اگر...وگرنه (Swift If...Else) if (if) else (else) else if (else if) اگر...وگرنه کوتاه (Short Hand If...Else) if تو در تو (Nested If) عملگرهای منطقی (Logical Operators) نمونه های دنیای واقعی (Real-Life Examples) سوئیچ (Swift Switch) حلقه while (Swift While Loop) حلقه repeat/while (Repeat/While Loop) نمونه های دنیای واقعی (Real-Life Examples) حلقه for (Swift For Loop) حلقه های تو در تو (Nested Loops) حلقه for-each (For-Each Loop) نمونه های دنیای واقعی (Real-Life Examples) شکستن/ادامه (Swift Break/Continue) کالکشن ها (Swift Collections) ست ها (Sets) دیکشنری ها (Dictionaries) map، filter، reduce (map, filter, reduce) مرتب سازی (Sorting) تغییرپذیری (let دربرابر var) (Mutability (let vs var)) پروتکل های کالکشن (Collection Protocols) توابع (Swift Functions) اختیاری ها (Swift Optionals) enumها و الگوها (Swift Enums & Patterns) Closureها (Swift Closures) تاپل ها و نام های مستعار نوع (Tuples & Type Aliases) برنامه نویسی شیءگرا (Swift OOP) کلاس ها/اشیا (Classes/Objects) ساختارها (Structs) کلاس vs ساختار (Class vs Struct) ویژگی های کلاس (Class Properties) متدهای کلاس (Class Methods) کلیدواژه self (self Keyword) ارث بری (Swift Inheritance) چندریختی (Swift Polymorphism) پروتکل ها (Swift Protocols) جنریک ها (Swift Generics) اکستنشن ها (Swift Extensions) کنترل دسترسی (Access Control) سازنده ها (Initializers) مخرب ها (Deinitializers) معنای مقداری و COW (Value Semantics & COW) Equatable و Comparable (Equatable & Comparable) مدیریت خطا (Swift Error Handling) هم روندی (Swift Concurrency) حافظه (Swift Memory) مدیر بسته سوئیفت (Swift Package Manager) معرفی SwiftUI (SwiftUI Intro) راه اندازی پروژه iOS (iOS Project Setup) چیدمان SwiftUI (SwiftUI Layout) HStack VStack ZStack (HStack VStack ZStack) اسپیسر و ترازبندی (Spacers & Alignment) فریم و پدینگ (Frames & Padding) گریدها (Grids) GeometryReader (GeometryReader) ناحیه امن (Safe Area) استک های تنبل (Lazy Stacks) ناوبری SwiftUI (SwiftUI Navigation) NavigationStack (NavigationStack) NavigationLink (NavigationLink) TabView (TabView) شیت ها و پاپ اورها (Sheets & Popovers) دیپ لینک ها (Deep Links) ناوبری برنامه ای (Programmatic Nav) navigationDestination (navigationDestination) نوار ابزار و آیتم ها (Toolbar & Bar Items) جریان داده در SwiftUI (SwiftUI Data Flow) @State (@State) @Binding (@Binding) @ObservedObject & @StateObject (@ObservedObject & @StateObject) @EnvironmentObject (@EnvironmentObject) @Environment (Values) (@Environment (Values)) لیست ها و فرم ها در SwiftUI (SwiftUI Lists & Forms) List (List) ForEach (ForEach) Section (Section) Form (Form) TextField/Toggle/Picker (TextField/Toggle/Picker) Swipe Actions (Swipe Actions) Edit Mode (Edit Mode) List Styles (List Styles) انیمیشن ها در SwiftUI (SwiftUI Animations) انیمیشن های ضمنی (Implicit Animations) انیمیشن های صریح (Explicit Animations) ترنزیشن ها (Transitions) MatchedGeometryEffect (MatchedGeometryEffect) انیمیشن های فنری (Spring Animations) منحنی های انیمیشن (Animation Curves) ژست ها در SwiftUI (SwiftUI Gestures) TapGesture (TapGesture) LongPressGesture (LongPressGesture) DragGesture (DragGesture) ترکیب ژست ها (Composing Gestures) MagnificationGesture (MagnificationGesture) RotationGesture (RotationGesture) Modifierها و ViewBuilder (SwiftUI Modifiers & ViewBuilder) مودیفایرها (Modifiers) ViewBuilder (ViewBuilder) مودیفایرهای سفارشی (Custom Modifiers) پیش نمایش ها (SwiftUI Previews) گونه ها و وضعیت ها (Variants & States) حالت روشن/تیره (Light/Dark Mode) دسترس پذیری در SwiftUI (SwiftUI Accessibility) برچسب ها و عمل ها (Labels & Actions) سایز پویا (Dynamic Type) فوکوس و VoiceOver (Focus & VoiceOver) استایل دهی و تم دهی در SwiftUI (SwiftUI Styling & Theming) طرح های رنگی (Color Schemes) متریال ها (Materials) تم دهی (Theming) شبکه سازی (Networking) ماندگاری (Persistence) ماندگاری (Core Data) (Persistence (Core Data)) معماری MVVM (MVVM Architecture) AppStorage و SceneStorage (AppStorage & SceneStorage) تست SwiftUI (Testing SwiftUI) حریم خصوصی و مجوزها (Privacy & Permissions) اعلان های پوش (Push Notifications) ویجت ها و اکستنشن ها (Widgets & Extensions) کار در پس زمینه (Background Work) Core Location (Core Location) App Clips (App Clips) مبانی Keychain (Keychain Basics) CloudKit (CloudKit) سیستم فایل (File System) URLSession پس زمینه (Background URLSession) MapKit (MapKit) بومی سازی (Localization) دسترس پذیری (Accessibility) حریم خصوصی اپ (App Privacy) خرید درون برنامه ای (In-App Purchases) آنالیتیکس و گزارش گیری (Analytics & Reporting) تست با XCTest (Testing with XCTest) دارایی ها و آیکون ها (Assets & App Icons) امضا و انتشار (Signing & Distribution) TestFlight و App Store (TestFlight & App Store) انتشار اولین اپ (Ship Your First App) تمارین (Swift Exercises) کوییز (Swift Quiz)
نتیجه‌ای برای جستجو یافت نشد.
Swift

Swift — جریان داده در SwiftUI (SwiftUI Data Flow)

آخرین بروزرسانی: 1404/08/15

جریان داده در SwiftUI (SwiftUI Data Flow)

اینجا درباره «جریان داده SwiftUI» حرف می زنیم. «State» یعنی وضعیت محلی یک ویو. «Binding» یعنی پل ساده برای اشتراک همان وضعیت با فرزند. سپس با «ObservableObject» و دوستانش، داده را بین چند ویو پخش می کنیم؛ مثل تابلو اعلانات مدرسه.

@State و @Binding

@State وضعیت محلی است. @Binding همین وضعیت را به فرزند می دهد. وقتی فرزند ویرایش کند، والد هم به روز می شود. مثل دفتر مشترک بین دو هم تیمی.

  1. یک متغیر با @State بساز.
  2. در فرزند، @Binding همان نوع را بگیر.
  3. با $state مقدار را به فرزند پاس بده.
  4. ویرایش در فرزند، والد را به روز می کند.
import SwiftUI

struct Child: View {
  @Binding var text: String
  var body: some View {
    TextField("Enter", text: $text)
      .textFieldStyle(.roundedBorder)
  }
}

struct Parent: View {
  @State private var text = "Hello"
  var body: some View {
    VStack {
      Text(text)
      Child(text: $text)
    }
    .padding()
  }
}

struct ContentView: View {
  var body: some View {
    Parent()
  }
}

@main
struct MyApp: App {
  var body: some Scene {
    WindowGroup {
      ContentView()
    }
  }
}

مشاهده در ادیتور

نکته: از @State برای داده محلی استفاده کن. اگر فرزند نیاز دارد، @Binding بده.

ObservableObject و StateObject

ObservableObject یک مدل قابل مشاهده است. @StateObject یعنی مالک مدل در همین ویو باشد. @ObservedObject یعنی مدل را فقط مشاهده کن. مثل یک شمارنده مشترک در چند کلاس.

  1. یک کلاس با @Published بساز.
  2. در والد از @StateObject برای مالکیت استفاده کن.
  3. در فرزند همان مدل را با @ObservedObject بگیر.
  4. روی دکمه بزن تا تغییرات همه جا دیده شود.
import SwiftUI

class CounterModel: ObservableObject {
  @Published var count = 0
  func increment() {
    count += 1
  }
}

struct ChildView: View {
  @ObservedObject var model: CounterModel
  var body: some View {
    HStack {
      Text("Count: \(model.count)")
      Button("Inc") {
        model.increment()
      }
    }
  }
}

struct ParentView: View {
  @StateObject private var model = CounterModel()
  var body: some View {
    VStack(spacing: 12) {
      ChildView(model: model)
    }
    .padding()
  }
}

struct ContentView: View {
  var body: some View {
    ParentView()
  }
}

@main
struct MyApp: App {
  var body: some Scene {
    WindowGroup {
      ContentView()
    }
  }
}

مشاهده در ادیتور

هشدار: مدل را در چند والد با @StateObject تکرار نکن. چرخه عمر به هم می ریزد.

@EnvironmentObject

وقتی داده باید همه جا باشد، از EnvironmentObject کمک بگیر. مدل را در ریشه با environmentObject تزریق کن. سپس در نوادگان با @EnvironmentObject بخوان. شبیه تابلو سراسری مدرسه.

  1. کلاس ObservableObject مشترک بساز.
  2. در ریشه، environmentObject(model) را ست کن.
  3. در فرزند، @EnvironmentObject را تعریف کن.
  4. حالا تغییرات همه جا دیده می شود.
import SwiftUI

final class AppSettings: ObservableObject {
  @Published var theme = "Light"
}

struct Root: View {
  @StateObject private var settings = AppSettings()
  var body: some View {
    VStack(spacing: 8) {
      Button("Toggle Theme") {
        settings.theme = (settings.theme == "Light") ? "Dark" : "Light"
      }
      Child()
    }
    .environmentObject(settings)
    .padding()
  }
}

struct Child: View {
  @EnvironmentObject var settings: AppSettings
  var body: some View {
    Text("Theme: \(settings.theme)")
  }
}

struct ContentView: View {
  var body: some View {
    Root()
  }
}

@main
struct MyApp: App {
  var body: some Scene {
    WindowGroup {
      ContentView()
    }
  }
}

مشاهده در ادیتور

نکته: برای تنظیمات، سشن، و تم، EnvironmentObject انتخاب خوبی است.

ارتباط با بخش های دیگر

برای ادامه مسیر، این بخش ها را ببین: نوار ابزار و آیتم ها، حالت (State)، و لینک تقویتی سئو: جریان داده SwiftUI.

جمع بندی سریع

  • @State محلی است و ساده.
  • @Binding وضعیت را به فرزند می دهد.
  • ObservableObject داده مشترک می دهد.
  • @StateObject مالک مدل در والد است.
  • @EnvironmentObject برای داده سراسری است.