docs(cn): translate legacy/createElement into Chinese #1210
Conversation
Size changes📦 Next.js Bundle Analysis for react-devThis analysis was generated by the Next.js Bundle Analysis action. 🤖 Three Pages Changed SizeThe following pages changed size from the code in this PR compared to its base branch:
DetailsOnly the gzipped size is provided here based on an expert tip. First Load is the size of the global bundle plus the bundle for the individual page. If a user were to show up to your website and land on a given page, the first load size represents the amount of javascript that user would need to download. If Any third party scripts you have added directly to your app using the Next to the size is how much the size has increased or decreased compared with the base branch of this PR. If this percentage has increased by 10% or more, there will be a red status indicator applied, indicating that special attention should be given to this. |
|
|
||
| ### `createElement(type, props, ...children)` {/*createelement*/} | ||
|
|
||
| Call `createElement` to create a React element with the given `type`, `props`, and `children`. | ||
| 调用 `createElement` 来创建一个 React 元素，它拥有给定的 `type`、`props` 和 `children`。 |
There was a problem hiding this comment.
确实，原文的意思应该是说“createElement 有这些参数”，而不是“元素有这些参数”。已修改。
|
|
||
| * `type`: The `type` argument must be a valid React component type. For example, it could be a tag name string (such as `'div'` or `'span'`), or a React component (a function, a class, or a special component like [`Fragment`](/reference/react/Fragment)). | ||
| * `type`：`type` 参数必须是一个有效的 React 组件类型。例如，它可以是一个标签名字符串（如 `'div'` 或 `'span'`），或一个 React 组件（一个函数、一个类，或者是一个特殊的组件，比如 [`Fragment`](/reference/react/Fragment)）。 |
|
|
||
| * You must **treat React elements and their props as [immutable](https://en.wikipedia.org/wiki/Immutable_object)** and never change their contents after creation. In development, React will [freeze](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/freeze) the returned element and its `props` property shallowly to enforce this. | ||
| * 你必须 **把 React 元素和它们的 props 视为[不可变的](https://en.wikipedia.org/wiki/Immutable_object)**，并且在创建后永远不要改变它们的内容。在开发环境中，React 会浅层 [冻结](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/freeze) 返回的元素及其 `props` 属性，以强制执行此操作。 |
There was a problem hiding this comment.
| * 你必须 **把 React 元素和它们的 props 视为[不可变的](https://en.wikipedia.org/wiki/Immutable_object)**，并且在创建后永远不要改变它们的内容。在开发环境中，React 会浅层 [冻结](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/freeze) 返回的元素及其 `props` 属性，以强制执行此操作。 | |
| * 你必须 **把 React 元素和它们的 props 视为 [不可变的](https://en.wikipedia.org/wiki/Immutable_object)**，并且在创建后永远不要改变它们的内容。在开发环境中，React 会浅层 [冻结](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/freeze) 返回的元素及其 `props` 属性，以强制执行此操作。 |
| }, | ||
| key: null, | ||
| ref: null, | ||
| } | ||
| ``` | ||
|
|
||
| **Note that creating this object does not render the `Greeting` component or create any DOM elements.** | ||
| **注意，创建这个对象并不会渲染 `Greeting` 组件或者创建任何 DOM 元素。** |
There was a problem hiding this comment.
已修改。
P.S. 这个规则是无条件的吗？如果加粗是句内的一部分还可以理解，但整段加粗的情况下句末标点也需要放在外面，感觉就有点怪了。
51d3e55 to
9475f9f
Compare
9475f9f to
b3c840e
Compare
|
对于翻译时要求直译或意译，有什么可以参考的指南吗？有些表达直译过来确实有些绕，我有改动过一些表述（如 如果依旧有很多地方拗口，我可以再多做一些这样的改动，例如 |
我的个人观点是，在保证原文意思不变的情况下，可以大胆“意译”。 |
b3c840e to
157cc79
Compare
157cc79 to
80e282d
Compare
|
rebase 了一下 main 分支，还有其它问题需要解决吗？ |
80e282d to
575dce4
Compare
575dce4 to
da13c8a
Compare
翻译 legacy/createElement。