Grid lists are an alternative to standard list views. Note that as of Material Components Web 6.0.0, this component is deprecated.
- Module @rmwc/grid-list
- Import styles:
- Using CSS Loader
- import '@rmwc/grid-list/styles';
- Or include stylesheets
- '@material/grid-list/dist/mdc.grid-list.css'
- Using CSS Loader
- MDC Docs: https://material.io/components/web/catalog/grid-lists/
function Example() {
const [state, setState] = React.useState({
tileGutter1: false,
headerCaption: false,
twolineCaption: false,
withIconAlignStart: false,
tileAspect: '1x1'
});
return (
<>
<GridList
tileGutter1={state.tileGutter1}
headerCaption={state.headerCaption}
twolineCaption={state.twolineCaption}
withIconAlignStart={state.withIconAlignStart}
tileAspect={state.tileAspect}
>
{Array(8)
.fill(undefined)
.map((val, i) => (
<GridTile key={i}>
<GridTilePrimary>
<GridTilePrimaryContent
src="images/backgrounds/mb-bg-fb-06.png"
alt="test"
/>
</GridTilePrimary>
<GridTileSecondary>
<GridTileIcon icon="info" />
<GridTileTitle>Tile {i + 1}</GridTileTitle>
</GridTileSecondary>
</GridTile>
))}
</GridList>
{[
'tileGutter1',
'headerCaption',
'twoLineCaption',
'withIconAlignStart'
].map((key) => (
<Checkbox
key={key}
label={key}
onChange={(evt) =>
setState({ ...state, [key]: evt.currentTarget.checked })
}
/>
))}
<Select
value={state.tileAspect}
onChange={(evt) =>
setState({
...state,
tileAspect: String(evt.currentTarget.value)
})
}
label="tileAspect"
options={['1x1', '16x9', '2x3', '3x2', '4x3', '3x4']}
/>
</>
);
}
Grid List Component
Name | Type | Description |
---|---|---|
headerCaption |
boolean |
Move the caption to the top of the card. |
tileAspect |
"1x1" | "16x9" | "2x3" | "3x2" | "4x3" | "3x4" |
One of the following values: 1x1, 16x9, 2x3, 3x2, 4x3, 3x4. |
tileGutter1 |
boolean |
Use a 1px gutter. |
twolineCaption |
boolean |
Make the caption two lines. |
withIconAlignStart |
boolean |
Leaves space for a start aligned icon. |
A grid tile
The icon for a Grid tile. This is an instance of Icon component.
Name | Type | Description |
---|---|---|
icon |
IconPropT |
The icon to use. This can be a string for a font icon, a url, or whatever the selected strategy needs. |
The primary content for a Grid tile
The secondary content for a Grid tile
Supporting Text for the Grid Tile
The title for a Grid tile