Skip to content

Commit 0fa2c7e

Browse files
jindongjierabbitism
jindongjie
and
rabbitism
authored
zh-CN Translation: Translate all content listed under the reference section (参考资料） (#546)
* fix index.md * fix pinchgesturerecognizer.md * improve the remaing file under gestrues folder * fix type error for style-selector-syntax.md * Remove unused controls reference file * add index.md for controls reference collection * add & trans border.md * fix not updated translations related to the button control * move & trans calender control * add & translate data-grid-tempalte-columns.md * trans drowing-image.md * add & trans sharedsizegroup.md * move & trans path-icon.md * move & trans label.md * fix makedtextbox.md & layout-controls.md * add & trans menu-flyout.md * add & trans selectable-textblock.md * add & trans tabcontrol, tabstrip * trans textblock, textbox, timepicker * trans tooltip, transitioningcctrl, tray-icon * add & trans treedatagrid section * add & trans treeview, uniformgrid, viewbox, wrappanel * update trans animation-settings, built-in-data-binding-converters --------- Co-authored-by: Dong Bin <[email protected]>
1 parent b999980 commit 0fa2c7e

Some content is hidden

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

47 files changed

+1900
-245
lines changed

‎i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/animation-settings.md

Lines changed: 29 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -36,18 +36,14 @@ import SineEaseOutScreenshot from '/img/reference/animation-settings/sine-ease-o
3636

3737
# 动画设置
3838

39-
This section contains full lists of the _Avalonia UI_ animation settings:
40-
本节包含 _Avalonia UI_ 动画设置的完整列表：
41-
42-
* 缓动函数（Easing Functions）
43-
* 填充模式（FillMode）
44-
* 播放方向（PlaybackDirection）
45-
* 重复（IterationCount）
39+
本节描述了如何自定义 `Animation` 播放。
4640

4741
## 缓动函数（Easing Functions）
4842

49-
| Default |
50-
|---------------------------------------------------------------|
43+
`Easing` 函数描述了动画属性在动画时间内从起始值到结束值的变化速度。`Avalonia.Animation.Easings` 包含以下缓动函数：
44+
45+
| 默认 |
46+
|-------------------------------------------------------------|
5147
| `LinearEasing`<br/><img src={LinearEasingScreenshot} alt=""/> |
5248

5349
| Ease-In | Ease-Out | Ease-In-Out |
@@ -63,36 +59,38 @@ This section contains full lists of the _Avalonia UI_ animation settings:
6359
| `ElasticEaseIn`<br/><img src={ElasticEaseInScreenshot} alt=""/> | `ElasticEaseOut`<br/><img src={ElasticEaseOutScreenshot} alt=""/> | `ElasticEaseInOut`<br/><img src={ElasticEaseInOutScreenshot} alt=""/> |
6460
| `BounceEaseIn`<br/><img src={BounceEaseInScreenshot} alt=""/> | `BounceEaseOut`<br/><img src={BounceEaseOutScreenshot} alt=""/> | `BounceEaseInOut`<br/><img src={BounceEaseInOutScreenshot} alt=""/> |
6561

66-
## 填充模式（FillMode）
62+
此外，您可以通过继承 `Easing` 或通过向 `SplineEasing` 或 `SpringEasing` 提供参数来提供自己的缓动函数。
6763

68-
动画的填充模式属性定义了动画运行后设置属性在延迟运行之间的持续方式。
64+
## 填充模式（FillModes）
6965

70-
以下表格描述了可能的行为：
66+
`Animation` 的 `FillMode` 属性定义了动画完成后以及在运行之间的延迟期间动画属性的持久化方式。
7167

72-
| 值 | 描述 |
73-
|------------|---------------------------------|
74-
| `None` | 在动画后值不会持续，也不会在延迟时应用第一个值。 |
75-
| `Forward` | 最后一个插值值将持续到目标属性。 |
76-
| `Backward` | 第一个插值值将在动画延迟时显示。 |
77-
| `Both` | 同时应用 `Forward` 和 `Backward` 行为。 |
68+
下表描述了支持的行为：
7869

79-
## 播放方向（PlaybackDirection）
70+
| 值 | 描述 |
71+
|------------|-----------------------------------------------------------------------------------------------------------|
72+
| `None` | 动画完成后值不会持久化，动画延迟时不会应用第一个值。 |
73+
| `Forward` | 最后插值的值将持久化到目标属性。 |
74+
| `Backward` | 动画延迟时将显示第一个插值的值。 |
75+
| `Both` | 将应用 `Forward` 和 `Backward` 行为。 |
8076

81-
播放方向定义了动画的播放方式，包括任何重复。以下表格描述了可能的设置：
77+
## 播放方向（PlaybackDirection）
8278

79+
`PlaybackDirection` 定义了 `Animation` 的播放方式。下表描述了可能的设置：
8380

84-
| Value | Description |
85-
|--------------------|-----------------|
86-
| `Normal` | 动画以正常方式播放。 |
87-
| `Reverse` | 动画以反向方向播放。 |
88-
| `Alternate` | 动画先正向播放，然后反向播放。 |
89-
| `AlternateReverse` | 动画先反向播放，然后正向播放。 |
81+
| 值 | 描述 |
82+
|--------------------|---------------------------------------------------------|
83+
| `Normal` | 动画正常播放。 |
84+
| `Reverse` | 动画反向播放。 |
85+
| `Alternate` | 动画先正向播放，然后反向播放。 |
86+
| `AlternateReverse` | 动画先反向播放，然后正向播放。 |
9087

9188
## 重复（IterationCount）
9289

93-
动画元素上的重复属性设置了动画的重复次数。有两种格式的设置方式：
90+
`Animation` 元素上的 `IterationCount` 设置动画要重播的次数。此设置有两种格式：
91+
92+
| 值 | 描述 |
93+
|------------|------------------------------------------|
94+
| `N` | (N 是一个整数) - 播放 N 次, N 可以为零。 |
95+
| `Infinite` | 永远重复 |
9496

95-
| 值 | 描述 |
96-
|------------|-----------------------|
97-
| `N` | N 是整数——重复 N 次。N 可以是零。 |
98-
| `Infinite` | 无限重复。 |

‎i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/built-in-data-binding-converters.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -6,41 +6,41 @@ description: REFERENCE
66

77
_Avalonia UI_ 包含许多用于常见场景的内置数据绑定转换器：
88

9-
| 转换器 | 描述 |
10-
|-------------------------------------|-----------------------------------------|
11-
| 否定运算符 | 可以将 `!` 运算符放在数据绑定路径前面，返回布尔值的反转。参见下面的备注。 |
12-
| `StringConverters.IsNullOrEmpty` | 如果输入字符串为 null 或空字符串，则返回 `true`。 |
13-
| `StringConverters.IsNotNullOrEmpty` | 如果输入字符串不为 null 且不为空字符串，则返回 `false`。 |
14-
| `ObjectConverters.IsNull` | 如果输入对象为 null，则返回 `true`。 |
15-
| `ObjectConverters.IsNotNull` | 如果输入对象不为 null，则返回 `false`。 |
16-
| `BoolConverters.And` | 这是一个多值转换器，如果所有输入值都为 `true`，则返回 true。 |
17-
| `BoolConverters.Or` | 这是一个多值转换器，如果任何输入值为 `true`，则返回 true。 |
9+
| 转换器 | 描述 |
10+
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
11+
| 取反运算符 | 可以在数据绑定路径前面放置 ! 运算符以返回布尔值的反值。另请参见下面的注释。 |
12+
| `StringConverters.IsNullOrEmpty` | 如果输入字符串为空或为 null，则返回 `true` |
13+
| `StringConverters.IsNotNullOrEmpty` | 如果输入字符串为空或为 null，则返回 `false` |
14+
| `ObjectConverters.IsNull` | 如果输入为 null，则返回 `true` |
15+
| `ObjectConverters.IsNotNull` | 如果输入为 null，则返回 `false` |
16+
| `BoolConverters.And` | 一个多值转换器，如果所有输入都为 true，则返回 `true` |
17+
| `BoolConverters.Or` | 一个多值转换器，如果任何输入为 true，则返回 `true` |
1818

19-
## 否定运算符示例
19+
## 取反运算符示例
2020

21-
这个例子展示了当绑定的值为false时，文本块的情况：
21+
此示例显示当绑定值为 false 时的 `TextBlock`：
2222

2323
```xml
2424
<StackPanel>
2525
<TextBox Name="input" IsEnabled="{Binding AllowInput}"/>
26-
<TextBlock IsVisible="{Binding !AllowInput}">Input is not allowed</TextBlock>
26+
<TextBlock IsVisible="{Binding !AllowInput}">不允许输入</TextBlock>
2727
</StackPanel>
2828
```
2929

30-
否定运算符在绑定到非布尔值时也可以工作。这是因为绑定的值首先会被转换为布尔值（使用函数`Convert.ToBoolean`），然后结果会被取反。
30+
当您绑定到非布尔值时，取反运算符也有效。这是因为绑定值首先转换为布尔值（使用函数 `Convert.ToBoolean`），然后结果被取反。
3131

32-
例如，整数零会被转换为false（通过函数`Convert.ToBoolean`），而其他所有整数值都会被转换为true，因此你可以使用否定运算符来在集合为空时显示一条消息，像这样：
32+
例如，由于整数零被转换为 false（通过函数 `Convert.ToBoolean`），而所有其他整数值被转换为 true，您可以使用取反运算符在集合为空时显示消息，如下所示：
3333

3434
```xml
3535
<Panel>
3636
<ListBox ItemsSource="{Binding Items}"/>
37-
<TextBlock IsVisible="{Binding !Items.Count}">No results found</TextBlock>
37+
<TextBlock IsVisible="{Binding !Items.Count}">未找到结果</TextBlock>
3838
</Panel>
3939
```
4040

41-
你也可以连续使用否定运算符两次。例如，在你想要将整数转换为布尔值，然后对该值取反时，可以这样写：
41+
您还可以使用取反运算符两次。例如，当您希望执行从整数到布尔值的转换，然后取反该值时。
4242

43-
你可以使用这种方式来在集合为空时隐藏一个控件（计数为零），像这样：
43+
您可以使用此方法在集合为空（计数为零）时隐藏控件，如下所示：
4444

4545
```xml
4646
<Panel>
@@ -50,15 +50,15 @@ _Avalonia UI_ 包含许多用于常见场景的内置数据绑定转换器：
5050

5151
## 其他转换示例
5252

53-
这个绑定示例将在绑定的文本为null或空字符串时隐藏文本块：
53+
此示例绑定将在绑定文本为空或为 null 时隐藏文本块：
5454

5555
```xml
5656
<TextBlock Text="{Binding MyText}"
5757
IsVisible="{Binding MyText,
5858
Converter={x:Static StringConverters.IsNotNullOrEmpty}}"/>
5959
```
6060

61-
而这个示例将在绑定的对象为null或为空时隐藏内容控件：
61+
此示例将在绑定对象为空或为 null 时隐藏内容控件：
6262

6363
```xml
6464
<ContentControl Content="{Binding MyContent}"
@@ -68,7 +68,7 @@ _Avalonia UI_ 包含许多用于常见场景的内置数据绑定转换器：
6868

6969
## 更多信息
7070

71-
7271
:::info
73-
你可以查看 Avalonia UI 的[值转换器示例](https://github.com/AvaloniaUI/Avalonia.Samples/tree/main/src/Avalonia.Samples/MVVM/ValueConversionSample)。
72+
您可以在 [这里](https://github.com/AvaloniaUI/Avalonia.Samples/tree/main/src/Avalonia.Samples/MVVM/ValueConversionSample) 查看 Avalonia UI 值转换器示例。
7473
:::
74+

‎i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/README.md

Lines changed: 0 additions & 28 deletions
This file was deleted.

‎i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/border.md

Lines changed: 113 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,113 @@
1+
---
2+
description: REFERENCE - Built-in Controls
3+
---
4+
5+
import BorderPodLookScreenshot from '/img/reference/controls/border/border-pod-look.png';
6+
import BorderDropShadowScreenshot from '/img/reference/controls/border/border-drop-shadow.png';
7+
8+
# Border 边框
9+
10+
边框控件为（单个）子控件装饰边框和背景。它还可以用于显示圆角。
11+
12+
## 常用属性
13+
14+
您可能最常使用这些属性：
15+
16+
<table><thead><tr><th width="261">属性</th><th>描述</th></tr></thead><tbody><tr><td><code>Background</code></td><td>背景颜色。</td></tr><tr><td><code>BorderBrush</code></td><td>边框颜色。</td></tr><tr><td><code>BorderThickness</code></td><td>边框线条厚度（整数）。</td></tr><tr><td><code>CornerRadius</code></td><td>所有四个角的半径（一个值），或指定为列表 - 见下文。</td></tr><tr><td><code>BoxShadow</code></td><td>定义阴影（见下文）。</td></tr></tbody></table>
17+
18+
## 圆角属性
19+
20+
您可以将圆角属性的值设置为单个值。在这种情况下，_Avalonia UI_ 将在子控件的所有四个角上使用相同的半径。
21+
22+
或者，您可以指定一个值列表；这必须采用以下两种格式之一。
23+
24+
当列表中只有两个值时，_Avalonia UI_ 将使用以下模式解释它们：
25+
26+
`CornerRadius="上方值 下方值"`
27+
28+
左上角和右上角的半径由第一个值设置，左下角和右下角的半径由第二个值设置。
29+
30+
当列表中有四个值时，_Avalonia UI_ 将使用以下模式解释它们：
31+
32+
`CornerRadius="左上值 右上值 右下值 左下值"`
33+
34+
:::warning
35+
如果您使用四值模式；您必须提供所有四个值，即使其中一个为零。列表中不允许有三个值。
36+
:::
37+
38+
### 示例
39+
40+
此示例添加了一些边框控件以在布局中创建“pod”外观：
41+
42+
```xml
43+
<StackPanel>
44+
<Border Background="Gainsboro"
45+
BorderBrush="Black"
46+
BorderThickness="2"
47+
CornerRadius="3"
48+
Padding="10" Margin="10">
49+
<TextBlock>Box 1</TextBlock>
50+
</Border>
51+
<Border Background="Gainsboro"
52+
BorderBrush="Black"
53+
BorderThickness="2"
54+
CornerRadius="3"
55+
Padding="10" Margin="10">
56+
<TextBlock>Box 2</TextBlock>
57+
</Border>
58+
</StackPanel>
59+
```
60+
61+
<img src={BorderPodLookScreenshot} alt=""/>
62+
63+
## 盒廓阴影
64+
65+
您可以通过设置其盒廓阴影属性来定义边框的阴影。您可以使用以下方式指定单个盒廓阴影：
66+
67+
* 一个可选的 `inset` 关键字 - 这将在边框内绘制阴影 - 不常用！
68+
* 两个、三个或四个长度值 - 见下文。
69+
* 一个颜色值。
70+
71+
如果只给出两个长度值，将它们解释为 `offset-x` 和 `offset-y`。如果给出第三个值，则将其解释为 `blur-radius`，如果给出第四个值，则将其解释为 `spread-radius`。
72+
73+
:::info
74+
您可以通过提供逗号分隔的阴影定义列表来指定多个阴影。
75+
:::
76+
77+
此表描述了盒廓阴影值，按它们出现的顺序：
78+
79+
<table><thead><tr><th width="203">值</th><th>描述</th></tr></thead><tbody><tr><td><code>inset</code></td><td>如果未指定（默认），则假定阴影为投影（如同盒廓被抬高在内容之上）。inset 关键字的存在将阴影更改为框架内部（如同内容被压入盒廓内部）。内嵌阴影绘制在边框内（即使是透明的），并且在背景之上但在任何内容之下</td></tr><tr><td><code>offset-x</code> </td><td>指定水平距离。负值将阴影放置在元素的左侧。</td></tr><tr><td><code>offset-y</code></td><td>指定垂直距离。负值将阴影放置在元素的上方。</td></tr><tr><td><code>blur-radius</code></td><td>此值越大，模糊效果越大，因此阴影变得更大且更轻。负值不允许。如果未指定，则使用默认值（零），阴影边缘是锐利的。</td></tr><tr><td><code>spread-radius</code></td><td>正值将导致阴影扩展和变大，负值将导致阴影收缩。如果未指定，它将为 0（阴影将与元素大小相同）。</td></tr><tr><td><code>color</code></td><td>使用颜色名称（例如红色）或带有 # 前缀的十六进制颜色值的阴影颜色。例如：#dadada</td></tr></tbody></table>
80+
81+
:::info
82+
如果两个偏移值都设置为零，阴影将放置在元素后面，并且只有在同时或者单独设置了 `blur-radius` , `spread-radius` 时才会生成模糊效果。
83+
:::
84+
85+
### 示例
86+
87+
这是一个投影的示例：
88+
89+
```xml
90+
<<StackPanel>
91+
<Border Background="Gainsboro"
92+
BorderBrush="Black"
93+
BorderThickness="2"
94+
CornerRadius="3"
95+
BoxShadow="5 5 10 0 DarkGray"
96+
Padding="10" Margin="40">
97+
<TextBlock>Box with a drop shadow</TextBlock>
98+
</Border>
99+
</StackPanel>
100+
```
101+
102+
<img src={BorderDropShadowScreenshot} alt=""/>
103+
104+
## 更多信息
105+
106+
:::info
107+
有关此控件的完整 API 文档，请参见[此处](http://reference.avaloniaui.net/api/Avalonia.Controls/Border/)。
108+
:::
109+
110+
:::info
111+
在 _GitHub_ 上查看源代码 [`Border.cs`](https://github.com/AvaloniaUI/Avalonia/blob/master/src/Avalonia.Controls/Border.cs)
112+
:::
113+

‎i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/buttons/button.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ import ButtonClickScreenshot from '/img/reference/controls/buttons/button-click.
88

99
按钮是一种对指针动作做出反应的控件（也有一些键盘等效操作）。当指针按下时，它会呈现出被按下的状态。
1010

11-
将指针按下到释放的序列解释为点击；此行为是可配置的。
11+
指针按下到释放的序列会解释为点击，并且此行为是可配置的。
1212

1313
:::warning
1414
在确定按钮是否被用户按下时，请始终使用`Click`事件而不是`PointerPressed`。`Click`是`Button`特有的高级事件，表示按钮已被按下。

‎i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/buttons/buttonspinner.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,13 +8,13 @@ import ButtonSpinnerScreenshot from '/img/reference/controls/buttons/button-spin
88

99
按钮微调器是一个包含向上和向下微调按钮的控件。该按钮的内容是灵活的，但您需要编写相当多的行为代码。
1010

11-
## 有用的属性
11+
## 常用属性
1212

1313
您可能经常使用以下属性：
1414

1515
<table><thead><tr><th width="261">属性</th><th>描述</th></tr></thead><tbody><tr><td><code>ButtonSpinnerLocation</code></td><td>微调按钮的位置：左侧或右侧。</td></tr><tr><td><code>ValidSpinDirection</code></td><td>用于限制微调方向：增加、减少或无。</td></tr></tbody></table>
1616

17-
## 更多信息
17+
## 示例代码
1818

1919
```xml
2020
<ButtonSpinner Height="20" Width="130" ButtonSpinnerLocation="Left">

‎i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/buttons/radiobutton.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ import RadioButtonScreenshot from '/img/reference/controls/buttons/radiobutton.g
2222
| `IsChecked` | 单选按钮选项是否被选中（true）或未选中（false）。 |
2323
| `IsEnabled` | 单选按钮选项是否启用。禁用的选项呈现为透明。 |
2424

25-
## 更多信息
25+
## 示例代码
2626

2727
以下示例展示了两组独立工作的单选按钮：
2828

‎i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/buttons/repeatbutton.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ import RepeatButtonHoldScreenshot from '/img/reference/controls/buttons/repeatbu
1717
| `Delay` | 在开始生成重复点击之前等待的时间（毫秒）。默认为300毫秒。 |
1818
| `Interval`| 生成点击事件之间的时间间隔（毫秒）。默认为100毫秒。 |
1919

20-
## 更多信息
20+
## 示例代码
2121

2222
下面的示例演示了一个重复按钮，使用默认的间隔和延迟来生成点击事件。
2323

‎i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/buttons/splitbutton.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ import SplitButtonExportButtonScreenshot from '/img/reference/controls/buttons/s
3838

3939
[SplitButton.cs](https://github.com/AvaloniaUI/Avalonia/blob/master/src/Avalonia.Controls/SplitButton/SplitButton.cs)
4040

41-
## 更多信息
41+
## 示例代码
4242

4343
### 基本示例
4444

‎i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/buttons/togglesplitbutton.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ import ToggleSplitButtonTextListScreenshot from '/img/reference/controls/buttons
4646

4747
[ToggleSplitButton.cs](https://github.com/AvaloniaUI/Avalonia/blob/master/src/Avalonia.Controls/SplitButton/ToggleSplitButton.cs)
4848

49-
## 更多信息
49+
## 示例代码
5050

5151
### 基本示例
5252

0 commit comments

Comments
 (0)