Introduce <RecordsIterator>

docs/Create.md

@@ -55,23 +55,24 @@ export default App;
 
 You can customize the `<Create>` component using the following props:
 
-| Prop                | Required | Type                | Default        | Description                                                                                      |
-|---------------------|----------|---------------------|----------------|--------------------------------------------------------------------------------------------------|
-| `children`          | Optional&nbsp;* | `ReactNode`         | -              | The components that render the form                                                              |
-| `render`            | Optional&nbsp;* | `function`          | -              | Alternative to children. Function that renders the form, receives the create context as argument |
-| `actions`           | Optional | `ReactNode`         | Default toolbar| Override the actions toolbar with a custom component                                             |
-| `aside`             | Optional | `ReactNode`         | -              | Component to render aside to the main content                                                    |
-| `className`         | Optional | `string`            | -              | Passed to the root component                                                                     |
-| `component`         | Optional | `string`/`Component`| `Card`         | Override the root component                                                                      |
-| `disableAuthentication` | Optional | `boolean`      | `false`         | Disable the authentication check                                                                 |
-| `mutationMode`      | Optional | `string`            | `pessimistic`  | Switch to optimistic or undoable mutations                                                       |
-| `mutationOptions`   | Optional | `object`            | -              | Options for the `dataProvider.create()` call                                                     |
-| `record`            | Optional | `object`            | `{}`           | Initialize the form with a record                                                                |
-| `redirect`          | Optional | `string`/`function` | `'edit'`       | Change the redirect location after successful creation                                           |
-| `resource`          | Optional | `string`            | From URL       | Override the name of the resource to create                                                      |
-| `sx`                | Optional | `object`            | -              | Override the styles                                                                              |
-| `title`             | Optional | `string`/`ReactNode`| Translation    | Override the page title                                                                          |
-| `transform`         | Optional | `function`          | -              | Transform the form data before calling `dataProvider.create()`                                   |
+| Prop                    | Required        | Type                 | Default         | Description                                                                                      |
+|-------------------------|-----------------|----------------------|-----------------|--------------------------------------------------------------------------------------------------|
+| `authLoading`           | Optional        | `ReactNode`          | -               | The component to display while checking for authentication                                       |
+| `children`              | Optional&nbsp;* | `ReactNode`          | -               | The components that render the form                                                              |
+| `render`                | Optional&nbsp;* | `function`           | -               | Alternative to children. Function that renders the form, receives the create context as argument |
+| `actions`               | Optional        | `ReactNode`          | Default toolbar | Override the actions toolbar with a custom component                                             |
+| `aside`                 | Optional        | `ReactNode`          | -               | Component to render aside to the main content                                                    |
+| `className`             | Optional        | `string`             | -               | Passed to the root component                                                                     |
+| `component`             | Optional        | `string`/`Component` | `Card`          | Override the root component                                                                      |
+| `disableAuthentication` | Optional        | `boolean`            | `false`         | Disable the authentication check                                                                 |
+| `mutationMode`          | Optional        | `string`             | `pessimistic`   | Switch to optimistic or undoable mutations                                                       |
+| `mutationOptions`       | Optional        | `object`             | -               | Options for the `dataProvider.create()` call                                                     |
+| `record`                | Optional        | `object`             | `{}`            | Initialize the form with a record                                                                |
+| `redirect`              | Optional        | `string`/`function`  | `'edit'`        | Change the redirect location after successful creation                                           |
+| `resource`              | Optional        | `string`             | From URL        | Override the name of the resource to create                                                      |
+| `sx`                    | Optional        | `object`             | -               | Override the styles                                                                              |
+| `title`                 | Optional        | `string`/`ReactNode` | Translation     | Override the page title                                                                          |
+| `transform`             | Optional        | `function`           | -               | Transform the form data before calling `dataProvider.create()`                                   |
 
 `*` You must provide either `children` or `render`.
 
@@ -125,6 +126,20 @@ const PostCreate = () => (
 
 {% endraw %}
 
+## `authLoading`
+
+By default, `<Create>` renders the `<Loading>` component while checking for authentication and permissions. You can display a custom component via the `authLoading` prop:
+
+```jsx
+import { Create } from 'react-admin';
+
+export const PostCreate = () => (
+    <Create authLoading={<p>Checking for permissions...</p>}>
+        ...
+    </Create>
+);
+```
+
 ## `children`
 
 The `<Create>` component will render its children inside a [`CreateContext`](./useCreateContext.md#return-value). Children can be any React node, but are usually a form component like [`<SimpleForm>`](./SimpleForm.md), [`<TabbedForm>`](./TabbedForm.md), or the headless [`<Form>`](./Form.md) component.

docs/CreateBase.md

@@ -45,8 +45,9 @@ export const BookCreate = () => (
 
 You can customize the `<CreateBase>` component using the following props, documented in the `<Create>` component:
 
-* `children`: the components that renders the form
-* `render`: alternative to children, a function that takes the `CreateController` context and renders the form
+* [`authLoading`](./Create.md#authloading): the component to display while checking for authentication
+* [`children`](./Create.md#children): the components that renders the form
+* [`render`](./Create.md#render): alternative to children, a function that takes the `CreateController` context and renders the form
 * [`disableAuthentication`](./Create.md#disableauthentication): disable the authentication check
 * [`mutationMode`](./Create.md#mutationmode): Switch to optimistic or undoable mutations (pessimistic by default)
 * [`mutationOptions`](./Create.md#mutationoptions): options for the `dataProvider.create()` call

docs/DataTable.md

@@ -970,21 +970,21 @@ export const PostList = () => (
 
 ### Props
 
-| Prop                 | Required | Type                    | Default               | Description                                                   |
-| -------------------- | -------- | ----------------------- | --------------------- | ------------------------------------------------------------- |
-| `align`              | Optional       | `"left" \| "right"`    | `"left"`              | The alignment of the column.                                  |
-| `children`           | Optional | ReactNode               | -                     | The content of the column.                                    |
-| `cellClassName`      | Optional | string                  | -                     | The class name of the cells.                                   |
-| `cellSx`          | Optional | function                 | -                     | A function that returns the sx prop to apply to a cell.                             |
-| `className`          | Optional | string                  | -                     | The class name of the column.                                 |
-| `disableSort`        | Optional | boolean                 | false                | Set to true to disable sort.                               |
-| `field`              | Optional | Component               | -                     | The field component to use for the column.                    |
-| `headerClassName`    | Optional | string                  | -                     | The class name of the header cell.                            |
-| `label`              | Optional | string                  | -                     | The column label, displayed in the header.                    |
-| `render`             | Optional | (record) => ReactNode | -               | A function to render the column content.                      |
-| `sortByOrder`        | Optional | "ASC" \| "DESC"         | "ASC"                 | The order to use for sorting the column.                      |
-| `source`             | Optional | string                  | -                     | The source of the column, used for sorting and to read the data from the record when there is no child. |
-| `sx`                | Optional | SxProps                 | -                     | The styles to apply to the column.                            |
+| Prop              | Required   | Type                      | Default    | Description                                                                                             |
+|-------------------|------------|---------------------------|------------|---------------------------------------------------------------------------------------------------------|
+| `align`           | Optional   | `"left"` | `"right"` | `"left"`   | The alignment of the column.                                                                            |
+| `children`        | Optional   | ReactNode                 | -          | The content of the column.                                                                              |
+| `cellClassName`   | Optional   | string                    | -          | The class name of the cells.                                                                            |
+| `cellSx`          | Optional   | function                  | -          | A function that returns the sx prop to apply to a cell.                                                 |
+| `className`       | Optional   | string                    | -          | The class name of the column.                                                                           |
+| `disableSort`     | Optional   | boolean                   | `false`    | Set to true to disable sort.                                                                            |
+| `field`           | Optional   | Component                 | -          | The field component to use for the column.                                                              |
+| `headerClassName` | Optional   | string                    | -          | The class name of the header cell.                                                                      |
+| `label`           | Optional   | string                    | -          | The column label, displayed in the header.                                                              |
+| `render`          | Optional   | (record) => ReactNode     | -          | A function to render the column content.                                                                |
+| `sortByOrder`     | Optional   | `"ASC"` | `"DESC"`   | `"ASC"`    | The order to use for sorting the column.                                                                |
+| `source`          | Optional   | string                    | -          | The source of the column, used for sorting and to read the data from the record when there is no child. |
+| `sx`              | Optional   | SxProps                   | -          | The styles to apply to the column.                                                                      |
 
 Additional props are passed to [the MUI `<TableCell>`](https://mui.com/material-ui/api/table-cell/) component.