Document new WithListContext keys

Author: erwanMarmelab

docs/WithListContext.md

@@ -84,6 +84,13 @@ Whether you use `<WithListContext>` or `useListContext` is a matter of coding st
 
 `<WithListContext>` accepts a single `render` prop, which should be a function.
 
+| Prop       | Required | Type           | Default | Description                                             |
+|------------|----------|----------------|---------|---------------------------------------------------------|
+| `empty`    | Optional | `ReactElement` |         | The component to display when the data is empty.       |
+| `error`    | Optional | `ReactElement` |         | The component to display in case of error.              |
+| `loading`  | Optional | `ReactElement` |         | The component to display while checking authorizations. |
+| `render`   | Required | `function`     |         | The function to render the data                         |
+
 ## `render`
 
 A function which will be called with the current [`ListContext`](./useListContext.md) as argument. It should return a React element.
@@ -139,6 +146,68 @@ As a reminder, the [`ListContext`](./useListContext.md) is an object with the fo
 }) => ( ... )}>
 ```
 
+## `empty`
+
+Use `empty` to display a dedicated component when the related record is empty.
+
+```jsx
+<WithListContext
+  empty={<p>no books</p>}
+  render={({ data }) => (
+      <ul>
+          {data.map(book => (
+              <li key={book.id}>
+                  <i>{book.title}</i>, published on
+                  {book.published_at}
+              </li>
+          ))}
+      </ul>
+  )}
+  loading={<p>Loading...</p>}
+/>
+```
+
+## `error`
+
+Use `error` to display a dedicated component when an error is thrown.
+
+```jsx
+<WithListContext
+  error={<p>Error while loading books...</p>}
+  render={({ data }) => (
+      <ul>
+          {data.map(book => (
+              <li key={book.id}>
+                  <i>{book.title}</i>, published on
+                  {book.published_at}
+              </li>
+          ))}
+      </ul>
+  )}
+  loading={<p>Loading...</p>}
+/>
+```
+
+## `loading`
+
+Use `loading` to display a dedicated component while checking for users' permissions.
+
+```jsx
+<WithListContext
+  loading={<p>loading...</p>}
+  render={({ data }) => (
+      <ul>
+          {data.map(book => (
+              <li key={book.id}>
+                  <i>{book.title}</i>, published on
+                  {book.published_at}
+              </li>
+          ))}
+      </ul>
+  )}
+/>
+```
+
 ## Availability
 
 Whenever you use a react-admin component to fetch a list of records, react-admin stores the data in a [`ListContext`](./useListContext.md). Consequently, `<WithListContext>` works in any component that is a descendant of: