mirror of
https://github.com/pointfreeco/swift-composable-architecture.git
synced 2025-12-24 12:14:25 +01:00
The -`able` naming evokes protocols in Swift, and is an outlier when considered alongside the rest of TCA's binding tools: - `BindingAction`: concrete type - `BindableAction`: protocol - `BindingReducer`: concrete type So, let's make things consistent. The one caveat is that Swift diagnostics for such a deprecation aren't great, so users won't get proactive warnings here for the time being: https://github.com/apple/swift/issues/63139 We may just want to keep the deprecation around till it does...
127 lines
3.2 KiB
Swift
127 lines
3.2 KiB
Swift
import ComposableArchitecture
|
|
import SwiftUI
|
|
|
|
private let readMe = """
|
|
This file demonstrates how to handle two-way bindings in the Composable Architecture using \
|
|
bindable state and actions.
|
|
|
|
Bindable state and actions allow you to safely eliminate the boilerplate caused by needing to \
|
|
have a unique action for every UI control. Instead, all UI bindings can be consolidated into a \
|
|
single `binding` action that holds onto a `BindingAction` value, and all bindable state can be \
|
|
safeguarded with the `BindingState` property wrapper.
|
|
|
|
It is instructive to compare this case study to the "Binding Basics" case study.
|
|
"""
|
|
|
|
// MARK: - Feature domain
|
|
|
|
struct BindingForm: ReducerProtocol {
|
|
struct State: Equatable {
|
|
@BindingState var sliderValue = 5.0
|
|
@BindingState var stepCount = 10
|
|
@BindingState var text = ""
|
|
@BindingState var toggleIsOn = false
|
|
}
|
|
|
|
enum Action: BindableAction, Equatable {
|
|
case binding(BindingAction<State>)
|
|
case resetButtonTapped
|
|
}
|
|
|
|
var body: some ReducerProtocol<State, Action> {
|
|
BindingReducer()
|
|
Reduce { state, action in
|
|
switch action {
|
|
case .binding(\.$stepCount):
|
|
state.sliderValue = .minimum(state.sliderValue, Double(state.stepCount))
|
|
return .none
|
|
|
|
case .binding:
|
|
return .none
|
|
|
|
case .resetButtonTapped:
|
|
state = State()
|
|
return .none
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// MARK: - Feature view
|
|
|
|
struct BindingFormView: View {
|
|
let store: StoreOf<BindingForm>
|
|
|
|
var body: some View {
|
|
WithViewStore(self.store, observe: { $0 }) { viewStore in
|
|
Form {
|
|
Section {
|
|
AboutView(readMe: readMe)
|
|
}
|
|
|
|
HStack {
|
|
TextField("Type here", text: viewStore.binding(\.$text))
|
|
.disableAutocorrection(true)
|
|
.foregroundStyle(viewStore.toggleIsOn ? Color.secondary : .primary)
|
|
Text(alternate(viewStore.text))
|
|
}
|
|
.disabled(viewStore.toggleIsOn)
|
|
|
|
Toggle(
|
|
"Disable other controls",
|
|
isOn: viewStore.binding(\.$toggleIsOn)
|
|
.resignFirstResponder()
|
|
)
|
|
|
|
Stepper(
|
|
"Max slider value: \(viewStore.stepCount)",
|
|
value: viewStore.binding(\.$stepCount),
|
|
in: 0...100
|
|
)
|
|
.disabled(viewStore.toggleIsOn)
|
|
|
|
HStack {
|
|
Text("Slider value: \(Int(viewStore.sliderValue))")
|
|
|
|
Slider(value: viewStore.binding(\.$sliderValue), in: 0...Double(viewStore.stepCount))
|
|
.tint(.accentColor)
|
|
}
|
|
.disabled(viewStore.toggleIsOn)
|
|
|
|
Button("Reset") {
|
|
viewStore.send(.resetButtonTapped)
|
|
}
|
|
.tint(.red)
|
|
}
|
|
}
|
|
.monospacedDigit()
|
|
.navigationTitle("Bindings form")
|
|
}
|
|
}
|
|
|
|
private func alternate(_ string: String) -> String {
|
|
string
|
|
.enumerated()
|
|
.map { idx, char in
|
|
idx.isMultiple(of: 2)
|
|
? char.uppercased()
|
|
: char.lowercased()
|
|
}
|
|
.joined()
|
|
}
|
|
|
|
// MARK: - SwiftUI previews
|
|
|
|
struct BindingFormView_Previews: PreviewProvider {
|
|
static var previews: some View {
|
|
NavigationView {
|
|
BindingFormView(
|
|
store: Store(
|
|
initialState: BindingForm.State(),
|
|
reducer: BindingForm()
|
|
)
|
|
)
|
|
}
|
|
}
|
|
}
|