[Doc] Improve example of using Field components inside a SimpleFormIterator

[WiXSL]

No description provided.

[WiXSL]

This is actually incorrect, it accepts fields components as children, but without a label, once you add the Labeled component you need the FormDataConsumer.

I don't know if I should rephrase this or just leave it like this

[fzaninotto]

Well, it depends: you can use Label+Fields directly to display the record value, but if you want to render a reactive value based on the form inputs, you have to use the FormDataConsumer.

I think this should be clarified in the doc.

[WiXSL]

Well, actually, you cannot use a Labeled + Field inside a SimpleFormIterator.
The SimpleFormIterator passes the correct source prop to each direct children, and the Labeled doesn't pass props to its children.

This is how it goes inside a SimpleFormIterator:

<ArrayInput source="authors">
    <SimpleFormIterator>
        <TextField source="role" />        // => Value is shown , no label
        <Labeled label="Role">              // => Label is shown , no value
            <TextField source="role" />
        </Labeled>
        <FormDataConsumer>               // => Label + value are shown
            {({ getSource }) => {
                return (
                    <Labeled label="Role">
                        <TextField source={getSource('role')} />
                    </Labeled>
                );
            }}
        </FormDataConsumer>
        <FormDataConsumer>                   // => Label is shown, no value
            {({ getSource, scopedFormData }) => {
                return (
                    <Labeled label="Role">
                        <TextField
                            source={getSource('role')}
                            record={scopedFormData}
                        />
                    </Labeled>
                );
            }}
        </FormDataConsumer>
    </SimpleFormIterator>
</ArrayInput>

[fzaninotto]

The last example should work. If it doesn't we should fix the bug.

[fzaninotto]

Well, it depends: you can use Label+Fields directly to display the record value, but if you want to render a reactive value based on the form inputs, you have to use the FormDataConsumer.

I think this should be clarified in the doc.

[fzaninotto]

This is wrong, this will show the data from the record, not the form.

If it doesn't work with scopedFormData, it may be because the usewatch() in FormDataConsumer doesn't return data before changes. This is what we must fix, not the docs.

[slax57]

Might be linked to #8340