ListNoResults

Default placeholder rendered by <List> when filters yield zero results.

Installation

pnpm dlx shadcn@latest add @shadmin/list-no-results

Usage

<ListNoResults> reads from the current <ListContext> to detect whether filters are active. When they are, it shows a "Clear filters" link that resets the filter values to an empty object:

import { List, ListNoResults } from "@/components/admin";
 
export const PostList = () => (
  <List empty={<ListNoResults />}>{/* ... */}</List>
);

When no filters are active, <ListNoResults> falls back to a simple translated message ("No results found.").

Props

PropRequiredTypeDefaultDescription
resourceOptionalstringFrom contextOverride the resource name
filterValuesOptionalobjectFrom ListContextOverride the active filter values
setFiltersOptionalfunctionFrom ListContextOverride the function used to reset filters
classNameOptionalstringExtra Tailwind classes appended to the root element

Translation Messages

<ListNoResults> uses the following translation keys:

  • ra.navigation.no_filtered_results (interpolated with name / resource)
  • ra.navigation.no_results (interpolated with name / resource)
  • ra.navigation.clear_filters
const messages = {
  ra: {
    navigation: {
      no_filtered_results: "No posts match the current filters.",
      no_results: "No posts found.",
      clear_filters: "Reset filters",
    },
  },
};