Fix chinese docs (#1814)

This commit is contained in:
sansx 2021-04-07 23:53:25 +08:00 committed by GitHub
parent b9fb7a1abc
commit e5dca45257
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
11 changed files with 42 additions and 15 deletions

View File

@ -11,7 +11,9 @@ original_id: components
## 生命周期
:::note `为我们的文档做出贡献:`[添加组件的生命周期图示](https://github.com/yewstack/docs/issues/22) :::
:::important contribute
`为我们的文档做出贡献:`[添加组件的生命周期图示](https://github.com/yewstack/docs/issues/22)
:::
## 生命周期方法
@ -90,7 +92,9 @@ impl Component for MyComponent {
}
```
:::tip note 请注意,可以不实现此生命周期方法,默认情况下不会执行任何操作。 :::
:::tip note
请注意,可以不实现此生命周期方法,默认情况下不会执行任何操作。
:::
### Update

View File

@ -11,7 +11,9 @@ original_id: properties
不要尝试自己去实现 `Properties`,而是通过使用 `#[derive(Properties)]` 来派生它。
:::note 要派生`Properties`的类型也必须实现`Clone` 。这同样可以通过使用`#[derive(Properties, Clone)]`或手动为您的类型实现`Clone` :::
:::note
要派生`Properties`的类型也必须实现`Clone` 。这同样可以通过使用`#[derive(Properties, Clone)]`或手动为您的类型实现`Clone`
:::
### 必需属性

View File

@ -14,6 +14,8 @@ original_id: html
2. 空的 `html! {}` 宏调用是有效的但不会渲染任何内容
3. 常量必须始终被引号括起来并被包含在大括号里:`html! { "Hello, World" }`
::: note `html!`宏可以轻松达到编译器的默认递归限制。如果遇到编译错误,建议增大其值。在根 crate 使用这样的属性`#![recursion_limit="1024"]``lib.rs``main.rs` 也是同理)处理这个问题。
:::note
`html!`宏可以轻松达到编译器的默认递归限制。如果遇到编译错误,建议增大其值。在根 crate 使用这样的属性`#![recursion_limit="1024"]``lib.rs``main.rs` 也是同理)处理这个问题。
查看 [官方文档](https://doc.rust-lang.org/reference/attributes/limits.html#the-recursion_limit-attribute) 和 [这篇 Stack Overflow 问答](https://stackoverflow.com/questions/27454761/what-is-a-crate-attribute-and-where-do-i-add-it) 来获取更多细节。 :::
查看 [官方文档](https://doc.rust-lang.org/reference/attributes/limits.html#the-recursion_limit-attribute) 和 [这篇 Stack Overflow 问答](https://stackoverflow.com/questions/27454761/what-is-a-crate-attribute-and-where-do-i-add-it) 来获取更多细节。
:::

View File

@ -60,7 +60,9 @@ impl Component for Container {
}
```
:::note 要派生`Properties`的类型也必须实现`Clone` 。这同样可以通过使用`#[derive(Properties, Clone)]`或手动为您的类型实现`Clone` :::
:::note
要派生`Properties`的类型也必须实现`Clone` 。这同样可以通过使用`#[derive(Properties, Clone)]`或手动为您的类型实现`Clone`
:::
## 拥有 Props 的嵌套子组件

View File

@ -45,7 +45,9 @@ html! {
<!--END_DOCUSAURUS_CODE_TABS-->
:::note 为方便起见,一些 *通常* 需要闭合标签的元素是被**允许**自闭合的。例如,`html! { <div class="placeholder" /> }` 这样写是有效的。 :::
:::note
为方便起见,一些 *通常* 需要闭合标签的元素是被**允许**自闭合的。例如,`html! { <div class="placeholder" /> }` 这样写是有效的。
:::
## Children
@ -268,9 +270,13 @@ impl Component for MyComponent {
## 事件类型
:::note 在下表中, 只有当`yew``web-sys`一起使用时,才应使用`web-sys`的事件类型(默认情况下启用)。如果您使用的是`yew-stdweb` crate请使用`stdweb`。更多有关信息,请参见<a href="https://yew.rs/docs/getting-started/choose-web-library" data-md-type="link">有关选择是选择`web-sys`还是`stdweb`</a> :::
:::note
在下表中, 只有当`yew``web-sys`一起使用时,才应使用`web-sys`的事件类型(默认情况下启用)。如果您使用的是`yew-stdweb` crate请使用`stdweb`。更多有关信息,请参见<a href="https://yew.rs/docs/getting-started/choose-web-library" data-md-type="link">有关选择是选择`web-sys`还是`stdweb`</a>
:::
:::note 下表中提到的所有事件类型都已在`yew::events`下重新导出。 比起手动将 `web-sys``stdweb`作为依赖项添加到你的 crate 中, 使用`yew::events`中的类型更容易确保版本兼容性,因为这样可以避免与指定的 Yew 版本冲突。 :::
:::note
下表中提到的所有事件类型都已在`yew::events`下重新导出。 比起手动将 `web-sys``stdweb`作为依赖项添加到你的 crate 中, 使用`yew::events`中的类型更容易确保版本兼容性,因为这样可以避免与指定的 Yew 版本冲突。
:::
事件名称 | `web_sys` 事件类型 | `stdweb` 事件类型
--- | --- | ---

View File

@ -55,7 +55,8 @@ enum AppRoute {
}
```
:::caution 请注意,通过为派生宏生成实现`Switch`将按照从前到后的顺序为每个标注的路径进行匹配,所以当有路由符合多个`at`注解的路径时,将会永远只会匹配第一个符合的路径。例如,如果您定义了以下`Switch` ,将只会匹配到`AppRoute::Home` 路由。
:::caution
请注意,通过为派生宏生成实现`Switch`将按照从前到后的顺序为每个标注的路径进行匹配,所以当有路由符合多个`at`注解的路径时,将会永远只会匹配第一个符合的路径。例如,如果您定义了以下`Switch` ,将只会匹配到`AppRoute::Home` 路由。
```rust
#[derive(Switch)]

View File

@ -6,4 +6,6 @@ id: version-0.17.3-services
original_id: services
---
::: note 本节仍在编写中。 :::
:::note
本节仍在编写中。
:::

View File

@ -4,4 +4,6 @@ id: version-0.17.3-format
original_id: format
---
:::important contribute `为我们的文档做出贡献:`[深入解释格式模块](https://github.com/yewstack/docs/issues/24) :::
:::important contribute
`为我们的文档做出贡献:`[深入解释格式模块](https://github.com/yewstack/docs/issues/24)
:::

View File

@ -30,4 +30,6 @@ cargo web start
- `wasm32-unknown-emscripten`
- `asmjs-unknown-emscripten`
:::note <br>对于 `*-emscripten` 的目标代码, 你需要安装 Emscripten SDK。 <br>:::
:::note
对于 `*-emscripten` 的目标代码, 你需要安装 Emscripten SDK。
:::

View File

@ -6,7 +6,9 @@ original_id: using-wasm-pack
这个工具由 Rust / Wasm 工作组开发维护,并且是现在最为活跃的 WebAssembly 应用开发工具。 它支持将代码打包成 `npm` 模块,并且随附了 [Webpack 插件](https://github.com/wasm-tool/wasm-pack-plugin),可以轻松的与已有的 JavaScript 应用结合。可以点击[这里](https://rustwasm.github.io/docs/wasm-pack/introduction.html)了解更多。
:::note 注:如果使用 `wasm-pack`作为开发工具,`Cargo.toml` 中的 `crate-type` 需要为 `cdylib` :::
:::note
注:如果使用 `wasm-pack`作为开发工具,`Cargo.toml` 中的 `crate-type` 需要为 `cdylib`
:::
## 安装

View File

@ -9,7 +9,9 @@ original_id: roadmap
由社区决定将来特性的开发优先度以及需要侧重的关注点。 在2020年春季发起过开发者调查问卷收集有关项目发展方向的反馈。您可以在[Yew Wiki中](https://github.com/yewstack/yew/wiki/Dev-Survey-%5BSpring-2020%5D)找到摘要。
:::note 可以在[Yew Github项目 ](https://github.com/yewstack/yew/projects)中跟踪所有主要计划的状态 :::
:::note
可以在[Yew Github项目 ](https://github.com/yewstack/yew/projects)中跟踪所有主要计划的状态
:::
## 关注点