Skip to content

Commit 2b2ada9

Browse files
[docs] Sync translations (#21535)
1 parent 4b42b43 commit 2b2ada9

120 files changed

Lines changed: 1297 additions & 969 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

docs/src/pages/components/about-the-lab/about-the-lab-pt.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Sobre o lab
22

3-
<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>
3+
<p class="description">Este pacote hospeda os componentes da incubadora que ainda não estão prontos para mover para o core.</p>
44

55
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).
66

@@ -12,7 +12,7 @@ Para que um componente esteja pronto para ir para o core, são considerados os s
1212
* 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.
1313
* 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.
1414
* Requer boa **cobertura de teste**. Atualmente, alguns dos componentes do lab não têm testes abrangentes.
15-
* 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.
15+
* O componente pode ser usado como **estratégia** para incentivar os usuários a atualizar para a versão mais recente? Quanto menos fragmentada a comunidade, melhor.
1616
* 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.
1717

1818
## Instalação
@@ -39,7 +39,7 @@ yarn add @material-ui/core
3939

4040
## TypeScript
4141

42-
In order to benefit from the [CSS overrides](/customization/globals/#css) and [default prop customization](/customization/globals/#default-props) with the theme, TypeScript users need to import the following types. Internally, it uses [module augmentation](/guides/typescript/#customization-of-theme) to extend the default theme structure with the extension components available in the lab.
42+
Para se beneficiar de [CSS overrides](/customization/globals/#css) e [customização de propriedades padrão](/customization/globals/#default-props) com o tema, usuários de TypeScript precisam importar os seguintes tipos. Internamente, ele usa [ampliação de módulos](/guides/typescript/#customization-of-theme) para estender a estrutura padrão do tema com os componentes de extensão disponíveis no lab.
4343

4444
```tsx
4545
import type '@material-ui/lab/themeAugmentation';

docs/src/pages/components/about-the-lab/about-the-lab-zh.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,18 @@
22

33
<p class="description">此依赖包包含了一些还在开发中的组件,它们还不能移到 core(核心)库中。</p>
44

5-
核心库(core)和实验室(lab)最主要的差别在于对组件进行版本管理的方式。 拥有独立的实验室版本,我们就可以在必要的时候发布一些会影响原本代码的改动,并且核心库遵循 [slower-moving policy](https://material-ui.com/versions/#release-frequency)
5+
核心库(core)和实验室(lab)的主要区别在于对组件进行版本管理的方式。 拥有独立的实验室版本,我们就可以在必要的时候发布一些会影响原本代码的改动,并且核心库遵循 [slower-moving 政策](https://material-ui.com/versions/#release-frequency)
66

7-
程序员在使用和测试组件后向项目报漏洞,维护者就知道更多关于组件的缺点:如缺少功能,能不能访问的问题、漏洞,API 设计等等的问题 一个组建被使用的时间越久,新问题被发现以及因此需要引入重大更改的可能性就越少
7+
程序员在使用和测试组件后向项目报漏洞,维护者就知道更多关于组件的缺点:如缺少功能,访问问题、漏洞,API 设计等等。 一个组建被使用的时间越久,发现一个新的问题,以及因此需要引入重大更改的可能性就越小
88

9-
那些准备放到核心库里的组件,需要考虑以下几点:
9+
对于那些准备放到核心库里的组件,需要考虑以下几点:
1010

11-
* 它需要**被使用过** Material-UI 团队使用谷歌分析的数据去评估每个组件的使用情况。 如果一个实验室组件使用量太少,意味着它并不能全部正常工作,或者需求量比较小。
12-
* 它需要和核心组件的**代码质量**相似。 作为核心代码的一部分,它不需要很完美,但是这个组件应该要很可靠,要另其他开发者可以依赖它
13-
* 每个组件需要**类型定义**。 就目前来说,实验室组件不需要定义类型,但是当搬到核心代码之后就需要定义好类型了。
14-
* 需要一个好的**测试覆盖率**有一些实验室组件目前并没有进行综合的测试
11+
* 它需要**被使用过** Material-UI 团队使用谷歌分析的数据(Google Analytics stats)去评估每个组件的使用情况。 如果一个 lab 的组件使用数据比较低,意味着它并不能全部正常工作,或者需求量比较小。
12+
* 它需要和核心组件一样的高**代码质量**。 作为核心代码的一部分,它不需要很完美,但是这个组件应该要很可靠,这样其他开发者可以依赖它
13+
* 每个组件需要**类型定义**。 就目前来说,一个实验室组件不需要定义类型,但是当搬到核心代码之后就需要定义好类型了。
14+
* 需要比较高的**测试覆盖率(test coverage)**有一些实验室组件目前不带有一些综合的测试
1515
* 这个组建是否可以作为一个激励用户更新到最新版本的**杠杆**? 一个社区的分裂程度越低越好。
16-
* 需要极少可能地在不久地将来就引入**破坏性变更**。 例如,如果它需要一个新的功能并因此将有可能引入重大更改,那么最好推迟将其纳入核心库
16+
* 短期内/中等时间,我们需要确认**破坏性的变更**极少发生。 例如,如果它需要一个新的功能并因此将有可能引入重大更改,那么最好推迟将其纳入核心库的进程
1717

1818
## 安装
1919

@@ -39,7 +39,7 @@ yarn add @material-ui/core
3939

4040
## TypeScript
4141

42-
In order to benefit from the [CSS overrides](/customization/globals/#css) and [default prop customization](/customization/globals/#default-props) with the theme, TypeScript users need to import the following types. Internally, it uses [module augmentation](/guides/typescript/#customization-of-theme) to extend the default theme structure with the extension components available in the lab.
42+
为了从 theme 中的 [CSS重载](/customization/globals/#css) [默认的属性自定义](/customization/globals/#default-props) 中获益,使用 TypeScript 的用户需要引入如下类型的 types。 TypeScript 在内部将实验室里可用的扩展组件和 [模块扩展(module augmentation)](/guides/typescript/#customization-of-theme) 一起使用,这样可以拓展默认的主题(theme)结构。
4343

4444
```tsx
4545
import type '@material-ui/lab/themeAugmentation';
Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,78 +1,78 @@
11
---
2-
title: React 提醒组件
2+
title: React Alert component 警告提示组件
33
components: Alert, AlertTitle
44
---
55

6-
# Alert 提醒
6+
# Alert 警告提示
77

8-
<p class="description">「提醒」是简短且重要的信息,在不影响用户操作的同时能够吸引用户的注意力。</p>
8+
<p class="description">一个警告提示组件展示了一段简短且重要的信息,在不影响用户操作的同时能够吸引用户的注意力。</p>
99

10-
**注意**这个组件不在[Material Design 指南](https://material.io/),但它是被 Material-UI 支持的
10+
**请注意**该组件不再出现在 [Material Design 指南](https://material.io/), 但 Material-UI 会继续支持此组件
1111

12-
## 简单的提醒
12+
## 简单的警告提示
1313

14-
一共有四种不同程度的「提醒」,每种都有自己独特的颜色和图标。
14+
警告提示有四种不同程度的级别,每种都有自己独特的颜色和图标。
1515

1616
{{"demo": "pages/components/alert/SimpleAlerts.js"}}
1717

1818
## 描述
1919

20-
在提醒内容的上面使用 `AlertTitle` 可以实现标题的格式化
20+
您可以使用 `AlertTitle` 组件在内容之上展示一个格式化的标题
2121

2222
{{"demo": "pages/components/alert/DescriptionAlerts.js"}}
2323

2424
## 行为
2525

26-
一个「提醒」可以有一个行为,例如「关闭」或「撤销」按钮。 它在消息之后,「提醒」结束时被渲染
26+
一个警告提示可以附带一个行为,例如一个关闭或撤销按钮。 它在消息之后,提醒结束前被渲染
2727

28-
如果提供了 `onClose` 回调且没有设置 `action` 属性的话,「关闭」图标就会显示。 这个 `action` 行为可以用其他形式来完成,例如使用一个按钮或者图标按钮
28+
如果提供了 `onClose` 回调且没有设置 `action` 属性的话,则会呈现一个关闭图标。 这个 `action` 属性可以用来提供一个可替代的行为,例如使用一个 Button 或者IconButton
2929

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

3232
### 过渡效果
3333

34-
可以使用 [过渡组件](/components/transitions/) `Collapse(展开)` 来实现「提醒」出现时的过渡效果
34+
您也可以使用 [过渡组件](/components/transitions/)如使用 `Collapse(展开)` 来实现提醒出现时的过渡效果
3535

3636
{{"demo": "pages/components/alert/TransitionAlerts.js"}}
3737

3838
## 图标
3939

40-
`icon`是指可以在「提醒」组件的开始的地方加一个图标。 以此来改变不同程度「提醒」的默认图标
40+
使用 `icon` 属性,您可以在警告提示组件开头添加一个图标。 以此来改变不同程度的默认图标
4141

42-
通过使用 `iconMapping` 这种映射方法,可以改变不同程度的默认图标。 在[自定义主题](/customization/globals/#default-props)中可以进行全局设置
42+
通过使用 `iconMapping` 属性,您可以改变不同程度的默认图标映射。 使用 [自定义主题](/customization/globals/#default-props),您可以进行全局的设置
4343

44-
把图标属性设置为 false 将会把图标都移除了
44+
把 icon 属性设置为 false 时,将会把图标都移除
4545

4646
{{"demo": "pages/components/alert/IconAlerts.js"}}
4747

48-
## 变种
48+
## 变体
4949

50-
还可以实现「边框」和「填充」这两种变体
50+
还有描边(outlined)和填充(filled)这两种组件的变体可以使用
5151

52-
### 边框
52+
### 描边
5353

5454
{{"demo": "pages/components/alert/OutlinedAlerts.js"}}
5555

5656
### 填充
5757

5858
{{"demo": "pages/components/alert/FilledAlerts.js"}}
5959

60-
## 提示
60+
## Toast(提示)
6161

62-
你可以使用「消息条」来显示[ 带确认按钮的Toast 提示](/components/snackbars/#customized-snackbars)
62+
你可以使用消息条(Snackbar)来显示一个带警告提示组件的 [toast](/components/snackbars/#customized-snackbars)
6363

6464
## Color 颜色
6565

66-
`color` 属性用来改变不同程度「提醒」的默认颜色
66+
使用 `color` 属性可以覆盖不同程度提醒的默认颜色
6767

6868
{{"demo": "pages/components/alert/ColorAlerts.js"}}
6969

70-
## 可访问性
70+
## 无障碍设计
7171

7272
(WAI-ARIA: https://www.w3.org/TR/wai-aria-practices/#alert)
7373

74-
动态显示组件时,大部分屏幕都会自动朗读其内容。 此时,屏幕不会将页面加载时出现的提醒通知给用户
74+
当动态地显示组件时,大部分屏幕都会自动朗读其内容。 此时,屏幕阅读不会将页面加载时出现的提醒通知给用户
7575

76-
使用颜色来增加意义只提供了一个视觉指示,而不会传达给用户的辅助技术,如屏幕阅读器。 确保用颜色表示的信息对于内容本身是明显的(例如可见的文本),或者通过其他方法包含进来,例如附加的隐藏文本
76+
使用颜色来增加意义只提供了一个视觉指示,而不会传达给一个辅助用户的技术,如屏幕阅读器。 请确保用颜色表示的信息,或者对于内容本身(例如一些可见的文本)是明显的,或者通过其他方法包含信息,例如一个附加的隐藏文本
7777

78-
动作的选项卡索引必须为0,这样只有键盘的用户才能访问它们
78+
动作的选项卡索引(tab index)必须为 0,这样只使用键盘的用户才能访问它们

docs/src/pages/components/app-bar/app-bar-pt.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -45,11 +45,11 @@ Uma barra de aplicativos proeminente.
4545

4646
{{"demo": "pages/components/app-bar/BottomAppBar.js", "iframe": true, "maxWidth": 400}}
4747

48-
## Local de filtros
48+
## Posicionamento fixo
4949

50-
Quando você renderiza a posição da barra de apps fixa, a dimensão do elemento não afeta o resto da página. Isso pode fazer com que parte do seu conteúdo fique invisível, atrás da barra de aplicativos. Aqui estão 3 soluções possíveis:
50+
Quando você renderiza a barra de aplicativos com um posicionamento fixo, a dimensão do elemento não afeta o resto da página. Isso pode fazer com que parte do seu conteúdo pareça estar invisível, atrás da barra de aplicativos. Aqui estão 3 soluções possíveis:
5151

52-
1. Você pode usar `posição="sticky"` ao invés de fixed. ⚠️ sticky não é suportado pelo IE 11.
52+
1. Você pode usar `position="sticky"` ao invés de fixed. ⚠️ sticky não é suportado pelo IE 11.
5353
2. Você pode renderizar um segundo componente `<Toolbar />`:
5454

5555
```jsx
@@ -65,7 +65,7 @@ function App() {
6565
}
6666
```
6767

68-
3. Você pode usar `theme.mixins.toolbar` CSS:
68+
3. Você pode usar o CSS `theme.mixins.toolbar`:
6969

7070
```jsx
7171
const useStyles = makeStyles(theme => ({
@@ -91,7 +91,7 @@ Você pode usar o hook `useScrollTrigger()` para responder às ações de rolage
9191

9292
### Barra de aplicativos oculta
9393

94-
A barra de aplicativos sumirá ao descer a página para deixar mais espaço de leitura.
94+
A barra de aplicativos ficará oculta ao rolar a página para baixo, deixando mais espaço de leitura.
9595

9696
{{"demo": "pages/components/app-bar/HideAppBar.js", "iframe": true}}
9797

@@ -113,7 +113,7 @@ Um botão de ação flutuante aparece na rolagem para facilitar o retorno ao top
113113

114114
1. `options` (*Object* [opcional]):
115115

116-
- `options.disableHysteresis` (*Boolean* [opcional]): Padrão `false`. Desabilita a histerese. Ignora a direção de rolagem ao determinar o valor `trigger`.
116+
- `options.disableHysteresis` (*Boolean* [opcional]): Padrão `false`. Desabilita a histerese. Ignora a direção de rolagem ao determinar o valor de `trigger`.
117117
- `options.target` (*Node* [opcional]): Padrão `window`.
118118
- `options.threshold` (*Number* [opcional]): Padrão `100`. Modifica o valor limite que aciona a `trigger` quando a barra de rolagem vertical cruzar ou chegar a este limite.
119119

0 commit comments

Comments
 (0)