mirror of
https://github.com/yewstack/yew.git
synced 2025-12-08 21:26:25 +00:00
Fix chinese docs (#1814)
This commit is contained in:
parent
b9fb7a1abc
commit
e5dca45257
@ -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
|
### Update
|
||||||
|
|
||||||
|
|||||||
@ -11,7 +11,9 @@ original_id: properties
|
|||||||
|
|
||||||
不要尝试自己去实现 `Properties`,而是通过使用 `#[derive(Properties)]` 来派生它。
|
不要尝试自己去实现 `Properties`,而是通过使用 `#[derive(Properties)]` 来派生它。
|
||||||
|
|
||||||
:::note 要派生`Properties`的类型也必须实现`Clone` 。这同样可以通过使用`#[derive(Properties, Clone)]`或手动为您的类型实现`Clone` :::
|
:::note
|
||||||
|
要派生`Properties`的类型也必须实现`Clone` 。这同样可以通过使用`#[derive(Properties, Clone)]`或手动为您的类型实现`Clone`
|
||||||
|
:::
|
||||||
|
|
||||||
### 必需属性
|
### 必需属性
|
||||||
|
|
||||||
|
|||||||
@ -14,6 +14,8 @@ original_id: html
|
|||||||
2. 空的 `html! {}` 宏调用是有效的但不会渲染任何内容
|
2. 空的 `html! {}` 宏调用是有效的但不会渲染任何内容
|
||||||
3. 常量必须始终被引号括起来并被包含在大括号里:`html! { "Hello, World" }`
|
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) 来获取更多细节。
|
||||||
|
:::
|
||||||
|
|||||||
@ -60,7 +60,9 @@ impl Component for Container {
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
:::note 要派生`Properties`的类型也必须实现`Clone` 。这同样可以通过使用`#[derive(Properties, Clone)]`或手动为您的类型实现`Clone` :::
|
:::note
|
||||||
|
要派生`Properties`的类型也必须实现`Clone` 。这同样可以通过使用`#[derive(Properties, Clone)]`或手动为您的类型实现`Clone`
|
||||||
|
:::
|
||||||
|
|
||||||
## 拥有 Props 的嵌套子组件
|
## 拥有 Props 的嵌套子组件
|
||||||
|
|
||||||
|
|||||||
@ -45,7 +45,9 @@ html! {
|
|||||||
|
|
||||||
<!--END_DOCUSAURUS_CODE_TABS-->
|
<!--END_DOCUSAURUS_CODE_TABS-->
|
||||||
|
|
||||||
:::note 为方便起见,一些 *通常* 需要闭合标签的元素是被**允许**自闭合的。例如,`html! { <div class="placeholder" /> }` 这样写是有效的。 :::
|
:::note
|
||||||
|
为方便起见,一些 *通常* 需要闭合标签的元素是被**允许**自闭合的。例如,`html! { <div class="placeholder" /> }` 这样写是有效的。
|
||||||
|
:::
|
||||||
|
|
||||||
## Children
|
## 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` 事件类型
|
事件名称 | `web_sys` 事件类型 | `stdweb` 事件类型
|
||||||
--- | --- | ---
|
--- | --- | ---
|
||||||
|
|||||||
@ -55,7 +55,8 @@ enum AppRoute {
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
:::caution 请注意,通过为派生宏生成实现`Switch`将按照从前到后的顺序为每个标注的路径进行匹配,所以当有路由符合多个`at`注解的路径时,将会永远只会匹配第一个符合的路径。例如,如果您定义了以下`Switch` ,将只会匹配到`AppRoute::Home` 路由。
|
:::caution
|
||||||
|
请注意,通过为派生宏生成实现`Switch`将按照从前到后的顺序为每个标注的路径进行匹配,所以当有路由符合多个`at`注解的路径时,将会永远只会匹配第一个符合的路径。例如,如果您定义了以下`Switch` ,将只会匹配到`AppRoute::Home` 路由。
|
||||||
|
|
||||||
```rust
|
```rust
|
||||||
#[derive(Switch)]
|
#[derive(Switch)]
|
||||||
|
|||||||
@ -6,4 +6,6 @@ id: version-0.17.3-services
|
|||||||
original_id: services
|
original_id: services
|
||||||
---
|
---
|
||||||
|
|
||||||
::: note 本节仍在编写中。 :::
|
:::note
|
||||||
|
本节仍在编写中。
|
||||||
|
:::
|
||||||
|
|||||||
@ -4,4 +4,6 @@ id: version-0.17.3-format
|
|||||||
original_id: format
|
original_id: format
|
||||||
---
|
---
|
||||||
|
|
||||||
:::important contribute `为我们的文档做出贡献:`[深入解释格式模块](https://github.com/yewstack/docs/issues/24) :::
|
:::important contribute
|
||||||
|
`为我们的文档做出贡献:`[深入解释格式模块](https://github.com/yewstack/docs/issues/24)
|
||||||
|
:::
|
||||||
|
|||||||
@ -30,4 +30,6 @@ cargo web start
|
|||||||
- `wasm32-unknown-emscripten`
|
- `wasm32-unknown-emscripten`
|
||||||
- `asmjs-unknown-emscripten`
|
- `asmjs-unknown-emscripten`
|
||||||
|
|
||||||
:::note <br>对于 `*-emscripten` 的目标代码, 你需要安装 Emscripten SDK。 <br>:::
|
:::note
|
||||||
|
对于 `*-emscripten` 的目标代码, 你需要安装 Emscripten SDK。
|
||||||
|
:::
|
||||||
|
|||||||
@ -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)了解更多。
|
这个工具由 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`
|
||||||
|
:::
|
||||||
|
|
||||||
## 安装
|
## 安装
|
||||||
|
|
||||||
|
|||||||
@ -9,7 +9,9 @@ original_id: roadmap
|
|||||||
|
|
||||||
由社区决定将来特性的开发优先度以及需要侧重的关注点。 在2020年春季,发起过开发者调查问卷,收集有关项目发展方向的反馈。您可以在[Yew Wiki中](https://github.com/yewstack/yew/wiki/Dev-Survey-%5BSpring-2020%5D)找到摘要。
|
由社区决定将来特性的开发优先度以及需要侧重的关注点。 在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)中跟踪所有主要计划的状态
|
||||||
|
:::
|
||||||
|
|
||||||
## 关注点
|
## 关注点
|
||||||
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user