198

I would like to initialise the value of a @State var in SwiftUI through the init() method of a Struct, so it can take the proper text from a prepared dictionary for manipulation purposes in a TextField. The source code looks like this:

struct StateFromOutside: View {
    let list = [
        "a": "Letter A",
        "b": "Letter B",
        // ...
    ]
    @State var fullText: String = ""

    init(letter: String) {
        self.fullText = list[letter]!
    }

    var body: some View {
        TextField($fullText)
    }
}

Unfortunately the execution fails with the error Thread 1: Fatal error: Accessing State<String> outside View.body

How can I resolve the situation? Thank you very much in advance!

mica
  • 3,898
  • 4
  • 34
  • 62
Daniel Messner
  • 2,305
  • 2
  • 15
  • 15
  • 12
    Use `State(initialValue:)` – onmyway133 Mar 16 '20 at 13:05
  • 10
    @Daniel please make the answer with 150+ coming on second number as accepted answer. As like me, many missed the second answer and stay stuck for a lot of time. – Tul Jul 04 '20 at 13:43
  • 1
    The [most upvoted answer](https://stackoverflow.com/a/58137096/2547229) is probably the answer you want in preference to the accepted answer. – Benjohn Dec 14 '20 at 17:44

8 Answers8

651

SwiftUI doesn't allow you to change @State in the initializer but you can initialize it.

Remove the default value and use _fullText to set @State directly instead of going through the property wrapper accessor.

@State var fullText: String // No default value of ""

init(letter: String) {
    _fullText = State(initialValue: list[letter]!)
}
shim
  • 9,289
  • 12
  • 69
  • 108
Kevin
  • 16,696
  • 7
  • 51
  • 68
  • 120
    This should be the accepted answer, onAppear may be too late in some cases. – Yonat Oct 16 '19 at 17:21
  • 2
    Where is the underscore documented? – Diesel Jan 26 '20 at 03:10
  • 3
    https://docs.swift.org/swift-book/LanguageGuide/Properties.html#ID617 – Kevin Jan 27 '20 at 15:51
  • Work like a dream! I was searching the way to change @State value when initializing for few days, in my case I need to init PageView from the main view. Thus, where could we know that SwiftUI doesn't allow us to change @State? Because I hope I could figure this out it by my own next time. – Zhou Haibo Apr 21 '20 at 03:40
  • I don't recall seeing State(...) having been brought to light elsewhere - for me, this and _xxx was a perfect combination enabling things like initializing @State variables used with Slider. Great answer. – Feldur May 20 '20 at 15:20
  • 7
    @Diesel At first I was hesitant to use this because I thought it was accessing some internal API, but it turns out it's part of the Swift language. For concise information about how property wrappers work under the hood including the synthesized underscore (_), see https://docs.swift.org/swift-book/ReferenceManual/Attributes.html under **propertyWrapper** – bcause Jul 01 '20 at 18:49
  • 17
    You should also note that the state you initialise inside `init` will probably immediately be overridden after all the stored properties are initialised. See [this comment](https://forums.swift.org/t/state-messing-with-initializer-flow/25276/3) where an  engineer explicitly says not to initialise @State using `init` but to do it inline instead. – Damiaan Dufaux Jul 08 '20 at 15:44
  • I am passing a struct into the view with the @State variable. the struct has a parameter called page which is a Int. So lets say the struct that im passing is called Work, I initialise it with ```var work: Work``` and I have a State variable defined as ```@State var count: Int```. How could I initialise count with ```work.page```? – Arnav Motwani Nov 04 '20 at 16:33
  • 2
    This solution is good, but it's not complete. the problem is that subsequent calls to the view have no effect on the State variable. The solution is easy: add ".id(some_var)" to the caller in the parent view. See my answer for complete example – RawMean Dec 12 '20 at 03:10
  • 10
    The answer is not a solution to the problem. It will not work "like a dream", rather nightmarish. Here, we need to use bindings which can be initialised within the initialiser, if we want to mutate the value within the view. Initialising @State in init will do it only the very first time a value of this view will be created. Subsequent views will not see the value which is passed as argument in the init, but the previous value which is cached by the SwiftUI system. – CouchDeveloper Apr 26 '21 at 11:21
  • 5
    https://developer.apple.com/forums/thread/657393 "init is not a good place to update the value of @State vars." – shim Jan 05 '22 at 22:55
  • Came across this post because my issue was the state variable was always nil in the initializer. Thanks this answer. – chitgoks Oct 22 '22 at 06:34
  • I'm new to SwiftUI, but found my way to this (helpful, if not perfect, reading the comments) answer while trying to find ways to generate `PreviewProvider` views with pre-determined/mock state that forced my application to display a certain way. – Craig Otis Jan 25 '23 at 02:13
  • 1
    Subsequent inits will ignore changes to _fullText. `initialValue` is only mean to be used with non-dynamic values. – Patrick Feb 17 '23 at 11:21
  • https://developer.apple.com/documentation/swiftui/state Note that the official docs state pretty clearly: "Always initialize state by providing a default value in the state’s declaration." Of course, it wouldn't be SwiftUI documentation if they explained *why*. – dbplunkett Jun 22 '23 at 03:41
  • 1
    This is not a correct answer and shouldn't be – MJ Studio Aug 16 '23 at 19:06
46

I would try to initialise it in onAppear.

struct StateFromOutside: View {
    let list = [
        "a": "Letter A",
        "b": "Letter B",
        // ...
    ]
    @State var fullText: String = ""

    var body: some View {
        TextField($fullText)
             .onAppear {
                 self.fullText = list[letter]!
             }
    }
}

Or, even better, use a model object (a BindableObject linked to your view) and do all the initialisation and business logic there. Your view will update to reflect the changes automatically.


Update: BindableObject is now called ObservableObject.

Marcus Rossel
  • 3,196
  • 1
  • 26
  • 41
Bogdan Farca
  • 3,856
  • 26
  • 38
  • Thank you, this works perfectly (although I have applied the .onAppear on a VStack which is around the TextField). – Daniel Messner Jun 21 '19 at 20:05
  • Hacking around a little longer I have noticed that your solution is a workaround for this very situation, but I ran into more situations where I have to initialise a @State var. Although it would be possible to apply this method there as well I do not think that this is the very best way to handle it. – Daniel Messner Jun 21 '19 at 20:55
  • @DanielMessner : Yes, I agree, for more complicated cases just use a model object (`BindableObject`) and do the initialization in that object, either when running init() or triggered in the view by an `.onAppear` event. – Bogdan Farca Jun 24 '19 at 12:38
  • 2
    This is not considered the best solution for the particular case in the question - but it is the best solution for another type of problem. I have a @State whose initial value depends on another object I pass in, so each time I show the view, I want it to have a different initial value. The other answer does not solve that, but setting the state in onAppear does. – Richard Venable Sep 24 '20 at 12:34
14

The top answer is an anti-pattern that will cause pain down the road, when the dependency changes (letter) and your state will not update accordingly.

One should never use State(initialValue:) or State(wrappedValue:) to initialize state in a View's init. In fact, State should only be initialized inline, like so:

@State private var fullText: String = "The value"

If that's not feasible, use @Binding, @ObservedObject, a combination between @Binding and @State or even a custom DynamicProperty

More about this here.

Rad'Val
  • 8,895
  • 9
  • 62
  • 92
1

It's not an issue nowadays to set a default value of the @State variables inside the init method. But you MUST just get rid of the default value which you gave to the state and it will work as desired:

,,,
    @State var fullText: String // <- No default value here

    init(letter: String) {
        self.fullText = list[letter]!
    }

    var body: some View {
        TextField("", text: $fullText)
    }
}
Mojtaba Hosseini
  • 95,414
  • 31
  • 268
  • 278
1

Depending on the case, you can initialize the State in different ways:

// With default value

@State var fullText: String = "XXX"

// Not optional value and without default value

@State var fullText: String

init(x: String) {
    fullText = x
}

// Optional value and without default value

@State var fullText: String

init(x: String) {
    _fullText = State(initialValue: x)
}
0

The answer of Bogdan Farca is right for this case but we can't say this is the solution for the asked question because I found there is the issue with the Textfield in the asked question. Still we can use the init for the same code So look into the below code it shows the exact solution for asked question.

struct StateFromOutside: View {
    let list = [
        "a": "Letter A",
        "b": "Letter B",
        // ...
    ]
    @State var fullText: String = ""

    init(letter: String) {
        self.fullText = list[letter]!
    }

    var body: some View {
        VStack {
            Text("\(self.fullText)")
            TextField("Enter some text", text: $fullText)
        }
    }
}

And use this by simply calling inside your view

struct ContentView: View {
    var body: some View {
        StateFromOutside(letter: "a")
    }
}
bhargav K
  • 64
  • 4
0

You can create a view model and initiate the same as well :

 class LetterViewModel: ObservableObject {

     var fullText: String
     let listTemp = [
         "a": "Letter A",
         "b": "Letter B",
         // ...
     ]

     init(initialLetter: String) {
         fullText = listTemp[initialLetter] ?? ""
     }
 }

 struct LetterView: View {

     @State var viewmodel: LetterViewModel

     var body: some View {
    
         TextField("Enter text", text: $viewmodel.fullText)
     }
 }

And then call the view like this:

 struct ContentView: View {

     var body: some View {

           LetterView(viewmodel: LetterViewModel(initialLetter: "a"))
     }
 }

By this you would also not have to call the State instantiate method.

-2

See the .id(count) in the example code below.

import SwiftUI
import MapKit

struct ContentView: View {
    @State private var count = 0
    
    var body: some View {
        Button("Tap me") {
            self.count += 1
            print(count)
        }
        Spacer()
        testView(count: count).id(count) // <------ THIS IS IMPORTANT. Without this "id" the initializer setting affects the testView only once and calling testView again won't change it (not desirable, of course)
    }
}



struct testView: View {
    var count2: Int
    @State private var region: MKCoordinateRegion
    
    init(count: Int) {
        count2 = 2*count
        print("in testView: \(count)")
        
        let lon =  -0.1246402 + Double(count) / 100.0
        let lat =  51.50007773 + Double(count) / 100.0
        let myRegion = MKCoordinateRegion(center: CLLocationCoordinate2D(latitude: lat, longitude: lon) , span: MKCoordinateSpan(latitudeDelta: 0.01, longitudeDelta: 0.01))
        _region = State(initialValue: myRegion)
    }

    var body: some View {
        Map(coordinateRegion: $region, interactionModes: MapInteractionModes.all)
        Text("\(count2)")
    }
}
McKinley
  • 1,123
  • 1
  • 8
  • 18
RawMean
  • 8,374
  • 6
  • 55
  • 82