doc: translate dom-elements #40
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
Deploy preview for zh-hant-reactjs-org ready! Built with commit 526968e |
92 tasks
piovischioh
force-pushed
the
reference-dom-elements
branch
from
ba7bd78 to
e956db5
Compare
|
|
||
| ### checked {#checked} | ||
|
|
||
| The `checked` attribute is supported by `<input>` components of type `checkbox` or `radio`. You can use it to set whether the component is checked. This is useful for building controlled components. `defaultChecked` is the uncontrolled equivalent, which sets whether the component is checked when it is first mounted. | ||
| 當 `<input>` 的 type 是 `checkbox` 或是 `radio` 時，可以使用 `checked` 這個 attribute 來設置 component 是否被選取。這對建立 controlled component 很有幫助。`defaultChecked` 則是使用在 uncontrolled component，當初始 mount 後設置 component 是否被選取。 |
There was a problem hiding this comment.
Suggested change
| 當 `<input>` 的 type 是 `checkbox` 或是 `radio` 時，可以使用 `checked` 這個 attribute 來設置 component 是否被選取。這對建立 controlled component 很有幫助。`defaultChecked` 則是使用在 uncontrolled component，當初始 mount 後設置 component 是否被選取。 | |
| 當 `<input>` 的 type 是 `checkbox` 或是 `radio` 時，可以使用 `checked` 這個 attribute 來設定 component 是否被選取。這對於建立被控制的 component 非常有用。`defaultChecked` 則是使用在非被控制的 component，在初始 mount 後，設定 component 是否被選取。 |
There was a problem hiding this comment.
I suggest controlled component should stay untranslated as in #23 since it appears quite often and people need to google it together with their questions.
There was a problem hiding this comment.
Although It is synonymous, I think 設置 would be more comprehensive and elegant.
There was a problem hiding this comment.
I had discussed with @chloewlin about controlled component and uncontrolled component this terms, you are right, let's keep the original terms in here.
|
|
||
| ### dangerouslySetInnerHTML {#dangerouslysetinnerhtml} | ||
|
|
||
| `dangerouslySetInnerHTML` is React's replacement for using `innerHTML` in the browser DOM. In general, setting HTML from code is risky because it's easy to inadvertently expose your users to a [cross-site scripting (XSS)](https://en.wikipedia.org/wiki/Cross-site_scripting) attack. So, you can set HTML directly from React, but you have to type out `dangerouslySetInnerHTML` and pass an object with a `__html` key, to remind yourself that it's dangerous. For example: | ||
| `dangerouslySetInnerHTML` 是 React 用來替代 DOM 的 `innerHTML`。普遍來說，從程式碼中注入 HTML 是個冒險的行為，你會很輕易地讓使用者暴露在 [cross-site scripting (XSS)](https://zh.wikipedia.org/wiki/跨網站指令碼) 風險之下。所以在 React 裡你還是可以直接注入 HTML，但是你必須使用 `dangerouslySetInnerHTML`，然後傳入一個有 `__html` 為 key 的 object，藉此來提醒你自己這樣做具有風險。例子如下： |
There was a problem hiding this comment.
Suggested change
| `dangerouslySetInnerHTML` 是 React 用來替代 DOM 的 `innerHTML`。普遍來說，從程式碼中注入 HTML 是個冒險的行為，你會很輕易地讓使用者暴露在 [cross-site scripting (XSS)](https://zh.wikipedia.org/wiki/跨網站指令碼) 風險之下。所以在 React 裡你還是可以直接注入 HTML，但是你必須使用 `dangerouslySetInnerHTML`，然後傳入一個有 `__html` 為 key 的 object，藉此來提醒你自己這樣做具有風險。例子如下： | |
| `dangerouslySetInnerHTML` 是 React 用來替代 DOM 的 `innerHTML`。普遍來說，從程式碼中注入 HTML 是個冒險的行為，你會很輕易地讓使用者暴露在 [cross-site scripting (XSS)](https://zh.wikipedia.org/wiki/Cross-site_scripting) 攻擊之下。所以在 React 裡你還是可以直接注入 HTML，但是你必須使用 `dangerouslySetInnerHTML`，然後傳入一個有 `__html` 為 key 的 object，藉此來提醒你自己這樣做具有風險。例如： |
There was a problem hiding this comment.
It's better to have equivalent links in Chinese according to the guide.
There was a problem hiding this comment.
Sorry for missing this translate style guide.
|
|
||
| ### selected {#selected} | ||
|
|
||
| The `selected` attribute is supported by `<option>` components. You can use it to set whether the component is selected. This is useful for building controlled components. | ||
| `selected` 這個 attribute 可以使用在 `<option>` 裡面，用來設置 component 是否已被選取。這對建立 controlled component 很有幫助。 |
There was a problem hiding this comment.
Suggested change
| `selected` 這個 attribute 可以使用在 `<option>` 裡面，用來設置 component 是否已被選取。這對建立 controlled component 很有幫助。 | |
| `selected` 這個 attribute 可以使用在 `<option>` 裡面，用來設置 component 是否已被選取。這對建立被控制的 component 很有幫助。 |
neighborhood999
added
In Review
|
Fixed and updated! |
|
@piovischioh thank you for translation, I merged it. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Besides words mentioned in Glossary, I remain these untranslated.
server/client(side)styletimestampkeypropertypixelcamelCasecontrolled componentWelcome for further discussion.