2. Adding Edit Page
Edit page is the page where you can edit the record. In this tutorial, we will create the edit page for the blog_posts
resource.
Creating Edit Page
First, let's create our file under the src/pages/blog-posts
folder. We will name it edit.tsx
. Then, we will copy the edit page code generated by Inferencer and paste it into the file.
To copy the code and paste it into the file, follow the steps below:
Navigate to the localhost:3000/blog-posts in your browser.
To open the edit page, click any "Edit" button in the "Actions" column of the table.
On the edit page, click on the "Show Code" button in the bottom right corner of the page.
You can see the edit page code generated by Inferencer. Click on the "Copy" button to copy the code.
Paste the code into the you created,
edit.tsx
file.
You can see the edit page code generated by Inferencer below:
Instead of coding the edit page component from scratch, Inferencer created the required code base on API response, so that we can customize.
Understanding the Edit Component
We will go through the edit page components and hooks one by one.
<Edit/>
is a refine component that is used to presentation purposes like showing the title of the page, save button, refresh button etc.useForm
hook, imported from@pankod/refine-react-hook-form
package, has been developed by using the React Hook Form anduseForm
hook imported from@pankod/refine-core
package.It provides all the features of the
useForm
hook from@pankod/refine-core
package as well as theuseForm
hook from React Hook Form.It also provides the
saveButtonProps
prop that we can pass to the submit button of the form.When you use
useForm
in the edit page, it automatically fetches the data of the record by using theid
in the URL, then fills the form with the data. It sends the form data todataProvider
'supdate
method when the form is submitted.Refer to the @pankod/refine-react-hook-form
useForm
documentation for more information →Refer to the React Hook Form documentation for more information →
All other components provided by Chakra UI are used to display the form fields.
Handling Relationships
In the edit page, we may need to select a record from another resource. For example, we may need to select a category from the categories
resource to assign the blog post to the category. In this case, we can use the useSelect
hook provided by refine. This hook fetches the data by passing the params to the dataProvider
's getList
method. Then, it returns the options
to be used in the <Select/>
component.
Refer to the useSelect
documentation for more information →
Refer to the Chakra UI <Select/>
documentation for more information →
In the auto-generated edit page code, Inferencer used the useSelect
hook to select a category from the categories
resource like below:
const { options: categoryOptions } = useSelect({
resource: "categories",
});
useSelect
returns 10 record by default, but the category of the blog post may not be in the first 10 records. To solve this problem, we can use the defaultValue
prop to set the default value of the useSelect
hook like below:
const { options: categoryOptions } = useSelect({
resource: "categories",
defaultValue: blogPostsData?.category?.id,
});
Adding the Edit Page to the App
Now that we have created the edit page, we need to add it to the App.tsx
file.
Open
src/App.tsx
file on your editor.Import the created
BlogPostEdit
component.Replace the
ChakraUIInferencer
component with theBlogPostEdit
component.
import { Refine } from "@pankod/refine-core";
import routerProvider from "@pankod/refine-react-router-v6";
import dataProvider from "@pankod/refine-simple-rest";
import {
ChakraProvider,
ErrorComponent,
Layout,
refineTheme,
ReadyPage,
useNotificationProvider,
} from "@pankod/refine-chakra-ui";
import { ChakraUIInferencer } from "@pankod/refine-inferencer/chakra-ui";
import { BlogPostList } from "pages/blog-posts/list";
import { BlogPostEdit } from "pages/blog-posts/edit";
const App = () => {
return (
<ChakraProvider theme={refineTheme}>
<Refine
notificationProvider={notificationProvider()}
routerProvider={routerProvider}
dataProvider={dataProvider("https://api.fake-rest.refine.dev")}
Layout={Layout}
ReadyPage={ReadyPage}
catchAll={<ErrorComponent />}
resources={[
{
name: "blog_posts",
list: BlogPostList,
edit: BlogPostEdit,
show: ChakraUIInferencer,
create: ChakraUIInferencer,
},
]}
/>
</ChakraProvider>
);
};
export default App;
Now, we can see the edit page in the browser at localhost:3000/blog-posts/edit/123