Skip to content

Commit

Permalink
[docs] Sync translations (#22888)
Browse files Browse the repository at this point in the history
  • Loading branch information
l10nbot committed Oct 15, 2020
1 parent f9f2ca1 commit 77e6054
Show file tree
Hide file tree
Showing 228 changed files with 1,696 additions and 1,031 deletions.
18 changes: 9 additions & 9 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 @@ -8,33 +8,33 @@

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

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

## 安装

请在您的项目目录中用以下方式安装依赖包:

```sh
// 用 npm 安装
npm install @material-ui/lab
npm install @material-ui/lab@next

// 用 yarn 安装
yarn add @material-ui/lab
yarn add @material-ui/lab@next
```

该 lab 和那些核心组件是对等依赖的。 若您还未在项目中使用 Material-UI,那可以按如下方式安装:

```sh
// 用 npm 安装
npm install @material-ui/core
npm install @material-ui/core@next

// 用 yarn 安装
yarn add @material-ui/core
yarn add @material-ui/core@next
```

## TypeScript
Expand Down
8 changes: 1 addition & 7 deletions docs/src/pages/components/accordion/accordion-de.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ materialDesign: https://material.io/archive/guidelines/components/expansion-pane
waiAria: 'https://www.w3.org/TR/wai-aria-practices/#accordion'
---

# Akkordeon
# Akkordeon (Accordion)

<p class="description">Erweiterungspanels (Tafeln) enthalten Erstellungsabläufe und ermöglichen die einfache Bearbeitung eines Elements.</p>

Expand All @@ -32,12 +32,6 @@ Hier ist ein Beispiel zum Anpassen der Komponente. Mehr dazu erfahren Sie auf de

{{"demo": "pages/components/accordion/CustomizedAccordions.js"}}

## Zusätzliche Aktionen

In order to put an action such as a `Checkbox` or a button inside of the `AccordionSummary`, you need to stop the propagation of the focus and click events to prevent the panel from expanding/collapsing when using the action. You should also provide an `aria-label` for the action, otherwise the label of the nested action will be included in the label of the parent button that controls the accordion expansion.

{{"demo": "pages/components/accordion/ActionsInAccordionSummary.js", "bg": true}}

## Performance

Der Inhalt von Accordions wird standardmäßig bereitgestellt, auch wenn das Panel nicht erweitert wird. Bei diesem Standardverhalten werden serverseitiges Rendering und SEO berücksichtigt. If you render expensive component trees inside your panels or simply render many panels it might be a good idea to change this default behavior by enabling the `unmountOnExit` in `TransitionProps`:
Expand Down
6 changes: 0 additions & 6 deletions docs/src/pages/components/accordion/accordion-es.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,12 +32,6 @@ He aquí un ejemplo de personalización del componente. You can learn more about

{{"demo": "pages/components/accordion/CustomizedAccordions.js"}}

## Acciones Adicionales

In order to put an action such as a `Checkbox` or a button inside of the `AccordionSummary`, you need to stop the propagation of the focus and click events to prevent the panel from expanding/collapsing when using the action. You should also provide an `aria-label` for the action, otherwise the label of the nested action will be included in the label of the parent button that controls the accordion expansion.

{{"demo": "pages/components/accordion/ActionsInAccordionSummary.js", "bg": true}}

## Rendimiento

The content of Accordions is mounted by default even if the panel is not expanded. This default behavior has server-side rendering and SEO in mind. If you render expensive component trees inside your panels or simply render many panels it might be a good idea to change this default behavior by enabling the `unmountOnExit` in `TransitionProps`:
Expand Down
6 changes: 0 additions & 6 deletions docs/src/pages/components/accordion/accordion-fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,12 +32,6 @@ Voici un exemple de personnalisation du composant. Vous pouvez en savoir plus da

{{"demo": "pages/components/accordion/CustomizedAccordions.js"}}

## Actions supplémentaires

Pour pouvoir exécuter une action comme une `Checkbox` ou un bouton à l'intérieur du `AccordionSummary`, vous aurez besoin d'arrêter la propagation du focus et de l'évènement de clique sur l'accordéon à partir de l'expansion/réduction au moment de son utilisation. Vous devriez également fournir un `aria-label` pour l'action, autrement le label de l'action imbriquer sera inclus dans le label du bouton parent qui contrôle l'expansion de l'accordéon.

{{"demo": "pages/components/accordion/ActionsInAccordionSummary.js", "bg": true}}

## Performances

Le contenu de l'accordéon est monter par défaut et se même si l'accordéon n'est pas ouvert. Se comportement à le "server-side rendrering" et le SEO comme objectif. Si vous devez rendre un lourd composant au niveau des détails de l'accordéon ou simplement rendre plusieurs accordéons, il serait une bonne idée de changer le comportement par défaut en activant le `unmountOnExit` dans le prop `TransitionProps`:
Expand Down
6 changes: 0 additions & 6 deletions docs/src/pages/components/accordion/accordion-ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,12 +32,6 @@ waiAria: 'https://www.w3.org/TR/wai-aria-practices/#accordion'

{{"demo": "pages/components/accordion/CustomizedAccordions.js"}}

## Additional actions

`Checkbox`などのアクションまたはボタンを`AccordionSummary`の内部で使うために、フォーカスの伝播を止めて、アクション時にクリックイベントがパネルの開閉動作を呼ばないようにする必要があります。 また、アクションに `aria-label` を付与する必要があります。 そうしないと、入れ子になったアクションのラベルがアコーディオンの拡張を制御する親コンポーネントのボタンのラベルに含まれることになります。

{{"demo": "pages/components/accordion/ActionsInAccordionSummary.js", "bg": true}}

## パフォーマンス

Accordionsのコンテンツは、パネルが展開されていない場合でもデフォルトでマウントされます。 このデフォルトの動作では、サーバー側のレンダリングとSEOが考慮されています。 If you render expensive component trees inside your panels or simply render many panels it might be a good idea to change this default behavior by enabling the `unmountOnExit` in `TransitionProps`:
Expand Down
6 changes: 0 additions & 6 deletions docs/src/pages/components/accordion/accordion-pt.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,12 +32,6 @@ Aqui está um exemplo de customização do componente. Você pode aprender mais

{{"demo": "pages/components/accordion/CustomizedAccordions.js"}}

## Ações adicionais

Para colocar uma ação como um `Checkbox` ou um botão dentro do `AccordionSummary`, você precisa parar a propogação do foco e eventos de clique para previnir o painel de expandir/colapsar quando usar a ação. Você deve fornecer também um `aria-label` para a ação, caso contrário, o rótulo da ação aninhada será incluído no rótulo do botão pai que controla a expansão do acordeão.

{{"demo": "pages/components/accordion/ActionsInAccordionSummary.js", "bg": true}}

## Performance

O conteúdo dos acordeões é montado por padrão, mesmo que o acordeão não esteja expandido. Esse comportamento padrão tem em mente a renderização do lado do servidor e o SEO. Se você renderizar grandes árvores de componentes dentro de seu acordeão ou simplesmente renderizar muitos acordeões, pode ser uma boa ideia desabilitar esse comportamento padrão habilitando `unmountOnExit` em `TransitionProps`:
Expand Down
8 changes: 1 addition & 7 deletions docs/src/pages/components/accordion/accordion-ru.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: React Accordion component
title: Компонент React Accordion
components: Accordion, AccordionActions, AccordionDetails, AccordionSummary
githubLabel: 'component: Accordion'
materialDesign: https://material.io/archive/guidelines/components/expansion-panels.html
Expand Down Expand Up @@ -32,12 +32,6 @@ waiAria: 'https://www.w3.org/TR/wai-aria-practices/#accordion'

{{"demo": "pages/components/accordion/CustomizedAccordions.js"}}

## Additional actions

In order to put an action such as a `Checkbox` or a button inside of the `AccordionSummary`, you need to stop the propagation of the focus and click events to prevent the panel from expanding/collapsing when using the action. You should also provide an `aria-label` for the action, otherwise the label of the nested action will be included in the label of the parent button that controls the accordion expansion.

{{"demo": "pages/components/accordion/ActionsInAccordionSummary.js", "bg": true}}

## Производительность

Содержимое Accordions монтируется по умолчанию, даже если панель не развернута. Это предопределенное поведение подразумевает рендеринг на стороне сервера и SEO. If you render expensive component trees inside your panels or simply render many panels it might be a good idea to change this default behavior by enabling the `unmountOnExit` in `TransitionProps`:
Expand Down
8 changes: 1 addition & 7 deletions docs/src/pages/components/accordion/accordion-zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ waiAria: 'https://www.w3.org/TR/wai-aria-practices/#accordion'

<p class="description">扩展面板包含了流程的创建和元素的轻量编辑。</p>

[扩展面板](https://material.io/archive/guidelines/components/accordion.html)是一个轻量级容器,既可以单独使用,也可以和卡片这样更大的平面相结合。
扩展面板是一个轻量级容器,既可以单独使用,也可以和卡片这样更大的平面相结合。

{{"component": "modules/components/ComponentLinkHeader.js"}}

Expand All @@ -32,12 +32,6 @@ waiAria: 'https://www.w3.org/TR/wai-aria-practices/#accordion'

{{"demo": "pages/components/accordion/CustomizedAccordions.js"}}

## 其他操作

当你把 `Checkbox` 或者一个按钮这样的操作事件放进 `AccordionSummary`,当在打开和收缩控制面板时使用这个操作,你则需要阻止 focus 和 click 事件的传播(propagation)。 您还应该为该操作提供一个 `aria-label` 标签,否则嵌套操作的标签将包含在控制扩展面板的父按钮的标签中。

{{"demo": "pages/components/accordion/ActionsInAccordionSummary.js", "bg": true}}

## 性能

即使扩展面板没有展开,默认情况下扩展面板的内容也会挂载。 这样的默认情况是是考虑到了服务端渲染(server-side rendering)和搜索引擎优化(SEO)。 如果您在扩展面板中渲染组件树性能开销很大,或者只是想要渲染很多不带内容的扩展面板,那么通过启用 `TransitionProps` 中的 `unmountOnExit` 来改变默认的渲染方式也许可行。
Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/alert/alert-de.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ githubLabel: 'component: Alert'
waiAria: 'https://www.w3.org/TR/wai-aria-practices/#alert'
---

# Hinweis
# Hinweis (Alert)

<p class="description">Ein Hinweis zeigt eine kurze, wichtige Nachricht auf eine Weise, welche die Aufmerksamkeit des Benutzers auf sich zieht ohne die Aufgabe des Benutzers zu unterbrechen.</p>

Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/alert/alert-ru.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: React Alert component
title: Компонент React Alert
components: Alert, AlertTitle
githubLabel: 'component: Alert'
waiAria: 'https://www.w3.org/TR/wai-aria-practices/#alert'
Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/app-bar/app-bar-de.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ A prominent app bar.

When you render the app bar position fixed, the dimension of the element doesn't impact the rest of the page. This can cause some part of your content to be invisible, behind the app bar. Here are 3 possible solutions:

1. You can use `position="sticky"` instead of fixed. ⚠️ sticky wird vom IE 11 nicht unterstützt.
1. You can use `position="sticky"` instead of fixed. ⚠️ sticky is not supported by IE11.
2. You can render a second `<Toolbar />` component:

```jsx
Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/app-bar/app-bar-es.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ Un App Bar prominente.

Cuando muestra la posición de la barra de App Bar fija, la dimensión de los elementos no tiene impacto sobre el resto de la página. Esto puede causar que alguna parte de su contenido no sea visible, detrás del App Bar. Aquí hay 3 posibles soluciones:

1. Puedes usar `position = "sticky"` en lugar de fijo. ⚠️ sticky no es compatible con IE 11.
1. Puedes usar `position = "sticky"` en lugar de fijo. ⚠️ sticky is not supported by IE11.
2. Puedes renderizar un segundo componente `<Toolbar />`:

```jsx
Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/app-bar/app-bar-fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ Barre d'application étendu.

Quand vous rendez la barre d'application en position fixe, les dimensions de l'élément n'impact pas le reste de page. Cela peut rendre certaine partie de votre contenu invisible, caché derrière la barre d'application. Voici 3 solutions possible:

1. Vous pouvez utiliser `position="sticky"` au lieu de `position="fixed"`. Sticky n'est pas supporter par IE 11.
1. Vous pouvez utiliser `position="sticky"` au lieu de `position="fixed"`. ⚠️ sticky is not supported by IE11.
2. Vous pouvez rendre un deuxième composant `<Toolbar />` :

```jsx
Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/app-bar/app-bar-ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ materialDesign: https://material.io/components/app-bars-top

アプリバーの位置を固定してレンダリングすると、要素の寸法はページの残りの部分に影響しません。 これにより、コンテンツの一部がアプリバーの背後で見えなくなる可能性があります。 以下に3つの解決策を示します。 これにより、コンテンツの一部がアプリバーの背後で見えなくなる可能性があります。 以下に3つの解決策を示します。 これにより、コンテンツの一部がアプリバーの背後で見えなくなる可能性があります。 以下に3つの解決策を示します。

1. fixed の代わりに `position="sticky"` を使用できます。 fixed の代わりに `position="sticky"` を使用できます。 ⚠️ stickyはIE 11ではサポートされていません。 fixed の代わりに `position="sticky"` を使用できます。 ⚠️ stickyはIE 11ではサポートされていません。
1. fixed の代わりに `position="sticky"` を使用できます。 fixed の代わりに `position="sticky"` を使用できます。 ⚠️ stickyはIE 11ではサポートされていません。 ⚠️ sticky is not supported by IE11.
2. 2番目の `<Toolbar />` コンポーネントをレンダリングできます:

```jsx
Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/app-bar/app-bar-pt.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ Uma barra de aplicativos proeminente.

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:

1. Você pode usar `position="sticky"` ao invés de fixed. ⚠️ sticky não é suportado pelo IE 11.
1. Você pode usar `position="sticky"` ao invés de fixed. ⚠️ sticky is not supported by IE11.
2. Você pode renderizar um segundo componente `<Toolbar />`:

```jsx
Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/app-bar/app-bar-ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ materialDesign: https://material.io/components/app-bars-top

Когда вы рендерите навигационную панель с фиксированным положением, размер элемента не влияет на остальную часть страницы. Это может быть причиной того, что часть вашего содержимого может стать невидимой, скрываясь за навигационной панелью. Есть 3 варианта решения:

1. Вы можете использовать `position="sticky"` вместо `"fixed"`. ⚠️ `"sticky"` не поддерживается в IE 11.
1. Вы можете использовать `position="sticky"` вместо `"fixed"`. ⚠️ sticky is not supported by IE11.
2. Вы можете отрендерить второй `<Toolbar />` компонент:

```jsx
Expand Down
24 changes: 12 additions & 12 deletions docs/src/pages/components/app-bar/app-bar-zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ materialDesign: https://material.io/components/app-bars-top

<p class="description">应用栏组件展示了与当前屏幕息息相关的信息和操作。</p>

[顶部应用栏](https://material.io/design/components/app-bars-top.html)则提供与当前屏幕相关的内容和操作。 它可用于展示品牌、屏幕标题、导航和操作选项。
而顶部应用栏(App Bar)则提供与当前屏幕相关的内容和操作。 它可用于展示品牌、屏幕标题、导航和操作选项。

它既可以用作于转换为上下文相关的操作栏,又可以直接充当导航栏。

Expand Down Expand Up @@ -53,7 +53,7 @@ materialDesign: https://material.io/components/app-bars-top

当渲染一个固定位置的应用栏时,元素的尺寸不会影响页面的其余内容。 这可能导致部分内容会被挡在应用程序栏后面,而无法可见。 下面是3种可能的解决方案:

1. 使用 `position =“ sticky”` 代替 fixed。 ⚠️ IE 11不支持 sticky
1. 使用 `position =“ sticky”` 代替 fixed。 ⚠️ sticky 不支持 IE11
2. 可以渲染第二个 `<Toolbar />` 组件:

```jsx
Expand All @@ -72,21 +72,21 @@ function App() {
3. 也可以用 `theme.mixins.toolbar` 的 CSS:

```jsx
const useStyles = makeStyles(theme => ({
const useStyles = makeStyles((theme) => ({
offset: theme.mixins.toolbar,
}))
}));

function App() {
const classes = useStyles();
return (
<React.Fragment>
<AppBar position="fixed">
<Toolbar>{/* content */}</Toolbar>
<Toolbar>{/* 内容 */}</Toolbar>
</AppBar>
<div className={classes.offset} />
</React.Fragment>
)
};
);
}
```

## Scrolling 滚动
Expand Down Expand Up @@ -115,11 +115,11 @@ function App() {

#### 参数

1. `options` (*Object* [optional]):
1. `options` (_Object_ [optional]):

- `options.disableHysteresis` (*Boolean* [optional]): 默认值为`false`。 禁用迟滞的效果。 在决定 `trigger` 的值时会忽略在滚动的方向。
- `options.target` *Node* [optional]):默认值时 `window`
- `options.threshold` (*Number* [optional]): 默认值是 `100`. 严格来说,当垂直滚动超过(但不包括)此阈值时,请更改 `trigger` 的值。 严格来说,当垂直滚动超过(但不包括)此阈值时,请更改 `trigger` 的值。
- `options.disableHysteresis` (_Boolean_ [optional])默认值为`false`。 禁用迟滞的效果。 在决定 `trigger` 的值时会忽略在滚动的方向。
- `options.target` (_Node_ [optional]):默认值是 `window`
- `options.threshold` (_Number_ [optional])默认值是 `100`。 严格来说,当垂直滚动超过(但不包括)此阈值时,请更改 `trigger` 的值。

#### 返回结果

Expand All @@ -134,7 +134,7 @@ function HideOnScroll(props) {
const trigger = useScrollTrigger();
return (
<Slide in={!trigger}>
<div>Hello</div>
<div>你好</div>
</Slide>
);
}
Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/autocomplete/autocomplete-ru.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: React Autocomplete component
title: Компонент React Autocomplete
components: TextField, Popper, Autocomplete
githubLabel: 'component: Autocomplete'
waiAria: 'https://www.w3.org/TR/wai-aria-practices/#combobox'
Expand Down

0 comments on commit 77e6054

Please sign in to comment.