From 34733ff69b094e344a47b7488173298af81bb0f1 Mon Sep 17 00:00:00 2001 From: Matthew Brookes Date: Sun, 16 Feb 2020 12:22:35 +0000 Subject: [PATCH] [docs] Update the translations --- docs/src/modules/components/backers-de.md | 6 +- docs/src/modules/components/backers-es.md | 10 +- docs/src/modules/components/backers-fr.md | 10 +- docs/src/modules/components/backers-pt.md | 6 +- docs/src/modules/components/backers-ru.md | 4 +- docs/src/modules/components/backers-zh.md | 10 +- .../about-the-lab/about-the-lab-aa.md | 17 +- .../about-the-lab/about-the-lab-de.md | 17 +- .../about-the-lab/about-the-lab-es.md | 19 +- .../about-the-lab/about-the-lab-fr.md | 17 +- .../about-the-lab/about-the-lab-ja.md | 17 +- .../about-the-lab/about-the-lab-pt.md | 17 +- .../about-the-lab/about-the-lab-ru.md | 15 +- .../about-the-lab/about-the-lab-zh.md | 17 +- docs/src/pages/components/alert/alert-es.md | 2 +- docs/src/pages/components/alert/alert-fr.md | 32 ++-- docs/src/pages/components/alert/alert-pt.md | 12 +- docs/src/pages/components/alert/alert-zh.md | 18 +- .../pages/components/app-bar/app-bar-zh.md | 2 +- .../autocomplete/autocomplete-aa.md | 101 ++++++----- .../autocomplete/autocomplete-de.md | 47 +++-- .../autocomplete/autocomplete-es.md | 15 +- .../autocomplete/autocomplete-fr.md | 15 +- .../autocomplete/autocomplete-ja.md | 15 +- .../autocomplete/autocomplete-pt.md | 17 +- .../autocomplete/autocomplete-ru.md | 19 +- .../autocomplete/autocomplete-zh.md | 27 ++- .../pages/components/avatars/avatars-aa.md | 2 +- .../pages/components/avatars/avatars-de.md | 2 +- .../pages/components/avatars/avatars-es.md | 2 +- .../pages/components/avatars/avatars-fr.md | 2 +- .../pages/components/avatars/avatars-ja.md | 2 +- .../pages/components/avatars/avatars-pt.md | 2 +- .../pages/components/avatars/avatars-ru.md | 2 +- .../pages/components/avatars/avatars-zh.md | 4 +- .../pages/components/backdrop/backdrop-ru.md | 4 +- .../pages/components/backdrop/backdrop-zh.md | 4 +- docs/src/pages/components/badges/badges-zh.md | 2 +- .../bottom-navigation/bottom-navigation-zh.md | 4 +- docs/src/pages/components/box/box-de.md | 4 +- docs/src/pages/components/box/box-zh.md | 2 +- .../components/breadcrumbs/breadcrumbs-zh.md | 2 +- .../pages/components/buttons/buttons-zh.md | 2 +- docs/src/pages/components/cards/cards-zh.md | 2 +- .../components/checkboxes/checkboxes-zh.md | 2 +- docs/src/pages/components/chips/chips-zh.md | 2 +- .../click-away-listener-zh.md | 2 +- .../components/container/container-zh.md | 2 +- .../css-baseline/css-baseline-aa.md | 18 +- .../css-baseline/css-baseline-de.md | 27 ++- .../css-baseline/css-baseline-es.md | 25 ++- .../css-baseline/css-baseline-fr.md | 25 ++- .../css-baseline/css-baseline-ja.md | 27 ++- .../css-baseline/css-baseline-pt.md | 27 ++- .../css-baseline/css-baseline-ru.md | 23 ++- .../css-baseline/css-baseline-zh.md | 29 ++- .../pages/components/dialogs/dialogs-zh.md | 2 +- .../pages/components/dividers/dividers-aa.md | 2 +- .../pages/components/dividers/dividers-de.md | 2 +- .../pages/components/dividers/dividers-es.md | 2 +- .../pages/components/dividers/dividers-fr.md | 2 +- .../pages/components/dividers/dividers-ja.md | 2 +- .../pages/components/dividers/dividers-pt.md | 2 +- .../pages/components/dividers/dividers-ru.md | 2 +- .../pages/components/dividers/dividers-zh.md | 4 +- .../pages/components/drawers/drawers-zh.md | 2 +- .../expansion-panels/expansion-panels-zh.md | 2 +- .../components/grid-list/grid-list-zh.md | 2 +- docs/src/pages/components/hidden/hidden-zh.md | 2 +- docs/src/pages/components/icons/icons-aa.md | 4 +- docs/src/pages/components/icons/icons-de.md | 4 +- docs/src/pages/components/icons/icons-es.md | 4 +- docs/src/pages/components/icons/icons-fr.md | 4 +- docs/src/pages/components/icons/icons-ja.md | 4 +- docs/src/pages/components/icons/icons-pt.md | 4 +- docs/src/pages/components/icons/icons-ru.md | 4 +- docs/src/pages/components/icons/icons-zh.md | 6 +- docs/src/pages/components/links/links-zh.md | 2 +- docs/src/pages/components/lists/lists-zh.md | 4 +- .../material-icons/material-icons-aa.md | 4 +- .../material-icons/material-icons-de.md | 4 +- .../material-icons/material-icons-es.md | 4 +- .../material-icons/material-icons-fr.md | 4 +- .../material-icons/material-icons-ja.md | 4 +- .../material-icons/material-icons-pt.md | 4 +- .../material-icons/material-icons-ru.md | 4 +- .../material-icons/material-icons-zh.md | 6 +- docs/src/pages/components/menus/menus-zh.md | 2 +- docs/src/pages/components/modal/modal-zh.md | 2 +- docs/src/pages/components/no-ssr/no-ssr-zh.md | 2 +- .../components/pagination/pagination-aa.md | 66 +++++++ .../components/pagination/pagination-de.md | 66 +++++++ .../components/pagination/pagination-es.md | 66 +++++++ .../components/pagination/pagination-fr.md | 66 +++++++ .../components/pagination/pagination-ja.md | 66 +++++++ .../components/pagination/pagination-pt.md | 66 +++++++ .../components/pagination/pagination-ru.md | 66 +++++++ .../components/pagination/pagination-zh.md | 66 +++++++ docs/src/pages/components/paper/paper-zh.md | 4 +- .../pages/components/pickers/pickers-zh.md | 2 +- .../pages/components/popover/popover-zh.md | 2 +- docs/src/pages/components/popper/popper-zh.md | 2 +- docs/src/pages/components/portal/portal-zh.md | 2 +- .../pages/components/progress/progress-zh.md | 2 +- .../radio-buttons/radio-buttons-zh.md | 2 +- docs/src/pages/components/rating/rating-zh.md | 2 +- .../pages/components/selects/selects-aa.md | 54 +++--- .../pages/components/selects/selects-de.md | 30 ++-- .../pages/components/selects/selects-es.md | 14 +- .../pages/components/selects/selects-fr.md | 12 +- .../pages/components/selects/selects-ja.md | 30 ++-- .../pages/components/selects/selects-pt.md | 30 ++-- .../pages/components/selects/selects-ru.md | 8 +- .../pages/components/selects/selects-zh.md | 28 +-- .../pages/components/skeleton/skeleton-ru.md | 4 +- docs/src/pages/components/slider/slider-zh.md | 2 +- .../components/snackbars/snackbars-zh.md | 2 +- .../components/speed-dial/speed-dial-zh.md | 2 +- .../pages/components/steppers/steppers-zh.md | 4 +- .../pages/components/switches/switches-zh.md | 2 +- docs/src/pages/components/tables/tables-zh.md | 2 +- docs/src/pages/components/tabs/tabs-zh.md | 2 +- .../components/text-fields/text-fields-aa.md | 7 +- .../components/text-fields/text-fields-de.md | 7 +- .../components/text-fields/text-fields-es.md | 7 +- .../components/text-fields/text-fields-fr.md | 7 +- .../components/text-fields/text-fields-ja.md | 7 +- .../components/text-fields/text-fields-pt.md | 31 ++-- .../components/text-fields/text-fields-ru.md | 7 +- .../components/text-fields/text-fields-zh.md | 15 +- .../textarea-autosize/textarea-autosize-zh.md | 2 +- .../toggle-button/toggle-button-aa.md | 26 ++- .../toggle-button/toggle-button-de.md | 20 +++ .../toggle-button/toggle-button-es.md | 24 ++- .../toggle-button/toggle-button-fr.md | 20 +++ .../toggle-button/toggle-button-ja.md | 22 ++- .../toggle-button/toggle-button-pt.md | 28 ++- .../toggle-button/toggle-button-ru.md | 20 +++ .../toggle-button/toggle-button-zh.md | 22 ++- .../pages/components/tooltips/tooltips-zh.md | 2 +- .../transfer-list/transfer-list-zh.md | 2 +- .../components/transitions/transitions-zh.md | 2 +- .../components/tree-view/tree-view-aa.md | 27 ++- .../components/tree-view/tree-view-de.md | 22 +++ .../components/tree-view/tree-view-es.md | 22 +++ .../components/tree-view/tree-view-fr.md | 22 +++ .../components/tree-view/tree-view-ja.md | 24 ++- .../components/tree-view/tree-view-pt.md | 24 ++- .../components/tree-view/tree-view-ru.md | 22 +++ .../components/tree-view/tree-view-zh.md | 26 ++- .../components/typography/typography-fr.md | 22 +-- .../components/typography/typography-zh.md | 2 +- .../use-media-query/use-media-query-zh.md | 2 +- .../pages/customization/palette/palette-aa.md | 2 +- .../pages/customization/palette/palette-de.md | 2 +- .../pages/customization/palette/palette-es.md | 2 +- .../pages/customization/palette/palette-fr.md | 2 +- .../pages/customization/palette/palette-ja.md | 2 +- .../pages/customization/palette/palette-pt.md | 2 +- .../pages/customization/palette/palette-ru.md | 2 +- .../pages/customization/palette/palette-zh.md | 2 +- .../related-projects/related-projects-aa.md | 52 +++--- .../related-projects/related-projects-de.md | 26 ++- .../related-projects/related-projects-es.md | 18 +- .../related-projects/related-projects-fr.md | 18 +- .../related-projects/related-projects-ja.md | 18 +- .../related-projects/related-projects-pt.md | 18 +- .../related-projects/related-projects-ru.md | 18 +- .../related-projects/related-projects-zh.md | 20 ++- docs/src/pages/discover-more/team/team-de.md | 6 +- .../pages/discover-more/vision/vision-pt.md | 2 +- .../example-projects/example-projects-aa.md | 7 + .../example-projects/example-projects-de.md | 7 + .../example-projects/example-projects-es.md | 15 +- .../example-projects/example-projects-fr.md | 7 + .../example-projects/example-projects-ja.md | 7 + .../example-projects/example-projects-pt.md | 7 + .../example-projects/example-projects-ru.md | 7 + .../example-projects/example-projects-zh.md | 7 + .../getting-started/support/support-de.md | 16 +- .../guides/localization/localization-aa.md | 41 +++-- .../guides/localization/localization-de.md | 3 + .../guides/localization/localization-es.md | 3 + .../guides/localization/localization-fr.md | 3 + .../guides/localization/localization-ja.md | 3 + .../guides/localization/localization-pt.md | 3 + .../guides/localization/localization-ru.md | 3 + .../guides/localization/localization-zh.md | 79 ++++---- .../pages/guides/typescript/typescript-aa.md | 39 +++- .../pages/guides/typescript/typescript-de.md | 41 ++++- .../pages/guides/typescript/typescript-es.md | 39 +++- .../pages/guides/typescript/typescript-fr.md | 39 +++- .../pages/guides/typescript/typescript-ja.md | 47 ++++- .../pages/guides/typescript/typescript-pt.md | 47 ++++- .../pages/guides/typescript/typescript-ru.md | 39 +++- .../pages/guides/typescript/typescript-zh.md | 47 ++++- .../pages/styles/typescript/typescript-zh.md | 2 +- docs/src/pages/system/api/api-aa.md | 109 +++++------ docs/src/pages/system/api/api-de.md | 1 + docs/src/pages/system/api/api-es.md | 1 + docs/src/pages/system/api/api-fr.md | 1 + docs/src/pages/system/api/api-ja.md | 3 +- docs/src/pages/system/api/api-pt.md | 1 + docs/src/pages/system/api/api-ru.md | 1 + docs/src/pages/system/api/api-zh.md | 1 + docs/src/pages/system/sizing/sizing-aa.md | 17 +- docs/src/pages/system/sizing/sizing-de.md | 3 +- docs/src/pages/system/sizing/sizing-es.md | 3 +- docs/src/pages/system/sizing/sizing-fr.md | 3 +- docs/src/pages/system/sizing/sizing-ja.md | 3 +- docs/src/pages/system/sizing/sizing-pt.md | 3 +- docs/src/pages/system/sizing/sizing-ru.md | 3 +- docs/src/pages/system/sizing/sizing-zh.md | 3 +- docs/src/pages/system/spacing/spacing-zh.md | 4 +- docs/src/pages/versions/versions-zh.md | 12 +- docs/translations/translations-aa.json | 1 + docs/translations/translations-de.json | 1 + docs/translations/translations-es.json | 1 + docs/translations/translations-fr.json | 13 +- docs/translations/translations-ja.json | 1 + docs/translations/translations-pt.json | 1 + docs/translations/translations-ru.json | 1 + docs/translations/translations-zh.json | 169 +++++++++--------- 223 files changed, 2468 insertions(+), 792 deletions(-) create mode 100644 docs/src/pages/components/pagination/pagination-aa.md create mode 100644 docs/src/pages/components/pagination/pagination-de.md create mode 100644 docs/src/pages/components/pagination/pagination-es.md create mode 100644 docs/src/pages/components/pagination/pagination-fr.md create mode 100644 docs/src/pages/components/pagination/pagination-ja.md create mode 100644 docs/src/pages/components/pagination/pagination-pt.md create mode 100644 docs/src/pages/components/pagination/pagination-ru.md create mode 100644 docs/src/pages/components/pagination/pagination-zh.md diff --git a/docs/src/modules/components/backers-de.md b/docs/src/modules/components/backers-de.md index 9c690e91c3ab56..e6f0620c955496 100644 --- a/docs/src/modules/components/backers-de.md +++ b/docs/src/modules/components/backers-de.md @@ -1,6 +1,6 @@

Sponsoren von Material-UI

-The continued development and maintenance of Material-UI is made possible by these generous sponsors: +Die kontinuierliche Weiterentwicklung und Wartung von Material-UI wird durch diese großzügigen Sponsoren ermöglicht: ### Diamant 💎 @@ -10,11 +10,11 @@ The continued development and maintenance of Material-UI is made possible by the

tidelift - bitsrc + bitsrc

- call-em-all + call-em-all

### Es gibt noch mehr! diff --git a/docs/src/modules/components/backers-es.md b/docs/src/modules/components/backers-es.md index 96cc3d5dbb28ba..cae8a48dcbbfaf 100644 --- a/docs/src/modules/components/backers-es.md +++ b/docs/src/modules/components/backers-es.md @@ -1,6 +1,6 @@

Patrocinadores de Material-UI

-The continued development and maintenance of Material-UI is made possible by these generous sponsors: +El continuo desarrollo y mantenimiento de Material-UI es posible gracias a estos generosos patrocinadores: ### Diamante 💎 @@ -9,14 +9,14 @@ The continued development and maintenance of Material-UI is made possible by the ### Oro 🏆

- tidelift - bitsrc + tidelift + bitsrc

- call-em-all + call-em-all

### ¡Y aún hay más! -See the full list of [our sponsors](/discover-more/backers/), and learn how you can contribute to the future of Material-UI. \ No newline at end of file +Ver la lista completa de [nuestros patrocinadores](/discover-more/backers/), y aprende cómo puedes contribuir al futuro de Material-UI. \ No newline at end of file diff --git a/docs/src/modules/components/backers-fr.md b/docs/src/modules/components/backers-fr.md index 79375574c8182e..98e922801459f5 100644 --- a/docs/src/modules/components/backers-fr.md +++ b/docs/src/modules/components/backers-fr.md @@ -1,6 +1,6 @@

Sponsors de Material-UI

-The continued development and maintenance of Material-UI is made possible by these generous sponsors: +Le développement et la maintenance continus de Material-UI sont rendus possibles par ces généreux sponsors : ### Diamant 💎 @@ -9,14 +9,14 @@ The continued development and maintenance of Material-UI is made possible by the ### Or 🏆

- tidelift - bitsrc + tidelift + bitsrc

- call-em-all + call-em-all

### Il y en a plus ! -See the full list of [our sponsors](/discover-more/backers/), and learn how you can contribute to the future of Material-UI. \ No newline at end of file +Voir la liste complète de [nos sponsors](/discover-more/backers/), et apprendre comment vous pouvez contribuer au futur de Material-UI. \ No newline at end of file diff --git a/docs/src/modules/components/backers-pt.md b/docs/src/modules/components/backers-pt.md index 8b9a437996525b..7915ac13105246 100644 --- a/docs/src/modules/components/backers-pt.md +++ b/docs/src/modules/components/backers-pt.md @@ -1,6 +1,6 @@

Patrocinadores do Material-UI

-The continued development and maintenance of Material-UI is made possible by these generous sponsors: +O desenvolvimento contínuo e manutenção do Material-UI possível por causa destes generosos patrocinadores: ### Diamante 💎 @@ -10,7 +10,7 @@ The continued development and maintenance of Material-UI is made possible by the

tidelift - bitsrc + bitsrc

@@ -19,4 +19,4 @@ The continued development and maintenance of Material-UI is made possible by the ### E tem mais! -See the full list of [our sponsors](/discover-more/backers/), and learn how you can contribute to the future of Material-UI. \ No newline at end of file +Veja a lista completa dos [nossos patrocinadores](/discover-more/backers/) e saiba como você pode contribuir com o futuro do Material-UI. \ No newline at end of file diff --git a/docs/src/modules/components/backers-ru.md b/docs/src/modules/components/backers-ru.md index 6a85086795c99a..da95f1650b389a 100644 --- a/docs/src/modules/components/backers-ru.md +++ b/docs/src/modules/components/backers-ru.md @@ -1,6 +1,6 @@

Спонсоры Material-UI

-The continued development and maintenance of Material-UI is made possible by these generous sponsors: +Дальнейшее развитие и поддержание Material-UI возможно благодаря этим щедрым спонсорам: ### Алмазные 💎 @@ -19,4 +19,4 @@ The continued development and maintenance of Material-UI is made possible by the ### Узнать больше! -See the full list of [our sponsors](/discover-more/backers/), and learn how you can contribute to the future of Material-UI. \ No newline at end of file +Ознакомьтесь с полным списком [наших спонсоров](/discover-more/backers/), и узнайте, как вы можете внести свой вклад в будущее Material-UI. \ No newline at end of file diff --git a/docs/src/modules/components/backers-zh.md b/docs/src/modules/components/backers-zh.md index 8690ee01f65ce0..dbabfa1a1d882e 100644 --- a/docs/src/modules/components/backers-zh.md +++ b/docs/src/modules/components/backers-zh.md @@ -1,6 +1,6 @@

Material-UI 的赞助商

-The continued development and maintenance of Material-UI is made possible by these generous sponsors: +这些慷慨的赞助商使 Material-UI 的持续开发和维护成为可能: ### 钻石级💎 @@ -9,14 +9,14 @@ The continued development and maintenance of Material-UI is made possible by the ### 金杯级 🏆

- tidelift - bitsrc + tidelift + bitsrc

- call-em-all + call-em-all

### 不仅如此! -See the full list of [our sponsors](/discover-more/backers/), and learn how you can contribute to the future of Material-UI. \ No newline at end of file +查看[我们的赞助商](/discover-more/backers/)的完整列表,了解您如何为 Material-UI 的未来做出贡献。 \ No newline at end of file diff --git a/docs/src/pages/components/about-the-lab/about-the-lab-aa.md b/docs/src/pages/components/about-the-lab/about-the-lab-aa.md index 69b6f9764b3d2e..11e4640653bd1f 100644 --- a/docs/src/pages/components/about-the-lab/about-the-lab-aa.md +++ b/docs/src/pages/components/about-the-lab/about-the-lab-aa.md @@ -2,15 +2,28 @@

crwdns89126:0crwdne89126:0

+crwdns109485:0crwdne109485:0 crwdns109487:0crwdne109487:0 + +crwdns109489:0crwdne109489:0 crwdns109491:0crwdne109491:0 + +crwdns109493:0crwdne109493:0 + +* crwdns109495:0crwdne109495:0 crwdns109497:0crwdne109497:0 crwdns109499:0crwdne109499:0 +* crwdns109501:0crwdne109501:0 crwdns109503:0crwdne109503:0 + * crwdns109505:0crwdne109505:0 crwdns109507:0crwdne109507:0 + * crwdns109509:0crwdne109509:0 crwdns109511:0crwdne109511:0 +* crwdns109513:0crwdne109513:0 crwdns109515:0crwdne109515:0 +* crwdns109517:0crwdne109517:0 crwdns109519:0crwdne109519:0 + ## crwdns89128:0crwdne89128:0 -crwdns89130:0crwdne89130:0 +crwdns109521:0crwdne109521:0 ```sh crwdns89132:0crwdne89132:0 ``` -crwdns89134:0crwdne89134:0 crwdns89136:0crwdne89136:0 +crwdns109523:0crwdne109523:0 crwdns109525:0crwdne109525:0 ```sh crwdns89138:0crwdne89138:0 diff --git a/docs/src/pages/components/about-the-lab/about-the-lab-de.md b/docs/src/pages/components/about-the-lab/about-the-lab-de.md index f1461907869163..a7e36e55d9b2bd 100644 --- a/docs/src/pages/components/about-the-lab/about-the-lab-de.md +++ b/docs/src/pages/components/about-the-lab/about-the-lab-de.md @@ -2,9 +2,22 @@

Dieses Paket enthält die Inkubator-Komponenten, die noch nicht bereit sind, in den Kern aufgenommen zu werden.

+The main difference between the lab and the core is how the components are versioned. Having a separate lab package allows us to release breaking changes when necessary while the core package follows a [slower-moving policy](https://material-ui.com/versions/#release-frequency). + +As developers use and test the components and report issues, the maintainers learn more about shortcomings of the components: missing features, accessibility issues, bugs, API design, etc. The older and more used a component is, the less likely it is that new issues will be found and subsequently need to introduce breaking changes. + +For a component to be ready to move to the core, the following criteria are considered: + +* It needs to be **used**. The Material-UI team uses Google Analytics stats among other metrics to evaluate the usage of each component. A lab component with low usage either means that it isn't fully working yet or that there is a low demand for it. +* It needs to match the **code quality** of the core components. It doesn't have to be perfect to be a part of the core, but the component should be reliable enough that developers can depend on it. + * Each component needs **type definitions**. It is not currently required that a lab component is typed, but it would need to be typed to move to the core. + * Requires good **test coverage**. Some of the lab components don't currently have comprehensive tests. +* Can it be used as **leverage** to incentivize users to upgrade to the latest major release? The less fragmented the community is, the better. +* It needs to have a low probability of a **breaking change** in the short/medium future. For instance, if it needs a new feature that will likely require a breaking change, it may be preferable to delay its promotion to the core. + ## Installation -Installieren Sie das Paket in Ihrem Projektverzeichnis mit: +Install the package in your project directory with: ```sh // mit npm @@ -14,7 +27,7 @@ npm install @material-ui/lab yarn add @material-ui/lab ``` -Das Labor hat eine Peer-Abhängigkeit von den Kernkomponenten. Wenn Sie in Ihrem Projekt noch keine Material-UI verwenden, können Sie es mit folgendem installieren: +The lab has a peer dependency on the core components. If you are not already using Material-UI in your project, you can install it with: ```sh // mit npm diff --git a/docs/src/pages/components/about-the-lab/about-the-lab-es.md b/docs/src/pages/components/about-the-lab/about-the-lab-es.md index c900bf47acb5b2..61b013076e5155 100644 --- a/docs/src/pages/components/about-the-lab/about-the-lab-es.md +++ b/docs/src/pages/components/about-the-lab/about-the-lab-es.md @@ -1,10 +1,23 @@ -# Acerca de lab +# Acerca del laboratorio

Este paquete almacena componentes en desarrollo, que todavía no están listos para estar en core.

+The main difference between the lab and the core is how the components are versioned. Having a separate lab package allows us to release breaking changes when necessary while the core package follows a [slower-moving policy](https://material-ui.com/versions/#release-frequency). + +As developers use and test the components and report issues, the maintainers learn more about shortcomings of the components: missing features, accessibility issues, bugs, API design, etc. The older and more used a component is, the less likely it is that new issues will be found and subsequently need to introduce breaking changes. + +For a component to be ready to move to the core, the following criteria are considered: + +* It needs to be **used**. The Material-UI team uses Google Analytics stats among other metrics to evaluate the usage of each component. A lab component with low usage either means that it isn't fully working yet or that there is a low demand for it. +* It needs to match the **code quality** of the core components. It doesn't have to be perfect to be a part of the core, but the component should be reliable enough that developers can depend on it. + * Each component needs **type definitions**. It is not currently required that a lab component is typed, but it would need to be typed to move to the core. + * Requires good **test coverage**. Some of the lab components don't currently have comprehensive tests. +* Can it be used as **leverage** to incentivize users to upgrade to the latest major release? The less fragmented the community is, the better. +* It needs to have a low probability of a **breaking change** in the short/medium future. For instance, if it needs a new feature that will likely require a breaking change, it may be preferable to delay its promotion to the core. + ## Instalación -Instala el paquete en el directorio de su proyecto con: +Install the package in your project directory with: ```sh // con npm @@ -14,7 +27,7 @@ npm install @material-ui/lab yarn add @material-ui/lab ``` -El lab tiene puntos de dependencias de los componentes core. Si aún no estás usando Material-UI en tu proyecto, puedes instalarlo con: +The lab has a peer dependency on the core components. If you are not already using Material-UI in your project, you can install it with: ```sh // usando npm diff --git a/docs/src/pages/components/about-the-lab/about-the-lab-fr.md b/docs/src/pages/components/about-the-lab/about-the-lab-fr.md index d8b8d58aab6f5c..a0c168d2b70117 100644 --- a/docs/src/pages/components/about-the-lab/about-the-lab-fr.md +++ b/docs/src/pages/components/about-the-lab/about-the-lab-fr.md @@ -2,9 +2,22 @@

Ce package contient des composants en incubation (en développement) qui ne sont pas encore prêts à être ajoutés au package principal.

+The main difference between the lab and the core is how the components are versioned. Having a separate lab package allows us to release breaking changes when necessary while the core package follows a [slower-moving policy](https://material-ui.com/versions/#release-frequency). + +As developers use and test the components and report issues, the maintainers learn more about shortcomings of the components: missing features, accessibility issues, bugs, API design, etc. The older and more used a component is, the less likely it is that new issues will be found and subsequently need to introduce breaking changes. + +For a component to be ready to move to the core, the following criteria are considered: + +* It needs to be **used**. The Material-UI team uses Google Analytics stats among other metrics to evaluate the usage of each component. A lab component with low usage either means that it isn't fully working yet or that there is a low demand for it. +* It needs to match the **code quality** of the core components. It doesn't have to be perfect to be a part of the core, but the component should be reliable enough that developers can depend on it. + * Each component needs **type definitions**. It is not currently required that a lab component is typed, but it would need to be typed to move to the core. + * Requires good **test coverage**. Some of the lab components don't currently have comprehensive tests. +* Can it be used as **leverage** to incentivize users to upgrade to the latest major release? The less fragmented the community is, the better. +* It needs to have a low probability of a **breaking change** in the short/medium future. For instance, if it needs a new feature that will likely require a breaking change, it may be preferable to delay its promotion to the core. + ## Installation -Installez le package dans votre répertoire de projet avec: +Install the package in your project directory with: ```sh // avec npm @@ -14,7 +27,7 @@ npm install @material-ui/lab yarn add @material-ui/lab ``` -Le laboratoire dépend des composants du package principal. Si vous n'utilisez pas encore Material-UI dans votre projet, vous pouvez l'installer avec: +The lab has a peer dependency on the core components. If you are not already using Material-UI in your project, you can install it with: ```sh // avec npm diff --git a/docs/src/pages/components/about-the-lab/about-the-lab-ja.md b/docs/src/pages/components/about-the-lab/about-the-lab-ja.md index be4468c65db80d..259df6c6c3fef7 100644 --- a/docs/src/pages/components/about-the-lab/about-the-lab-ja.md +++ b/docs/src/pages/components/about-the-lab/about-the-lab-ja.md @@ -2,9 +2,22 @@

このパッケージは、まだコアに移動する準備ができていないインキュベーター・コンポーネントをホストします。

+The main difference between the lab and the core is how the components are versioned. Having a separate lab package allows us to release breaking changes when necessary while the core package follows a [slower-moving policy](https://material-ui.com/versions/#release-frequency). + +As developers use and test the components and report issues, the maintainers learn more about shortcomings of the components: missing features, accessibility issues, bugs, API design, etc. The older and more used a component is, the less likely it is that new issues will be found and subsequently need to introduce breaking changes. + +For a component to be ready to move to the core, the following criteria are considered: + +* It needs to be **used**. The Material-UI team uses Google Analytics stats among other metrics to evaluate the usage of each component. A lab component with low usage either means that it isn't fully working yet or that there is a low demand for it. +* It needs to match the **code quality** of the core components. It doesn't have to be perfect to be a part of the core, but the component should be reliable enough that developers can depend on it. + * Each component needs **type definitions**. It is not currently required that a lab component is typed, but it would need to be typed to move to the core. + * Requires good **test coverage**. Some of the lab components don't currently have comprehensive tests. +* Can it be used as **leverage** to incentivize users to upgrade to the latest major release? The less fragmented the community is, the better. +* It needs to have a low probability of a **breaking change** in the short/medium future. For instance, if it needs a new feature that will likely require a breaking change, it may be preferable to delay its promotion to the core. + ## インストール -次を使用して、プロジェクトディレクトリにパッケージをインストールします。 +Install the package in your project directory with: ```sh // with npm @@ -14,7 +27,7 @@ npm install @material-ui/lab yarn add @material-ui/lab ``` -このラボには、コアコンポーネントへのピア依存関係があります。 プロジェクトでまだMaterial-UIを使用していない場合は、次のコマンドでインストールできます。 +The lab has a peer dependency on the core components. If you are not already using Material-UI in your project, you can install it with: ```sh // npmの場合 diff --git a/docs/src/pages/components/about-the-lab/about-the-lab-pt.md b/docs/src/pages/components/about-the-lab/about-the-lab-pt.md index f745d941540e84..ef0ac171b53eca 100644 --- a/docs/src/pages/components/about-the-lab/about-the-lab-pt.md +++ b/docs/src/pages/components/about-the-lab/about-the-lab-pt.md @@ -2,9 +2,22 @@

Este pacote hospeda os componentes da incubadora que ainda não estão prontos para mover para o núcleo (core).

+The main difference between the lab and the core is how the components are versioned. Having a separate lab package allows us to release breaking changes when necessary while the core package follows a [slower-moving policy](https://material-ui.com/versions/#release-frequency). + +As developers use and test the components and report issues, the maintainers learn more about shortcomings of the components: missing features, accessibility issues, bugs, API design, etc. The older and more used a component is, the less likely it is that new issues will be found and subsequently need to introduce breaking changes. + +For a component to be ready to move to the core, the following criteria are considered: + +* It needs to be **used**. The Material-UI team uses Google Analytics stats among other metrics to evaluate the usage of each component. A lab component with low usage either means that it isn't fully working yet or that there is a low demand for it. +* It needs to match the **code quality** of the core components. It doesn't have to be perfect to be a part of the core, but the component should be reliable enough that developers can depend on it. + * Each component needs **type definitions**. It is not currently required that a lab component is typed, but it would need to be typed to move to the core. + * Requires good **test coverage**. Some of the lab components don't currently have comprehensive tests. +* Can it be used as **leverage** to incentivize users to upgrade to the latest major release? The less fragmented the community is, the better. +* It needs to have a low probability of a **breaking change** in the short/medium future. For instance, if it needs a new feature that will likely require a breaking change, it may be preferable to delay its promotion to the core. + ## Instalação -Instale o pacote no diretório do seu projeto com: +Install the package in your project directory with: ```sh // usando npm @@ -14,7 +27,7 @@ npm install @material-ui/lab yarn add @material-ui/lab ``` -O lab tem uma dependência com o core componentes. Se você ainda não estiver usando Material-UI no seu projeto, você pode instalá-lo com: +The lab has a peer dependency on the core components. If you are not already using Material-UI in your project, you can install it with: ```sh // usando npm diff --git a/docs/src/pages/components/about-the-lab/about-the-lab-ru.md b/docs/src/pages/components/about-the-lab/about-the-lab-ru.md index b9b42394835df6..f7c95eba8c9d5a 100644 --- a/docs/src/pages/components/about-the-lab/about-the-lab-ru.md +++ b/docs/src/pages/components/about-the-lab/about-the-lab-ru.md @@ -2,6 +2,19 @@

Этот пакет содержит инкубационные компоненты, которые еще не готовы к переходу в основной пакет.

+The main difference between the lab and the core is how the components are versioned. Having a separate lab package allows us to release breaking changes when necessary while the core package follows a [slower-moving policy](https://material-ui.com/versions/#release-frequency). + +As developers use and test the components and report issues, the maintainers learn more about shortcomings of the components: missing features, accessibility issues, bugs, API design, etc. The older and more used a component is, the less likely it is that new issues will be found and subsequently need to introduce breaking changes. + +For a component to be ready to move to the core, the following criteria are considered: + +* It needs to be **used**. The Material-UI team uses Google Analytics stats among other metrics to evaluate the usage of each component. A lab component with low usage either means that it isn't fully working yet or that there is a low demand for it. +* It needs to match the **code quality** of the core components. It doesn't have to be perfect to be a part of the core, but the component should be reliable enough that developers can depend on it. + * Each component needs **type definitions**. It is not currently required that a lab component is typed, but it would need to be typed to move to the core. + * Requires good **test coverage**. Some of the lab components don't currently have comprehensive tests. +* Can it be used as **leverage** to incentivize users to upgrade to the latest major release? The less fragmented the community is, the better. +* It needs to have a low probability of a **breaking change** in the short/medium future. For instance, if it needs a new feature that will likely require a breaking change, it may be preferable to delay its promotion to the core. + ## Инструкция по установке Установите пакет в каталог проекта командой: @@ -14,7 +27,7 @@ npm install @material-ui/lab yarn add @material-ui/lab ``` -Пакет lab зависит напрямую от пакета основных компонентов. Если Material-UI ещё не использовался вашем проекте, вы можете установить его командой: +The lab has a peer dependency on the core components. If you are not already using Material-UI in your project, you can install it with: ```sh // with npm diff --git a/docs/src/pages/components/about-the-lab/about-the-lab-zh.md b/docs/src/pages/components/about-the-lab/about-the-lab-zh.md index 54f0018c7e9e9b..d31572a0f0753f 100644 --- a/docs/src/pages/components/about-the-lab/about-the-lab-zh.md +++ b/docs/src/pages/components/about-the-lab/about-the-lab-zh.md @@ -2,9 +2,22 @@

此依赖包包含了一些还在开发中的组件,它们还不能移到 core(核心)库中。

+核心库(core)和实验室(lab)之间的主要差别就是组件是如何版本化的 Having a separate lab package allows us to release breaking changes when necessary while the core package follows a [slower-moving policy](https://material-ui.com/versions/#release-frequency). + +As developers use and test the components and report issues, the maintainers learn more about shortcomings of the components: missing features, accessibility issues, bugs, API design, etc. The older and more used a component is, the less likely it is that new issues will be found and subsequently need to introduce breaking changes. + +For a component to be ready to move to the core, the following criteria are considered: + +* It needs to be **used**. The Material-UI team uses Google Analytics stats among other metrics to evaluate the usage of each component. A lab component with low usage either means that it isn't fully working yet or that there is a low demand for it. +* It needs to match the **code quality** of the core components. It doesn't have to be perfect to be a part of the core, but the component should be reliable enough that developers can depend on it. + * Each component needs **type definitions**. It is not currently required that a lab component is typed, but it would need to be typed to move to the core. + * Requires good **test coverage**. Some of the lab components don't currently have comprehensive tests. +* Can it be used as **leverage** to incentivize users to upgrade to the latest major release? The less fragmented the community is, the better. +* It needs to have a low probability of a **breaking change** in the short/medium future. For instance, if it needs a new feature that will likely require a breaking change, it may be preferable to delay its promotion to the core. + ## 安装 -请在您的项目目录中用以下方式安装依赖包: +Install the package in your project directory with: ```sh // 用 npm 安装 @@ -14,7 +27,7 @@ npm install @material-ui/lab yarn add @material-ui/lab ``` -该 lab 和那些核心组件是对等依赖的。 若您还未在项目中使用 Material-UI,你可以按如下方式安装: +The lab has a peer dependency on the core components. If you are not already using Material-UI in your project, you can install it with: ```sh // 用 npm 安装 diff --git a/docs/src/pages/components/alert/alert-es.md b/docs/src/pages/components/alert/alert-es.md index dc34ec6ffe84c6..439a534f31925b 100644 --- a/docs/src/pages/components/alert/alert-es.md +++ b/docs/src/pages/components/alert/alert-es.md @@ -37,7 +37,7 @@ Puede utilizar el componente de [ transition ](/components/transitions/) como `C ## Iconos -El `icon` prop permite añadir un icono para el inicio del componente Alert. This will override the default icon for the specified severity. +El `icon` prop permite añadir un icono para el inicio del componente Alert. Esto anulará el icono por defecto para la gravedad especificada. You can change the default severity to icon mapping with the `iconMapping` prop. This can be defined globally using [theme customization](/customization/globals/#default-props). diff --git a/docs/src/pages/components/alert/alert-fr.md b/docs/src/pages/components/alert/alert-fr.md index 3f12939bf216f2..f70cef18bc630e 100644 --- a/docs/src/pages/components/alert/alert-fr.md +++ b/docs/src/pages/components/alert/alert-fr.md @@ -1,5 +1,5 @@ --- -title: Alert React component +title: Composant Alert React components: Alert --- @@ -7,47 +7,47 @@ components: Alert

Une alerte affiche un message court et important d'une manière qui attire l'attention de l'utilisateur sans interrompre sa tâche.

-**Note:** This component is not documented in the [Material Design guidelines](https://material.io/), but Material-UI supports it. +**Remarque :** Ce composant n'est pas documenté dans les [consignes de Material Design](https://material.io/), mais Material-UI le supporte. ## Alertes simples -The alert offers four severity levels that set a distinctive icon and color. +L'alerte offre quatre niveaux de sévérité qui définissent une icône et une couleur distinctes. {{"demo": "pages/components/alert/SimpleAlerts.js"}} ## Description -You can use the `AlertTitle` component to display a formatted title above the content. +Vous pouvez utiliser le composant `AlertTitle` pour afficher un titre formaté au-dessus du contenu. {{"demo": "pages/components/alert/DescriptionAlerts.js"}} ## Actions -An alert can have an action, such as a close or undo button. It is rendered after the message, at the end of the alert. +Une alerte peut avoir une action, comme un bouton de fermeture ou d'annulation. Il est affiché après le message, à la fin de l'alerte. -If an `onClose` callback is provided and no `action` prop is set, a close icon is displayed. The `action` prop can be used to provide an alternative action, for example using a Button or IconButton. +Si une fonction de rappel `onClose` est fournie et qu'aucune propriété `action` n'est définie, une icône de fermeture s'affiche. La propriété `action` peut être utilisée pour fournir une action alternative, par exemple en utilisant un `Button` ou un `IconButton`. {{"demo": "pages/components/alert/ActionAlerts.js"}} ### Transition -You can use a [transition component](/components/transitions/) such as `Collapse` to transition the appearance of the alert. +Vous pouvez utiliser un [composant de transition](/components/transitions/) tel que `Collapse` pour faire la transition de l'apparence de l'alerte. {{"demo": "pages/components/alert/TransitionAlerts.js"}} ## Icônes -The `icon` prop allows you to add an icon to the beginning of the alert component. This will override the default icon for the specified severity. +La propriété `icon` vous permet d'ajouter une icône au début du composant d'alerte. Cela remplacera l'icône par défaut pour la sévérité spécifiée. -You can change the default severity to icon mapping with the `iconMapping` prop. This can be defined globally using [theme customization](/customization/globals/#default-props). +Vous pouvez changer la sévérité par défaut pour le mapping d'icône avec la propriété `iconMapping`. Ceci peut être défini globalement en utilisant [la personnalisation du thème](/customization/globals/#default-props). -Setting the icon prop to false will remove the icon altogether. +Définir la propriété `icon` à `false` supprimera complètement l'icône. {{"demo": "pages/components/alert/IconAlerts.js"}} ## Variants -Two additional variants are available – outlined, and filled: +Deux variantes supplémentaires sont disponibles – `outlined` et `filled` : ### Outlined @@ -59,11 +59,11 @@ Two additional variants are available – outlined, and filled: ## Toast -You can use the Snackbar to [display a toast](/components/snackbars/#customized-snackbars) with the Alert. +Vous pouvez utiliser la `Snackbar` pour [afficher un toast](/components/snackbars/#customized-snackbars) avec l'alerte. ## Couleur -The `color` prop will override the default color for the specified severity. +La propriété `color` remplacera la couleur par défaut pour la sévérité spécifiée. {{"demo": "pages/components/alert/ColorAlerts.js"}} @@ -71,8 +71,8 @@ The `color` prop will override the default color for the specified severity. (WAI-ARIA: https://www.w3.org/TR/wai-aria-practices/#alert) -When the component is dynamically displayed, the content is automatically announced by most screen readers. At this time, screen readers do not inform users of alerts that are present when the page loads. +Lorsque le composant est affiché dynamiquement, le contenu est automatiquement annoncé par la plupart des lecteurs d'écran. À l'heure actuelle, les lecteurs d'écran n'informent pas les utilisateurs des alertes présentes lors du chargement de la page. -Using color to add meaning only provides a visual indication, which will not be conveyed to users of assistive technologies such as screen readers. Ensure that information denoted by the color is either obvious from the content itself (for example the visible text), or is included through alternative means, such as additional hidden text. +L'utilisation de la couleur pour ajouter de la signification ne fournit qu'une indication visuelle qui ne sera pas transmise aux utilisateurs de technologies d'assistance telles que les lecteurs d'écran. Assurez-vous que les informations indiquées par la couleur sont soit évidentes à partir du contenu lui-même (par exemple le texte visible), ou est inclus par d'autres moyens, tels que le texte caché supplémentaire. -Actions must have a tab index of 0 so that they can be reached by keyboard-only users. +Les actions doivent avoir un index de tabulation de 0 pour être accessibles aux utilisateurs utilisant uniquement le clavier. diff --git a/docs/src/pages/components/alert/alert-pt.md b/docs/src/pages/components/alert/alert-pt.md index 81566020416309..62102331f645e7 100644 --- a/docs/src/pages/components/alert/alert-pt.md +++ b/docs/src/pages/components/alert/alert-pt.md @@ -1,23 +1,23 @@ --- -title: Alert React component +title: Componente do React Alert components: Alert --- # Alert -

An alert displays a short, important message in a way that attracts the user's attention without interrupting the user's task.

+

Um alerta exibe uma mensagem curta e importante de uma forma que atrai a atenção do usuário sem interromper o que ele estiver fazendo.

-**Note:** This component is not documented in the [Material Design guidelines](https://material.io/), but Material-UI supports it. +**Observação:** Este componente não está documentado nos [guias do Material Design](https://material.io/), mas o Material-UI o suporta. -## Simple alerts +## Alerta simples -The alert offers four severity levels that set a distinctive icon and color. +Este alerta oferece quatro níveis de severidade que definem diferentes ícones e cores. {{"demo": "pages/components/alert/SimpleAlerts.js"}} ## Descrição -You can use the `AlertTitle` component to display a formatted title above the content. +Você pode usar o componente `AlertTitle` para exibir um título formatado acima do conteúdo. {{"demo": "pages/components/alert/DescriptionAlerts.js"}} diff --git a/docs/src/pages/components/alert/alert-zh.md b/docs/src/pages/components/alert/alert-zh.md index 14534cd2a56694..b3c0ca594b2923 100644 --- a/docs/src/pages/components/alert/alert-zh.md +++ b/docs/src/pages/components/alert/alert-zh.md @@ -1,9 +1,9 @@ --- -title: 提醒组件 -components: 提醒 +title: React 提醒组件 +components: Alert --- -# 提醒 +# Alert 提醒

「提醒」是简短且重要的信息,在不影响用户操作的同时能够吸引用户的注意力。

@@ -35,7 +35,7 @@ components: 提醒 {{"demo": "pages/components/alert/TransitionAlerts.js"}} -## Icons(图标) +## Icons 图标 `icon`是指可以在「提醒」组件的开始的地方加一个图标。 以此来改变不同程度「提醒」的默认图标。 @@ -57,9 +57,9 @@ components: 提醒 {{"demo": "pages/components/alert/FilledAlerts.js"}} -## Toast +## Toast(提示) -You can use the Snackbar to [display a toast](/components/snackbars/#customized-snackbars) with the Alert. +你可以使用「消息条」来显示[ 带确认按钮的Toast 提示](/components/snackbars/#customized-snackbars) 。 ## 颜色 @@ -71,8 +71,8 @@ You can use the Snackbar to [display a toast](/components/snackbars/#customized- (WAI-ARIA: https://www.w3.org/TR/wai-aria-practices/#alert) -动态显示组件时,大部分屏幕都会自动显示其内容。 此时,屏幕不会将页面加载时出现的提醒通知给用户。 +动态显示组件时,大部分屏幕都会自动朗读其内容。 此时,屏幕不会将页面加载时出现的提醒通知给用户。 -Using color to add meaning only provides a visual indication, which will not be conveyed to users of assistive technologies such as screen readers. Ensure that information denoted by the color is either obvious from the content itself (for example the visible text), or is included through alternative means, such as additional hidden text. +使用颜色来增加意义只提供了一个视觉指示,而不会传达给用户的辅助技术,如屏幕阅读器。 确保用颜色表示的信息对于内容本身是明显的(例如可见的文本),或者通过其他方法包含进来,例如附加的隐藏文本。 -Actions must have a tab index of 0 so that they can be reached by keyboard-only users. +动作的选项卡索引必须为0,这样只有键盘的用户才能访问它们。 diff --git a/docs/src/pages/components/app-bar/app-bar-zh.md b/docs/src/pages/components/app-bar/app-bar-zh.md index 3b8ce8bb1e9450..8259f06cd7c59d 100644 --- a/docs/src/pages/components/app-bar/app-bar-zh.md +++ b/docs/src/pages/components/app-bar/app-bar-zh.md @@ -3,7 +3,7 @@ title: React App Bar(应用栏)组件 components: AppBar, Toolbar, Menu --- -# App Bar(应用栏) +# App Bar 应用栏

应用栏用来显示与当前屏幕相关的信息和操作。

diff --git a/docs/src/pages/components/autocomplete/autocomplete-aa.md b/docs/src/pages/components/autocomplete/autocomplete-aa.md index 0d62fe04799329..84fb6ab86942bd 100644 --- a/docs/src/pages/components/autocomplete/autocomplete-aa.md +++ b/docs/src/pages/components/autocomplete/autocomplete-aa.md @@ -34,21 +34,31 @@ crwdns104506:0crwdne104506:0 crwdns107773:0crwdne107773:0 crwdns107775:0crwdne107775:0 -crwdns107777:0crwdne107777:0 +crwdns109699:0crwdne109699:0 crwdns107779:0crwdne107779:0 +### crwdns109701:0crwdne109701:0 + +crwdns109703:0crwdne109703:0 crwdns109705:0crwdne109705:0 + +crwdns109707:0crwdne109707:0 + +crwdns109709:0crwdne109709:0 + +crwdns109711:0crwdne109711:0 + ## crwdns104514:0crwdne104514:0 -crwdns107781:0crwdne107781:0 +crwdns109713:0crwdne109713:0 ## crwdns104518:0crwdne104518:0 -crwdns107783:0crwdne107783:0 +crwdns109715:0crwdne109715:0 ## `crwdns104522:0crwdne104522:0` -crwdns107785:0crwdne107785:0 crwdns107787:0crwdne107787:0 crwdns107789:0crwdne107789:0 +crwdns109717:0crwdne109717:0 crwdns109719:0crwdne109719:0 crwdns109721:0crwdne109721:0 ```jsx crwdns104530:0crwdne104530:0 @@ -56,73 +66,73 @@ crwdns104530:0crwdne104530:0 - crwdns105108:0crwdne105108:0 -crwdns107791:0crwdne107791:0 +crwdns109723:0crwdne109723:0 -### crwdns104950:0crwdne104950:0 +### crwdns109725:0crwdne109725:0 -crwdns107793:0crwdne107793:0 +crwdns109727:0crwdne109727:0 -crwdns107795:0crwdne107795:0 +crwdns109729:0crwdne109729:0 ## crwdns104542:0crwdne104542:0 -crwdns107797:0crwdne107797:0 +crwdns109731:0crwdne109731:0 -### crwdns104546:0crwdne104546:0 +### crwdns109733:0crwdne109733:0 -crwdns107799:0crwdne107799:0 +crwdns109735:0crwdne109735:0 -crwdns107801:0crwdne107801:0 +crwdns109737:0crwdne109737:0 -crwdns107803:0crwdne107803:0 +crwdns109739:0crwdne109739:0 > crwdns104960:0crwdne104960:0 ## crwdns104554:0crwdne104554:0 -crwdns107805:0crwdne107805:0 +crwdns109741:0crwdne109741:0 -crwdns107807:0crwdne107807:0 +crwdns109743:0crwdne109743:0 -### crwdns104560:0crwdne104560:0 +### crwdns109745:0crwdne109745:0 -crwdns107809:0crwdne107809:0 +crwdns109747:0crwdne109747:0 -crwdns107811:0crwdne107811:0 +crwdns109749:0crwdne109749:0 -### crwdns104566:0crwdne104566:0 +### crwdns109751:0crwdne109751:0 -crwdns107813:0crwdne107813:0 +crwdns109753:0crwdne109753:0 ## crwdns106429:0crwdne106429:0 -crwdns107815:0crwdne107815:0 crwdns107817:0crwdne107817:0 +crwdns109755:0crwdne109755:0 crwdns109757:0crwdne109757:0 -crwdns107819:0crwdne107819:0 +crwdns109759:0crwdne109759:0 ## crwdns106437:0crwdne106437:0 -crwdns107821:0crwdne107821:0 +crwdns109761:0crwdne109761:0 -crwdns107823:0crwdne107823:0 +crwdns109763:0crwdne109763:0 -crwdns107825:0crwdne107825:0 +crwdns109765:0crwdne109765:0 ## crwdns106445:0crwdne106445:0 -crwdns107827:0crwdne107827:0 +crwdns109767:0crwdne109767:0 -crwdns107829:0crwdne107829:0 +crwdns109769:0crwdne109769:0 ## crwdns106451:0crwdne106451:0 -crwdns107831:0crwdne107831:0 crwdns107833:0crwdne107833:0 +crwdns109771:0crwdne109771:0 crwdns109773:0crwdne109773:0 ```js crwdns104588:0{ createFilterOptions }crwdne104588:0 ``` -crwdns107835:0crwdne107835:0 +crwdns109775:0crwdne109775:0 1. crwdns104592:0[optional]crwdne104592:0 - crwdns104594:0[optional]crwdne104594:0 crwdns104596:0crwdne104596:0 @@ -130,18 +140,19 @@ crwdns107835:0crwdne107835:0 - crwdns104602:0[optional]crwdne104602:0 - crwdns104604:0[optional]crwdne104604:0 - crwdns104606:0[optional]crwdne104606:0 crwdns104608:0crwdne104608:0 + - crwdns109191:0[optional]crwdne109191:0 crwdns109193:0crwdne109193:0 crwdns109195:0crwdne109195:0 crwdns109197:0crwdne109197:0 -crwdns107837:0crwdne107837:0 +crwdns109777:0crwdne109777:0 ```js crwdns104612:0{filterOptions}crwdne104612:0 ``` -crwdns107839:0crwdne107839:0 +crwdns109779:0crwdne109779:0 -### crwdns104994:0crwdne104994:0 +### crwdns109781:0crwdne109781:0 -crwdns107841:0crwdne107841:0 crwdns107843:0crwdne107843:0 +crwdns109783:0crwdne109783:0 crwdns109785:0crwdne109785:0 ```jsx crwdns104620:0{ inputValue }crwdnd104620:0{filterOptions}crwdne104620:0 @@ -149,19 +160,19 @@ crwdns104620:0{ inputValue }crwdnd104620:0{filterOptions}crwdne104620:0 ## crwdns106467:0crwdne106467:0 -crwdns107845:0crwdne107845:0 crwdns107847:0crwdne107847:0 +crwdns109787:0crwdne109787:0 crwdns109789:0crwdne109789:0 -crwdns107849:0crwdne107849:0 +crwdns109791:0crwdne109791:0 ## crwdns106475:0crwdne106475:0 -### crwdns107851:0crwdne107851:0 +### crwdns109793:0crwdne109793:0 -crwdns107853:0crwdne107853:0 crwdns107855:0crwdne107855:0 +crwdns109795:0crwdne109795:0 crwdns109797:0crwdne109797:0 -crwdns107857:0crwdne107857:0 +crwdns109799:0crwdne109799:0 -crwdns107859:0crwdne107859:0 crwdns107861:0crwdne107861:0 +crwdns109801:0crwdne109801:0 crwdns109803:0crwdne109803:0 - crwdns107863:0crwdne107863:0 crwdns107865:0crwdne107865:0 crwdns107867:0crwdne107867:0 - crwdns107869:0crwdne107869:0 @@ -170,16 +181,16 @@ crwdns107859:0crwdne107859:0 crwdns107861:0crwdne107861:0 autoComplete: 'new-password', }}crwdne107871:0 -### crwdns107873:0crwdne107873:0 +### crwdns109805:0crwdne109805:0 -crwdns107875:0crwdne107875:0 crwdns107877:0crwdne107877:0 +crwdns109807:0crwdne109807:0 crwdns109809:0crwdne109809:0 -### crwdns107879:0crwdne107879:0 +### crwdns109811:0crwdne109811:0 -crwdns107881:0crwdne107881:0 crwdns107883:0crwdne107883:0 crwdns107885:0crwdne107885:0 +crwdns109813:0crwdne109813:0 crwdns109815:0crwdne109815:0 crwdns109817:0crwdne109817:0 ## crwdns106481:0crwdne106481:0 -crwdns107887:0crwdne107887:0 +crwdns109819:0crwdne109819:0 -crwdns107889:0crwdne107889:0 crwdns107891:0crwdne107891:0 \ No newline at end of file +crwdns109821:0crwdne109821:0 crwdns109823:0crwdne109823:0 \ No newline at end of file diff --git a/docs/src/pages/components/autocomplete/autocomplete-de.md b/docs/src/pages/components/autocomplete/autocomplete-de.md index c794d4d9342a2e..6a56fbdb8138af 100644 --- a/docs/src/pages/components/autocomplete/autocomplete-de.md +++ b/docs/src/pages/components/autocomplete/autocomplete-de.md @@ -34,10 +34,20 @@ Wählen Sie ein Land aus 248. Set `freeSolo` to true so the textbox can contain any arbitrary value. The prop is designed to cover the primary use case of a search box with suggestions, e.g. Google search. -However, if you intend to use it for a [combo box](#combo-box) like experience (an enhanced version of a select element) we recommend setting `selectOnFocus`. +However, if you intend to use it for a [combo box](#combo-box) like experience (an enhanced version of a select element) we recommend setting `selectOnFocus` (it helps the user clearning the selected value). {{"demo": "pages/components/autocomplete/FreeSolo.js"}} +### Helper message + +Sometimes you want to make explicit to the user that he/she can add whatever value he/she wants. The following demo adds a last option: `Add "YOUR SEARCH"`. + +{{"demo": "pages/components/autocomplete/FreeSoloCreateOption.js"}} + +You could also display a dialog when the user wants to add a new value. + +{{"demo": "pages/components/autocomplete/FreeSoloCreateOptionDialog.js"}} + ## Grouped {{"demo": "pages/components/autocomplete/Grouped.js"}} @@ -68,29 +78,29 @@ Head to the [Customized Autocomplete](#customized-autocomplete) section for a cu {{"demo": "pages/components/autocomplete/Asynchronous.js"}} -### Google Maps Ort +### Google Maps place -Eine angepasste Oberfläche für Google Maps Places Autovervollständigung. +A customized UI for Google Maps Places Autocomplete. {{"demo": "pages/components/autocomplete/GoogleMaps.js"}} -Für diese Demo müssen wir die [Google Maps JavaScript](https://developers.google.com/maps/documentation/javascript/tutorial) API laden. +For this demo, we need to load the [Google Maps JavaScript](https://developers.google.com/maps/documentation/javascript/tutorial) API. > ⚠️ Bevor Sie die Google Maps JavaScript-API verwenden können, müssen Sie sich anmelden und ein Abrechnungskonto erstellen. ## Mehrere Werte -Auch als Tags bekannt, darf der Benutzer mehr als einen Wert eingeben. +Also known as tags, the user is allowed to enter more than one value. {{"demo": "pages/components/autocomplete/Tags.js"}} -### Feste Optionen +### Fixed options -Falls Sie bestimmte Tags sperren müssen, damit sie nicht in der Schnittstelle entfernt werden können, können Sie die Chips deaktivieren. +In the event that you need to lock certain tag so that they can't be removed in the interface, you can set the chips disabled. {{"demo": "pages/components/autocomplete/FixedTags.js"}} -### Kontrollkästchen +### Checkboxes {{"demo": "pages/components/autocomplete/CheckboxesTags.js"}} @@ -102,7 +112,7 @@ Fancy smaller inputs? Verwenden Sie die `size` Prop. ## Angepasste Autovervollständigung -Diese Demo reproduziert die Label-Auswahl von GitHub: +This demo reproduces the GitHub's label picker: {{"demo": "pages/components/autocomplete/GitHubLabel.js"}} @@ -116,13 +126,13 @@ The following demo relies on [autosuggest-highlight](https://github.com/moroshko ## Benutzerderfinierter Filter -The component exposes a factory to create a filter method that can provided to the `filerOption` prop. Sie können es verwenden, um das Standard-Filterverhalten der Option zu ändern. +The component exposes a factory to create a filter method that can provided to the `filerOption` prop. You can use it to change the default option filter behavior. ```js import { createFilterOptions } from '@material-ui/lab/Autocomplete'; ``` -Es unterstützt die folgenden Optionen: +It supports the following options: 1. `config` (*Object* [optional]): - `config.ignoreAccents` (*Boolean* [optional]): Defaults to `true`. Remove diacritics. @@ -130,8 +140,9 @@ Es unterstützt die folgenden Optionen: - `config.matchFrom` (*'any' | 'start'* [optional]): Defaults to `'any'`. - `config.stringify` (*Func* [optional]): Defaults to `JSON.stringify`. - `config.trim ` (*Boolean* [optional]): Standardeinstellung ist `false`. Abschließende Leerzeichen entfernen. + - `config.limit` (*Number* [optional]): Default to null. Limit the number of suggested options to be shown. For example, if `config.limit` is `100`, only the first `100` matching options are shown. It can be useful if a lot of options match and virtualization wasn't set up. -In der folgenden Demo müssen die Optionen mit dem Abfragepräfix beginnen: +In the following demo, the options need to start with the query prefix: ```js const filterOptions = createFilterOptions({ @@ -159,7 +170,7 @@ const filterOptions = (options, { inputValue }) => ## Virtualisierung -Suche innerhalb von 10.000 zufällig generierten Optionen. Die Liste ist virtualisiert dank [react-window](https://github.com/bvaughn/react-window). +Search within 10,000 randomly generated options. The list is virtualized thanks to [react-window](https://github.com/bvaughn/react-window). {{"demo": "pages/components/autocomplete/Virtualize.js"}} @@ -167,11 +178,11 @@ Suche innerhalb von 10.000 zufällig generierten Optionen. Die Liste ist virtual ### autocomplete/autofill -Die Browser haben Heuristiken, um den Benutzern zu helfen, die Formulareingaben auszufüllen. Es kann jedoch die UX der Komponente negativ beeinflussen. +The browsers have heuristics to help the users fill the form inputs. However, it can harm the UX of the component. By default, the component disable the **autocomplete** feature (remembering what the user has typed for a given field in a previous session) with the `autoComplete="off"` attribute. -Zusätzlich zur Speicherung der eingegebenen Werte kann der Browser aber auch **Autofill** Vorschläge vorschlagen (gespeichertes Login, Adresse oder Zahlungsinformationen). Falls Sie die automatische Füllung vermeiden möchten, können Sie Folgendes versuchen: +However, in addition to remembering past entered values, the browser might also propose **autofill** suggestions (saved login, address, or payment details). In the event you want the avoid autofill, you can try the following: - Name the input without leaking any information the browser can use. e.g. `id="field1"` instead of `id="country"`. Wenn Sie die ID leer lassen, verwendet die Komponente eine zufällige ID. - Setze `autoComplete="neues Passwort"`: @@ -186,14 +197,14 @@ Zusätzlich zur Speicherung der eingegebenen Werte kann der Browser aber auch ** ### iOS VoiceOver -VoiceOver auf iOS Safari unterstützt das `aria-owns` Attribut nicht sehr gut. You can work around the issue with the `disablePortal` prop. +VoiceOver on iOS Safari doesn't support the `aria-owns` attribute very well. You can work around the issue with the `disablePortal` prop. ### TypeScript -To fully take advantage of type inference, you need to set the `multiple` prop to `undefined`, `false` or `true`. See [this discussion](https://github.com/mui-org/material-ui/pull/18854#discussion_r364215153) for more details. TypeScript könnte diesen Fehler in Zukunft lösen. +To fully take advantage of type inference, you need to set the `multiple` prop to `undefined`, `false` or `true`. See [this discussion](https://github.com/mui-org/material-ui/pull/18854#discussion_r364215153) for more details. TypeScript might solve this bug in the future. ## Barrierefreiheit (WAI-ARIA: https://www.w3.org/TR/wai-aria-practices/#combobox) -Wir empfehlen die Verwendung eines Labels für die Textbox. Die Komponente implementiert die WAI-ARIA Autorenpraktiken. \ No newline at end of file +We encourage the usage of a label for the textbox. The component implements the WAI-ARIA authoring practices. \ No newline at end of file diff --git a/docs/src/pages/components/autocomplete/autocomplete-es.md b/docs/src/pages/components/autocomplete/autocomplete-es.md index 26cb9a8640df2a..3254a93b2d2a7f 100644 --- a/docs/src/pages/components/autocomplete/autocomplete-es.md +++ b/docs/src/pages/components/autocomplete/autocomplete-es.md @@ -34,10 +34,20 @@ Choose one country between 248. Set `freeSolo` to true so the textbox can contain any arbitrary value. The prop is designed to cover the primary use case of a search box with suggestions, e.g. Google search. -However, if you intend to use it for a [combo box](#combo-box) like experience (an enhanced version of a select element) we recommend setting `selectOnFocus`. +However, if you intend to use it for a [combo box](#combo-box) like experience (an enhanced version of a select element) we recommend setting `selectOnFocus` (it helps the user clearning the selected value). {{"demo": "pages/components/autocomplete/FreeSolo.js"}} +### Helper message + +Sometimes you want to make explicit to the user that he/she can add whatever value he/she wants. The following demo adds a last option: `Add "YOUR SEARCH"`. + +{{"demo": "pages/components/autocomplete/FreeSoloCreateOption.js"}} + +You could also display a dialog when the user wants to add a new value. + +{{"demo": "pages/components/autocomplete/FreeSoloCreateOptionDialog.js"}} + ## Grouped {{"demo": "pages/components/autocomplete/Grouped.js"}} @@ -90,7 +100,7 @@ In the event that you need to lock certain tag so that they can't be removed in {{"demo": "pages/components/autocomplete/FixedTags.js"}} -### Casillas de Verificación +### Checkboxes {{"demo": "pages/components/autocomplete/CheckboxesTags.js"}} @@ -130,6 +140,7 @@ It supports the following options: - `config.matchFrom` (*'any' | 'start'* [optional]): Defaults to `'any'`. - `config.stringify` (*Func* [optional]): Defaults to `JSON.stringify`. - `config.trim` (*Boolean* [optional]): Default `false`. Remove trailing spaces. + - `config.limit` (*Number* [optional]): Default to null. Limit the number of suggested options to be shown. For example, if `config.limit` is `100`, only the first `100` matching options are shown. It can be useful if a lot of options match and virtualization wasn't set up. In the following demo, the options need to start with the query prefix: diff --git a/docs/src/pages/components/autocomplete/autocomplete-fr.md b/docs/src/pages/components/autocomplete/autocomplete-fr.md index 68631a95a3f15d..ef33cda22d511d 100644 --- a/docs/src/pages/components/autocomplete/autocomplete-fr.md +++ b/docs/src/pages/components/autocomplete/autocomplete-fr.md @@ -34,10 +34,20 @@ Choose one country between 248. Set `freeSolo` to true so the textbox can contain any arbitrary value. The prop is designed to cover the primary use case of a search box with suggestions, e.g. Google search. -However, if you intend to use it for a [combo box](#combo-box) like experience (an enhanced version of a select element) we recommend setting `selectOnFocus`. +However, if you intend to use it for a [combo box](#combo-box) like experience (an enhanced version of a select element) we recommend setting `selectOnFocus` (it helps the user clearning the selected value). {{"demo": "pages/components/autocomplete/FreeSolo.js"}} +### Helper message + +Sometimes you want to make explicit to the user that he/she can add whatever value he/she wants. The following demo adds a last option: `Add "YOUR SEARCH"`. + +{{"demo": "pages/components/autocomplete/FreeSoloCreateOption.js"}} + +You could also display a dialog when the user wants to add a new value. + +{{"demo": "pages/components/autocomplete/FreeSoloCreateOptionDialog.js"}} + ## Grouped {{"demo": "pages/components/autocomplete/Grouped.js"}} @@ -90,7 +100,7 @@ In the event that you need to lock certain tag so that they can't be removed in {{"demo": "pages/components/autocomplete/FixedTags.js"}} -### Cases à cocher +### Checkboxes {{"demo": "pages/components/autocomplete/CheckboxesTags.js"}} @@ -130,6 +140,7 @@ It supports the following options: - `config.matchFrom` (*'any' | 'start'* [optional]): Defaults to `'any'`. - `config.stringify` (*Func* [optional]): Defaults to `JSON.stringify`. - `config.trim` (*Boolean* [optional]): Valeur par défaut `false`. Remove trailing spaces. + - `config.limit` (*Number* [optional]): Default to null. Limit the number of suggested options to be shown. For example, if `config.limit` is `100`, only the first `100` matching options are shown. It can be useful if a lot of options match and virtualization wasn't set up. In the following demo, the options need to start with the query prefix: diff --git a/docs/src/pages/components/autocomplete/autocomplete-ja.md b/docs/src/pages/components/autocomplete/autocomplete-ja.md index 6c39226286bd8c..ed79976262e8bb 100644 --- a/docs/src/pages/components/autocomplete/autocomplete-ja.md +++ b/docs/src/pages/components/autocomplete/autocomplete-ja.md @@ -34,10 +34,20 @@ Choose one country between 248. Set `freeSolo` to true so the textbox can contain any arbitrary value. The prop is designed to cover the primary use case of a search box with suggestions, e.g. Google search. -However, if you intend to use it for a [combo box](#combo-box) like experience (an enhanced version of a select element) we recommend setting `selectOnFocus`. +However, if you intend to use it for a [combo box](#combo-box) like experience (an enhanced version of a select element) we recommend setting `selectOnFocus` (it helps the user clearning the selected value). {{"demo": "pages/components/autocomplete/FreeSolo.js"}} +### Helper message + +Sometimes you want to make explicit to the user that he/she can add whatever value he/she wants. The following demo adds a last option: `Add "YOUR SEARCH"`. + +{{"demo": "pages/components/autocomplete/FreeSoloCreateOption.js"}} + +You could also display a dialog when the user wants to add a new value. + +{{"demo": "pages/components/autocomplete/FreeSoloCreateOptionDialog.js"}} + ## Grouped {{"demo": "pages/components/autocomplete/Grouped.js"}} @@ -90,7 +100,7 @@ In the event that you need to lock certain tag so that they can't be removed in {{"demo": "pages/components/autocomplete/FixedTags.js"}} -### チェックボックス +### Checkboxes {{"demo": "pages/components/autocomplete/CheckboxesTags.js"}} @@ -130,6 +140,7 @@ It supports the following options: - `config.matchFrom` (*'any' | 'start'* [optional]): Defaults to `'any'`. - `config.stringify` (*Func* [optional]): Defaults to `JSON.stringify`. - `config.trim` (*ブール値* [任意]): デフォルト値 `false`. Remove trailing spaces. + - `config.limit` (*Number* [optional]): Default to null. Limit the number of suggested options to be shown. For example, if `config.limit` is `100`, only the first `100` matching options are shown. It can be useful if a lot of options match and virtualization wasn't set up. In the following demo, the options need to start with the query prefix: diff --git a/docs/src/pages/components/autocomplete/autocomplete-pt.md b/docs/src/pages/components/autocomplete/autocomplete-pt.md index bbfb388a8562fb..0a0c5f6be5fd56 100644 --- a/docs/src/pages/components/autocomplete/autocomplete-pt.md +++ b/docs/src/pages/components/autocomplete/autocomplete-pt.md @@ -34,10 +34,20 @@ Choose one country between 248. Set `freeSolo` to true so the textbox can contain any arbitrary value. The prop is designed to cover the primary use case of a search box with suggestions, e.g. Google search. -However, if you intend to use it for a [combo box](#combo-box) like experience (an enhanced version of a select element) we recommend setting `selectOnFocus`. +However, if you intend to use it for a [combo box](#combo-box) like experience (an enhanced version of a select element) we recommend setting `selectOnFocus` (it helps the user clearning the selected value). {{"demo": "pages/components/autocomplete/FreeSolo.js"}} +### Helper message + +Sometimes you want to make explicit to the user that he/she can add whatever value he/she wants. The following demo adds a last option: `Add "YOUR SEARCH"`. + +{{"demo": "pages/components/autocomplete/FreeSoloCreateOption.js"}} + +You could also display a dialog when the user wants to add a new value. + +{{"demo": "pages/components/autocomplete/FreeSoloCreateOptionDialog.js"}} + ## Grouped {{"demo": "pages/components/autocomplete/Grouped.js"}} @@ -90,13 +100,13 @@ In the event that you need to lock certain tag so that they can't be removed in {{"demo": "pages/components/autocomplete/FixedTags.js"}} -### Caixas de Seleção +### Checkboxes {{"demo": "pages/components/autocomplete/CheckboxesTags.js"}} ## Tamanhos -Fancy smaller inputs? Use a propriedade `size`. +Gosta mais de campos de texto menores? Use a propriedade `size`. {{"demo": "pages/components/autocomplete/Sizes.js"}} @@ -130,6 +140,7 @@ It supports the following options: - `config.matchFrom` (*'any' | 'start'* [optional]): Defaults to `'any'`. - `config.stringify` (*Func* [optional]): Defaults to `JSON.stringify`. - `config.trim` (*Boolean* [opcional]): Padrão `false`. Remove trailing spaces. + - `config.limit` (*Number* [optional]): Default to null. Limit the number of suggested options to be shown. For example, if `config.limit` is `100`, only the first `100` matching options are shown. It can be useful if a lot of options match and virtualization wasn't set up. In the following demo, the options need to start with the query prefix: diff --git a/docs/src/pages/components/autocomplete/autocomplete-ru.md b/docs/src/pages/components/autocomplete/autocomplete-ru.md index 38e83535bed046..c4e3566dfee5c0 100644 --- a/docs/src/pages/components/autocomplete/autocomplete-ru.md +++ b/docs/src/pages/components/autocomplete/autocomplete-ru.md @@ -34,10 +34,20 @@ components: TextField, Popper, Autocomplete Set `freeSolo` to true so the textbox can contain any arbitrary value. The prop is designed to cover the primary use case of a search box with suggestions, e.g. Google search. -However, if you intend to use it for a [combo box](#combo-box) like experience (an enhanced version of a select element) we recommend setting `selectOnFocus`. +However, if you intend to use it for a [combo box](#combo-box) like experience (an enhanced version of a select element) we recommend setting `selectOnFocus` (it helps the user clearning the selected value). {{"demo": "pages/components/autocomplete/FreeSolo.js"}} +### Helper message + +Sometimes you want to make explicit to the user that he/she can add whatever value he/she wants. The following demo adds a last option: `Add "YOUR SEARCH"`. + +{{"demo": "pages/components/autocomplete/FreeSoloCreateOption.js"}} + +You could also display a dialog when the user wants to add a new value. + +{{"demo": "pages/components/autocomplete/FreeSoloCreateOptionDialog.js"}} + ## Сгруппированные {{"demo": "pages/components/autocomplete/Grouped.js"}} @@ -68,7 +78,7 @@ Head to the [Customized Autocomplete](#customized-autocomplete) section for a cu {{"demo": "pages/components/autocomplete/Asynchronous.js"}} -### Места Google Maps +### Google Maps place A customized UI for Google Maps Places Autocomplete. @@ -84,13 +94,13 @@ Also known as tags, the user is allowed to enter more than one value. {{"demo": "pages/components/autocomplete/Tags.js"}} -### Фиксированные опции +### Fixed options In the event that you need to lock certain tag so that they can't be removed in the interface, you can set the chips disabled. {{"demo": "pages/components/autocomplete/FixedTags.js"}} -### Чекбоксы +### Checkboxes {{"demo": "pages/components/autocomplete/CheckboxesTags.js"}} @@ -130,6 +140,7 @@ It supports the following options: - `config.matchFrom` (*'any' | 'start'* [optional]): Defaults to `'any'`. - `config.stringify` (*Func* [optional]): Defaults to `JSON.stringify`. - `config.trim` (*Boolean* [optional]): По умолчанию - `false`. Remove trailing spaces. + - `config.limit` (*Number* [optional]): Default to null. Limit the number of suggested options to be shown. For example, if `config.limit` is `100`, only the first `100` matching options are shown. It can be useful if a lot of options match and virtualization wasn't set up. In the following demo, the options need to start with the query prefix: diff --git a/docs/src/pages/components/autocomplete/autocomplete-zh.md b/docs/src/pages/components/autocomplete/autocomplete-zh.md index f98d0ca93422e9..507861295a4371 100644 --- a/docs/src/pages/components/autocomplete/autocomplete-zh.md +++ b/docs/src/pages/components/autocomplete/autocomplete-zh.md @@ -3,7 +3,7 @@ title: React Autocomplete(自动补全)组件 components: TextField, Popper, Autocomplete --- -# Autocomplete(自动补全) +# Autocomplete 自动补全

自动补全是一个通过一组建议选项来帮助用户输入的普通文本输入框。

@@ -34,10 +34,20 @@ components: TextField, Popper, Autocomplete Set `freeSolo` to true so the textbox can contain any arbitrary value. The prop is designed to cover the primary use case of a search box with suggestions, e.g. Google search. -However, if you intend to use it for a [combo box](#combo-box) like experience (an enhanced version of a select element) we recommend setting `selectOnFocus`. +However, if you intend to use it for a [combo box](#combo-box) like experience (an enhanced version of a select element) we recommend setting `selectOnFocus` (it helps the user clearning the selected value). {{"demo": "pages/components/autocomplete/FreeSolo.js"}} +### Helper message + +Sometimes you want to make explicit to the user that he/she can add whatever value he/she wants. The following demo adds a last option: `Add "YOUR SEARCH"`. + +{{"demo": "pages/components/autocomplete/FreeSoloCreateOption.js"}} + +You could also display a dialog when the user wants to add a new value. + +{{"demo": "pages/components/autocomplete/FreeSoloCreateOptionDialog.js"}} + ## 分组 {{"demo": "pages/components/autocomplete/Grouped.js"}} @@ -58,7 +68,7 @@ import useAutocomplete from '@material-ui/lab/useAutocomplete'; {{"demo": "pages/components/autocomplete/UseAutocomplete.js", "defaultCodeOpen": false}} -### 自定义钩子 +### Customized hook {{"demo": "pages/components/autocomplete/CustomizedHook.js"}} @@ -76,21 +86,21 @@ A customized UI for Google Maps Places Autocomplete. For this demo, we need to load the [Google Maps JavaScript](https://developers.google.com/maps/documentation/javascript/tutorial) API. -> ⚠️ Before you can start using the Google Maps JavaScript API, you must sign up and create a billing account. +> 在你开始使用谷歌地图javascript API之前,你需要创建一个帐户 (用于使用谷歌地图api). ## Multiple values(多重值) -这也称为标签,允许用户输入多个值。 +Also known as tags, the user is allowed to enter more than one value. {{"demo": "pages/components/autocomplete/Tags.js"}} -### 固定选项 +### Fixed options In the event that you need to lock certain tag so that they can't be removed in the interface, you can set the chips disabled. {{"demo": "pages/components/autocomplete/FixedTags.js"}} -### Checkboxes(复选框) +### Checkboxes {{"demo": "pages/components/autocomplete/CheckboxesTags.js"}} @@ -102,7 +112,7 @@ Fancy smaller inputs? Use the `size` prop. ## 定制的自动完成组件 -该演示再现了GitHub的标签选择器: +This demo reproduces the GitHub's label picker: {{"demo": "pages/components/autocomplete/GitHubLabel.js"}} @@ -130,6 +140,7 @@ It supports the following options: - `config.matchFrom` (*'any' | 'start'* [optional]): Defaults to `'any'`. - `config.stringify` (*Func* [optional]): Defaults to `JSON.stringify`. - `config.trim` (*Boolean* [optional]): 默认值为`false`。 Remove trailing spaces. + - `config.limit` (*Number* [optional]): Default to null. Limit the number of suggested options to be shown. For example, if `config.limit` is `100`, only the first `100` matching options are shown. It can be useful if a lot of options match and virtualization wasn't set up. In the following demo, the options need to start with the query prefix: diff --git a/docs/src/pages/components/avatars/avatars-aa.md b/docs/src/pages/components/avatars/avatars-aa.md index 56ae6f508d6eba..75d441e106060c 100644 --- a/docs/src/pages/components/avatars/avatars-aa.md +++ b/docs/src/pages/components/avatars/avatars-aa.md @@ -42,7 +42,7 @@ crwdns106575:0crwdne106575:0 crwdns106579:0crwdne106579:0 - crwdns106545:0crwdne106545:0 -- crwdns106547:0crwdne106547:0 +- crwdns109189:0crwdne109189:0 - crwdns106549:0crwdne106549:0 crwdns106581:0crwdne106581:0 diff --git a/docs/src/pages/components/avatars/avatars-de.md b/docs/src/pages/components/avatars/avatars-de.md index 5b6f5edf9ed236..dbc9a1c7f38e1f 100644 --- a/docs/src/pages/components/avatars/avatars-de.md +++ b/docs/src/pages/components/avatars/avatars-de.md @@ -42,7 +42,7 @@ If you need square or rounded avatars, use the `variant` prop. If there is an error loading the avatar image, the component falls back to an alternative in the following order: - the provided children -- the first letter of tha `alt` text +- the first letter of the `alt` text - ein generisches Avatar-Symbol {{"demo": "pages/components/avatars/FallbackAvatars.js"}} diff --git a/docs/src/pages/components/avatars/avatars-es.md b/docs/src/pages/components/avatars/avatars-es.md index 285cd2a5dada06..37e4d6b70fe60d 100644 --- a/docs/src/pages/components/avatars/avatars-es.md +++ b/docs/src/pages/components/avatars/avatars-es.md @@ -42,7 +42,7 @@ If you need square or rounded avatars, use the `variant` prop. If there is an error loading the avatar image, the component falls back to an alternative in the following order: - the provided children -- the first letter of tha `alt` text +- the first letter of the `alt` text - a generic avatar icon {{"demo": "pages/components/avatars/FallbackAvatars.js"}} diff --git a/docs/src/pages/components/avatars/avatars-fr.md b/docs/src/pages/components/avatars/avatars-fr.md index acb1a490dd0bd9..ff8141543e207c 100644 --- a/docs/src/pages/components/avatars/avatars-fr.md +++ b/docs/src/pages/components/avatars/avatars-fr.md @@ -42,7 +42,7 @@ If you need square or rounded avatars, use the `variant` prop. If there is an error loading the avatar image, the component falls back to an alternative in the following order: - the provided children -- the first letter of tha `alt` text +- the first letter of the `alt` text - a generic avatar icon {{"demo": "pages/components/avatars/FallbackAvatars.js"}} diff --git a/docs/src/pages/components/avatars/avatars-ja.md b/docs/src/pages/components/avatars/avatars-ja.md index 0f3c5ba33a88c3..265feb88d06fa3 100644 --- a/docs/src/pages/components/avatars/avatars-ja.md +++ b/docs/src/pages/components/avatars/avatars-ja.md @@ -42,7 +42,7 @@ If you need square or rounded avatars, use the `variant` prop. If there is an error loading the avatar image, the component falls back to an alternative in the following order: - the provided children -- the first letter of tha `alt` text +- the first letter of the `alt` text - a generic avatar icon {{"demo": "pages/components/avatars/FallbackAvatars.js"}} diff --git a/docs/src/pages/components/avatars/avatars-pt.md b/docs/src/pages/components/avatars/avatars-pt.md index 1f43a2758b7da2..9af303355765aa 100644 --- a/docs/src/pages/components/avatars/avatars-pt.md +++ b/docs/src/pages/components/avatars/avatars-pt.md @@ -42,7 +42,7 @@ If you need square or rounded avatars, use the `variant` prop. If there is an error loading the avatar image, the component falls back to an alternative in the following order: - the provided children -- the first letter of tha `alt` text +- the first letter of the `alt` text - a generic avatar icon {{"demo": "pages/components/avatars/FallbackAvatars.js"}} diff --git a/docs/src/pages/components/avatars/avatars-ru.md b/docs/src/pages/components/avatars/avatars-ru.md index eebaf7fb05d096..1dfa8a51f88dbc 100644 --- a/docs/src/pages/components/avatars/avatars-ru.md +++ b/docs/src/pages/components/avatars/avatars-ru.md @@ -42,7 +42,7 @@ components: Avatar, AvatarGroup, Badge If there is an error loading the avatar image, the component falls back to an alternative in the following order: - the provided children -- the first letter of tha `alt` text +- the first letter of the `alt` text - a generic avatar icon {{"demo": "pages/components/avatars/FallbackAvatars.js"}} diff --git a/docs/src/pages/components/avatars/avatars-zh.md b/docs/src/pages/components/avatars/avatars-zh.md index 3b60ad363ea68e..f62197b56ed468 100644 --- a/docs/src/pages/components/avatars/avatars-zh.md +++ b/docs/src/pages/components/avatars/avatars-zh.md @@ -3,7 +3,7 @@ title: React Avatar(头像)组件 components: Avatar, AvatarGroup, Badge --- -# Avatar (头像) +# Avatar 头像

在整个 material design 中,无论是在表格中还是到对话框菜单中,都可以找到使用头像的身影。

@@ -42,7 +42,7 @@ If you need square or rounded avatars, use the `variant` prop. If there is an error loading the avatar image, the component falls back to an alternative in the following order: - the provided children -- the first letter of tha `alt` text +- the first letter of the `alt` text - a generic avatar icon {{"demo": "pages/components/avatars/FallbackAvatars.js"}} diff --git a/docs/src/pages/components/backdrop/backdrop-ru.md b/docs/src/pages/components/backdrop/backdrop-ru.md index cd5748138d39cc..a131f0c05f0573 100644 --- a/docs/src/pages/components/backdrop/backdrop-ru.md +++ b/docs/src/pages/components/backdrop/backdrop-ru.md @@ -1,9 +1,9 @@ --- title: 'Затемнение: компонент React' -components: Затемнение +components: Backdrop --- -# Затемнение +# Backdrop (Затемнение)

Затемнение предназначено для акцентирования внимания пользователя на определенном элементе интерфейса.

diff --git a/docs/src/pages/components/backdrop/backdrop-zh.md b/docs/src/pages/components/backdrop/backdrop-zh.md index 2d5c6e20ea908d..bfea124bbcb772 100644 --- a/docs/src/pages/components/backdrop/backdrop-zh.md +++ b/docs/src/pages/components/backdrop/backdrop-zh.md @@ -1,9 +1,9 @@ --- title: 覆盖 React 组件 -components: 背景板(Backdrop) +components: Backdrop --- -# 背景板(Backdrop) +# Backdrop 背景板

Backdrop 组件用于提供对特定元素或其部分的强调。

diff --git a/docs/src/pages/components/badges/badges-zh.md b/docs/src/pages/components/badges/badges-zh.md index 18841dc11c346b..5466679e74740f 100644 --- a/docs/src/pages/components/badges/badges-zh.md +++ b/docs/src/pages/components/badges/badges-zh.md @@ -3,7 +3,7 @@ title: React Badge(徽章)组件 components: Badge --- -# Badge(徽章) +# Badge 徽章

徽章会在其子项的右上角生成一个小徽章。

diff --git a/docs/src/pages/components/bottom-navigation/bottom-navigation-zh.md b/docs/src/pages/components/bottom-navigation/bottom-navigation-zh.md index 7ba43fc2674f1f..5ba729002552d9 100644 --- a/docs/src/pages/components/bottom-navigation/bottom-navigation-zh.md +++ b/docs/src/pages/components/bottom-navigation/bottom-navigation-zh.md @@ -3,13 +3,13 @@ title: React Bottom Navigation(底部导航栏)组件 components: BottomNavigation, BottomNavigationAction --- -# Bottom Navigation(底部导航栏) +# Bottom Navigation 底部导航栏

使用底部导航栏,您可以在应用程序的主要导航项之间跳转。

[底部导航栏](https://material.io/design/components/bottom-navigation.html)在屏幕下方显示三到五个导航项。 每一个导航项都由一个图标和一个可选文本标签表示。 当点击底部导航图标时,用户被切换到该图标关联的目标页面顶部。 -## Bottom Navigation(底部导航栏) +## 底部导航栏 当只有 **三个** 导航项时,导航栏会始终显示图标和文本标签。 diff --git a/docs/src/pages/components/box/box-de.md b/docs/src/pages/components/box/box-de.md index 1e437fa5464572..1e440fce62f2fb 100644 --- a/docs/src/pages/components/box/box-de.md +++ b/docs/src/pages/components/box/box-de.md @@ -6,7 +6,7 @@ title: Box React Komponente

Die Box-Komponente dient als Wrapper-Komponente für die meisten Anforderungen des CSS-Dienstprogramms.

-Die Box-Komponenten packt [alle Stilfunktionen](/system/basics/#all-inclusive), die in `@material-ui/system` verfügbar sind. It's created using the [`styled()`](/styles/api/#styled-style-function-component) function of `@material-ui/core/styles`. +Die Box-Komponenten packt [alle Stilfunktionen](/system/basics/#all-inclusive), die in `@material-ui/system` verfügbar sind. Es wird mit der [`styled()`](/styles/api/#styled-style-function-component) function aus `@material-ui/core/styles` erstellt. ## Beispiel @@ -46,7 +46,7 @@ Die Box-Kinder akzeptieren eine Render-Funktion als Eigenschaft. Sie können den ``` -> ⚠️ Die CSS-Spezifität hängt von der Importreihenfolge ab. If you want the guarantee that the wrapped component's style will be overridden, you need to import the Box last. +> ⚠️ Die CSS-Spezifität hängt von der Importreihenfolge ab. Wenn Sie garantieren wollen, dass der Stil der wrapped Komponente überschrieben wird, müssen Sie die Box zuletzt importieren. ## API diff --git a/docs/src/pages/components/box/box-zh.md b/docs/src/pages/components/box/box-zh.md index 8313f2661f1ead..a961cf4f28c306 100644 --- a/docs/src/pages/components/box/box-zh.md +++ b/docs/src/pages/components/box/box-zh.md @@ -2,7 +2,7 @@ title: React Box(分组)组件 --- -# Box(分组) +# Box 分组

对于大多数 CSS 实用程序来说,Box 组件能够作为一个包装组件来使用。

diff --git a/docs/src/pages/components/breadcrumbs/breadcrumbs-zh.md b/docs/src/pages/components/breadcrumbs/breadcrumbs-zh.md index 8ac7f04e9278b7..382c05e4733dae 100644 --- a/docs/src/pages/components/breadcrumbs/breadcrumbs-zh.md +++ b/docs/src/pages/components/breadcrumbs/breadcrumbs-zh.md @@ -3,7 +3,7 @@ title: React Breadcrumbs(面包屑导航)组件 components: Breadcrumbs, Link, Typography --- -# Breadcrumbs(面包屑导航) +# Breadcrumbs 面包屑导航

面包屑导航允许用户在一系列的值中进行选择。

diff --git a/docs/src/pages/components/buttons/buttons-zh.md b/docs/src/pages/components/buttons/buttons-zh.md index 5a219b47cf44a7..f85d2f96b68114 100644 --- a/docs/src/pages/components/buttons/buttons-zh.md +++ b/docs/src/pages/components/buttons/buttons-zh.md @@ -3,7 +3,7 @@ title: React Button(按钮)组件 components: Button, IconButton, ButtonBase --- -# Button(按钮) +# Button 按钮

只需通过轻按一下按钮,用户即可采取行动并做出选择。

diff --git a/docs/src/pages/components/cards/cards-zh.md b/docs/src/pages/components/cards/cards-zh.md index eb9362e317f98d..4cf4fdd99459bf 100644 --- a/docs/src/pages/components/cards/cards-zh.md +++ b/docs/src/pages/components/cards/cards-zh.md @@ -3,7 +3,7 @@ title: React Card(卡片)组件 components: Card, CardActionArea, CardActions, CardContent, CardHeader, CardMedia, Collapse, Paper --- -# Card(卡片) +# Card 卡片

卡片包含有关单个主题的内容和操作。

diff --git a/docs/src/pages/components/checkboxes/checkboxes-zh.md b/docs/src/pages/components/checkboxes/checkboxes-zh.md index d8b401013a7633..987ab7da6634cf 100644 --- a/docs/src/pages/components/checkboxes/checkboxes-zh.md +++ b/docs/src/pages/components/checkboxes/checkboxes-zh.md @@ -3,7 +3,7 @@ title: React Checkbox(复选框)组件 components: Checkbox, FormControl, FormGroup, FormLabel, FormControlLabel --- -# Checkbox(选择框) +# Checkbox 选择框

在一个集合内,用户可以通过复选框来选择一个或者多个选项。

diff --git a/docs/src/pages/components/chips/chips-zh.md b/docs/src/pages/components/chips/chips-zh.md index 86ccdb241e4701..11267e692fb59c 100644 --- a/docs/src/pages/components/chips/chips-zh.md +++ b/docs/src/pages/components/chips/chips-zh.md @@ -3,7 +3,7 @@ title: React Chip(纸片)组件 components: Chip --- -# Chip(纸片组件) +# Chip 纸片组件

纸片组件是用来表示输入框、属性或操作的紧凑元素。

diff --git a/docs/src/pages/components/click-away-listener/click-away-listener-zh.md b/docs/src/pages/components/click-away-listener/click-away-listener-zh.md index 7d6db824657d4d..155849fa32d8ea 100644 --- a/docs/src/pages/components/click-away-listener/click-away-listener-zh.md +++ b/docs/src/pages/components/click-away-listener/click-away-listener-zh.md @@ -3,7 +3,7 @@ title: 检测 React 组件外部的单击事件 components: ClickAwayListener --- -# Click away listener(他处点击监听器) +# Click away listener 他处点击监听器

用于检测点击事件是否发生在元素之外。 它可以监听文档中某处发生的点击事件。

diff --git a/docs/src/pages/components/container/container-zh.md b/docs/src/pages/components/container/container-zh.md index 1ab7780c6c3378..00187bdf7f32ea 100644 --- a/docs/src/pages/components/container/container-zh.md +++ b/docs/src/pages/components/container/container-zh.md @@ -3,7 +3,7 @@ title: React Container(容器)组件 components: Container --- -# Container(容器) +# Container 容器

容器组件会让您页面的内容水平居中。 这是最基本的布局元素。

diff --git a/docs/src/pages/components/css-baseline/css-baseline-aa.md b/docs/src/pages/components/css-baseline/css-baseline-aa.md index 3a7cfccb83ce19..84b9e9a104d645 100644 --- a/docs/src/pages/components/css-baseline/css-baseline-aa.md +++ b/docs/src/pages/components/css-baseline/css-baseline-aa.md @@ -1,22 +1,32 @@ --- -components: crwdns89896:0crwdne89896:0 +components: crwdns109827:0crwdne109827:0 --- # crwdns89898:0crwdne89898:0

crwdns89900:0crwdne89900:0

+## crwdns109829:0crwdne109829:0 + crwdns89902:0crwdne89902:0 ```jsx crwdns103976:0crwdne103976:0 ``` -## crwdns89906:0crwdne89906:0 +## crwdns109831:0crwdne109831:0 + +crwdns109833:0crwdne109833:0 crwdns109835:0crwdne109835:0 + +```jsx +crwdns109837:0crwdne109837:0 +``` + +## crwdns109839:0crwdne109839:0 ### crwdns89908:0crwdne89908:0 -crwdns89910:0crwdne89910:0 crwdns89912:0crwdne89912:0 +crwdns109841:0crwdne109841:0 crwdns109843:0crwdne109843:0 - crwdns89914:0crwdne89914:0 - crwdns89916:0crwdne89916:0 crwdns107223:0crwdne107223:0 @@ -29,5 +39,5 @@ crwdns89910:0crwdne89910:0 crwdns89912:0crwdne89912:0 - crwdns89928:0crwdne89928:0 crwdns89930:0crwdne89930:0 - crwdns89932:0crwdne89932:0 -- crwdns89934:0crwdne89934:0 crwdns89936:0crwdne89936:0 +- crwdns109845:0crwdne109845:0 - crwdns89938:0crwdne89938:0 \ No newline at end of file diff --git a/docs/src/pages/components/css-baseline/css-baseline-de.md b/docs/src/pages/components/css-baseline/css-baseline-de.md index f61d2e0b82b052..cb224a67a78003 100644 --- a/docs/src/pages/components/css-baseline/css-baseline-de.md +++ b/docs/src/pages/components/css-baseline/css-baseline-de.md @@ -1,11 +1,13 @@ --- -components: CssBaseline +components: CssBaseline, ScopedCssBaseline --- # CSS-Baseline

Die Material-UI bietet eine CssBaseline-Komponente, um eine elegante, konsistente und einfache Basis zu schaffen, auf der aufgebaut werden kann.

+## Global reset + Möglicherweise kennen Sie [normalize.css](https://github.com/necolas/normalize.css), eine Sammlung von HTML-Element- und Attributstil-Normalisierungen. ```jsx @@ -22,11 +24,28 @@ export default function MyApp() { } ``` -## Ansatz +## Scoping on children + +However, you might be progressively migrating a website to Material-UI, using a global reset might not be an option. It's possible to apply the baseline only to the children by using the `ScopedCssBaseline` component. + +```jsx +import React from 'react'; +import ScopedCssBaseline from '@material-ui/core/ScopedCssBaseline'; + +export default function MyApp() { + return ( + + {/* The rest of your application */} + + ); +} +``` + +## Approach ### Seite -The `` and `` elements are updated to provide better page-wide defaults. Genauer gesagt: +The `` and `` elements are updated to provide better page-wide defaults. More specifically: - Der Rand in allen Browsern wird entfernt. - Die Standardhintergrundfarbe des Materialdesigns wird angewendet. Es verwendet [`theme.palette.background.default`](/customization/default-theme/?expand-path=$.palette.background) für normale Geräte und einen weißen Hintergrund für Drucker. @@ -39,5 +58,5 @@ The `` and `` elements are updated to provide better page-wide defau - Für das ``-Element wird keine Basisschriftgröße deklariert, es wird jedoch von 16px ausgegangen (Standardeinstellung des Browsers). Sie können mehr über die Auswirkungen lernen von den sich ändernden `` Standard - Schriftgröße auf [der Theme Dokumentation](/customization/typography/#typography-html-font-size) Seite. - Set the `theme.typography.body2` style on the `` element. -- Set the font-weight to "bolder" for the `` and `` elements. Bolder is one font weight heavier than the parent element (among the available weights of the font). +- Set the font-weight to `theme.typography.fontWeightBold` for the `` and `` elements. - Das Antialiasing von Schriftarten ist aktiviert, um die Roboto-Schrift besser anzuzeigen. \ No newline at end of file diff --git a/docs/src/pages/components/css-baseline/css-baseline-es.md b/docs/src/pages/components/css-baseline/css-baseline-es.md index 6d8b3ded275746..375d13c2341eef 100644 --- a/docs/src/pages/components/css-baseline/css-baseline-es.md +++ b/docs/src/pages/components/css-baseline/css-baseline-es.md @@ -1,11 +1,13 @@ --- -components: CssBaseline +components: CssBaseline, ScopedCssBaseline --- # Base de CSS

Material-UI provee un componente llamado CssBaseline como un punto de partida elegante, simple y consistente para empezar a desarrollar.

+## Global reset + Tal vez tengas familiaridad con [normalize.css](https://github.com/necolas/normalize.css), una colección de atributos de estilos normalizados para elementos HTML. ```jsx @@ -22,7 +24,24 @@ export default function MyApp() { } ``` -## Enfoque +## Scoping on children + +However, you might be progressively migrating a website to Material-UI, using a global reset might not be an option. It's possible to apply the baseline only to the children by using the `ScopedCssBaseline` component. + +```jsx +import React from 'react'; +import ScopedCssBaseline from '@material-ui/core/ScopedCssBaseline'; + +export default function MyApp() { + return ( + + {/* The rest of your application */} + + ); +} +``` + +## Approach ### Página @@ -39,5 +58,5 @@ The `` and `` elements are updated to provide better page-wide defau - No se declara ningún tamaño de fuente de base en el elemento ``, pero se asume 16px (el valor predeterminado del navegador). Puedes aprender más acerca de las implicaciones de cambiar el tamaño de fuente predeterminado de ``, en la página [de documentación del tema](/customization/typography/#typography-html-font-size). - Set the `theme.typography.body2` style on the `` element. -- Set the font-weight to "bolder" for the `` and `` elements. Bolder is one font weight heavier than the parent element (among the available weights of the font). +- Set the font-weight to `theme.typography.fontWeightBold` for the `` and `` elements. - El antialiasing de fuentes está habilitado para una mejor visualización de la fuente Roboto. \ No newline at end of file diff --git a/docs/src/pages/components/css-baseline/css-baseline-fr.md b/docs/src/pages/components/css-baseline/css-baseline-fr.md index 6a3f37b44ac641..e6ea7262e3e975 100644 --- a/docs/src/pages/components/css-baseline/css-baseline-fr.md +++ b/docs/src/pages/components/css-baseline/css-baseline-fr.md @@ -1,11 +1,13 @@ --- -components: CssBaseline +components: CssBaseline, ScopedCssBaseline --- # Principes CSS

Material-UI fournit un composant CssBaseline pour relancer une base élégante, cohérente et simple sur laquelle s'appuyer.

+## Global reset + Vous connaissez peut-être [normalize.css](https://github.com/necolas/normalize.css), une collection d'éléments HTML et de normalisations de style d'attributs. ```jsx @@ -22,7 +24,24 @@ export default function MyApp() { } ``` -## Approche +## Scoping on children + +However, you might be progressively migrating a website to Material-UI, using a global reset might not be an option. It's possible to apply the baseline only to the children by using the `ScopedCssBaseline` component. + +```jsx +import React from 'react'; +import ScopedCssBaseline from '@material-ui/core/ScopedCssBaseline'; + +export default function MyApp() { + return ( + + {/* The rest of your application */} + + ); +} +``` + +## Approach ### Page @@ -39,5 +58,5 @@ The `` and `` elements are updated to provide better page-wide defau - Aucune taille de police de base n’est déclarée sur le ``, mais 16px est utilisée (valeur par défaut du navigateur). Vous pouvez en apprendre davantage sur les implications de l' évolution du `` taille de la police par défaut dans [la documentation abordant les thèmes](/customization/typography/#typography-html-font-size) page. - Set the `theme.typography.body2` style on the `` element. -- Set the font-weight to "bolder" for the `` and `` elements. Bolder is one font weight heavier than the parent element (among the available weights of the font). +- Set the font-weight to `theme.typography.fontWeightBold` for the `` and `` elements. - L'anticrénelage des polices est activé pour un meilleur affichage de la police Roboto. \ No newline at end of file diff --git a/docs/src/pages/components/css-baseline/css-baseline-ja.md b/docs/src/pages/components/css-baseline/css-baseline-ja.md index 0ed34da996bbdf..65ce0c9574c8f1 100644 --- a/docs/src/pages/components/css-baseline/css-baseline-ja.md +++ b/docs/src/pages/components/css-baseline/css-baseline-ja.md @@ -1,11 +1,13 @@ --- -components: CssBaseline +components: CssBaseline, ScopedCssBaseline --- # CSSベースライン

Material-UIはCssBaselineコンポーネントを提供することで、エレガントで一貫性のあるシンプルなベースラインを構築します。

+## Global reset + 貴方はもしかしたら、HTMLの要素と属性のスタイル正規化のコレクションである [normalize.css](https://github.com/necolas/normalize.css)精通しているかもしれません。 ```jsx @@ -22,11 +24,28 @@ export default function MyApp() { } ``` -## アプローチ +## Scoping on children + +However, you might be progressively migrating a website to Material-UI, using a global reset might not be an option. It's possible to apply the baseline only to the children by using the `ScopedCssBaseline` component. + +```jsx +import React from 'react'; +import ScopedCssBaseline from '@material-ui/core/ScopedCssBaseline'; + +export default function MyApp() { + return ( + + {/* The rest of your application */} + + ); +} +``` + +## Approach ### ページ -`` および `` 要素は、ページ全体のデフォルトが改善されるように更新されています。 具体的には: +The `` and `` elements are updated to provide better page-wide defaults. More specifically: - すべてのブラウザの余白が削除されています。 - デフォルトのマテリアルデザインの背景色が適用されます。 It's using [`theme.palette.background.default`](/customization/default-theme/?expand-path=$.palette.background) for standard devices and a white background for print devices. @@ -39,5 +58,5 @@ export default function MyApp() { - ``には基本フォントサイズは宣言されていませんが、16pxが想定されています(ブラウザのデフォルト)。 デフォルトのフォントサイズの``を変更した場合の影響については、ここをクリックしてください。[the theme documentation](/customization/typography/#typography-html-font-size) - `` 要素に `theme.typography.body2` スタイルを設定します。 -- `` および `` 要素のfont-weightを「bolder」に設定します。 Bolderは、親要素よりも重いフォントの重みです(使用可能なフォントの重みの中で)。 +- Set the font-weight to `theme.typography.fontWeightBold` for the `` and `` elements. - Robotoフォントを見やすくするために、フォントのアンチエイリアスが有効になります。 \ No newline at end of file diff --git a/docs/src/pages/components/css-baseline/css-baseline-pt.md b/docs/src/pages/components/css-baseline/css-baseline-pt.md index b54db620bf623e..d797d0119691c9 100644 --- a/docs/src/pages/components/css-baseline/css-baseline-pt.md +++ b/docs/src/pages/components/css-baseline/css-baseline-pt.md @@ -1,11 +1,13 @@ --- -components: CssBaseline +components: CssBaseline, ScopedCssBaseline --- # CSS Baseline

Material-UI oferece um componente CSS Base a fim de inciar uma elegante, consistente e simples base para construir sobre.

+## Global reset + Você já deve estar familiarizado com [normalize.css](https://github.com/necolas/normalize.css), uma coleção de elementos HTML e normas de atributos de estilo. ```jsx @@ -22,11 +24,28 @@ export default function MyApp() { } ``` -## Abordagem +## Scoping on children + +However, you might be progressively migrating a website to Material-UI, using a global reset might not be an option. It's possible to apply the baseline only to the children by using the `ScopedCssBaseline` component. + +```jsx +import React from 'react'; +import ScopedCssBaseline from '@material-ui/core/ScopedCssBaseline'; + +export default function MyApp() { + return ( + + {/* The rest of your application */} + + ); +} +``` + +## Approach ### Página -Os elementos `` e `` são atualizados para fornecer melhores padrões para toda a página. Mais especificamente: +The `` and `` elements are updated to provide better page-wide defaults. More specifically: - The margin in all browsers is removed. - A cor de fundo padrão do material design é aplicada. It's using [`theme.palette.background.default`](/customization/default-theme/?expand-path=$.palette.background) for standard devices and a white background for print devices. @@ -39,5 +58,5 @@ Os elementos `` e `` são atualizados para fornecer melhores padrõe - Nenhum tamanho de fonte base é declarado no ``, mas 16px é assumido (o padrão do navegador). Você pode aprender mais sobre as implicações da mudança do padrão de tamanho de fonte do `` na página de [documentação de tema](/customization/typography/#typography-html-font-size). - Defina o estilo `theme.typography.body2` no elemento ``. -- Defina o font-weight como "bolder" para os elementos `` e ``. Bolder é um font-weight mais pesado que o elemento pai (entre os pesos disponíveis da fonte). +- Set the font-weight to `theme.typography.fontWeightBold` for the `` and `` elements. - O antialiasing de fonte é habilitado para melhorar a exibição da fonte Roboto. \ No newline at end of file diff --git a/docs/src/pages/components/css-baseline/css-baseline-ru.md b/docs/src/pages/components/css-baseline/css-baseline-ru.md index 49b7fa32f8a13e..bc0e036f2f6587 100644 --- a/docs/src/pages/components/css-baseline/css-baseline-ru.md +++ b/docs/src/pages/components/css-baseline/css-baseline-ru.md @@ -1,11 +1,13 @@ --- -components: CssBaseline +components: CssBaseline, ScopedCssBaseline --- # CSS Baseline

Material-UI предоставляет компонент CssBaseline, чтобы создать элегантную, согласованную и простую основу для работы.

+## Global reset + You might be familiar with [normalize.css](https://github.com/necolas/normalize.css), a collection of HTML element and attribute style-normalizations. ```jsx @@ -22,6 +24,23 @@ export default function MyApp() { } ``` +## Scoping on children + +However, you might be progressively migrating a website to Material-UI, using a global reset might not be an option. It's possible to apply the baseline only to the children by using the `ScopedCssBaseline` component. + +```jsx +import React from 'react'; +import ScopedCssBaseline from '@material-ui/core/ScopedCssBaseline'; + +export default function MyApp() { + return ( + + {/* The rest of your application */} + + ); +} +``` + ## Approach ### Страница @@ -39,5 +58,5 @@ The `` and `` elements are updated to provide better page-wide defau - No base font-size is declared on the ``, but 16px is assumed (the browser default). You can learn more about the implications of changing the `` default font size in [the theme documentation](/customization/typography/#typography-html-font-size) page. - Set the `theme.typography.body2` style on the `` element. -- Set the font-weight to "bolder" for the `` and `` elements. Bolder is one font weight heavier than the parent element (among the available weights of the font). +- Set the font-weight to `theme.typography.fontWeightBold` for the `` and `` elements. - Сглаживание шрифтов включено для лучшего отображения шрифта Roboto. \ No newline at end of file diff --git a/docs/src/pages/components/css-baseline/css-baseline-zh.md b/docs/src/pages/components/css-baseline/css-baseline-zh.md index ac5f0298935b7c..e05a0ce2445811 100644 --- a/docs/src/pages/components/css-baseline/css-baseline-zh.md +++ b/docs/src/pages/components/css-baseline/css-baseline-zh.md @@ -1,11 +1,13 @@ --- -components: CssBaseline +components: CssBaseline, ScopedCssBaseline --- -# CSS Baseline(CSS 基线) +# CSS Baseline 基线

Material-UI 提供了一个 CssBaseline 组件,用于启动一个优雅、一致且简单的基线。

+## Global reset + 您可能对 [normailize.css](https://github.com/necolas/normalize.css)比较熟悉,而这是一个 HTML 元素和样式规范化的属性的集合。 ```jsx @@ -22,11 +24,28 @@ export default function MyApp() { } ``` -## 方法 +## Scoping on children + +However, you might be progressively migrating a website to Material-UI, using a global reset might not be an option. It's possible to apply the baseline only to the children by using the `ScopedCssBaseline` component. + +```jsx +import React from 'react'; +import ScopedCssBaseline from '@material-ui/core/ScopedCssBaseline'; + +export default function MyApp() { + return ( + + {/* The rest of your application */} + + ); +} +``` + +## Approach ### 页面 -我们更新了 `` 和 `` 元素,这样能够更好地设置页面范围的默认设置。 具体来说: +The `` and `` elements are updated to provide better page-wide defaults. More specifically: - 所有浏览器中的边距将会被删除。 - Material Design 的背景颜色会默认地被应用。 It's using [`theme.palette.background.default`](/customization/default-theme/?expand-path=$.palette.background) for standard devices and a white background for print devices. @@ -39,5 +58,5 @@ export default function MyApp() { - 在 `` 里面不会声明基础的 font-size,但是我们假设是 16px (浏览器的默认设置)。 您可以在[主题文档](/customization/typography/#typography-html-font-size) 页面中了解更多有关更改 `` 默认字体大小的影响 。 - 在 `theme.typography.body2` 元素上设置 `` 样式。 -- 您可以设置 `` 和 `` 元素的 font-weight 属性为 “bolder”。 Bolder 是其中一种比父元素粗的字体(在字体可选的粗细大小里)。 +- Set the font-weight to `theme.typography.fontWeightBold` for the `` and `` elements. - 字体的平滑化能让 Roboto 字体更好地展示。 \ No newline at end of file diff --git a/docs/src/pages/components/dialogs/dialogs-zh.md b/docs/src/pages/components/dialogs/dialogs-zh.md index 3609d89e8823ad..d33a88e59a4088 100644 --- a/docs/src/pages/components/dialogs/dialogs-zh.md +++ b/docs/src/pages/components/dialogs/dialogs-zh.md @@ -3,7 +3,7 @@ title: React Dialog(对话框)组件 components: Dialog, DialogTitle, DialogContent, DialogContentText, DialogActions, Slide --- -# Dialog(对话框) +# Dialog 对话框

对话框将一个任务告知给用户,它包含了一些关键信息,需要用户进行确认,或者包含了多个任务。

diff --git a/docs/src/pages/components/dividers/dividers-aa.md b/docs/src/pages/components/dividers/dividers-aa.md index f24144171f9cdb..b0f81e97dd699a 100644 --- a/docs/src/pages/components/dividers/dividers-aa.md +++ b/docs/src/pages/components/dividers/dividers-aa.md @@ -33,6 +33,6 @@ crwdns105555:0crwdne105555:0 ## crwdns105557:0crwdne105557:0 -crwdns105559:0crwdne105559:0 +crwdns109479:0crwdne109479:0 crwdns109483:0crwdne109483:0 crwdns105561:0crwdne105561:0 \ No newline at end of file diff --git a/docs/src/pages/components/dividers/dividers-de.md b/docs/src/pages/components/dividers/dividers-de.md index 5384d5173161e7..4c31697d28ce0e 100644 --- a/docs/src/pages/components/dividers/dividers-de.md +++ b/docs/src/pages/components/dividers/dividers-de.md @@ -33,6 +33,6 @@ In einer Liste sollten sie sicherstellen, dass der `Trenner` als `
  • ` gerender ## Vertikale Trennlinien -Sie können einen Trenner auch vertikal mit der `orientation` prop rendern. +You can also render a divider vertically using the `orientation` prop. Note the use of the `flexItem` prop to accommodate for the flex container. {{"demo": "pages/components/dividers/VerticalDividers.js", "bg": true}} \ No newline at end of file diff --git a/docs/src/pages/components/dividers/dividers-es.md b/docs/src/pages/components/dividers/dividers-es.md index f218ea94673220..9c21eb21af5788 100644 --- a/docs/src/pages/components/dividers/dividers-es.md +++ b/docs/src/pages/components/dividers/dividers-es.md @@ -33,6 +33,6 @@ In a list, you should ensure the `Divider` is rendered as an `
  • ` to match the ## Vertical Dividers -You can also render a divider vertically using the `orientation` prop. +You can also render a divider vertically using the `orientation` prop. Note the use of the `flexItem` prop to accommodate for the flex container. {{"demo": "pages/components/dividers/VerticalDividers.js", "bg": true}} \ No newline at end of file diff --git a/docs/src/pages/components/dividers/dividers-fr.md b/docs/src/pages/components/dividers/dividers-fr.md index 6486e65d37f289..eddbb7740b6476 100644 --- a/docs/src/pages/components/dividers/dividers-fr.md +++ b/docs/src/pages/components/dividers/dividers-fr.md @@ -33,6 +33,6 @@ In a list, you should ensure the `Divider` is rendered as an `
  • ` to match the ## Vertical Dividers -You can also render a divider vertically using the `orientation` prop. +You can also render a divider vertically using the `orientation` prop. Note the use of the `flexItem` prop to accommodate for the flex container. {{"demo": "pages/components/dividers/VerticalDividers.js", "bg": true}} \ No newline at end of file diff --git a/docs/src/pages/components/dividers/dividers-ja.md b/docs/src/pages/components/dividers/dividers-ja.md index 19372074ad7ae2..6aa09b08760c06 100644 --- a/docs/src/pages/components/dividers/dividers-ja.md +++ b/docs/src/pages/components/dividers/dividers-ja.md @@ -33,6 +33,6 @@ In a list, you should ensure the `Divider` is rendered as an `
  • ` to match the ## Vertical Dividers -You can also render a divider vertically using the `orientation` prop. +You can also render a divider vertically using the `orientation` prop. Note the use of the `flexItem` prop to accommodate for the flex container. {{"demo": "pages/components/dividers/VerticalDividers.js", "bg": true}} \ No newline at end of file diff --git a/docs/src/pages/components/dividers/dividers-pt.md b/docs/src/pages/components/dividers/dividers-pt.md index 3ed7a52a37a0de..f2c43a66e7b5e5 100644 --- a/docs/src/pages/components/dividers/dividers-pt.md +++ b/docs/src/pages/components/dividers/dividers-pt.md @@ -33,6 +33,6 @@ Em uma lista, você deve garantir que o `Divisor` seja renderizado como um eleme ## Vertical Dividers -You can also render a divider vertically using the `orientation` prop. +You can also render a divider vertically using the `orientation` prop. Note the use of the `flexItem` prop to accommodate for the flex container. {{"demo": "pages/components/dividers/VerticalDividers.js", "bg": true}} \ No newline at end of file diff --git a/docs/src/pages/components/dividers/dividers-ru.md b/docs/src/pages/components/dividers/dividers-ru.md index de78cf37ad25a4..9976623dfde445 100644 --- a/docs/src/pages/components/dividers/dividers-ru.md +++ b/docs/src/pages/components/dividers/dividers-ru.md @@ -33,6 +33,6 @@ In a list, you should ensure the `Divider` is rendered as an `
  • ` to match the ## Vertical Dividers -You can also render a divider vertically using the `orientation` prop. +You can also render a divider vertically using the `orientation` prop. Note the use of the `flexItem` prop to accommodate for the flex container. {{"demo": "pages/components/dividers/VerticalDividers.js", "bg": true}} \ No newline at end of file diff --git a/docs/src/pages/components/dividers/dividers-zh.md b/docs/src/pages/components/dividers/dividers-zh.md index 36337e0c665d15..4ab9b7a03830b9 100644 --- a/docs/src/pages/components/dividers/dividers-zh.md +++ b/docs/src/pages/components/dividers/dividers-zh.md @@ -3,7 +3,7 @@ title: React Divider(分隔线)组件 components: Divider --- -# Divider (分隔线) +# Divider 分隔线

    分隔线是对列表和布局中的内容进行分组的一条细线。

    @@ -33,6 +33,6 @@ In a list, you should ensure the `Divider` is rendered as an `
  • ` to match the ## Vertical Dividers -You can also render a divider vertically using the `orientation` prop. +You can also render a divider vertically using the `orientation` prop. Note the use of the `flexItem` prop to accommodate for the flex container. {{"demo": "pages/components/dividers/VerticalDividers.js", "bg": true}} \ No newline at end of file diff --git a/docs/src/pages/components/drawers/drawers-zh.md b/docs/src/pages/components/drawers/drawers-zh.md index 5bbbf4b7c1bb21..49c7da0d99df2e 100644 --- a/docs/src/pages/components/drawers/drawers-zh.md +++ b/docs/src/pages/components/drawers/drawers-zh.md @@ -3,7 +3,7 @@ title: React Drawer(抽屉)组件 components: Drawer, SwipeableDrawer --- -# Drawer(抽屉) +# Drawer 抽屉

    导航抽屉可以访问您应用中的目标地址。侧边栏包含了补充的内容,而它被固定在屏幕的左侧或右侧。

    diff --git a/docs/src/pages/components/expansion-panels/expansion-panels-zh.md b/docs/src/pages/components/expansion-panels/expansion-panels-zh.md index c7879a7d6bef7d..69d98a193d85f4 100644 --- a/docs/src/pages/components/expansion-panels/expansion-panels-zh.md +++ b/docs/src/pages/components/expansion-panels/expansion-panels-zh.md @@ -3,7 +3,7 @@ title: React Expansion Panel(扩展面板)组件 components: ExpansionPanel, ExpansionPanelActions, ExpansionPanelDetails, ExpansionPanelSummary --- -# Expansion Panel (拓展面板) +# Expansion Panel 拓展面板

    扩展面板包含了创建流程和轻量地编辑元素。

    diff --git a/docs/src/pages/components/grid-list/grid-list-zh.md b/docs/src/pages/components/grid-list/grid-list-zh.md index cd116fd08f4f6c..8b10658b1eb6ab 100644 --- a/docs/src/pages/components/grid-list/grid-list-zh.md +++ b/docs/src/pages/components/grid-list/grid-list-zh.md @@ -3,7 +3,7 @@ title: React Grid List(网格列表)组件 components: GridList, GridListTile, GridListTileBar, ListSubheader, IconButton --- -# Grid List(网格列表) +# Grid List 网格列表

    网格列表在一个系统的网格中展示了一系列的图像。

    diff --git a/docs/src/pages/components/hidden/hidden-zh.md b/docs/src/pages/components/hidden/hidden-zh.md index 11056b2d877e79..4ee7b147b76686 100644 --- a/docs/src/pages/components/hidden/hidden-zh.md +++ b/docs/src/pages/components/hidden/hidden-zh.md @@ -3,7 +3,7 @@ title: React Hidden(隐藏)组件 components: Hidden --- -# Hidden +# Hidden 隐藏组件

    您可以使用我们的隐藏组件来实现快速并响应式地控制元素的显隐。

    diff --git a/docs/src/pages/components/icons/icons-aa.md b/docs/src/pages/components/icons/icons-aa.md index 4d1334f70ae377..25457493db9fda 100644 --- a/docs/src/pages/components/icons/icons-aa.md +++ b/docs/src/pages/components/icons/icons-aa.md @@ -15,7 +15,7 @@ crwdns103500:0crwdne103500:0 ## crwdns103508:0crwdne103508:0 -crwdns103510:0crwdne103510:0 crwdns105937:0crwdne105937:0 crwdns105939:0crwdne105939:0 +crwdns109979:0crwdne109979:0 crwdns105937:0crwdne105937:0 crwdns105939:0crwdne105939:0 ### crwdns102762:0crwdne102762:0 @@ -84,7 +84,7 @@ crwdns105997:0{StarIcon}crwdne105997:0 #### crwdns103572:0crwdne103572:0 -crwdns106001:0crwdne106001:0 +crwdns109981:0crwdne109981:0 #### crwdns103576:0crwdne103576:0 diff --git a/docs/src/pages/components/icons/icons-de.md b/docs/src/pages/components/icons/icons-de.md index ae714ff87627a1..74e948fe93236a 100644 --- a/docs/src/pages/components/icons/icons-de.md +++ b/docs/src/pages/components/icons/icons-de.md @@ -15,7 +15,7 @@ Material-UI provides icons support in three ways: ## Material Icons -Material Design has standardized over 1,000 official icons, each in five different "themes" (see below). For each SVG icon, we export the respective React component from the @material-ui/icons package. You can [search the full list of these icons](/components/material-icons/). +Material Design has standardized over 1,100 official icons, each in five different "themes" (see below). For each SVG icon, we export the respective React component from the @material-ui/icons package. You can [search the full list of these icons](/components/material-icons/). ### Nutzung @@ -96,7 +96,7 @@ import StarIcon from './star.svg'; #### Material Design (recommended) -Material Design has standardized over [1,000 official icons](#material-icons). +Material Design has standardized over [1,100 official icons](#material-icons). #### MDI diff --git a/docs/src/pages/components/icons/icons-es.md b/docs/src/pages/components/icons/icons-es.md index da50c1d5e5b785..cef019376a148d 100644 --- a/docs/src/pages/components/icons/icons-es.md +++ b/docs/src/pages/components/icons/icons-es.md @@ -15,7 +15,7 @@ Material-UI provides icons support in three ways: ## Material Icons -Material Design has standardized over 1,000 official icons, each in five different "themes" (see below). For each SVG icon, we export the respective React component from the @material-ui/icons package. You can [search the full list of these icons](/components/material-icons/). +Material Design has standardized over 1,100 official icons, each in five different "themes" (see below). For each SVG icon, we export the respective React component from the @material-ui/icons package. You can [search the full list of these icons](/components/material-icons/). ### Implementación @@ -96,7 +96,7 @@ import StarIcon from './star.svg'; #### Material Design (recommended) -Material Design has standardized over [1,000 official icons](#material-icons). +Material Design has standardized over [1,100 official icons](#material-icons). #### MDI diff --git a/docs/src/pages/components/icons/icons-fr.md b/docs/src/pages/components/icons/icons-fr.md index 70ec92dfcbe852..5fadf83e1d69c2 100644 --- a/docs/src/pages/components/icons/icons-fr.md +++ b/docs/src/pages/components/icons/icons-fr.md @@ -15,7 +15,7 @@ Material-UI provides icons support in three ways: ## Icônes Material Ui -Material Design has standardized over 1,000 official icons, each in five different "themes" (see below). For each SVG icon, we export the respective React component from the @material-ui/icons package. You can [search the full list of these icons](/components/material-icons/). +Material Design has standardized over 1,100 official icons, each in five different "themes" (see below). For each SVG icon, we export the respective React component from the @material-ui/icons package. You can [search the full list of these icons](/components/material-icons/). ### Utilisation @@ -96,7 +96,7 @@ import StarIcon from './star.svg'; #### Material Design (recommended) -Material Design has standardized over [1,000 official icons](#material-icons). +Material Design has standardized over [1,100 official icons](#material-icons). #### MDI diff --git a/docs/src/pages/components/icons/icons-ja.md b/docs/src/pages/components/icons/icons-ja.md index 1904e6afa7ab7d..356f707df807de 100644 --- a/docs/src/pages/components/icons/icons-ja.md +++ b/docs/src/pages/components/icons/icons-ja.md @@ -15,7 +15,7 @@ Material-UI provides icons support in three ways: ## マテリアルアイコン(Material Icons) -Material Design has standardized over 1,000 official icons, each in five different "themes" (see below). For each SVG icon, we export the respective React component from the @material-ui/icons package. You can [search the full list of these icons](/components/material-icons/). +Material Design has standardized over 1,100 official icons, each in five different "themes" (see below). For each SVG icon, we export the respective React component from the @material-ui/icons package. You can [search the full list of these icons](/components/material-icons/). ### 使い方 @@ -96,7 +96,7 @@ import StarIcon from './star.svg'; #### Material Design (recommended) -Material Design has standardized over [1,000 official icons](#material-icons). +Material Design has standardized over [1,100 official icons](#material-icons). #### MDI diff --git a/docs/src/pages/components/icons/icons-pt.md b/docs/src/pages/components/icons/icons-pt.md index 0107ad63f70748..315683245371a9 100644 --- a/docs/src/pages/components/icons/icons-pt.md +++ b/docs/src/pages/components/icons/icons-pt.md @@ -15,7 +15,7 @@ Material-UI fornece suporte de ícones de três maneiras: ## Ícones Material -O Material Design padronizou mais de 1.000 ícones oficiais, cada um em cinco "temas" diferentes (veja abaixo). Para cada ícone SVG, exportamos o respectivo componente React do pacote @material-ui/icons. You can [search the full list of these icons](/components/material-icons/). +Material Design has standardized over 1,100 official icons, each in five different "themes" (see below). Para cada ícone SVG, exportamos o respectivo componente React do pacote @material-ui/icons. You can [search the full list of these icons](/components/material-icons/). ### Utilização @@ -96,7 +96,7 @@ import StarIcon from './star.svg'; #### Material Design (recomendado) -Material Design padronizou mais de [1.000 ícones oficiais](#material-icons). +Material Design has standardized over [1,100 official icons](#material-icons). #### MDI diff --git a/docs/src/pages/components/icons/icons-ru.md b/docs/src/pages/components/icons/icons-ru.md index feefd81ddd964f..3ca0667d0d0986 100644 --- a/docs/src/pages/components/icons/icons-ru.md +++ b/docs/src/pages/components/icons/icons-ru.md @@ -15,7 +15,7 @@ Material-UI обеспечивает поддержку иконок тремя ## Material Icons -Material Design has standardized over 1,000 official icons, each in five different "themes" (see below). For each SVG icon, we export the respective React component from the @material-ui/icons package. You can [search the full list of these icons](/components/material-icons/). +Material Design has standardized over 1,100 official icons, each in five different "themes" (see below). For each SVG icon, we export the respective React component from the @material-ui/icons package. You can [search the full list of these icons](/components/material-icons/). ### Использование @@ -96,7 +96,7 @@ import StarIcon from './star.svg'; #### Material Design (recommended) -Material Design has standardized over [1,000 official icons](#material-icons). +Material Design has standardized over [1,100 official icons](#material-icons). #### MDI diff --git a/docs/src/pages/components/icons/icons-zh.md b/docs/src/pages/components/icons/icons-zh.md index 2eac96c710e06b..3df3bccaef03f9 100644 --- a/docs/src/pages/components/icons/icons-zh.md +++ b/docs/src/pages/components/icons/icons-zh.md @@ -3,7 +3,7 @@ title: React Icon(图标)组件 components: Icon, SvgIcon --- -# Icons(图标) +# Icons 图标

    一些在 Material-UI 中使用图标的建议和指导。

    @@ -15,7 +15,7 @@ Material-UI通过三种方式提供图标支持: ## Material Icons (材料图标) -Material Design已经标准化了1,000多个官方图标,每个图标都有五个不同的“主题”(见下文)。 对于每个SVG图标,我们从 @ material-ui/icons 包中导出相应的React组件。 You can [search the full list of these icons](/components/material-icons/). +Material Design has standardized over 1,100 official icons, each in five different "themes" (see below). 对于每个SVG图标,我们从 @ material-ui/icons 包中导出相应的React组件。 You can [search the full list of these icons](/components/material-icons/). ### 使用 @@ -96,7 +96,7 @@ import StarIcon from './star.svg'; #### Material Design (recommended) -Material Design has standardized over [1,000 official icons](#material-icons). +Material Design has standardized over [1,100 official icons](#material-icons). #### MDI diff --git a/docs/src/pages/components/links/links-zh.md b/docs/src/pages/components/links/links-zh.md index 62af01f3de2165..c2a0de1edad6d5 100644 --- a/docs/src/pages/components/links/links-zh.md +++ b/docs/src/pages/components/links/links-zh.md @@ -2,7 +2,7 @@ components: Link --- -# 链接 +# Link 链接

    链接(Links)组件允许您使用主题颜色和版面设计轻松自定义锚定元素。

    diff --git a/docs/src/pages/components/lists/lists-zh.md b/docs/src/pages/components/lists/lists-zh.md index d960975f0f05c5..5b84c02b6d3d49 100644 --- a/docs/src/pages/components/lists/lists-zh.md +++ b/docs/src/pages/components/lists/lists-zh.md @@ -3,7 +3,7 @@ title: React List(列表)组件 components: Collapse, Divider, List, ListItem, ListItemAvatar, ListItemIcon, ListItemSecondaryAction, ListItemText, ListSubheader --- -# Lists(列表) +# Lists 列表

    列表是对文本或图像的连续、垂直的索引。

    @@ -67,7 +67,7 @@ The checkbox is the primary action and the state indicator for the list item. Th {{"demo": "pages/components/lists/CheckboxListSecondary.js", "bg": true}} -### Switch (开关) +### Switch 该开关是辅助操作和单独的目标。 diff --git a/docs/src/pages/components/material-icons/material-icons-aa.md b/docs/src/pages/components/material-icons/material-icons-aa.md index 9e02df84d74f9f..419deb827351b0 100644 --- a/docs/src/pages/components/material-icons/material-icons-aa.md +++ b/docs/src/pages/components/material-icons/material-icons-aa.md @@ -5,9 +5,9 @@ components: crwdns100256:0crwdne100256:0 # crwdns100258:0crwdne100258:0 -

    crwdns100260:0crwdne100260:0

    +

    crwdns109983:0crwdne109983:0

    -crwdns100262:0crwdne100262:0 +crwdns109985:0crwdne109985:0 crwdns105621:0crwdne105621:0 diff --git a/docs/src/pages/components/material-icons/material-icons-de.md b/docs/src/pages/components/material-icons/material-icons-de.md index 15accf4a319d29..5bfa7ce522ba70 100644 --- a/docs/src/pages/components/material-icons/material-icons-de.md +++ b/docs/src/pages/components/material-icons/material-icons-de.md @@ -5,9 +5,9 @@ components: Icon, SvgIcon # Material Icons -

    Mehr als 1000 React Material Icons werden von der offiziellen Webseite zur Verfügung gestellt.

    +

    1,100+ React Material icons ready to use from the official website.

    -The following npm package, [@material-ui/icons](https://www.npmjs.com/package/@material-ui/icons), includes the 1,000+ official [Material icons](https://material.io/tools/icons/?style=baseline) converted to [`SvgIcon`](/api/svg-icon/) components. +The following npm package, [@material-ui/icons](https://www.npmjs.com/package/@material-ui/icons), includes the 1,100+ official [Material icons](https://material.io/tools/icons/?style=baseline) converted to [`SvgIcon`](/api/svg-icon/) components. {{"demo": "pages/components/material-icons/SearchIcons.js", "hideHeader": true, "bg": true}} diff --git a/docs/src/pages/components/material-icons/material-icons-es.md b/docs/src/pages/components/material-icons/material-icons-es.md index 4c1dacb6d4272d..ad8cab3f3e11b6 100644 --- a/docs/src/pages/components/material-icons/material-icons-es.md +++ b/docs/src/pages/components/material-icons/material-icons-es.md @@ -5,9 +5,9 @@ components: Icon, SvgIcon # Material Icons -

    Más de 1,000 iconos de Material React listos para usar desde el sitio web oficial.

    +

    1,100+ React Material icons ready to use from the official website.

    -El siguiente paquete npm, [@material-ui/icons](https://www.npmjs.com/package/@material-ui/icons), incluye más de 1,000 [Material icons](https://material.io/tools/icons/?style=baseline) oficiales convertidos a componentes [`SvgIcon`](/api/svg-icon/). +The following npm package, [@material-ui/icons](https://www.npmjs.com/package/@material-ui/icons), includes the 1,100+ official [Material icons](https://material.io/tools/icons/?style=baseline) converted to [`SvgIcon`](/api/svg-icon/) components. {{"demo": "pages/components/material-icons/SearchIcons.js", "hideHeader": true, "bg": true}} diff --git a/docs/src/pages/components/material-icons/material-icons-fr.md b/docs/src/pages/components/material-icons/material-icons-fr.md index 1abdbe9f9528b0..b2dfd0f1997bf3 100644 --- a/docs/src/pages/components/material-icons/material-icons-fr.md +++ b/docs/src/pages/components/material-icons/material-icons-fr.md @@ -5,9 +5,9 @@ components: Icones, SvgIcon # Icônes Material Ui -

    Plus de 1000 Icônes Material conçues pour React sont disponibles depuis le site officiel.

    +

    1,100+ React Material icons ready to use from the official website.

    -Le package [@material-ui/icons](https://www.npmjs.com/package/@material-ui/icons) inclut plus de 1000 [Icones Material Ui](https://material.io/tools/icons/?style=baseline) officielles converties en composants [`SvgIcon`](/api/svg-icon/). +The following npm package, [@material-ui/icons](https://www.npmjs.com/package/@material-ui/icons), includes the 1,100+ official [Material icons](https://material.io/tools/icons/?style=baseline) converted to [`SvgIcon`](/api/svg-icon/) components. {{"demo": "pages/components/material-icons/SearchIcons.js", "hideHeader": true, "bg": true}} diff --git a/docs/src/pages/components/material-icons/material-icons-ja.md b/docs/src/pages/components/material-icons/material-icons-ja.md index 0f5c3de7b15c9f..59900a90762108 100644 --- a/docs/src/pages/components/material-icons/material-icons-ja.md +++ b/docs/src/pages/components/material-icons/material-icons-ja.md @@ -5,9 +5,9 @@ components: Icon, SvgIcon # マテリアルアイコン(Material Icons) -

    1,000+ React Material icons ready to use from the official website.

    +

    1,100+ React Material icons ready to use from the official website.

    -The following npm package, [@material-ui/icons](https://www.npmjs.com/package/@material-ui/icons), includes the 1,000+ official [Material icons](https://material.io/tools/icons/?style=baseline) converted to [`SvgIcon`](/api/svg-icon/) components. +The following npm package, [@material-ui/icons](https://www.npmjs.com/package/@material-ui/icons), includes the 1,100+ official [Material icons](https://material.io/tools/icons/?style=baseline) converted to [`SvgIcon`](/api/svg-icon/) components. {{"demo": "pages/components/material-icons/SearchIcons.js", "hideHeader": true, "bg": true}} diff --git a/docs/src/pages/components/material-icons/material-icons-pt.md b/docs/src/pages/components/material-icons/material-icons-pt.md index 6c7135e5f797e9..e0cd4ee64c5c59 100644 --- a/docs/src/pages/components/material-icons/material-icons-pt.md +++ b/docs/src/pages/components/material-icons/material-icons-pt.md @@ -5,9 +5,9 @@ components: Icon, SvgIcon # Ícones Material -

    Mais de 1.000 ícones React, oficiais do Material e prontos para uso.

    +

    1,100+ React Material icons ready to use from the official website.

    -O pacote npm a seguir, [@material-ui/icons](https://www.npmjs.com/package/@material-ui/icons), inclui os mais de 1,000 [Ícones Material](https://material.io/tools/icons/?style=baseline) oficiais, convertidos para componentes [`SvgIcon`](/api/svg-icon/). +The following npm package, [@material-ui/icons](https://www.npmjs.com/package/@material-ui/icons), includes the 1,100+ official [Material icons](https://material.io/tools/icons/?style=baseline) converted to [`SvgIcon`](/api/svg-icon/) components. {{"demo": "pages/components/material-icons/SearchIcons.js", "hideHeader": true, "bg": true}} diff --git a/docs/src/pages/components/material-icons/material-icons-ru.md b/docs/src/pages/components/material-icons/material-icons-ru.md index c5d5f22a7ab064..5bfa7ce522ba70 100644 --- a/docs/src/pages/components/material-icons/material-icons-ru.md +++ b/docs/src/pages/components/material-icons/material-icons-ru.md @@ -5,9 +5,9 @@ components: Icon, SvgIcon # Material Icons -

    1,000+ React Material icons ready to use from the official website.

    +

    1,100+ React Material icons ready to use from the official website.

    -The following npm package, [@material-ui/icons](https://www.npmjs.com/package/@material-ui/icons), includes the 1,000+ official [Material icons](https://material.io/tools/icons/?style=baseline) converted to [`SvgIcon`](/api/svg-icon/) components. +The following npm package, [@material-ui/icons](https://www.npmjs.com/package/@material-ui/icons), includes the 1,100+ official [Material icons](https://material.io/tools/icons/?style=baseline) converted to [`SvgIcon`](/api/svg-icon/) components. {{"demo": "pages/components/material-icons/SearchIcons.js", "hideHeader": true, "bg": true}} diff --git a/docs/src/pages/components/material-icons/material-icons-zh.md b/docs/src/pages/components/material-icons/material-icons-zh.md index 074a84ddf87698..e2240cec6208db 100644 --- a/docs/src/pages/components/material-icons/material-icons-zh.md +++ b/docs/src/pages/components/material-icons/material-icons-zh.md @@ -3,11 +3,11 @@ title: Material Icons (材料图标) components: Icon, SvgIcon --- -# Material Icons (材料图标) +# Material Icons 材料图标 -

    可以从官方网站上使用超过1,000个React Material图标。

    +

    1,100+ React Material icons ready to use from the official website.

    -我们提供[@material-ui/icons](https://www.npmjs.com/package/@material-ui/icons)这样一个单独的 npm 包,其中包括1000多个已转换为 Svg 图标`SvgIcon` [材料图标](https://material.io/tools/icons/?style=baseline)。

    +The following npm package, [@material-ui/icons](https://www.npmjs.com/package/@material-ui/icons), includes the 1,100+ official [Material icons](https://material.io/tools/icons/?style=baseline) converted to [`SvgIcon`](/api/svg-icon/) components. {{"demo": "pages/components/material-icons/SearchIcons.js", "hideHeader": true, "bg": true}} diff --git a/docs/src/pages/components/menus/menus-zh.md b/docs/src/pages/components/menus/menus-zh.md index 80c4d4baf8ff5e..393cde8dc4b94d 100644 --- a/docs/src/pages/components/menus/menus-zh.md +++ b/docs/src/pages/components/menus/menus-zh.md @@ -3,7 +3,7 @@ title: React Menu(菜单)组件 components: Menu, MenuItem, MenuList, ClickAwayListener, Popover, Popper --- -# Menus(菜单) +# Menus 菜单

    菜单在临时出现的位置上展示一系列的选项列表。

    diff --git a/docs/src/pages/components/modal/modal-zh.md b/docs/src/pages/components/modal/modal-zh.md index e751fa1988b626..907b0393558470 100644 --- a/docs/src/pages/components/modal/modal-zh.md +++ b/docs/src/pages/components/modal/modal-zh.md @@ -3,7 +3,7 @@ title: 模态框 React 组件 components: Modal --- -# Modal +# Modal 模态框

    模态框组件可以用来快速创建对话框、弹出窗口,灯箱等任何你所需的组件。

    diff --git a/docs/src/pages/components/no-ssr/no-ssr-zh.md b/docs/src/pages/components/no-ssr/no-ssr-zh.md index 893e0719f40af6..c1048e64733bfb 100644 --- a/docs/src/pages/components/no-ssr/no-ssr-zh.md +++ b/docs/src/pages/components/no-ssr/no-ssr-zh.md @@ -3,7 +3,7 @@ title: 没有SSR React组件 components: NoSsr --- -# 没有SSR +# SSR 没有

    NoSsr故意从服务器端渲染(SSR)主题中删除组件。

    diff --git a/docs/src/pages/components/pagination/pagination-aa.md b/docs/src/pages/components/pagination/pagination-aa.md new file mode 100644 index 00000000000000..adc92ff753b7fb --- /dev/null +++ b/docs/src/pages/components/pagination/pagination-aa.md @@ -0,0 +1,66 @@ +--- +title: crwdns109415:0crwdne109415:0 +components: crwdns109417:0crwdne109417:0 +--- + +# crwdns109419:0crwdne109419:0 + +

    crwdns109421:0crwdne109421:0

    + +## crwdns109527:0crwdne109527:0 + +crwdns109425:0crwdne109425:0 + +## crwdns109427:0crwdne109427:0 + +crwdns109429:0crwdne109429:0 + +## crwdns109431:0crwdne109431:0 + +crwdns109433:0crwdne109433:0 + +## crwdns109435:0crwdne109435:0 + +crwdns109437:0crwdne109437:0 + +## crwdns109439:0crwdne109439:0 + +crwdns109441:0crwdne109441:0 + +crwdns109443:0crwdne109443:0 + +## crwdns109445:0crwdne109445:0 + +crwdns109447:0crwdne109447:0 + +crwdns109449:0crwdne109449:0 + +## crwdns109451:0crwdne109451:0 + +crwdns109453:0crwdne109453:0 + +## crwdns109455:0crwdne109455:0 + +crwdns109457:0crwdne109457:0 + +crwdns109459:0crwdne109459:0 + +## `crwdns109529:0crwdne109529:0` + +crwdns109531:0crwdne109531:0 crwdns109533:0crwdne109533:0 crwdns109535:0crwdne109535:0 + +```jsx +crwdns109537:0{ usePagination }crwdne109537:0 +``` + +crwdns109539:0crwdne109539:0 + +## crwdns109541:0crwdne109541:0 + +### crwdns109467:0crwdne109467:0 + +crwdns109469:0crwdne109469:0 crwdns109471:0crwdne109471:0 crwdns109473:0crwdne109473:0 + +### crwdns109475:0crwdne109475:0 + +crwdns109477:0crwdne109477:0 diff --git a/docs/src/pages/components/pagination/pagination-de.md b/docs/src/pages/components/pagination/pagination-de.md new file mode 100644 index 00000000000000..2d305a7ff99cf5 --- /dev/null +++ b/docs/src/pages/components/pagination/pagination-de.md @@ -0,0 +1,66 @@ +--- +title: Pagination React component +components: Pagination, PaginationItem +--- + +# Paginierung + +

    The Pagination component enables the user to select a specific page from a range of pages.

    + +## Basic pagination + +{{"demo": "pages/components/pagination/BasicPagination.js"}} + +## Outlined pagination + +{{"demo": "pages/components/pagination/PaginationOutlined.js"}} + +## Rounded pagination + +{{"demo": "pages/components/pagination/PaginationRounded.js"}} + +## Pagination size + +{{"demo": "pages/components/pagination/PaginationSize.js"}} + +## Buttons + +You can optionally enable first-page and last-page buttons, or disable the previous-page and next-page buttons. + +{{"demo": "pages/components/pagination/PaginationButtons.js"}} + +## Pagination ranges + +You can specify how many digits to display either side of current page with the `siblingRange` prop, and adjacent to the start and end page number with the `boundaryRange` prop. + +{{"demo": "pages/components/pagination/PaginationRanges.js"}} + +## Controlled pagination + +{{"demo": "pages/components/pagination/PaginationControlled.js"}} + +## Router integration + +Pagination supports two approaches for Router integration, the `renderItem` prop: + +{{"demo": "pages/components/pagination/PaginationLink.js"}} + +## `usePagination` + +For advanced customization use cases, we expose a `usePagination()` hook. It accepts almost the same options as the Pagination component minus all the props related to the rendering of JSX. The Pagination component uses this hook internally. + +```jsx +import { usePagination } from '@material-ui/lab/Pagination'; +``` + +{{"demo": "pages/components/pagination/UsePagination.js"}} + +## Barrierefreiheit + +### ARIA + +The root node has a role of "navigation" and aria-label "pagination navigation" by default. The page items have an aria-label that identifies the purpose of the item ("go to first page", "go to previous page", "go to page 1" etc.). You can override these using the `getItemAriaLabel` prop. + +### Keyboard + +The pagination items are in tab order, with a tabindex of "0". diff --git a/docs/src/pages/components/pagination/pagination-es.md b/docs/src/pages/components/pagination/pagination-es.md new file mode 100644 index 00000000000000..280d7d308cd4d4 --- /dev/null +++ b/docs/src/pages/components/pagination/pagination-es.md @@ -0,0 +1,66 @@ +--- +title: Pagination React component +components: Pagination, PaginationItem +--- + +# Pagination + +

    The Pagination component enables the user to select a specific page from a range of pages.

    + +## Basic pagination + +{{"demo": "pages/components/pagination/BasicPagination.js"}} + +## Outlined pagination + +{{"demo": "pages/components/pagination/PaginationOutlined.js"}} + +## Rounded pagination + +{{"demo": "pages/components/pagination/PaginationRounded.js"}} + +## Pagination size + +{{"demo": "pages/components/pagination/PaginationSize.js"}} + +## Buttons + +You can optionally enable first-page and last-page buttons, or disable the previous-page and next-page buttons. + +{{"demo": "pages/components/pagination/PaginationButtons.js"}} + +## Pagination ranges + +You can specify how many digits to display either side of current page with the `siblingRange` prop, and adjacent to the start and end page number with the `boundaryRange` prop. + +{{"demo": "pages/components/pagination/PaginationRanges.js"}} + +## Controlled pagination + +{{"demo": "pages/components/pagination/PaginationControlled.js"}} + +## Router integration + +Pagination supports two approaches for Router integration, the `renderItem` prop: + +{{"demo": "pages/components/pagination/PaginationLink.js"}} + +## `usePagination` + +For advanced customization use cases, we expose a `usePagination()` hook. It accepts almost the same options as the Pagination component minus all the props related to the rendering of JSX. The Pagination component uses this hook internally. + +```jsx +import { usePagination } from '@material-ui/lab/Pagination'; +``` + +{{"demo": "pages/components/pagination/UsePagination.js"}} + +## Accesibilidad + +### ARIA + +The root node has a role of "navigation" and aria-label "pagination navigation" by default. The page items have an aria-label that identifies the purpose of the item ("go to first page", "go to previous page", "go to page 1" etc.). You can override these using the `getItemAriaLabel` prop. + +### Keyboard + +The pagination items are in tab order, with a tabindex of "0". diff --git a/docs/src/pages/components/pagination/pagination-fr.md b/docs/src/pages/components/pagination/pagination-fr.md new file mode 100644 index 00000000000000..f9cb75b9a276a2 --- /dev/null +++ b/docs/src/pages/components/pagination/pagination-fr.md @@ -0,0 +1,66 @@ +--- +title: Pagination React component +components: Pagination, PaginationItem +--- + +# Pagination + +

    The Pagination component enables the user to select a specific page from a range of pages.

    + +## Basic pagination + +{{"demo": "pages/components/pagination/BasicPagination.js"}} + +## Outlined pagination + +{{"demo": "pages/components/pagination/PaginationOutlined.js"}} + +## Rounded pagination + +{{"demo": "pages/components/pagination/PaginationRounded.js"}} + +## Pagination size + +{{"demo": "pages/components/pagination/PaginationSize.js"}} + +## Buttons + +You can optionally enable first-page and last-page buttons, or disable the previous-page and next-page buttons. + +{{"demo": "pages/components/pagination/PaginationButtons.js"}} + +## Pagination ranges + +You can specify how many digits to display either side of current page with the `siblingRange` prop, and adjacent to the start and end page number with the `boundaryRange` prop. + +{{"demo": "pages/components/pagination/PaginationRanges.js"}} + +## Controlled pagination + +{{"demo": "pages/components/pagination/PaginationControlled.js"}} + +## Router integration + +Pagination supports two approaches for Router integration, the `renderItem` prop: + +{{"demo": "pages/components/pagination/PaginationLink.js"}} + +## `usePagination` + +For advanced customization use cases, we expose a `usePagination()` hook. It accepts almost the same options as the Pagination component minus all the props related to the rendering of JSX. The Pagination component uses this hook internally. + +```jsx +import { usePagination } from '@material-ui/lab/Pagination'; +``` + +{{"demo": "pages/components/pagination/UsePagination.js"}} + +## Accessibilité + +### ARIA + +The root node has a role of "navigation" and aria-label "pagination navigation" by default. The page items have an aria-label that identifies the purpose of the item ("go to first page", "go to previous page", "go to page 1" etc.). You can override these using the `getItemAriaLabel` prop. + +### Keyboard + +The pagination items are in tab order, with a tabindex of "0". diff --git a/docs/src/pages/components/pagination/pagination-ja.md b/docs/src/pages/components/pagination/pagination-ja.md new file mode 100644 index 00000000000000..991acd84a4920d --- /dev/null +++ b/docs/src/pages/components/pagination/pagination-ja.md @@ -0,0 +1,66 @@ +--- +title: Pagination React component +components: Pagination, PaginationItem +--- + +# Pagination + +

    The Pagination component enables the user to select a specific page from a range of pages.

    + +## Basic pagination + +{{"demo": "pages/components/pagination/BasicPagination.js"}} + +## Outlined pagination + +{{"demo": "pages/components/pagination/PaginationOutlined.js"}} + +## Rounded pagination + +{{"demo": "pages/components/pagination/PaginationRounded.js"}} + +## Pagination size + +{{"demo": "pages/components/pagination/PaginationSize.js"}} + +## Buttons + +You can optionally enable first-page and last-page buttons, or disable the previous-page and next-page buttons. + +{{"demo": "pages/components/pagination/PaginationButtons.js"}} + +## Pagination ranges + +You can specify how many digits to display either side of current page with the `siblingRange` prop, and adjacent to the start and end page number with the `boundaryRange` prop. + +{{"demo": "pages/components/pagination/PaginationRanges.js"}} + +## Controlled pagination + +{{"demo": "pages/components/pagination/PaginationControlled.js"}} + +## Router integration + +Pagination supports two approaches for Router integration, the `renderItem` prop: + +{{"demo": "pages/components/pagination/PaginationLink.js"}} + +## `usePagination` + +For advanced customization use cases, we expose a `usePagination()` hook. It accepts almost the same options as the Pagination component minus all the props related to the rendering of JSX. The Pagination component uses this hook internally. + +```jsx +import { usePagination } from '@material-ui/lab/Pagination'; +``` + +{{"demo": "pages/components/pagination/UsePagination.js"}} + +## アクセシビリティ + +### ARIA + +The root node has a role of "navigation" and aria-label "pagination navigation" by default. The page items have an aria-label that identifies the purpose of the item ("go to first page", "go to previous page", "go to page 1" etc.). You can override these using the `getItemAriaLabel` prop. + +### Keyboard + +The pagination items are in tab order, with a tabindex of "0". diff --git a/docs/src/pages/components/pagination/pagination-pt.md b/docs/src/pages/components/pagination/pagination-pt.md new file mode 100644 index 00000000000000..4a1aebd25d6107 --- /dev/null +++ b/docs/src/pages/components/pagination/pagination-pt.md @@ -0,0 +1,66 @@ +--- +title: Pagination React component +components: Pagination, PaginationItem +--- + +# Pagination + +

    The Pagination component enables the user to select a specific page from a range of pages.

    + +## Basic pagination + +{{"demo": "pages/components/pagination/BasicPagination.js"}} + +## Outlined pagination + +{{"demo": "pages/components/pagination/PaginationOutlined.js"}} + +## Rounded pagination + +{{"demo": "pages/components/pagination/PaginationRounded.js"}} + +## Pagination size + +{{"demo": "pages/components/pagination/PaginationSize.js"}} + +## Buttons + +You can optionally enable first-page and last-page buttons, or disable the previous-page and next-page buttons. + +{{"demo": "pages/components/pagination/PaginationButtons.js"}} + +## Pagination ranges + +You can specify how many digits to display either side of current page with the `siblingRange` prop, and adjacent to the start and end page number with the `boundaryRange` prop. + +{{"demo": "pages/components/pagination/PaginationRanges.js"}} + +## Controlled pagination + +{{"demo": "pages/components/pagination/PaginationControlled.js"}} + +## Router integration + +Pagination supports two approaches for Router integration, the `renderItem` prop: + +{{"demo": "pages/components/pagination/PaginationLink.js"}} + +## `usePagination` + +For advanced customization use cases, we expose a `usePagination()` hook. It accepts almost the same options as the Pagination component minus all the props related to the rendering of JSX. The Pagination component uses this hook internally. + +```jsx +import { usePagination } from '@material-ui/lab/Pagination'; +``` + +{{"demo": "pages/components/pagination/UsePagination.js"}} + +## Acessibilidade + +### ARIA + +The root node has a role of "navigation" and aria-label "pagination navigation" by default. The page items have an aria-label that identifies the purpose of the item ("go to first page", "go to previous page", "go to page 1" etc.). You can override these using the `getItemAriaLabel` prop. + +### Keyboard + +The pagination items are in tab order, with a tabindex of "0". diff --git a/docs/src/pages/components/pagination/pagination-ru.md b/docs/src/pages/components/pagination/pagination-ru.md new file mode 100644 index 00000000000000..b665c0ff3cbf5c --- /dev/null +++ b/docs/src/pages/components/pagination/pagination-ru.md @@ -0,0 +1,66 @@ +--- +title: Pagination React component +components: Pagination, PaginationItem +--- + +# Pagination + +

    The Pagination component enables the user to select a specific page from a range of pages.

    + +## Basic pagination + +{{"demo": "pages/components/pagination/BasicPagination.js"}} + +## Outlined pagination + +{{"demo": "pages/components/pagination/PaginationOutlined.js"}} + +## Rounded pagination + +{{"demo": "pages/components/pagination/PaginationRounded.js"}} + +## Pagination size + +{{"demo": "pages/components/pagination/PaginationSize.js"}} + +## Buttons + +You can optionally enable first-page and last-page buttons, or disable the previous-page and next-page buttons. + +{{"demo": "pages/components/pagination/PaginationButtons.js"}} + +## Pagination ranges + +You can specify how many digits to display either side of current page with the `siblingRange` prop, and adjacent to the start and end page number with the `boundaryRange` prop. + +{{"demo": "pages/components/pagination/PaginationRanges.js"}} + +## Controlled pagination + +{{"demo": "pages/components/pagination/PaginationControlled.js"}} + +## Router integration + +Pagination supports two approaches for Router integration, the `renderItem` prop: + +{{"demo": "pages/components/pagination/PaginationLink.js"}} + +## `usePagination` + +For advanced customization use cases, we expose a `usePagination()` hook. It accepts almost the same options as the Pagination component minus all the props related to the rendering of JSX. The Pagination component uses this hook internally. + +```jsx +import { usePagination } from '@material-ui/lab/Pagination'; +``` + +{{"demo": "pages/components/pagination/UsePagination.js"}} + +## Доступность + +### ARIA + +The root node has a role of "navigation" and aria-label "pagination navigation" by default. The page items have an aria-label that identifies the purpose of the item ("go to first page", "go to previous page", "go to page 1" etc.). You can override these using the `getItemAriaLabel` prop. + +### Keyboard + +The pagination items are in tab order, with a tabindex of "0". diff --git a/docs/src/pages/components/pagination/pagination-zh.md b/docs/src/pages/components/pagination/pagination-zh.md new file mode 100644 index 00000000000000..ed897b5abdbf75 --- /dev/null +++ b/docs/src/pages/components/pagination/pagination-zh.md @@ -0,0 +1,66 @@ +--- +title: Pagination React component +components: Pagination, PaginationItem +--- + +# Pagination + +

    The Pagination component enables the user to select a specific page from a range of pages.

    + +## Basic pagination + +{{"demo": "pages/components/pagination/BasicPagination.js"}} + +## Outlined pagination + +{{"demo": "pages/components/pagination/PaginationOutlined.js"}} + +## Rounded pagination + +{{"demo": "pages/components/pagination/PaginationRounded.js"}} + +## Pagination size + +{{"demo": "pages/components/pagination/PaginationSize.js"}} + +## Buttons + +You can optionally enable first-page and last-page buttons, or disable the previous-page and next-page buttons. + +{{"demo": "pages/components/pagination/PaginationButtons.js"}} + +## Pagination ranges + +You can specify how many digits to display either side of current page with the `siblingRange` prop, and adjacent to the start and end page number with the `boundaryRange` prop. + +{{"demo": "pages/components/pagination/PaginationRanges.js"}} + +## Controlled pagination + +{{"demo": "pages/components/pagination/PaginationControlled.js"}} + +## Router integration + +Pagination supports two approaches for Router integration, the `renderItem` prop: + +{{"demo": "pages/components/pagination/PaginationLink.js"}} + +## `usePagination` + +For advanced customization use cases, we expose a `usePagination()` hook. It accepts almost the same options as the Pagination component minus all the props related to the rendering of JSX. The Pagination component uses this hook internally. + +```jsx +import { usePagination } from '@material-ui/lab/Pagination'; +``` + +{{"demo": "pages/components/pagination/UsePagination.js"}} + +## 可访问性 + +### ARIA + +The root node has a role of "navigation" and aria-label "pagination navigation" by default. The page items have an aria-label that identifies the purpose of the item ("go to first page", "go to previous page", "go to page 1" etc.). You can override these using the `getItemAriaLabel` prop. + +### Keyboard + +The pagination items are in tab order, with a tabindex of "0". diff --git a/docs/src/pages/components/paper/paper-zh.md b/docs/src/pages/components/paper/paper-zh.md index 695d0e62587cf0..c258ac9b205694 100644 --- a/docs/src/pages/components/paper/paper-zh.md +++ b/docs/src/pages/components/paper/paper-zh.md @@ -3,7 +3,7 @@ title: React Paper(纸张)组件 components: Paper --- -# Paper +# Paper 纸张

    在 Material Design 中,我们在屏幕上展现了纸张的物理属性。

    @@ -11,7 +11,7 @@ components: Paper {{"demo": "pages/components/paper/SimplePaper.js", "bg": true}} -## 变种(Variants) +## 变种 If you need an outlined surface, use the `variant` prop. diff --git a/docs/src/pages/components/pickers/pickers-zh.md b/docs/src/pages/components/pickers/pickers-zh.md index af840a23895038..2961ca674211e0 100644 --- a/docs/src/pages/components/pickers/pickers-zh.md +++ b/docs/src/pages/components/pickers/pickers-zh.md @@ -3,7 +3,7 @@ title: Date picker, Time picker React components components: TextField --- -# 日期/时间选择器 +# Date / Time pickers 日期/时间选择器

    日期选择器和时间选择器提供了一种从预定集中选择单个值的简单方法。

    diff --git a/docs/src/pages/components/popover/popover-zh.md b/docs/src/pages/components/popover/popover-zh.md index 8c4e84339925b3..7b7a8620f632c8 100644 --- a/docs/src/pages/components/popover/popover-zh.md +++ b/docs/src/pages/components/popover/popover-zh.md @@ -3,7 +3,7 @@ title: 气泡卡片 React 组件 components: Grow, Popover --- -# 弹出框 (Popover) +# Popover 弹出框

    弹出框可用于在元素边缘显示某些内容。

    diff --git a/docs/src/pages/components/popper/popper-zh.md b/docs/src/pages/components/popper/popper-zh.md index 4ccc38f1f89ff3..c165e8b2d5797f 100644 --- a/docs/src/pages/components/popper/popper-zh.md +++ b/docs/src/pages/components/popper/popper-zh.md @@ -3,7 +3,7 @@ title: 弹出器 React 组件 components: Popper --- -# Popper +# Popper 弹出提示

    A Popper can be used to display some content on top of another. It's an alternative to react-popper.

    diff --git a/docs/src/pages/components/portal/portal-zh.md b/docs/src/pages/components/portal/portal-zh.md index b1effe1ef73328..6af7e325b2db2b 100644 --- a/docs/src/pages/components/portal/portal-zh.md +++ b/docs/src/pages/components/portal/portal-zh.md @@ -3,7 +3,7 @@ title: React Portal 组件 components: Portal --- -# Portal +# Portal 传送门

    Portal 组件将其子节点渲染到当前组件层次结构之外的新 "子树" 中。

    diff --git a/docs/src/pages/components/progress/progress-zh.md b/docs/src/pages/components/progress/progress-zh.md index 643c4692d55d65..171aaf49894093 100644 --- a/docs/src/pages/components/progress/progress-zh.md +++ b/docs/src/pages/components/progress/progress-zh.md @@ -3,7 +3,7 @@ title: React Circular Progress(环形进度条)、Linear Progress(线形 components: CircularProgress, LinearProgress --- -# Progress(进度条) +# Progress 进度条

    Progress indicators commonly known as spinners, express an unspecified wait time or display the length of a process. The animation works with CSS, not JavaScript.

    diff --git a/docs/src/pages/components/radio-buttons/radio-buttons-zh.md b/docs/src/pages/components/radio-buttons/radio-buttons-zh.md index ee43ccf9d3f9cd..0319659ac2aad0 100644 --- a/docs/src/pages/components/radio-buttons/radio-buttons-zh.md +++ b/docs/src/pages/components/radio-buttons/radio-buttons-zh.md @@ -3,7 +3,7 @@ title: React Radio buttons(单选按钮)组件 components: Radio, RadioGroup, FormControl, FormLabel, FormControlLabel --- -# Radio(单选框) +# Radio 单选框

    用户可以通过单选按钮从一组中选择一个选项。

    diff --git a/docs/src/pages/components/rating/rating-zh.md b/docs/src/pages/components/rating/rating-zh.md index 60a8724bd0c267..2b4a94e42310e1 100644 --- a/docs/src/pages/components/rating/rating-zh.md +++ b/docs/src/pages/components/rating/rating-zh.md @@ -3,7 +3,7 @@ title: Rating React component components: Rating --- -# Rating (评分) +# Rating 评分

    Ratings provide insight regarding others’ opinions and experiences with a product. Users can also rate products they’ve purchased.

    diff --git a/docs/src/pages/components/selects/selects-aa.md b/docs/src/pages/components/selects/selects-aa.md index dbc6701b36fa84..16bd7ddcc66b24 100644 --- a/docs/src/pages/components/selects/selects-aa.md +++ b/docs/src/pages/components/selects/selects-aa.md @@ -13,57 +13,63 @@ crwdns91546:0crwdne91546:0 crwdns91548:0crwdne91548:0 -## crwdns91550:0crwdne91550:0 +## crwdns109987:0crwdne109987:0 -crwdns91552:0crwdne91552:0 +crwdns109989:0crwdne109989:0 -crwdns91554:0crwdne91554:0 +crwdns109991:0crwdne109991:0 crwdns109993:0crwdne109993:0 -## crwdns104638:0crwdne104638:0 +## crwdns109995:0crwdne109995:0 -crwdns104640:0crwdne104640:0 crwdns104642:0crwdne104642:0 +crwdns109997:0crwdne109997:0 -## crwdns104644:0crwdne104644:0 +crwdns109999:0crwdne109999:0 -crwdns104646:0crwdne104646:0 crwdns104648:0crwdne104648:0 +## crwdns110001:0crwdne110001:0 -crwdns104650:0crwdne104650:0 crwdns104652:0crwdne104652:0 +crwdns110003:0crwdne110003:0 crwdns110005:0crwdne110005:0 -crwdns104654:0crwdne104654:0 +## crwdns110007:0crwdne110007:0 -## crwdns104656:0crwdne104656:0 +crwdns110009:0crwdne110009:0 crwdns110011:0crwdne110011:0 -crwdns104658:0crwdne104658:0 crwdns104660:0crwdne104660:0 +crwdns110013:0crwdne110013:0 crwdns110015:0crwdne110015:0 -crwdns104662:0crwdne104662:0 crwdns104664:0crwdne104664:0 +crwdns110017:0crwdne110017:0 -crwdns104666:0crwdne104666:0 +## crwdns110019:0crwdne110019:0 -## crwdns104668:0crwdne104668:0 +crwdns110021:0crwdne110021:0 crwdns110023:0crwdne110023:0 -crwdns104670:0crwdne104670:0 +crwdns110025:0crwdne110025:0 crwdns110027:0crwdne110027:0 -## crwdns104672:0crwdne104672:0 +crwdns110029:0crwdne110029:0 -crwdns104674:0crwdne104674:0 +## crwdns110031:0crwdne110031:0 -crwdns104676:0crwdne104676:0 +crwdns110033:0crwdne110033:0 -## crwdns104678:0crwdne104678:0 +## crwdns110035:0crwdne110035:0 -crwdns104680:0crwdne104680:0 +crwdns110037:0crwdne110037:0 -crwdns104682:0crwdne104682:0 +crwdns110039:0crwdne110039:0 -## crwdns104684:0crwdne104684:0 +## crwdns110041:0crwdne110041:0 -crwdns104686:0crwdne104686:0 crwdns104688:0crwdne104688:0 +crwdns110043:0crwdne110043:0 + +crwdns110045:0crwdne110045:0 + +## crwdns110047:0crwdne110047:0 + +crwdns110049:0crwdne110049:0 crwdns110051:0crwdne110051:0 ```jsx crwdns104946:0crwdne104946:0 ``` -crwdns104690:0crwdne104690:0 +crwdns110053:0crwdne110053:0 ```jsx crwdns104948:0crwdne104948:0 diff --git a/docs/src/pages/components/selects/selects-de.md b/docs/src/pages/components/selects/selects-de.md index 8a4bb046fab9ae..4a2322e0dd4181 100644 --- a/docs/src/pages/components/selects/selects-de.md +++ b/docs/src/pages/components/selects/selects-de.md @@ -13,43 +13,49 @@ Menüs werden über ihren Referenzelementen so positioniert, dass der aktuell au {{"demo": "pages/components/selects/SimpleSelect.js"}} -## Native Auswahl +## Advanced features -Da die Benutzererfahrung auf mobilen Geräten durch die native Auswahl der Plattform verbessert werden kann, erlauben wir ein solches Muster. +The Select component is meant to be interchangeable with a native `` element. + +If you are looking for more advanced features, like combobox, multiselect, autocomplete, async or creatable support, head to the [`Autocomplete` component](/components/autocomplete/). It's also meant to be an improved version of the "react-select" package. + +## Native Select + +As the user experience can be improved on mobile using the native select of the platform, we allow such pattern. {{"demo": "pages/components/selects/NativeSelects.js"}} -## Campos de texto +## Text Fields El componente `TextField` es un control de formulario completo, incluyendo una etiqueta, el campo de texto y texto de ayuda. You can find an example with the select mode [in this section](/components/text-fields/#select). -## Selecciones personalizadas +## Customized selects Here are some examples of customizing the component. You can learn more about this in the [overrides documentation page](/customization/components/). diff --git a/docs/src/pages/components/selects/selects-fr.md b/docs/src/pages/components/selects/selects-fr.md index 76d251a1e583b9..a0b936ca45cfdf 100644 --- a/docs/src/pages/components/selects/selects-fr.md +++ b/docs/src/pages/components/selects/selects-fr.md @@ -13,13 +13,19 @@ Menus are positioned over their emitting elements such that the currently select {{"demo": "pages/components/selects/SimpleSelect.js"}} +## Advanced features + +The Select component is meant to be interchangeable with a native `` element. + +If you are looking for more advanced features, like combobox, multiselect, autocomplete, async or creatable support, head to the [`Autocomplete` component](/components/autocomplete/). It's also meant to be an improved version of the "react-select" package. + +## Native Select + +As the user experience can be improved on mobile using the native select of the platform, we allow such pattern. {{"demo": "pages/components/selects/NativeSelects.js"}} -## テキストフィールド +## Text Fields -`TextField` ラッパーコンポーネントは、ラベル、入力、およびヘルプテキストを含む完全なフォームコントロールです。 このセクションで、選択モード 例を見つけることができます。

    +`TextField` ラッパーコンポーネントは、ラベル、入力、およびヘルプテキストを含む完全なフォームコントロールです。 You can find an example with the select mode [in this section](/components/text-fields/#select). -## カスタマイズされた選択 +## Customized selects コンポーネントのカスタマイズの例を次に示します。 詳細については、 [オーバーライドのドキュメントページ](/customization/components/)を参照してください。 -最初のステップは、 `InputBase` コンポーネントのスタイル設定です。 スタイルを設定したら、テキストフィールドとして直接使用するか、select `input` プロパティに提供して、 `select` フィールドを作成できます。 +The first step is to style the `InputBase` component. Once it's styled, you can either use it directly as a text field or provide it to the select `input` property to have a `select` field. {{"demo": "pages/components/selects/CustomizedSelects.js"}} -## 複数選択 +## Multiple Select -`Select` コンポーネントは、複数の選択を処理できます。 `multiple` プロパティで有効になります。 +The `Select` component can handle multiple selections. It's enabled with the `multiple` property. -単一選択の場合と同様に、 `onChange` コールバックで `event.target.value` にアクセスすることにより、新しい値を引き出すことができます。 常に配列です。 +Like with the single selection, you can pull out the new value by accessing `event.target.value` in the `onChange` callback. It's always an array. {{"demo": "pages/components/selects/MultipleSelect.js"}} -## 制御開選択 +## Controlled Open Select {{"demo": "pages/components/selects/ControlledOpenSelect.js"}} -## ダイアログ付き +## With a Dialog -Material Designの仕様では推奨されていませんが、ダイアログ内でselectを使用できます。 +While it's discouraged by the Material Design specification, you can use a select inside a dialog. {{"demo": "pages/components/selects/DialogSelect.js"}} diff --git a/docs/src/pages/components/selects/selects-pt.md b/docs/src/pages/components/selects/selects-pt.md index b3f065ca31ca7f..aee131c61291ef 100644 --- a/docs/src/pages/components/selects/selects-pt.md +++ b/docs/src/pages/components/selects/selects-pt.md @@ -13,39 +13,45 @@ Os menus são posicionados sobre seus elementos emissores, de modo que o item de {{"demo": "pages/components/selects/SimpleSelect.js"}} -## Seleção Nativa +## Advanced features -Como a experiência do usuário pode ser melhorada em dispositivos móveis usando a seleção nativa da plataforma, permitimos esse padrão. +The Select component is meant to be interchangeable with a native `` element. + +If you are looking for more advanced features, like combobox, multiselect, autocomplete, async or creatable support, head to the [`Autocomplete` component](/components/autocomplete/). It's also meant to be an improved version of the "react-select" package. + ## Native Select As the user experience can be improved on mobile using the native select of the platform, we allow such pattern. {{"demo": "pages/components/selects/NativeSelects.js"}} -## Текстовые поля +## Text Fields `TextField` представляет собой полноценный элемент управления формы, включая метку (label), само поле ввода и вспомогательный текст. You can find an example with the select mode [in this section](/components/text-fields/#select). diff --git a/docs/src/pages/components/selects/selects-zh.md b/docs/src/pages/components/selects/selects-zh.md index 07f59365056142..527cb595e37412 100644 --- a/docs/src/pages/components/selects/selects-zh.md +++ b/docs/src/pages/components/selects/selects-zh.md @@ -3,7 +3,7 @@ title: React Select(选择器)组件 components: Select, NativeSelect --- -# Select(选择器) +# Select 选择器

    选择器组件能从一个选项列表中去获得用户所提供的信息。

    @@ -13,25 +13,31 @@ components: Select, NativeSelect {{"demo": "pages/components/selects/SimpleSelect.js"}} -## 原生的选择器 +## Advanced features -我们允许这种模式,如此一来,选择在移动设备上使用平台的原生选择器能够改进用户体验。 +The Select component is meant to be interchangeable with a native `