[DNM] Remove ListIterator

docs/ReferenceArrayFieldBase.md

@@ -45,15 +45,17 @@ A typical `post` record therefore looks like this:
 In that case, use `<ReferenceArrayFieldBase>` to display the post tag names as a list of chips, as follows:
 
 ```jsx
-import { ListBase, ListIterator, ReferenceArrayFieldBase } from 'react-admin';
+import { ListBase, RecordsIterator, ReferenceArrayFieldBase, WithListContext } from 'react-admin'; 
 
 export const PostList = () => (
     <ListBase>
-        <ListIterator>
-            <ReferenceArrayFieldBase reference="tags" source="tag_ids">
-                <TagList />
-            </ReferenceArrayFieldBase>
-        </ListIterator>
+        <WithListContext loading={null} errorElement={null} offline={null} empty={null}>
+            <RecordsIterator>
+                <ReferenceArrayFieldBase reference="tags" source="tag_ids">
+                    <TagList />
+                </ReferenceArrayFieldBase>
+            </RecordsIterator>
+        </WithListContext>
     </ListBase>
 );
 

docs/ReferenceFieldBase.md

@@ -223,15 +223,17 @@ When used in a `<DataTable>`, `<ReferenceFieldBase>` fetches the referenced reco
 For instance, with this code:
 
 ```jsx
-import { ListBase, ListIterator, ReferenceFieldBase } from 'react-admin';
+import { ListBase, RecordsIterator, ReferenceFieldBase, WithListContext } from 'react-admin';
 
 export const PostList = () => (
     <ListBase>
-        <ListIterator>
-            <ReferenceFieldBase source="user_id" reference="users">
-                <AuthorView />
-            </ReferenceFieldBase>
-        </ListIterator>
+        <WithListContext loading={null} errorElement={null} offline={null} empty={null}>
+            <RecordsIterator>
+                <ReferenceFieldBase source="user_id" reference="users">
+                    <AuthorView />
+                </ReferenceFieldBase>
+            </RecordsIterator>
+        </WithListContext>
     </ListBase>
 );
 ```
@@ -270,16 +272,16 @@ For example, the following code prefetches the authors referenced by the posts:
 ```jsx
 const PostList = () => (
     <ListBase queryOptions={{ meta: { prefetch: ['author'] } }}>
-        <ListIterator
-            render={({ title, author_id }) => (
+        <WithListContext loading={null} errorElement={null} offline={null} empty={null}>
+            <RecordsIterator render={(author) => (
                 <div>
-                    <h3>{title}</h3>
+                    <h3>{author.title}</h3>
                     <ReferenceFieldBase source="author_id" reference="authors">
                         <AuthorView />
                     </ReferenceFieldBase>
                 </div>
-            )}
-        />
+            )} />
+        </WithListContext>
     </ListBase>
 );
 ```
@@ -303,4 +305,4 @@ React-Admin will call `canAccess` with the following parameters:
 - If the `users` resource has a Show view: `{ action: "show", resource: 'posts', record: Object }`
 - If the `users` resource has an Edit view: `{ action: "edit", resource: 'posts', record: Object }`
 
-And the link property of the referenceField context will be set accordingly. It will be set to false if the access is denied.
+And the link property of the referenceField context will be set accordingly. It will be set to false if the access is denied.

docs/ReferenceManyFieldBase.md

@@ -72,15 +72,17 @@ const BookList = ({
 You can also use `<ReferenceManyFieldBase>` in a list, e.g. to display the authors of the comments related to each post in a list by matching `post.id` to `comment.post_id`:
 
 ```jsx
-import { ListBase, ListIterator, ReferenceManyFieldBase } from 'react-admin';
+import { ListBase, RecordsIterator, ReferenceManyFieldBase, WithListContext } from 'react-admin';
 
 export const PostList = () => (
     <ListBase>
-        <ListIterator>
-            <ReferenceManyFieldBase reference="comments" target="post_id">
-                <CustomAuthorView source="name"/>
-            </ReferenceManyFieldBase>
-        </ListIterator>
+        <WithListContext loading={null} errorElement={null} offline={null} empty={null}>
+            <RecordsIterator>
+                <ReferenceManyFieldBase reference="comments" target="post_id">
+                    <CustomAuthorView source="name"/>
+                </ReferenceManyFieldBase>
+            </RecordsIterator>
+        </WithListContext>
     </ListBase>
 );
 ```
@@ -116,20 +118,31 @@ export const PostList = () => (
 - [`<EditableDatagrid>`](./EditableDatagrid.md)
 - [`<Calendar>`](./Calendar.md)
 
-For instance, use a `<ListIterator>` to render the related records:
+For instance, use a `<RecordsIterator>` to render the related records:
 
 ```jsx
-import { ShowBase, ReferenceManyFieldBase, ListIterator } from 'react-admin';
+import { ShowBase, RecordsIterator, ReferenceManyFieldBase } from 'react-admin';
 
 export const AuthorShow = () => (
     <ShowBase>
-        <ReferenceManyFieldBase label="Books" reference="books" target="author_id">
+        <ReferenceManyFieldBase
+            label="Books"
+            reference="books"
+            target="author_id"
+            loading={<p>Loading...</p>}
+            error={null}
+            offline={null}
+            empty={null}
+        >
             <ul>
-                <ListIterator render={(book) => (
-                    <li key={book.id}>
-                        <i>{book.title}</i>, published on{' '}{book.published_at}
-                    </li>
-                )}/>
+                <RecordsIterator
+                    render={book => (
+                        <li key={book.id}>
+                            <i>{book.title}</i>, published on
+                            {book.published_at}
+                        </li>
+                    )}
+                />
             </ul>
         </ReferenceManyFieldBase>
     </ShowBase>
@@ -343,8 +356,12 @@ In the example below, both lists use the same reference ('books'), but their sel
         queryOptions={{
             meta: { foo: 'bar' },
         }}
+        loading={<p>Loading...</p>}
+        error={null}
+        offline={null}
+        empty={<p>No books</p>}
     >
-        <ListIterator render={(book) => (
+        <RecordsIterator render={(book) => (
             <p>{book.title}</p>
         )} />
     </ReferenceManyFieldBase>