useMenu

useMenu is used to get menu items derived from the resources. These items include a link to the dashboard page (if it exists) and links to the user-defined resources (passed as children to <Refine>).

This hook can also be used to build custom menus, including multi-level support. <Sider/> components inside @refinedev/antd, @refinedev/mui, @refinedev/chakra-ui and, @refinedev/mantine packages are using this hook as a base for their menus.

const { selectedKey, menuItems, defaultOpenKeys } = useMenu();

• menuItems is a list of style agnostic menu items. Each of them has a key.
• selectedKey is the key of the resource user is viewing at the moment. Its inferred from the route.
• defaultOpenKeys is the array with the keys of default opened menus.

caution

useMenu hooks exported from @refinedev/antd and @refinedev/mui packages are now deprecated and will be removed. Please use useMenu from @refinedev/core.

Usage

tip

If you are using @refinedev/antd, @refinedev/mui, @refinedev/chakra-ui or @refinedev/mantine as a UI framework integration, you can find out more info about their structure and how to use useMenu in the Custom Layout

Creating a Menu

We will show you how to use useMenu to create a simple menu for your refine application.

http://localhost:3000

import React from "react";
import { useMenu, LayoutProps, ITreeMenu } from "@refinedev/core";

import { Link } from "react-router-dom";

const Layout: React.FC<LayoutProps> = ({ children }) => {
    const { menuItems, selectedKey } = useMenu();

    const renderMenuItems = (items: ITreeMenu[]) => {
        return (
            <>
                {menuItems.map(({ name, label, icon, route }) => {
                    const isSelected = key === selectedKey;
                    return (
                        <li key={name}>
                            <Link
                                to={route}
                                style={{
                                    fontWeight: isSelected ? "bold" : "normal",
                                }}
                            >
                                {icon}
                                <span>{label ?? name}</span>
                            </Link>
                        </li>
                    );
                })}
            </>
        );
    };

    return (
        <div>
            <div>
                <Link to="/">
                    <img
                        src="https://refine.dev/img/refine_logo.png"
                        alt="Logo"
                    />
                </Link>
                <ul>
                    {renderMenuItems(menuItems)}
                </ul>
            </div>
            <div>{children}</div>
        </div>
    );
};

import { Refine } from "@refinedev/core";
import routerProvider, { NavigateToResource } from "@refinedev/react-router-v6";
import dataProvider from "@refinedev/simple-rest";

import { BrowserRouter, Routes, Route, Outlet } from "react-router-dom";

import { Layout } from "components";

const API_URL = "https://api.fake-rest.refine.dev";

const App: React.FC = () => {
    return (
        <BrowserRouter>
            <Refine
                dataProvider={dataProvider(API_URL)}
                routerProvider={routerProvider}
                resources={[
                    {
                        name: "posts",
                        list: "/posts"
                    },
                    {
                        name: "categories",
                        list: "/categories"
                    },
                ]}
            >
                <Routes>
                    <Route
                        element={(
                            <Layout>
                                <Outlet />
                            </Layout>
                        )}
                    >
                        <Route index element={<NavigateToResource />} />
                        <Route path="/posts" element={<div>dummy posts page</div>} />
                        <Route path="/categories" element={<div>dummy categories page</div>} />
                    </Route>
                </Routes>
            </Refine>
        </BrowserRouter>
    );
};

We created <Layout> with a header with a logo and a list of links to all menu items (resources). The links are clickable and will navigate to the corresponding resource. To do this, we used the useMenu hook to get the menu items from the <Refine/> and the useRouterContext hook to get the <Link/> component from the router provider. Also useNavigation hook can be used to navigate between routes.

children is the content of the layout. In our case, it is the content of the Page components.

tip

Refer to Custom Layout guide for more detailed information on layout customization. →

After creating the <Layout/> component, we can use it in our application. We need to pass it to the <Refine/> component as a prop.

Multi Level Menus

useMenu hook comes out of the box with multi level menu support, you can render menu items recursively to get a multi level menu.

Update your resources in <Refine/> with meta.parent to nest them inside a label.

src/App.tsx

import { Refine } from "@refinedev/core";
import routerProvider, { NavigateToResource } from "@refinedev/react-router-v6";
import dataProvider from "@refinedev/simple-rest";

import { BrowserRouter, Routes, Route, Outlet } from "react-router-dom";

import { Layout } from "components/layout";

const API_URL = "https://api.fake-rest.refine.dev";

const App: React.FC = () => {
    return (
        <BrowserRouter>
            <Refine
                routerProvider={routerProvider}
                dataProvider={dataProvider(API_URL)}
                resources={[
                    {
                        name: "CMS",
                    },
                    {
                        name: "posts",
                        list: "/CMS/posts",
                        meta: { parent: "CMS" },
                    },
                    {
                        name: "categories",
                        list: "/CMS/categories",
                        meta: { parent: "CMS" },
                    },
                ]}
            >
                <Routes>
                    <Route
                        element={(
                            <Layout>
                                <Outlet />
                            </Layout>
                        )}
                    >
                        <Route index element={<NavigateToResource />} />
                        <Route path="/posts" element={<div>dummy posts page</div>} />
                        <Route path="/categories" element={<div>dummy categories page</div>} />
                    </Route>
                </Routes>
            </Refine>
        </BrowserRouter>
    );
};

export default App;

Now you can update your <Layout/> to support multi level rendering with following code:

src/components/Layout.tsx

import React from "react";
import { useMenu, LayoutProps, ITreeMenu } from "@refinedev/core";

import { Link } from "react-router-dom";

export const Layout: React.FC<LayoutProps> = ({ children }) => {
    const { menuItems, selectedKey } = useMenu();

    const renderMenuItems = (items: ITreeMenu[]) => {
        return (
            <>
                {items.map(({ name, label, icon, route, children, list }) => {
                    if (!list) {
                        return (
                            <li key={label}>
                                <span>{label ?? name}</span>
                                {children ? renderMenuItems(children) : null}
                            </li>
                        );
                    }

                    const isSelected = key === selectedKey;

                    return (
                        <li key={label}>
                            <Link
                                to={route}
                                style={{
                                    fontWeight: isSelected ? "bold" : "normal",
                                }}
                            >
                                {icon}
                                <span>{label ?? name}</span>
                            </Link>
                        </li>
                    );
                })}
            </>
        );
    };

    return (
        <div>
            <div>
                <Link to="/">
                    <img
                        src="https://refine.dev/img/refine_logo.png"
                        alt="Logo"
                    />
                </Link>
                <ul>
                    {renderMenuItems(menuItems)}
                </ul>
            </div>
            <div>{children}</div>
        </div>
    );
};

Return Values

selectedKey

Key of the resource the user is viewing at the moment.

menuItems

List of keys and routes and some metadata of resources and also the dashboard if exists.

defaultOpenKeys

Array with the keys of default opened menus.

API Reference

Return values

Property	Description	Type
selectedKey	Key of the resource the user is viewing at the moment.	string | undefined
menuItems	List of keys and routes and some metadata of resources and also the dashboard if exists.	TreeMenuItem[]
defaultOpenKeys	Array with the keys of default opened menus.	string[]

Interfaces

export type TreeMenuItem = IResourceItem & {
    key: string;
    route?: string;
    icon?: React.ReactNode;
    label?: string;
    children: TreeMenuItem[];
};

Example

VIEW SOURCE CODE →

RUN IN YOUR LOCAL

npm create refine-app@latest -- --example core-use-menu