[DataGridPro] Add list view tests

packages/x-data-grid-pro/src/tests/listView.DataGridPro.test.tsx

@@ -0,0 +1,98 @@
+import * as React from 'react';
+import { expect } from 'chai';
+import { createRenderer, screen } from '@mui/internal-test-utils';
+import {
+  DataGridPro,
+  DataGridProProps,
+  GridColDef,
+  GridListColDef,
+  GridRowsProp,
+} from '@mui/x-data-grid-pro';
+
+const rows: GridRowsProp = [{ id: '123567', title: 'test' }];
+
+const columns: GridColDef[] = [{ field: 'id' }, { field: 'title' }];
+
+const listColumn: GridListColDef = {
+  field: 'listColumn',
+  renderCell: (params) => <div data-testid="list-column">Title: {params.row.title}</div>,
+};
+
+describe('<DataGridPro /> - List view', () => {
+  const { render } = createRenderer();
+
+  function Test(props: Partial<DataGridProProps>) {
+    return (
+      <div style={{ width: 300, height: 300 }}>
+        <DataGridPro columns={columns} rows={rows} {...props} />
+      </div>
+    );
+  }
+
+  it('should not render list column when list view is not enabled', () => {
+    render(
+      <div style={{ width: 300, height: 300 }}>
+        <DataGridPro columns={columns} rows={rows} unstable_listColumn={listColumn} />
+      </div>,
+    );
+    expect(screen.queryByTestId('list-column')).to.equal(null);
+  });
+
+  it('should render list column when list view is enabled', () => {
+    render(
+      <div style={{ width: 300, height: 300 }}>
+        <DataGridPro
+          columns={columns}
+          rows={rows}
+          unstable_listView
+          unstable_listColumn={listColumn}
+        />
+      </div>,
+    );
+    expect(screen.getByTestId('list-column')).not.to.equal(null);
+    expect(screen.getByTestId('list-column')).to.have.text('Title: test');
+  });
+
+  it('should render list column when `unstable_listView` prop updates', () => {
+    const { setProps } = render(<Test unstable_listColumn={listColumn} />);
+    expect(screen.queryByTestId('list-column')).to.equal(null);
+
+    setProps({ unstable_listView: true });
+
+    expect(screen.getByTestId('list-column')).not.to.equal(null);
+    expect(screen.getByTestId('list-column')).to.have.text('Title: test');
+
+    setProps({ unstable_listView: false });
+
+    expect(screen.queryByTestId('list-column')).to.equal(null);
+  });
+
+  it('should update cell contents when the `renderCell` function changes', () => {
+    const { setProps } = render(<Test unstable_listView unstable_listColumn={listColumn} />);
+
+    setProps({
+      unstable_listColumn: {
+        ...listColumn,
+        renderCell: (params) => <div data-testid="list-column">ID: {params.row.id}</div>,
+      },
+    } as Partial<DataGridProProps>);
+
+    expect(screen.getByTestId('list-column')).to.have.text('ID: 123567');
+  });
+
+  it('should warn if the `unstable_listColumn` prop is not provided when `unstable_listView` is enabled', () => {
+    expect(() => {
+      render(
+        <div style={{ width: 300, height: 300 }}>
+          <DataGridPro columns={columns} rows={rows} unstable_listView />
+        </div>,
+      );
+    }).toWarnDev(
+      [
+        'MUI X: The `unstable_listColumn` prop must be set if `unstable_listView` is enabled.',
+        'To fix, pass a column definition to the `unstable_listColumn` prop, e.g. `{ field: "example", renderCell: (params) => <div>{params.row.id}</div> }`.',
+        'For more details, see https://mui.com/x/react-data-grid/list-view/',
+      ].join('\n'),
+    );
+  });
+});

packages/x-data-grid/src/hooks/features/listView/useGridListView.tsx

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import { warnOnce } from '@mui/x-internals/warning';
 import type { GridListColDef } from '../../../models/colDef/gridColDef';
 import { GridStateInitializer } from '../../utils/useGridInitializeState';
 import { GridPrivateApiCommunity } from '../../../models/api/gridApiCommunity';
@@ -13,12 +14,14 @@ export const listViewStateInitializer: GridStateInitializer<
   Pick<DataGridProcessedProps, 'unstable_listColumn'>
 > = (state, props, apiRef) => ({
   ...state,
-  listViewColumn: { ...props.unstable_listColumn, computedWidth: getListColumnWidth(apiRef) },
+  listViewColumn: props.unstable_listColumn
+    ? { ...props.unstable_listColumn, computedWidth: getListColumnWidth(apiRef) }
+    : undefined,
 });
 
 export function useGridListView(
   apiRef: React.MutableRefObject<GridPrivateApiCommunity>,
-  props: Pick<DataGridProcessedProps, 'unstable_listColumn'>,
+  props: Pick<DataGridProcessedProps, 'unstable_listView' | 'unstable_listColumn'>,
 ) {
   /*
    * EVENTS
@@ -68,6 +71,16 @@ export function useGridListView(
       });
     }
   }, [apiRef, props.unstable_listColumn]);
+
+  React.useEffect(() => {
+    if (props.unstable_listView && !props.unstable_listColumn) {
+      warnOnce([
+        'MUI X: The `unstable_listColumn` prop must be set if `unstable_listView` is enabled.',
+        'To fix, pass a column definition to the `unstable_listColumn` prop, e.g. `{ field: "example", renderCell: (params) => <div>{params.row.id}</div> }`.',
+        'For more details, see https://mui.com/x/react-data-grid/list-view/',
+      ]);
+    }
+  }, [props.unstable_listView, props.unstable_listColumn]);
 }
 
 function getListColumnWidth(apiRef: React.MutableRefObject<GridPrivateApiCommunity>) {