You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: src/content/reference/react-dom/components/link.md
+4-4
Original file line number
Diff line number
Diff line change
@@ -79,7 +79,7 @@ Props that are **not recommended** for use with React:
79
79
80
80
#### Special rendering behavior {/*special-rendering-behavior*/}
81
81
82
-
React will always place the DOM element corresponding to the `<link>` component within the document’s `<head>`, regardless of where in the React tree it is rendered. The `<head>` is the only valid place for `<link>` to exist within the DOM, yet it’s convenient and keeps things composable if a component representing a specific page can render `<link>` components itself.
82
+
React will always place the DOM element corresponding to the `<link>` component within the document’s `<head>`, regardless of where in the React tree it is rendered. The `<head>` is the only valid place for `<link>` to exist within the DOM, yet it’s convenient and keeps things composable if a component representing a specific page can render `<link>` components itself.
83
83
84
84
There are a few exceptions to this:
85
85
@@ -91,7 +91,7 @@ There are a few exceptions to this:
91
91
92
92
In addition, if the `<link>` is to a stylesheet (namely, it has `rel="stylesheet"` in its props), React treats it specially in the following ways:
93
93
94
-
* The component that renders `<link>` will [suspend](http://localhost:3000/reference/react/Suspense) while the stylesheet is loading.
94
+
* The component that renders `<link>` will [suspend](/reference/react/Suspense) while the stylesheet is loading.
95
95
* If multiple components render links to the same stylesheet, React will de-duplicate them and only put a single link into the DOM. Two links are considered the same if they have the same `href` prop.
96
96
97
97
There are two exception to this special behavior:
@@ -133,7 +133,7 @@ export default function BlogPage() {
133
133
134
134
### Linking to a stylesheet {/*linking-to-a-stylesheet*/}
135
135
136
-
If a component depends on a certain stylesheet in order to be displayed correctly, you can render a link to that stylesheet within the component. Your component will [suspend](http://localhost:3000/reference/react/Suspense) while the stylesheet is loading. You must supply the `precedence` prop, which tells React where to place this stylesheet relative to others — stylesheets with higher precedence can override those with lower precedence.
136
+
If a component depends on a certain stylesheet in order to be displayed correctly, you can render a link to that stylesheet within the component. Your component will [suspend](/reference/react/Suspense) while the stylesheet is loading. You must supply the `precedence` prop, which tells React where to place this stylesheet relative to others — stylesheets with higher precedence can override those with lower precedence.
137
137
138
138
<Note>
139
139
When you want to use a stylesheet, it can be beneficial to call the [preinit](/reference/react-dom/preinit) function. Calling this function may allow the browser to start fetching the stylesheet earlier than if you just render a `<link>` component, for example by sending an [HTTP Early Hints response](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/103).
@@ -217,7 +217,7 @@ function Component() {
217
217
218
218
### Annotating specific items within the document with links {/*annotating-specific-items-within-the-document-with-links*/}
219
219
220
-
You can use the `<link>` component with the `itemProp` prop to annotate specific items within the document with links to related resources. In this case, React will *not* place these annotations within the document `<head>` but will place them like any other React component.
220
+
You can use the `<link>` component with the `itemProp` prop to annotate specific items within the document with links to related resources. In this case, React will *not* place these annotations within the document `<head>` but will place them like any other React component.
Copy file name to clipboardexpand all lines: src/content/reference/react-dom/components/style.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -52,7 +52,7 @@ Props that are **not recommended** for use with React:
52
52
53
53
#### Special rendering behavior {/*special-rendering-behavior*/}
54
54
55
-
React can move `<style>` components to the document's `<head>`, de-duplicate identical stylesheets, and [suspend](http://localhost:3000/reference/react/Suspense) while the stylesheet is loading.
55
+
React can move `<style>` components to the document's `<head>`, de-duplicate identical stylesheets, and [suspend](/reference/react/Suspense) while the stylesheet is loading.
56
56
57
57
To opt into this behavior, provide the `href` and `precedence` props. React will de-duplicate styles if they have the same `href`. The precedence prop tells React where to rank the `<style>` DOM node relative to others in the document `<head>`, which determines which stylesheet can override the other.
Copy file name to clipboardexpand all lines: src/content/reference/react/index.md
+8
Original file line number
Diff line number
Diff line change
@@ -29,6 +29,14 @@ React-dom contains features that are only supported for web applications (which
29
29
*[Client APIs](/reference/react-dom/client) - The `react-dom/client` APIs let you render React components on the client (in the browser).
30
30
*[Server APIs](/reference/react-dom/server) - The `react-dom/server` APIs let you render React components to HTML on the server.
31
31
32
+
## Rules of React {/*rules-of-react*/}
33
+
34
+
React has idioms — or rules — for how to express patterns in a way that is easy to understand and yields high-quality applications:
35
+
36
+
*[Components and Hooks must be pure](/reference/rules/components-and-hooks-must-be-pure) – Purity makes your code easier to understand, debug, and allows React to automatically optimize your components and hooks correctly.
37
+
*[React calls Components and Hooks](/reference/rules/react-calls-components-and-hooks) – React is responsible for rendering components and hooks when necessary to optimize the user experience.
38
+
*[Rules of Hooks](/reference/rules/rules-of-hooks) – Hooks are defined using JavaScript functions, but they represent a special type of reusable UI logic with restrictions on where they can be called.
39
+
32
40
## Legacy APIs {/*legacy-apis*/}
33
41
34
42
*[Legacy APIs](/reference/react/legacy) - Exported from the `react` package, but not recommended for use in newly written code.
0 commit comments