Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[docs] Sync translations #20779

Merged
merged 1 commit into from Apr 26, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
12 changes: 6 additions & 6 deletions docs/src/pages/components/about-the-lab/about-the-lab-pt.md
Expand Up @@ -2,22 +2,22 @@

<p class="description">Este pacote hospeda os componentes da incubadora que ainda não estão prontos para mover para o núcleo (core).</p>

A principal diferença entre o lab e o core (núcleo) é como os componentes são versionados. Tendo um pacote separado para o lab, podemos liberar alterações radicais quando necessário, enquanto o pacote do core segue uma [política de movimentação mais lenta](https://material-ui.com/versions/#release-frequency).
A principal diferença entre o lab e o core (núcleo) é como os componentes são versionados. Tendo um pacote separado para o lab, podemos liberar alterações críticas quando necessário, enquanto o pacote do core segue uma [política de liberação mais lenta](https://material-ui.com/versions/#release-frequency).

À medida que os desenvolvedores usam, testam os componentes e relatam problemas, os mantenedores aprendem mais sobre as deficiências dos componentes: recursos ausentes, problemas de acessibilidade, bugs, design de API, etc. Quanto mais antigo e mais usado for um componente, menor é a probabilidade de novos problemas serem encontrados e, posteriormente, novas alterações radicais precisarão ser introduzidas.
À medida que os desenvolvedores usam, testam os componentes e relatam problemas, os mantenedores aprendem mais sobre as deficiências dos componentes: recursos ausentes, problemas de acessibilidade, bugs, design de API, etc. Quanto mais antigo e mais usado for um componente, menor é a probabilidade de novos problemas serem encontrados e, consequentemente, necessidades de alterações críticas serem feitas.

Para que um componente esteja pronto para ir para o core, são considerados os seguintes critérios:

* Ele precisa ser **utilizado**. A equipe do Material-UI usa o Google Analytics e outras métricas para avaliar o uso de cada componente. Um componente do lab com baixo uso significa que ainda não está totalmente funcionando ou que há uma baixa demanda por ele.
* Ele precisa corresponder à **qualidade de código** dos componentes principais. O componente não precisa ser perfeito para fazer parte do core, mas ele deve ser confiável o suficiente para que os desenvolvedores possam depender dele.
* Ele precisa ser **utilizado**. A equipe do Material-UI usa o Google Analytics e outras métricas para avaliar o uso de cada componente. Um componente do lab com baixo uso significa que ainda não está totalmente funcional ou que há uma baixa demanda por ele.
* Ele precisa atender critérios de **qualidade de código**, semelhante aos componentes do core. O componente não precisa ser perfeito para fazer parte do core, mas ele deve ser confiável o suficiente para que os desenvolvedores possam depender dele.
* Cada componente precisa de **definições de tipo**. Atualmente, não é necessário que um componente do lab seja tipado, mas ele precisará ser tipado para passar para o core.
* Requer boa **cobertura de teste**. Atualmente, alguns dos componentes do lab não têm testes abrangentes.
* O componente pode ser usado como **alavancagem** para incentivar os usuários a atualizar para a versão mais recente? Quanto menos fragmentada a comunidade, melhor.
* Ele precisa ter uma baixa probabilidade de **alterações radicais** no curto/médio prazo. Por exemplo, se o componente precisar de um novo recurso que provavelmente precisará de alterações radicais, pode ser preferível adiar sua promoção para o core.
* Ele precisa ter uma baixa probabilidade de **alterações críticas** no curto/médio prazo. Por exemplo, se o componente precisar de um novo recurso que provavelmente precisará de alterações críticas, pode ser preferível adiar sua promoção para o core.

## Instalação

Instale o pacote no diretório do projeto com:
Instale o pacote no diretório do seu projeto com:

```sh
// usando npm
Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/alert/alert-de.md
Expand Up @@ -25,7 +25,7 @@ Die `AlertTitle`-Komponente kann verwendet werden um einen formatierten Titel ü

Ein Hinweis kann eine Aktion wie zum Beispiel Schließen oder Zurücksetzen haben. Sie wird am Ende des Hinweises, hinter der Nachricht, angezeigt.

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.
Wenn ein `onClose` callback und kein `action` prop gesetzt ist, wird ein Schließ-Icon angezeigt. The `action` prop can be used to provide an alternative action, for example using a Button or IconButton.

{{"demo": "pages/components/alert/ActionAlerts.js"}}

Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/app-bar/app-bar-pt.md
Expand Up @@ -89,7 +89,7 @@ function App() {

Você pode usar o hook `useScrollTrigger()` para responder às ações de rolagem do usuário.

### Barra de Aplicativos oculta
### Barra de aplicativos oculta

A barra de aplicativos sumirá ao descer a página para deixar mais espaço de leitura.

Expand Down
35 changes: 19 additions & 16 deletions docs/src/pages/components/autocomplete/autocomplete-aa.md
Expand Up @@ -36,22 +36,26 @@ crwdns130722:0crwdne130722:0

crwdns131304:0crwdne131304:0

1. crwdns131306:0crwdne131306:0
2. crwdns131308:0crwdne131308:0
1. crwdns131692:0crwdne131692:0 crwdns131694:0crwdne131694:0
2. crwdns131696:0crwdne131696:0 crwdns131698:0crwdne131698:0

> crwdns131310:0crwdne131310:0

## crwdns104508:0crwdne104508:0
crwdns131700:0crwdne131700:0

crwdns131312:0crwdne131312:0 crwdns131314:0crwdne131314:0
## crwdns104508:0crwdne104508:0

crwdns131316:0crwdne131316:0
crwdns131702:0crwdne131702:0 crwdns131704:0crwdne131704:0

crwdns131318:0crwdne131318:0

### crwdns131320:0crwdne131320:0
### crwdns131706:0crwdne131706:0

crwdns131708:0crwdne131708:0

crwdns131322:0crwdne131322:0 crwdns131324:0crwdne131324:0
- crwdns131710:0crwdne131710:0
- crwdns131712:0crwdne131712:0
- crwdns131714:0crwdne131714:0

crwdns131326:0crwdne131326:0

Expand All @@ -75,7 +79,7 @@ crwdns131336:0crwdne131336:0 crwdns131338:0crwdne131338:0 crwdns131340:0crwdne13
crwdns104530:0crwdne104530:0
```

- crwdns105108:0crwdne105108:0
- crwdns131716:0crwdne131716:0

crwdns131342:0crwdne131342:0

Expand Down Expand Up @@ -143,7 +147,7 @@ crwdns131396:0crwdne131396:0

## crwdns106451:0crwdne106451:0

crwdns131398:0crwdne131398:0 crwdns131400:0crwdne131400:0
crwdns131642:0crwdne131642:0 crwdns131400:0crwdne131400:0

```js
crwdns104588:0{ createFilterOptions }crwdne104588:0
Expand All @@ -158,9 +162,8 @@ crwdns104588:0{ createFilterOptions }crwdne104588:0
- crwdns131410:0[optional]crwdne131410:0 crwdns131412:0crwdne131412:0
- crwdns131414:0[optional]crwdne131414:0 crwdns131416:0crwdne131416:0 crwdns131418:0crwdne131418:0 crwdns131420:0crwdne131420:0
- crwdns131422:0[optional]crwdne131422:0
- crwdns131424:0[optional]crwdne131424:0 crwdns131426:0crwdne131426:0
- crwdns131428:0[optional]crwdne131428:0
- crwdns131430:0[optional]crwdne131430:0 crwdns131432:0crwdne131432:0
- crwdns131718:0[optional]crwdne131718:0
- crwdns131720:0[optional]crwdne131720:0 crwdns131722:0crwdne131722:0

#### crwdns130372:0crwdne130372:0

Expand Down Expand Up @@ -198,12 +201,12 @@ crwdns131458:0crwdne131458:0

crwdns131460:0crwdne131460:0 crwdns131462:0crwdne131462:0

- crwdns107863:0crwdne107863:0 crwdns107865:0crwdne107865:0 crwdns107867:0crwdne107867:0
- crwdns107869:0crwdne107869:0
crwdns107871:0{...params}crwdnd107871:0{{
- crwdns131724:0crwdne131724:0 crwdns131726:0crwdne131726:0 crwdns131728:0crwdne131728:0
- crwdns131730:0crwdne131730:0
crwdns131732:0{...params}crwdnd131732:0{{
...params.inputProps,
autoComplete: 'new-password',
}}crwdne107871:0
}}crwdne131732:0

### crwdns131464:0crwdne131464:0

Expand Down
21 changes: 12 additions & 9 deletions docs/src/pages/components/autocomplete/autocomplete-de.md
Expand Up @@ -36,22 +36,26 @@ Wählen Sie eines der 248 Länder.

The component has two states that can be controlled:

1. the "value" state with the `value`/`onChange` props combination.
2. the "input value" state with the `inputValue`/`onInputChange` props combination.
1. the "value" state with the `value`/`onChange` props combination. This state represents the value selected by the user, for instance when pressing <kbd>Enter</kbd>.
2. the "input value" state with the `inputValue`/`onInputChange` props combination. This state represents the value displayed in the textbox.

> ⚠️ These two state are isolated, they should be controlled independently.

## Free solo
{{"demo": "pages/components/autocomplete/ControllableStates.js"}}

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.
## Free solo

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 clear the selected value).
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 or react-autowhatever.

{{"demo": "pages/components/autocomplete/FreeSolo.js"}}

### Helper message
### Creatable

If you intend to use this mode for a [combo box](#combo-box) like experience (an enhanced version of a select element) we recommend setting:

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"`.
- `selectOnFocus` to helps the user clear the selected value.
- `clearOnBlur` to helps the user to enter a new value.
- A last option, for instance `Add "YOUR SEARCH"`.

{{"demo": "pages/components/autocomplete/FreeSoloCreateOption.js"}}

Expand Down Expand Up @@ -143,7 +147,7 @@ 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 `filterOptions` prop. Sie können es verwenden, um das Standard-Filterverhalten der Option zu ändern.

```js
import { createFilterOptions } from '@material-ui/lab/Autocomplete';
Expand All @@ -158,7 +162,6 @@ import { createFilterOptions } from '@material-ui/lab/Autocomplete';
- `config.ignoreCase` (*Boolean* [optional]): Defaults to `true`. Alles in Kleinbuchstaben.
- `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.
- `config.matchFrom` (*'any' | 'start'* [optional]): Defaults to `'any'`.
- `config.startAfter`(*Number* [optional]): Default to `0`. Show the suggested options only after a certain number of letters
- `config.stringify` (*Func* [optional]): Controls how an option is converted into a string so that it can be matched against the input text fragment.
- `config.trim ` (*Boolean* [optional]): Standardeinstellung ist `false`. Abschließende Leerzeichen entfernen.

Expand Down
21 changes: 12 additions & 9 deletions docs/src/pages/components/autocomplete/autocomplete-es.md
Expand Up @@ -36,22 +36,26 @@ Choose one of the 248 countries.

The component has two states that can be controlled:

1. the "value" state with the `value`/`onChange` props combination.
2. the "input value" state with the `inputValue`/`onInputChange` props combination.
1. the "value" state with the `value`/`onChange` props combination. This state represents the value selected by the user, for instance when pressing <kbd>Enter</kbd>.
2. the "input value" state with the `inputValue`/`onInputChange` props combination. This state represents the value displayed in the textbox.

> ⚠️ These two state are isolated, they should be controlled independently.

## Free solo
{{"demo": "pages/components/autocomplete/ControllableStates.js"}}

Setear `freeSolo` a true, para que el cuadro de texto pueda contener cualquier valor arbitrario. La propiedad está diseñada para cubrir el principal caso de uso de una caja de búsqueda con sugerencias, ej: Google Search.
## Free solo

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 clear the selected value).
Setear `freeSolo` a true, para que el cuadro de texto pueda contener cualquier valor arbitrario. The prop is designed to cover the primary use case of a **search box** with suggestions, e.g. Google search or react-autowhatever.

{{"demo": "pages/components/autocomplete/FreeSolo.js"}}

### Helper message
### Creatable

If you intend to use this mode for a [combo box](#combo-box) like experience (an enhanced version of a select element) we recommend setting:

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"`.
- `selectOnFocus` to helps the user clear the selected value.
- `clearOnBlur` to helps the user to enter a new value.
- A last option, for instance `Add "YOUR SEARCH"`.

{{"demo": "pages/components/autocomplete/FreeSoloCreateOption.js"}}

Expand Down Expand Up @@ -143,7 +147,7 @@ La siguiente demostración se basa en [autosuggest-highlight](https://github.com

## Filtro personalizado

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.
The component exposes a factory to create a filter method that can provided to the `filterOptions` prop. You can use it to change the default option filter behavior.

```js
import { createFilterOptions } from '@material-ui/lab/Autocomplete';
Expand All @@ -158,7 +162,6 @@ import { createFilterOptions } from '@material-ui/lab/Autocomplete';
- `config.ignoreCase` (*Boolean* [optional]): Defaults to `true`. Lowercase everything.
- `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.
- `config.matchFrom` (*'any' | 'start'* [optional]): Defaults to `'any'`.
- `config.startAfter`(*Number* [optional]): Default to `0`. Show the suggested options only after a certain number of letters
- `config.stringify` (*Func* [optional]): Controls how an option is converted into a string so that it can be matched against the input text fragment.
- `config.trim` (*Boolean* [optional]): Default `false`. Remove trailing spaces.

Expand Down
21 changes: 12 additions & 9 deletions docs/src/pages/components/autocomplete/autocomplete-fr.md
Expand Up @@ -36,22 +36,26 @@ Choose one of the 248 countries.

The component has two states that can be controlled:

1. the "value" state with the `value`/`onChange` props combination.
2. the "input value" state with the `inputValue`/`onInputChange` props combination.
1. the "value" state with the `value`/`onChange` props combination. This state represents the value selected by the user, for instance when pressing <kbd>Enter</kbd>.
2. the "input value" state with the `inputValue`/`onInputChange` props combination. This state represents the value displayed in the textbox.

> ⚠️ These two state are isolated, they should be controlled independently.

## Free solo
{{"demo": "pages/components/autocomplete/ControllableStates.js"}}

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.
## Free solo

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 clear the selected value).
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 or react-autowhatever.

{{"demo": "pages/components/autocomplete/FreeSolo.js"}}

### Helper message
### Creatable

If you intend to use this mode for a [combo box](#combo-box) like experience (an enhanced version of a select element) we recommend setting:

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"`.
- `selectOnFocus` to helps the user clear the selected value.
- `clearOnBlur` to helps the user to enter a new value.
- A last option, for instance `Add "YOUR SEARCH"`.

{{"demo": "pages/components/autocomplete/FreeSoloCreateOption.js"}}

Expand Down Expand Up @@ -143,7 +147,7 @@ The following demo relies on [autosuggest-highlight](https://github.com/moroshko

## Custom filter

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.
The component exposes a factory to create a filter method that can provided to the `filterOptions` prop. You can use it to change the default option filter behavior.

```js
import { createFilterOptions } from '@material-ui/lab/Autocomplete';
Expand All @@ -158,7 +162,6 @@ import { createFilterOptions } from '@material-ui/lab/Autocomplete';
- `config.ignoreCase` (*Boolean* [optional]): Defaults to `true`. Lowercase everything.
- `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.
- `config.matchFrom` (*'any' | 'start'* [optional]): Defaults to `'any'`.
- `config.startAfter`(*Number* [optional]): Default to `0`. Show the suggested options only after a certain number of letters
- `config.stringify` (*Func* [optional]): Controls how an option is converted into a string so that it can be matched against the input text fragment.
- `config.trim` (*Boolean* [optional]): Valeur par défaut `false`. Remove trailing spaces.

Expand Down