packages/mui/src/components/buttons/list/index.tsx
import React from "react";
import { useListButton } from "@refinedev/core";
import {
RefineButtonClassNames,
RefineButtonTestIds,
} from "@refinedev/ui-types";
import Button from "@mui/material/Button";
import ListOutlined from "@mui/icons-material/ListOutlined";
import type { ListButtonProps } from "../types";
/**
* `<ListButton>` is using uses Material UI {@link https://mui.com/components/buttons/ `<Button>`} component.
* It uses the {@link https://refine.dev/docs/api-reference/core/hooks/navigation/useNavigation#list `list`} method from {@link https://refine.dev/docs/api-reference/core/hooks/navigation/useNavigation `useNavigation`} under the hood.
* It can be useful when redirecting the app to the list page route of resource}.
*
* @see {@link https://refine.dev/docs/api-reference/mui/components/buttons/list-button} for more details.
*/
export const ListButton: React.FC<ListButtonProps> = ({
resource: resourceNameFromProps,
resourceNameOrRouteName,
hideText = false,
accessControl,
svgIconProps,
meta,
children,
onClick,
...rest
}) => {
const { to, label, title, hidden, disabled, LinkComponent } = useListButton({
resource: resourceNameFromProps ?? resourceNameOrRouteName,
meta,
accessControl,
});
if (hidden) return null;
const { sx, ...restProps } = rest;
return (
<LinkComponent
to={to}
replace={false}
onClick={(e: React.MouseEvent<HTMLButtonElement, MouseEvent>) => {
if (disabled) {
e.preventDefault();
return;
}
if (onClick) {
e.preventDefault();
onClick(e);
}
}}
style={{ textDecoration: "none" }}
>
<Button
disabled={disabled}
startIcon={!hideText && <ListOutlined {...svgIconProps} />}
title={title}
sx={{ minWidth: 0, ...sx }}
data-testid={RefineButtonTestIds.ListButton}
className={RefineButtonClassNames.ListButton}
{...restProps}
>
{hideText ? (
<ListOutlined fontSize="small" {...svgIconProps} />
) : (
children ?? label
)}
</Button>
</LinkComponent>
);
};