diff --git a/docs/pages/api-docs/icon-button.md b/docs/pages/api-docs/icon-button.md index 5a63b1d6513328..01d1e5407bd450 100644 --- a/docs/pages/api-docs/icon-button.md +++ b/docs/pages/api-docs/icon-button.md @@ -73,5 +73,4 @@ You can take advantage of this behavior to [target nested components](/guides/ap - [Buttons](/components/buttons/) - [Grid List](/components/grid-list/) -- [Image List](/components/image-list/) diff --git a/docs/pages/api-docs/image-list-tile-bar.js b/docs/pages/api-docs/image-list-item-bar.js similarity index 85% rename from docs/pages/api-docs/image-list-tile-bar.js rename to docs/pages/api-docs/image-list-item-bar.js index cf3b33ee40c355..edb472fed02622 100644 --- a/docs/pages/api-docs/image-list-tile-bar.js +++ b/docs/pages/api-docs/image-list-item-bar.js @@ -2,8 +2,8 @@ import React from 'react'; import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs'; import { prepareMarkdown } from 'docs/src/modules/utils/parseMarkdown'; -const pageFilename = 'api/image-list-tile-bar'; -const requireRaw = require.context('!raw-loader!./', false, /\/image-list-tile-bar\.md$/); +const pageFilename = 'api/image-list-item-bar'; +const requireRaw = require.context('!raw-loader!./', false, /\/image-list-item-bar\.md$/); export default function Page({ docs }) { return ; diff --git a/docs/pages/api-docs/image-list-tile-bar.md b/docs/pages/api-docs/image-list-item-bar.md similarity index 74% rename from docs/pages/api-docs/image-list-tile-bar.md rename to docs/pages/api-docs/image-list-item-bar.md index 0176e1d24f606c..382ea829806faa 100644 --- a/docs/pages/api-docs/image-list-tile-bar.md +++ b/docs/pages/api-docs/image-list-item-bar.md @@ -1,19 +1,19 @@ --- -filename: /packages/material-ui/src/ImageListTileBar/ImageListTileBar.js +filename: /packages/material-ui/src/ImageListItemBar/ImageListItemBar.js --- -# ImageListTileBar API +# ImageListItemBar API -

The API documentation of the ImageListTileBar React component. Learn more about the props and the CSS customization points.

+

The API documentation of the ImageListItemBar React component. Learn more about the props and the CSS customization points.

## Import ```js -import ImageListTileBar from '@material-ui/core/ImageListTileBar'; +import ImageListItemBar from '@material-ui/core/ImageListItemBar'; // or -import { ImageListTileBar } from '@material-ui/core'; +import { ImageListItemBar } from '@material-ui/core'; ``` You can learn more about the difference by [reading this guide](/guides/minimizing-bundle-size/). @@ -22,7 +22,7 @@ You can learn more about the difference by [reading this guide](/guides/minimizi ## Component name -The `MuiImageListTileBar` name can be used for providing [default props](/customization/globals/#default-props) or [style overrides](/customization/globals/#css) at the theme level. +The `MuiImageListItemBar` name can be used for providing [default props](/customization/globals/#default-props) or [style overrides](/customization/globals/#css) at the theme level. ## Props @@ -43,17 +43,17 @@ Any other props supplied will be provided to the root element (native element). | Rule name | Global class | Description | |:-----|:-------------|:------------| -| root | .MuiImageListTileBar-root | Styles applied to the root element. -| titlePositionBottom | .MuiImageListTileBar-titlePositionBottom | Styles applied to the root element if `titlePosition="bottom"`. -| titlePositionTop | .MuiImageListTileBar-titlePositionTop | Styles applied to the root element if `titlePosition="top"`. -| rootSubtitle | .MuiImageListTileBar-rootSubtitle | Styles applied to the root element if a `subtitle` is provided. -| titleWrap | .MuiImageListTileBar-titleWrap | Styles applied to the title and subtitle container element. -| titleWrapActionPosLeft | .MuiImageListTileBar-titleWrapActionPosLeft | Styles applied to the container element if `actionPosition="left"`. -| titleWrapActionPosRight | .MuiImageListTileBar-titleWrapActionPosRight | Styles applied to the container element if `actionPosition="right"`. -| title | .MuiImageListTileBar-title | Styles applied to the title container element. -| subtitle | .MuiImageListTileBar-subtitle | Styles applied to the subtitle container element. -| actionIcon | .MuiImageListTileBar-actionIcon | Styles applied to the actionIcon if supplied. -| actionIconActionPosLeft | .MuiImageListTileBar-actionIconActionPosLeft | Styles applied to the actionIcon if `actionPosition="left"`. +| root | .MuiImageListItemBar-root | Styles applied to the root element. +| titlePositionBottom | .MuiImageListItemBar-titlePositionBottom | Styles applied to the root element if `titlePosition="bottom"`. +| titlePositionTop | .MuiImageListItemBar-titlePositionTop | Styles applied to the root element if `titlePosition="top"`. +| rootSubtitle | .MuiImageListItemBar-rootSubtitle | Styles applied to the root element if a `subtitle` is provided. +| titleWrap | .MuiImageListItemBar-titleWrap | Styles applied to the title and subtitle container element. +| titleWrapActionPosLeft | .MuiImageListItemBar-titleWrapActionPosLeft | Styles applied to the container element if `actionPosition="left"`. +| titleWrapActionPosRight | .MuiImageListItemBar-titleWrapActionPosRight | Styles applied to the container element if `actionPosition="right"`. +| title | .MuiImageListItemBar-title | Styles applied to the title container element. +| subtitle | .MuiImageListItemBar-subtitle | Styles applied to the subtitle container element. +| actionIcon | .MuiImageListItemBar-actionIcon | Styles applied to the actionIcon if supplied. +| actionIconActionPosLeft | .MuiImageListItemBar-actionIconActionPosLeft | Styles applied to the actionIcon if `actionPosition="left"`. You can override the style of the component thanks to one of these customization points: @@ -61,7 +61,7 @@ You can override the style of the component thanks to one of these customization - With a [global class name](/customization/components/#overriding-styles-with-global-class-names). - With a theme and an [`overrides` property](/customization/globals/#css). -If that's not sufficient, you can check the [implementation of the component](https://github.com/mui-org/material-ui/blob/master/packages/material-ui/src/ImageListTileBar/ImageListTileBar.js) for more detail. +If that's not sufficient, you can check the [implementation of the component](https://github.com/mui-org/material-ui/blob/master/packages/material-ui/src/ImageListItemBar/ImageListItemBar.js) for more detail. ## Demos diff --git a/docs/pages/api-docs/image-list-tile.js b/docs/pages/api-docs/image-list-item.js similarity index 87% rename from docs/pages/api-docs/image-list-tile.js rename to docs/pages/api-docs/image-list-item.js index 87e81591cb6d14..b6bf73a4e99c11 100644 --- a/docs/pages/api-docs/image-list-tile.js +++ b/docs/pages/api-docs/image-list-item.js @@ -2,8 +2,8 @@ import React from 'react'; import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs'; import { prepareMarkdown } from 'docs/src/modules/utils/parseMarkdown'; -const pageFilename = 'api/image-list-tile'; -const requireRaw = require.context('!raw-loader!./', false, /\/image-list-tile\.md$/); +const pageFilename = 'api/image-list-item'; +const requireRaw = require.context('!raw-loader!./', false, /\/image-list-item\.md$/); export default function Page({ docs }) { return ; diff --git a/docs/pages/api-docs/image-list-tile.md b/docs/pages/api-docs/image-list-item.md similarity index 74% rename from docs/pages/api-docs/image-list-tile.md rename to docs/pages/api-docs/image-list-item.md index e6e12d6de9efc1..1535b4bb9f75f9 100644 --- a/docs/pages/api-docs/image-list-tile.md +++ b/docs/pages/api-docs/image-list-item.md @@ -1,19 +1,19 @@ --- -filename: /packages/material-ui/src/ImageListTile/ImageListTile.js +filename: /packages/material-ui/src/ImageListItem/ImageListItem.js --- -# ImageListTile API +# ImageListItem API -

The API documentation of the ImageListTile React component. Learn more about the props and the CSS customization points.

+

The API documentation of the ImageListItem React component. Learn more about the props and the CSS customization points.

## Import ```js -import ImageListTile from '@material-ui/core/ImageListTile'; +import ImageListItem from '@material-ui/core/ImageListItem'; // or -import { ImageListTile } from '@material-ui/core'; +import { ImageListItem } from '@material-ui/core'; ``` You can learn more about the difference by [reading this guide](/guides/minimizing-bundle-size/). @@ -22,7 +22,7 @@ You can learn more about the difference by [reading this guide](/guides/minimizi ## Component name -The `MuiImageListTile` name can be used for providing [default props](/customization/globals/#default-props) or [style overrides](/customization/globals/#css) at the theme level. +The `MuiImageListItem` name can be used for providing [default props](/customization/globals/#default-props) or [style overrides](/customization/globals/#css) at the theme level. ## Props @@ -39,10 +39,10 @@ Any other props supplied will be provided to the root element (native element). | Rule name | Global class | Description | |:-----|:-------------|:------------| -| root | .MuiImageListTile-root | Styles applied to the root element. -| tile | .MuiImageListTile-tile | Styles applied to the `div` element that wraps the children. -| imgFullHeight | .MuiImageListTile-imgFullHeight | Styles applied to an `img` element child, if needed to ensure it covers the tile. -| imgFullWidth | .MuiImageListTile-imgFullWidth | Styles applied to an `img` element child, if needed to ensure it covers the tile. +| root | .MuiImageListItem-root | Styles applied to the root element. +| tile | .MuiImageListItem-tile | Styles applied to the `div` element that wraps the children. +| imgFullHeight | .MuiImageListItem-imgFullHeight | Styles applied to an `img` element child, if needed to ensure it covers the tile. +| imgFullWidth | .MuiImageListItem-imgFullWidth | Styles applied to an `img` element child, if needed to ensure it covers the tile. You can override the style of the component thanks to one of these customization points: @@ -50,7 +50,7 @@ You can override the style of the component thanks to one of these customization - With a [global class name](/customization/components/#overriding-styles-with-global-class-names). - With a theme and an [`overrides` property](/customization/globals/#css). -If that's not sufficient, you can check the [implementation of the component](https://github.com/mui-org/material-ui/blob/master/packages/material-ui/src/ImageListTile/ImageListTile.js) for more detail. +If that's not sufficient, you can check the [implementation of the component](https://github.com/mui-org/material-ui/blob/master/packages/material-ui/src/ImageListItem/ImageListItem.js) for more detail. ## Demos diff --git a/docs/pages/api-docs/list-subheader.md b/docs/pages/api-docs/list-subheader.md index 3422c7c9bdc55d..1e174241c8682d 100644 --- a/docs/pages/api-docs/list-subheader.md +++ b/docs/pages/api-docs/list-subheader.md @@ -62,6 +62,5 @@ If that's not sufficient, you can check the [implementation of the component](ht ## Demos - [Grid List](/components/grid-list/) -- [Image List](/components/image-list/) - [Lists](/components/lists/) diff --git a/docs/src/pages/components/cards/cards.md b/docs/src/pages/components/cards/cards.md index 6377dbe052caf3..ee050a6c6754c3 100644 --- a/docs/src/pages/components/cards/cards.md +++ b/docs/src/pages/components/cards/cards.md @@ -25,7 +25,7 @@ Set `variant="outlined"` to render an outlined card. ## Complex Interaction -On desktop, card content can expand. +On desktop, card content can expand. (Click the downward chevron to view the recipe.) {{"demo": "pages/components/cards/RecipeReviewCard.js", "bg": true}} diff --git a/docs/src/pages/components/image-list/AdvancedImageList.js b/docs/src/pages/components/image-list/AdvancedImageList.js index 5225564b6b9d7e..0c12cf2ff95729 100644 --- a/docs/src/pages/components/image-list/AdvancedImageList.js +++ b/docs/src/pages/components/image-list/AdvancedImageList.js @@ -1,8 +1,8 @@ import React from 'react'; import { makeStyles } from '@material-ui/core/styles'; import ImageList from '@material-ui/core/ImageList'; -import ImageListTile from '@material-ui/core/ImageListTile'; -import ImageListTileBar from '@material-ui/core/ImageListTileBar'; +import ImageListItem from '@material-ui/core/ImageListItem'; +import ImageListItemBar from '@material-ui/core/ImageListItemBar'; import IconButton from '@material-ui/core/IconButton'; import StarBorderIcon from '@material-ui/icons/StarBorder'; import tileData from './tileData'; @@ -56,9 +56,9 @@ export default function AdvancedImageList() {
{tileData.map((tile) => ( - + {tile.title} - - + ))}
diff --git a/docs/src/pages/components/image-list/AdvancedImageList.tsx b/docs/src/pages/components/image-list/AdvancedImageList.tsx index 3e82f56b6f01e3..eeb79a30ca48ea 100644 --- a/docs/src/pages/components/image-list/AdvancedImageList.tsx +++ b/docs/src/pages/components/image-list/AdvancedImageList.tsx @@ -1,8 +1,8 @@ import React from 'react'; import { createStyles, Theme, makeStyles } from '@material-ui/core/styles'; import ImageList from '@material-ui/core/ImageList'; -import ImageListTile from '@material-ui/core/ImageListTile'; -import ImageListTileBar from '@material-ui/core/ImageListTileBar'; +import ImageListItem from '@material-ui/core/ImageListItem'; +import ImageListItemBar from '@material-ui/core/ImageListItemBar'; import IconButton from '@material-ui/core/IconButton'; import StarBorderIcon from '@material-ui/icons/StarBorder'; import tileData from './tileData'; @@ -58,9 +58,9 @@ export default function AdvancedImageList() {
{tileData.map((tile) => ( - + {tile.title} - - + ))}
diff --git a/docs/src/pages/components/image-list/BasicImageList.js b/docs/src/pages/components/image-list/BasicImageList.js index f7ef16a3741024..6264e61a23ee7b 100644 --- a/docs/src/pages/components/image-list/BasicImageList.js +++ b/docs/src/pages/components/image-list/BasicImageList.js @@ -1,7 +1,7 @@ import React from 'react'; import { makeStyles } from '@material-ui/core/styles'; import ImageList from '@material-ui/core/ImageList'; -import ImageListTile from '@material-ui/core/ImageListTile'; +import ImageListItem from '@material-ui/core/ImageListItem'; import tileData from './tileData'; const useStyles = makeStyles((theme) => ({ @@ -43,9 +43,9 @@ export default function BasicImageList() {
{tileData.map((tile) => ( - + {tile.title} - + ))}
diff --git a/docs/src/pages/components/image-list/BasicImageList.tsx b/docs/src/pages/components/image-list/BasicImageList.tsx index f2b382df5655df..aebd7c507cc831 100644 --- a/docs/src/pages/components/image-list/BasicImageList.tsx +++ b/docs/src/pages/components/image-list/BasicImageList.tsx @@ -1,7 +1,7 @@ import React from 'react'; import { Theme, createStyles, makeStyles } from '@material-ui/core/styles'; import ImageList from '@material-ui/core/ImageList'; -import ImageListTile from '@material-ui/core/ImageListTile'; +import ImageListItem from '@material-ui/core/ImageListItem'; import tileData from './tileData'; const useStyles = makeStyles((theme: Theme) => @@ -45,9 +45,9 @@ export default function BasicImageList() {
{tileData.map((tile) => ( - + {tile.title} - + ))}
diff --git a/docs/src/pages/components/image-list/SingleLineImageList.js b/docs/src/pages/components/image-list/SingleLineImageList.js index 5f0640dc5d4c13..b61c0ede845d75 100644 --- a/docs/src/pages/components/image-list/SingleLineImageList.js +++ b/docs/src/pages/components/image-list/SingleLineImageList.js @@ -1,8 +1,8 @@ import React from 'react'; import { makeStyles } from '@material-ui/core/styles'; import ImageList from '@material-ui/core/ImageList'; -import ImageListTile from '@material-ui/core/ImageListTile'; -import ImageListTileBar from '@material-ui/core/ImageListTileBar'; +import ImageListItem from '@material-ui/core/ImageListItem'; +import ImageListItemBar from '@material-ui/core/ImageListItemBar'; import IconButton from '@material-ui/core/IconButton'; import StarBorderIcon from '@material-ui/icons/StarBorder'; import tileData from './tileData'; @@ -53,9 +53,9 @@ export default function SingleLineImageList() {
{tileData.map((tile) => ( - + {tile.title} - } /> - + ))}
diff --git a/docs/src/pages/components/image-list/SingleLineImageList.tsx b/docs/src/pages/components/image-list/SingleLineImageList.tsx index b7a208fea8b9eb..259e44b5e6d176 100644 --- a/docs/src/pages/components/image-list/SingleLineImageList.tsx +++ b/docs/src/pages/components/image-list/SingleLineImageList.tsx @@ -1,8 +1,8 @@ import React from 'react'; import { Theme, createStyles, makeStyles } from '@material-ui/core/styles'; import ImageList from '@material-ui/core/ImageList'; -import ImageListTile from '@material-ui/core/ImageListTile'; -import ImageListTileBar from '@material-ui/core/ImageListTileBar'; +import ImageListItem from '@material-ui/core/ImageListItem'; +import ImageListItemBar from '@material-ui/core/ImageListItemBar'; import IconButton from '@material-ui/core/IconButton'; import StarBorderIcon from '@material-ui/icons/StarBorder'; import tileData from './tileData'; @@ -55,9 +55,9 @@ export default function SingleLineImageList() {
{tileData.map((tile) => ( - + {tile.title} - } /> - + ))}
diff --git a/docs/src/pages/components/image-list/TitlebarImageList.js b/docs/src/pages/components/image-list/TitlebarImageList.js index b675a512c6ef6a..2b9a8f0b4ee609 100644 --- a/docs/src/pages/components/image-list/TitlebarImageList.js +++ b/docs/src/pages/components/image-list/TitlebarImageList.js @@ -1,8 +1,8 @@ import React from 'react'; import { makeStyles } from '@material-ui/core/styles'; import ImageList from '@material-ui/core/ImageList'; -import ImageListTile from '@material-ui/core/ImageListTile'; -import ImageListTileBar from '@material-ui/core/ImageListTileBar'; +import ImageListItem from '@material-ui/core/ImageListItem'; +import ImageListItemBar from '@material-ui/core/ImageListItemBar'; import ListSubheader from '@material-ui/core/ListSubheader'; import IconButton from '@material-ui/core/IconButton'; import InfoIcon from '@material-ui/icons/Info'; @@ -48,13 +48,13 @@ export default function TitlebarImageList() { return (
- + December - + {tileData.map((tile) => ( - + {tile.title} - by: {tile.author}} actionIcon={ @@ -63,7 +63,7 @@ export default function TitlebarImageList() { } /> - + ))}
diff --git a/docs/src/pages/components/image-list/TitlebarImageList.tsx b/docs/src/pages/components/image-list/TitlebarImageList.tsx index a6db3fcede891e..6d0c5cba1cf71b 100644 --- a/docs/src/pages/components/image-list/TitlebarImageList.tsx +++ b/docs/src/pages/components/image-list/TitlebarImageList.tsx @@ -1,8 +1,8 @@ import React from 'react'; import { Theme, createStyles, makeStyles } from '@material-ui/core/styles'; import ImageList from '@material-ui/core/ImageList'; -import ImageListTile from '@material-ui/core/ImageListTile'; -import ImageListTileBar from '@material-ui/core/ImageListTileBar'; +import ImageListItem from '@material-ui/core/ImageListItem'; +import ImageListItemBar from '@material-ui/core/ImageListItemBar'; import ListSubheader from '@material-ui/core/ListSubheader'; import IconButton from '@material-ui/core/IconButton'; import InfoIcon from '@material-ui/icons/Info'; @@ -50,13 +50,13 @@ export default function TitlebarImageList() { return (
- + December - + {tileData.map((tile) => ( - + {tile.title} - by: {tile.author}} actionIcon={ @@ -65,7 +65,7 @@ export default function TitlebarImageList() { } /> - + ))}
diff --git a/docs/src/pages/components/image-list/image-list-de.md b/docs/src/pages/components/image-list/image-list-de.md index 86d9a57be4e64e..666e8650a06b06 100644 --- a/docs/src/pages/components/image-list/image-list-de.md +++ b/docs/src/pages/components/image-list/image-list-de.md @@ -1,6 +1,6 @@ --- title: Grid List React Komponente -components: ImageList, ImageListTile, ImageListTileBar, ListSubheader, IconButton +components: ImageList, ImageListItem, ImageListItemBar, ListSubheader, IconButton --- # Rasterliste (Grid List) @@ -17,7 +17,7 @@ Ein einfaches Beispiel für ein scrollbare `RasterList` mit Bildern. ## Rasterliste mit Titelleisten -In diesem Beispiel wird die Verwendung der `ImageListTileBar` veranschaulicht, um jeweils eine Überlagerung zu jedem `ImageListTile`hinzuzufügen. Die Überlagerung kann einen `title`, `subtitle` und eine sekundäre Aktion aufnehmen - in diesem Beispiel ein `IconButton`. +In diesem Beispiel wird die Verwendung der `ImageListItemBar` veranschaulicht, um jeweils eine Überlagerung zu jedem `ImageListItem`hinzuzufügen. Die Überlagerung kann einen `title`, `subtitle` und eine sekundäre Aktion aufnehmen - in diesem Beispiel ein `IconButton`. {{"demo": "pages/components/image-list/TitlebarImageList.js", "hideEditButton": true}} diff --git a/docs/src/pages/components/image-list/image-list-es.md b/docs/src/pages/components/image-list/image-list-es.md index efe2485f488393..b9c063b2eed5f6 100644 --- a/docs/src/pages/components/image-list/image-list-es.md +++ b/docs/src/pages/components/image-list/image-list-es.md @@ -1,6 +1,6 @@ --- title: Componente React para Lista cuadriculada -components: ImageList, ImageListTile, ImageListTileBar, ListSubheader, IconButton +components: ImageList, ImageListItem, ImageListItemBar, ListSubheader, IconButton --- # Lista cuadriculada @@ -17,7 +17,7 @@ Un ejemplo simple de una lista cuadriculada (`ImageList`) con imágenes desplaza ## Lista cuadriculada con barras de título -Este ejemplo demuestra el uso de una barra para cuadro de lista cuadriculada (`ImageListTileBar`) que agrega una capa sobrepuesta a cada cuadro en una lista cuadriculada (`ImageListTile`). La capa sobrepuesta puede acomodar un título (`title`), subtítulo (`subtitle`), y acción secundaria (en este ejemplo un `IconButton`). +Este ejemplo demuestra el uso de una barra para cuadro de lista cuadriculada (`ImageListItemBar`) que agrega una capa sobrepuesta a cada cuadro en una lista cuadriculada (`ImageListItem`). La capa sobrepuesta puede acomodar un título (`title`), subtítulo (`subtitle`), y acción secundaria (en este ejemplo un `IconButton`). {{"demo": "pages/components/image-list/TitlebarImageList.js", "hideEditButton": true}} diff --git a/docs/src/pages/components/image-list/image-list-fr.md b/docs/src/pages/components/image-list/image-list-fr.md index ee0eb86516004b..cb0d8befc9d9e4 100644 --- a/docs/src/pages/components/image-list/image-list-fr.md +++ b/docs/src/pages/components/image-list/image-list-fr.md @@ -1,6 +1,6 @@ --- title: Composant React Grid List -components: ImageList, ImageListTile, ImageListTileBar, ListSubheader, IconButton +components: ImageList, ImageListItem, ImageListItemBar, ListSubheader, IconButton --- # Grid list @@ -17,7 +17,7 @@ Un exemple simple d'image défilable `ImageList`. ## Grid list avec barres de titre -Cet exemple illustre l'utilisation de `ImageListTileBar` pour ajouter une superposition à chaque `ImageListTile`. La superposition peut accueillir un `titre`, `sous - titre` et une action secondaire - dans cet exemple un `IconButton`. +Cet exemple illustre l'utilisation de `ImageListItemBar` pour ajouter une superposition à chaque `ImageListItem`. La superposition peut accueillir un `titre`, `sous - titre` et une action secondaire - dans cet exemple un `IconButton`. {{"demo": "pages/components/image-list/TitlebarImageList.js", "hideEditButton": true}} diff --git a/docs/src/pages/components/image-list/image-list-ja.md b/docs/src/pages/components/image-list/image-list-ja.md index 83474bd42f2321..7decf95449aa47 100644 --- a/docs/src/pages/components/image-list/image-list-ja.md +++ b/docs/src/pages/components/image-list/image-list-ja.md @@ -1,6 +1,6 @@ --- title: Grid List React component -components: ImageList, ImageListTile, ImageListTileBar, ListSubheader, IconButton +components: ImageList, ImageListItem, ImageListItemBar, ListSubheader, IconButton --- # Grid List @@ -17,7 +17,7 @@ components: ImageList, ImageListTile, ImageListTileBar, ListSubheader, IconButto ## タイトルバー付きのGrid list -この例は、 `ImageListTileBar` を使用して、各 `ImageListTile`オーバーレイを追加する方法を示しています。 オーバーレイには、 `title`, `subtitle` および副次的アクション例えば`IconButton`を含めることができます。 +この例は、 `ImageListItemBar` を使用して、各 `ImageListItem`オーバーレイを追加する方法を示しています。 オーバーレイには、 `title`, `subtitle` および副次的アクション例えば`IconButton`を含めることができます。 {{"demo": "pages/components/image-list/TitlebarImageList.js", "hideEditButton": true}} diff --git a/docs/src/pages/components/image-list/image-list-pt.md b/docs/src/pages/components/image-list/image-list-pt.md index 56ac37297109f2..c462efcdfea529 100644 --- a/docs/src/pages/components/image-list/image-list-pt.md +++ b/docs/src/pages/components/image-list/image-list-pt.md @@ -1,6 +1,6 @@ --- title: Componente React para Lista de Grade -components: ImageList, ImageListTile, ImageListTileBar, ListSubheader, IconButton +components: ImageList, ImageListItem, ImageListItemBar, ListSubheader, IconButton --- # Lista de Grade @@ -17,7 +17,7 @@ Um exemplo simples de uma `ImageList` com imagens. ## Lista de grade com barras de título -Este exemplo demonstra o uso do `ImageListTileBar` para adicionar uma sobreposição a cada `ImageListTile`. A sobreposição pode acomodar um `title`, `subtitle` e ação secundária - neste exemplo utilizamos um `IconButton`. +Este exemplo demonstra o uso do `ImageListItemBar` para adicionar uma sobreposição a cada `ImageListItem`. A sobreposição pode acomodar um `title`, `subtitle` e ação secundária - neste exemplo utilizamos um `IconButton`. {{"demo": "pages/components/image-list/TitlebarImageList.js", "hideEditButton": true}} diff --git a/docs/src/pages/components/image-list/image-list-ru.md b/docs/src/pages/components/image-list/image-list-ru.md index 218cd94fd080ce..92e365577b43b8 100644 --- a/docs/src/pages/components/image-list/image-list-ru.md +++ b/docs/src/pages/components/image-list/image-list-ru.md @@ -1,6 +1,6 @@ --- title: Сеть изображений, компонент React -components: ImageList, ImageListTile, ImageListTileBar, ListSubheader, IconButton +components: ImageList, ImageListItem, ImageListItemBar, ListSubheader, IconButton --- # Сеть изображений diff --git a/docs/src/pages/components/image-list/image-list-zh.md b/docs/src/pages/components/image-list/image-list-zh.md index c615a6cd9fbe65..82fb813bbcb8b8 100644 --- a/docs/src/pages/components/image-list/image-list-zh.md +++ b/docs/src/pages/components/image-list/image-list-zh.md @@ -1,6 +1,6 @@ --- title: React Grid List 网格列表组件 -components: ImageList, ImageListTile, ImageListTileBar, ListSubheader, IconButton +components: ImageList, ImageListItem, ImageListItemBar, ListSubheader, IconButton --- # Grid List 网格列表 @@ -17,7 +17,7 @@ components: ImageList, ImageListTile, ImageListTileBar, ListSubheader, IconButto ## 带有标题栏的网格列表 -此示例演示如何使用 `ImageListTileBar` 为每个 `ImageListTile` 添加一个叠加层。 叠加层可以容纳 `title`, `subtitle` 和辅助操作—在本例中为 `IconButton`。 +此示例演示如何使用 `ImageListItemBar` 为每个 `ImageListItem` 添加一个叠加层。 叠加层可以容纳 `title`, `subtitle` 和辅助操作—在本例中为 `IconButton`。 {{"demo": "pages/components/image-list/TitlebarImageList.js", "hideEditButton": true}} diff --git a/docs/src/pages/components/image-list/image-list.md b/docs/src/pages/components/image-list/image-list.md index fa389daa84dc06..05d4ba928f47fd 100644 --- a/docs/src/pages/components/image-list/image-list.md +++ b/docs/src/pages/components/image-list/image-list.md @@ -1,6 +1,6 @@ --- title: Image list React component -components: ImageList, ImageListTile, ImageListTileBar, ListSubheader, IconButton +components: ImageList, ImageListItem, ImageListItemBar --- # Image list @@ -17,7 +17,7 @@ A simple example of a scrollable image `ImageList`. ## Image list with titlebars -This example demonstrates the use of the `ImageListTileBar` to add an overlay to each `ImageListTile`. +This example demonstrates the use of the `ImageListItemBar` to add an overlay to each `ImageListItem`. The overlay can accommodate a `title`, `subtitle` and secondary action - in this example an `IconButton`. {{"demo": "pages/components/image-list/TitlebarImageList.js", "hideEditButton": true}} diff --git a/docs/src/pages/guides/migration-v4/migration-v4.md b/docs/src/pages/guides/migration-v4/migration-v4.md new file mode 100644 index 00000000000000..0ecc6ff38cbd71 --- /dev/null +++ b/docs/src/pages/guides/migration-v4/migration-v4.md @@ -0,0 +1,568 @@ +# Migration from v4 to v5 + +

Yeah, v5 has been released!

+ +Looking for the v4 docs? [Find them here](https://material-ui.com/versions/). + +> This document is a work in progress. +> Have you upgraded your site and run into something that's not covered here? +> [Add your changes on GitHub](https://github.com/mui-org/material-ui/blob/next/docs/src/pages/guides/migration-v4/migration-v4.md). + +## Introduction + +This is a reference for upgrading your site from Material-UI v4 to v5. +While there's a lot covered here, you probably won't need to do everything for your site. +We'll do our best to keep things easy to follow, and as sequential as possible so you can quickly get rocking on v5! + +## Why you should migrate + +This documentation page covers the _how_ of migrating from v4 to v5. +The _why_ is covered in the [release blog post on Medium](https://medium.com/material-ui/material-ui-v4-is-out-4b7587d1e701). + +## Updating your dependencies + +The very first thing you will need to do is to update your dependencies. + +### Update Material-UI version + +You need to update your `package.json` to use the latest version of Material-UI. + +```json +"dependencies": { + "@material-ui/core": "^5.0.0-alpha.1" +} +``` + +Or run + +```sh +npm install @material-ui/core@next + +or + +yarn add @material-ui/core@next +``` + +## Handling breaking changes + +### non-ref-forwarding class components + +Support for non-ref-forwarding class components in the `component` prop or as an immediate `children` has been dropped. If you were using `unstable_createStrictModeTheme` or didn't see any warnings related to `findDOMNode` in `React.StrictMode` then you don't need to do anything. +Otherwise check out the ["Caveat with refs" section in our composition guide](/guides/composition/#caveat-with-refs) to find out how to migrate. +This change affects almost all components where you're using the `component` prop or passing `children` to components that require `children` to be elements (e.g. ``) + +### Theme + +- The "gutters" abstraction hasn't proven to be used frequently enough to be valuable. + + ```diff + -theme.mixins.gutters(), + +paddingLeft: theme.spacing(2), + +paddingRight: theme.spacing(2), + +[theme.breakpoints.up('sm')]: { + + paddingLeft: theme.spacing(3), + + paddingRight: theme.spacing(3), + +}, + ``` + +- The components' definition inside the theme were restructure under the `components` key, to allow people easier discoverability about the definitions regarding one component. + +1. `props` + +```diff +import { createMuiTheme } from '@material-ui/core/styles'; + +const theme = createMuitheme({ +- props: { +- MuiButton: { +- disableRipple: true, +- }, +- }, ++ components: { ++ MuiButton: { ++ props: { ++ disableRipple: true, ++ }, ++ }, ++ }, +}); +``` + +2. `overrides` + +```diff +import { createMuiTheme } from '@material-ui/core/styles'; + +const theme = createMuitheme({ +- overrides: { +- MuiButton: { +- root: { padding: 0 }, +- }, +- }, ++ components: { ++ MuiButton: { ++ overrides: { ++ root: { padding: 0 }, ++ }, ++ }, ++ }, +}); +``` + +For a smoother transition, the `adaptV4Theme` helper allows you to iteratively upgrade to the new theme structure. Note that it will display a deprecation warning in the console, since it will be removed at the next major release. + +```diff +-import { createMuiTheme } from '@material-ui/core/styles'; ++import { createMuiTheme, adaptV4Theme } from '@material-ui/core/styles'; + +-const theme = createMuitheme({ ++const theme = createMuitheme(adaptV4Theme({ + props: { + MuiButton: { + disableRipple: true, + }, + }, + overrides: { + MuiButton: { + root: { padding: 0 }, + }, + }, +-}); ++})); +``` + +### Avatar + +- Rename `circle` to `circular` for consistency. The possible values should be adjectives, not nouns: + + ```diff + - + - + + + + + ``` + +### Badge + +- Rename `circle` to `circular` and `rectangle` to `rectangular` for consistency. The possible values should be adjectives, not nouns: + + ```diff + - + - + + + + + + ``` + +### BottomNavigation + +- TypeScript: The `event` in `onChange` is no longer typed as a `React.ChangeEvent` but `React.SyntheticEvent`. + + ```diff + -) => {}} /> + + {}} /> + ``` + +### Button + +- The button `color` prop is now "primary" by default, and "default" has been removed. This makes the button closer to the Material Design specification and simplifies the API. + + ```diff + - + + - + + + - + + + ``` + +- TypeScript: The `event` in `onChange` is no longer typed as a `React.ChangeEvent` but `React.SyntheticEvent`. + + ```diff + -, expanded: boolean) => {}} /> + + {}} /> + ``` + +### Fab + +- Rename `round` to `circular` for consistency. The possible values should be adjectives, not nouns: + + ```diff + - + + + ``` + +### Grid + +- Rename `justify` prop with `justifyContent` to be aligned with the CSS property name. + + ```diff + - + + + ``` + +### GridList + +- Rename the `GridList` components to `ImageList` to align with the current Material Design naming. + +```diff +-import GridList from '@material-ui/core/GridList'; +-import GridListTile from '@material-ui/core/GridListTile'; +-import GridListTileBar from '@material-ui/core/GridListTileBar'; ++import ImageList from '@material-ui/core/ImageList'; ++import ImageListItem from '@material-ui/core/ImageListItem'; ++import ImageListItemBar from '@material-ui/core/ImageListItemBar'; + +- +- ++ ++ + Image title +- +- +- ++ ++ +``` + +### Menu + +- The onE\* transition props were removed. Use TransitionProps instead. + + ```diff + + ``` + +### Pagination + +- Rename `round` to `circular` for consistency. The possible values should be adjectives, not nouns: + + ```diff + - + + + ``` + +### PaginationItem + +- Rename `round` to `circular` for consistency. The possible values should be adjectives, not nouns: + + ```diff + - + + + ``` + + ### Popover + +- The onE\* transition props were removed. Use TransitionProps instead. + + ```diff + + ``` + +### Rating + +- Rename `visuallyhidden` to `visuallyHidden` for consistency: + + ```diff + + ``` + +### RootRef + +- This component was removed. + You can get a reference to the underlying DOM node of our components via `ref` prop. + The component relied on [`ReactDOM.findDOMNode`](https://reactjs.org/docs/react-dom.html#finddomnode) which is [deprecated in `React.StrictMode`](https://reactjs.org/docs/strict-mode.html#warning-about-deprecated-finddomnode-usage). + + ```diff + - + -