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 #21336

Merged
merged 1 commit into from
Jun 7, 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.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/src/pages/components/about-the-lab/about-the-lab-zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,16 +4,16 @@

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

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

那些准备放到核心库里的组件,需要考虑以下几点:

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

## 安装

Expand Down
8 changes: 4 additions & 4 deletions docs/src/pages/components/autocomplete/autocomplete-pt.md
Original file line number Diff line number Diff line change
Expand Up @@ -136,15 +136,15 @@ Gosta mais de campos de texto menores? Use a propriedade `size`.

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

## Customizations
## Customizações

### Custom input
### Input customizado

The `renderInput` prop allows you to customize the rendered input. The first argument of this render prop contains props that you need to forward. Pay specific attention to the `ref` and `inputProps` keys.
A propriedade `renderInput` permite que você customize o input renderizado. O primeiro argumento desta propriedade de render, contém propriedades que você precisa repassar. Preste atenção específicamente nas chaves `ref` e `inputProps`.

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

### GitHub's picker
### Seletor do GitHub

Esta demonstração reproduz o rótulo de selecão do GitHub's:

Expand Down
14 changes: 7 additions & 7 deletions docs/src/pages/components/autocomplete/autocomplete-zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,13 +49,13 @@ components: TextField, Popper, Autocomplete

### 搜索输入栏

该 prop 是皆在涵盖带有搜索建议的 **输入栏** 的主要用例,例如 Google 搜索 或 react-autowhatever。
该属性的主要使用方式是创建一个带有搜索建议的 **输入栏**,例如 Google 搜索 或 react-autowhatever。

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

### 可创建的
### Creatable (可创造性)

如果您打算将此模式用于类似 [组合框](#combo-box) 的体验(选择控件元素的增强版),我们建议设置:
如果您打算将此模块用于类似 [组合框](#combo-box) 的体验(选择控件元素的增强版),我们建议设置:

- `selectOnFocus` 帮助用户清除所选值。
- `clearOnBlur` 帮助用户输入一个新的值。
Expand Down Expand Up @@ -136,15 +136,15 @@ import useAutocomplete from '@material-ui/lab/useAutocomplete';

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

## Customizations
## 自定义设置

### Custom input
### 自定义输入

The `renderInput` prop allows you to customize the rendered input. The first argument of this render prop contains props that you need to forward. Pay specific attention to the `ref` and `inputProps` keys.
`renderInput` 属性允许你对输入内容进行自定义渲染 The first argument of this render prop contains props that you need to forward. 请特别注意 `ref` `inputProps` 键(key)。

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

### GitHub's picker
### GitHub 标签选择器

该演示再现了GitHub的标签选择器:

Expand Down
8 changes: 4 additions & 4 deletions docs/src/pages/components/buttons/buttons-pt.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,15 +44,15 @@ Botões delineados são uma alternativa de menor ênfase comparado com botões c

{{"demo": "pages/components/buttons/OutlinedButtons.js"}}

## Handling clicks
## Manipulando cliques

All components accept an `onClick` handler that is applied to the root DOM element.
Todos os componentes aceitam um método manipulador `onClick` que é aplicado ao elemento DOM raiz.

```jsx
<Button onClick={() => { alert('clicked') }}>Click me</Button>
<Button onClick={() => { alert('clicado') }}>Clique aqui</Button>
```

Note that the documentation [avoids](/guides/api/#native-properties) mentioning native props (there are a lot) in the API section of the components.
Note que a documentação [evita](/guides/api/#native-properties) mencionar as propriedades nativas (existem várias) na seção de API dos componentes.

## Botão de Upload

Expand Down
8 changes: 4 additions & 4 deletions docs/src/pages/components/buttons/buttons-zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,17 +44,17 @@ components: Button, IconButton, ButtonBase

{{"demo": "pages/components/buttons/OutlinedButtons.js"}}

## Handling clicks
## Handling clicks 处理点击

All components accept an `onClick` handler that is applied to the root DOM element.
所有组件都接受 `onClick` 处理程序,该处理程序被应用到 根(root) DOM 元素。

```jsx
<Button onClick={() => { alert('clicked') }}>Click me</Button>
```

Note that the documentation [avoids](/guides/api/#native-properties) mentioning native props (there are a lot) in the API section of the components.
请注意,文档里组件的 api 部分 [避免](/guides/api/#native-properties) 提到大量的 原生(native) 属性。

## 一个上传按钮
## Upload button 上传按钮

{{"demo": "pages/components/buttons/UploadButtons.js"}}

Expand Down
6 changes: 3 additions & 3 deletions docs/src/pages/components/cards/cards-es.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,17 +9,17 @@ components: Card, CardActionArea, CardActions, CardContent, CardHeader, CardMedi

Las [Tarjetas](https://material.io/design/components/cards.html) son superficies que muestran contenido y acciones sobre un tema particular.

They should be easy to scan for relevant and actionable information. Elements, like text and images, should be placed on them in a way that clearly indicates hierarchy.
Deberían ser fáciles de visualizar sus acciones e información relevante. Los elementos como textos e imágenes deberían ubicarse de forma que indiquen jerarquía.

## Tarjeta simple

Aunque las tarjetas pueden permitir múltiples acciones, controles de la interfaz y varios menús, debemos usarlas con precaución ya que son puntos de ingreso a información mas detallada.

{{"demo": "pages/components/cards/SimpleCard.js", "bg": true}}

### Outlined Card
### Tarjeta con bordes

Set `variant="outlined"` to render an outlined card.
Usa `variant="outlined"` para mostrar una tarjeta con bordes.

{{"demo": "pages/components/cards/OutlinedCard.js", "bg": true}}

Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/checkboxes/checkboxes-pt.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ O componente `Checkbox` pode ser fornecido com um rótulo graças ao componente

{{"demo": "pages/components/checkboxes/CheckboxesGroup.js"}}

## Label placement
## Posicionamento do rótulo

Você pode alterar o posicionamento do rótulo:

Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/container/container-es.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Si bien los contenedores pueden anidarse, la mayoria de los layouts no requieren

## Fluido

A fluid container width is bounded by the `maxWidth` property value.
El ancho de un contenedor fluido está ligado al valor de la propiedad `maxWidth`.

{{"demo": "pages/components/container/SimpleContainer.js", "iframe": true, "defaultCodeOpen": false}}

Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/css-baseline/css-baseline-zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ export default function MyApp() {

- 在 `<html>` 元素里面,我们将 `box-sizing` 全局设置为 `border-box`。 这样一来,包括 `*:: before` 和 `*:: after` 的每个元素,都会被声明来继承这个属性,这样能够确保元素的声明宽度永远不会超过 padding 或者 border。

### 文字排版
### Typography

- 在 `<html>` 里面不会声明基础的 font-size,但是我们假设是 16px (浏览器的默认设置)。 您可以在[主题文档](/customization/typography/#typography-html-font-size) 页面中了解更多有关更改 `<html>` 默认字体大小的影响 。
- 在 `theme.typography.body2` 元素上设置 `<body>` 样式。
Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/paper/paper-es.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,6 @@ El fondo de una aplicación asemeja la textura plana, opaca de una hoja de papel

## Variants

If you need an outlined surface, use the `variant` prop.
Si necesitas una superficie con bordes, usa la propiedad `variant`.

{{"demo": "pages/components/paper/Variants.js", "bg": "inline"}}
8 changes: 4 additions & 4 deletions docs/src/pages/components/progress/progress-zh.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
title: React Circular 进度环, React Linear progress 进度条组件
title: React Circular progress(进度环组件),React Linear progress 进度条组件
components: CircularProgress, LinearProgress
---

# Progress 进度条
# Progress 进度条组件

<p class="description">Progress indicators(进度指示器)通常称为微调器 (spinners) 。它能够表示一个不明确的等待时间,或者显示处理过程的时间长短。 动画使用 CSS 实现,而不是 JavaScript。</p>
<p class="description">Progress indicators(进度指示器)也称为微调器 (spinners) ,它表示了一个不明确的等待时间,或者显示处理过程的时间长短。 动画效果通过 CSS 实现,而不是 JavaScript。</p>

[进度指示器](https://material.io/design/components/progress-indicators.html)能够将当前处理过程的状态通知用户,例如加载一个应用,提交一个表单或保存一些更新。 它们与应用程序状态进行通信并指示可用的操作,例如用户是否可从当前页面离开。

Expand Down Expand Up @@ -99,6 +99,6 @@ function Progress(props) {

![高负载](/static/images/progress/heavy-load.gif)

当它不可用时,您可以利用 `disableShrink` 属性来缓解这个问题。 查看 [这个问题](https://github.com/mui-org/material-ui/issues/10327).
当这个方法不可行的时候,您可以利用 `disableShrink` 属性来缓解这个问题。 请查看 [这个问题](https://github.com/mui-org/material-ui/issues/10327)

{{"demo": "pages/components/progress/CircularUnderLoad.js"}}
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ components: Radio, RadioGroup, FormControl, FormLabel, FormControlLabel

## 标签放置

你可以用 `FormControlLabel` 组件的 `labelPlacement` prop 来改变标签的位置
你可以用 `FormControlLabel` 组件的 `labelPlacement` 属性来改变标签的位置

{{"demo": "pages/components/radio-buttons/FormControlLabelPlacement.js"}}

Expand Down
8 changes: 4 additions & 4 deletions docs/src/pages/components/skeleton/skeleton-pt.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,11 +31,11 @@ Por padrão, o skeleton pulsa, mas você pode mudar a animação para uma onda o

{{"demo": "pages/components/skeleton/Animations.js"}}

### Pulsate example
### Exemplo com efeito de pulsação

{{"demo": "pages/components/skeleton/YouTube.js", "defaultCodeOpen": false}}

### Wave example
### Exemplo com efeito de ondas

{{"demo": "pages/components/skeleton/Facebook.js", "defaultCodeOpen": false, "bg": true}}

Expand Down Expand Up @@ -65,6 +65,6 @@ loading

## Acessibilidade

Skeleton screens provide an alternative to the traditional spinner methods. Rather than showing an abstract widget, skeleton screens create anticipation of what is to come and reduce cognitive load.
Telas com Skeleton fornecem uma alternativa aos métodos tradicionais de feedback. Em vez de mostrar um resumo abstrato na tela, telas com skeleton criam uma expectativa do que está por vir, reduzindo a sensação cognitiva do processo de carregamento.

The background color of the skeleton uses the least amount of luminance to be visible in good conditions (good ambient light, good screen, no visual impairments).
A cor de fundo do skeleton usa uma quantidade menor de luminância para ser visível em boas condições (boa luz ambiente, boa tela, sem deficiência visual).
10 changes: 5 additions & 5 deletions docs/src/pages/components/skeleton/skeleton-zh.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: 骨架屏 React 组件
title: React Skeleton 骨架屏组件
components: Skeleton
---

Expand Down Expand Up @@ -31,11 +31,11 @@ components: Skeleton

{{"demo": "pages/components/skeleton/Animations.js"}}

### Pulsate example
### 脉动动画例子

{{"demo": "pages/components/skeleton/YouTube.js", "defaultCodeOpen": false}}

### Wave example
### 波浪动画例子

{{"demo": "pages/components/skeleton/Facebook.js", "defaultCodeOpen": false, "bg": true}}

Expand Down Expand Up @@ -65,6 +65,6 @@ loading

## 可访问性

Skeleton screens provide an alternative to the traditional spinner methods. Rather than showing an abstract widget, skeleton screens create anticipation of what is to come and reduce cognitive load.
骨架屏提供了一个可替代传统 进度条(spinner) 的解决方案。 骨架屏不是一个抽象的小部件,而是提供一个对未来事件的预期,来减少人们的认知负荷。

The background color of the skeleton uses the least amount of luminance to be visible in good conditions (good ambient light, good screen, no visual impairments).
骨架屏使用的背景色是在良好条件下可见的最小亮度(良好的环境光、良好的屏幕、无视觉障碍)。
18 changes: 9 additions & 9 deletions docs/src/pages/components/snackbars/snackbars-zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,11 @@ components: Snackbar, SnackbarContent

# Snackbar 消息条

<p class="description">Snackbars 提供了关于应用流程的简短信息。 该组件也被称为 toast。</p>
<p class="description">消息条组件提供了关于应用流程的简短信息。 该组件也被称为 toast。</p>

[消息条](https://material.io/design/components/snackbars.html) 将应用程序已执行或即将执行的进程通知用户。 它们会从屏幕底部短暂地出现。 它们不应中断用户体验,也不要求任何用户的操作来关闭。
[消息条](https://material.io/design/components/snackbars.html)将应用程序已执行或即将执行的进程通知用户。 它们会从屏幕底部短暂地出现。 它们不应中断用户体验,也不要求任何用户的操作来关闭。

Snackbars 包含一行直接与所执行操作相关的文本。 它们可能包含一些文本操作,但没有图标。 您可以使用它们来显示通知
消息条包含了一行直接与所执行操作相关的文本。 它们可能包含一些文本操作,但并不会展示图标。 您也可以用他们展示通知

#### 频率

Expand All @@ -29,7 +29,7 @@ Snackbars 包含一行直接与所执行操作相关的文本。 它们可能包

## 定位的消息条

在宽大的布局中,如果消息条始终放在屏幕底部的同一位置,那么可以左对齐或中间对齐,但在某些情况下,消息条的位置可能需要更加灵活。 你可以通过指定 `anchorOrigin` prop 来控制消息条的位置
在宽大的布局中,如果消息条始终放在屏幕底部的同一位置,那么可以左对齐或中间对齐,但在某些情况下,消息条的位置可能需要更加灵活。 通过指定 `anchorOrigin` 的属性,您可以控制消息条的位置

{{"demo": "pages/components/snackbars/PositionedSnackbar.js"}}

Expand All @@ -47,15 +47,15 @@ Snackbars 包含一行直接与所执行操作相关的文本。 它们可能包

{{"demo": "pages/components/snackbars/ConsecutiveSnackbars.js"}}

### Snackbars(消息条)和 FABs(悬浮按钮
### 消息条(Snackbars)和悬浮按钮(FABs

消息条应当显示在悬浮按钮的上方(这是在移动设备上)。

{{"demo": "pages/components/snackbars/FabIntegrationSnackbar.js", "iframe": true, "maxWidth": 400}}

### 更改过渡动画

[Grow](/components/transitions/#grow)是默认的过渡动画但你可以使用不同的过渡动画
[Grow](/components/transitions/#grow) 是默认的过渡动画,但你可以使用不同的过渡动画

{{"demo": "pages/components/snackbars/TransitionsSnackbar.js"}}

Expand All @@ -73,12 +73,12 @@ Snackbars 包含一行直接与所执行操作相关的文本。 它们可能包

![评星](https://img.shields.io/github/stars/iamhosseindhv/notistack.svg?style=social&label=Stars) ![npm下载](https://img.shields.io/npm/dm/notistack.svg)

以下例子演示了如何使用 [notistack](https://github.com/iamhosseindhv/notistack)。 notistack 有一个 **imperative API** 可以轻松地显示一串消息条,且无需处理其打开/关闭状态。 它还可以让你把它们 **堆叠** 在一起(尽管 Material Design 规范不鼓励这样做)。
以下例子演示了如何使用 [notistack](https://github.com/iamhosseindhv/notistack)。 notistack 有一个 **imperative API** 可以轻松地显示一串消息条,且无需处理其打开/关闭状态。 您也可以把它们 **堆叠** 在一起(尽管 Material Design 规范不鼓励这样做)。

{{"demo": "pages/components/snackbars/IntegrationNotistack.js", "defaultCodeOpen": false}}

## 可及性
## 无障碍设计

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

- 默认情况下,消息条不会自动隐藏。 但是,如果您决定使用 `autoHideDuration` prop,建议给用户 [足够的时间](https://www.w3.org/TR/UNDERSTANDING-WCAG20/time-limits.html) 来响应。
- 默认情况下,消息条不会自动隐藏。 但是,如果您决定使用 `autoHideDuration` 属性,我们建议给用户提供 [足够的时间](https://www.w3.org/TR/UNDERSTANDING-WCAG20/time-limits.html) 来响应。
Loading