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
*`render`: The render function for your component. React calls this function with the props and `ref` that your component received from its parent. The JSX you return will be the output of your component.
37
+
*`render`: Komponenttisi renderöintifunktio. React kutsuu tätä funktiota komponentin pääkomponentilta saamilla propseilla ja `ref`:lla. JSX, jonka palautat, on komponenttisi ulostulo.
38
38
39
-
#### Returns {/*returns*/}
39
+
#### Palautukset {/*returns*/}
40
40
41
-
`forwardRef`returns a React component that you can render in JSX. Unlike React components defined as plain functions, a component returned by `forwardRef` is also able to receive a `ref`prop.
41
+
`forwardRef`palauttaa React-komponentin, jonka voit renderöidä JSX:llä. Toisin kuin React-komponentit, jotka on määritelty tavallisina funktioina, `forwardRef`:n palauttama komponentti voi myös vastaanottaa `ref`propin.
42
42
43
-
#### Caveats {/*caveats*/}
43
+
#### Huomiot {/*caveats*/}
44
44
45
-
*In Strict Mode, React will **call your render function twice**in order to [help you find accidental impurities.](#my-initializer-or-updater-function-runs-twice) This is development-only behavior and does not affect production. If your render function is pure (as it should be), this should not affect the logic of your component. The result from one of the calls will be ignored.
45
+
* Strict Modessa, React **kutsuu renderöintifunktiotasi kahdesti**auttaakseen sinua löytämään tahattomia epäpuhtauksia. Tämä on vain kehitystilassa tapahtuva käyttäytyminen, eikä vaikuta tuotantoon. Jos renderöintifunktiosi on puhdas (kuten sen pitäisi olla), tämä ei vaikuta komponenttisi logiikkaan. Toinen kutsuista jätetään huomiotta.
46
46
47
47
48
48
---
49
49
50
-
### `render`function {/*render-function*/}
50
+
### `render`funktio {/*render-function*/}
51
51
52
-
`forwardRef`accepts a render function as an argument. React calls this function with `props`and`ref`:
52
+
`forwardRef`hyväksyy renderöintifunktion argumenttina. React kutsuu tätä funktiota `props`ja`ref` -argumenteilla:
*`props`: The props passed by the parent component.
67
+
*`props`: Propsit, jotka pääkomponentti on välittänyt.
68
68
69
-
*`ref`: The `ref`attribute passed by the parent component. The `ref`can be an object or a function. If the parent component has not passed a ref, it will be `null`. You should either pass the`ref`you receive to another component, or pass it to [`useImperativeHandle`.](/reference/react/useImperativeHandle)
69
+
*`ref`: `ref`attribuutti, jonka pääkomponentti on välittänyt. `ref`voi olla joko objekti tai funktio. Jos pääkomponentti ei ole välittänyt ref:iä, se on `null`. Sinun tulisi joko välittää saamasi`ref`toiselle komponentille tai välittää se [`useImperativeHandle`:lle.](/reference/react/useImperativeHandle)
70
70
71
-
#### Returns {/*render-returns*/}
71
+
#### Palautukset {/*render-returns*/}
72
72
73
-
`forwardRef`returns a React component that you can render in JSX. Unlike React components defined as plain functions, the component returned by `forwardRef` is able to take a`ref`prop.
73
+
`forwardRef`palauttaa React komponentin, jonka voit renderöidä JSX:llä. Toisin kuin React komponentit, jotka on määritelty tavallisina funktioina, `forwardRef`:n palauttama komponentti voi myös vastaanottaa`ref`propin.
74
74
75
75
---
76
76
77
-
## Usage {/*usage*/}
77
+
## Käyttö {/*usage*/}
78
78
79
-
### Exposing a DOM node to the parent component {/*exposing-a-dom-node-to-the-parent-component*/}
79
+
### DOM noodin välittäminen pääkomponentille {/*exposing-a-dom-node-to-the-parent-component*/}
80
80
81
-
By default, each component's DOM nodes are private. However, sometimes it's useful to expose a DOM node to the parent--for example, to allow focusing it. To opt in, wrap your component definition into `forwardRef()`:
81
+
Oletuksena jokaisen komponentin DOM noodit ovat yksityisiä. Joskus on kuitenkin hyödyllistä välittää DOM noodi pääkomponentille, esimerkiksi mahdollistaaksesi siihen kohdentamisen. Ottaaksesi tämän käyttöön, kääri komponenttisi `forwardRef()` -funktioon:
This `Form`component [passes a ref](/reference/react/useRef#manipulating-the-dom-with-a-ref)to `MyInput`. The `MyInput`component *forwards* that ref to the `<input>`browser tag. As a result, the `Form`component can access that `<input>` DOM node and call[`focus()`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus)on it.
134
+
`Form`komponentti [välittää ref:n](/reference/react/useRef#manipulating-the-dom-with-a-ref)`MyInput`:lle. `MyInput`komponentti *välittää* sen ref:n`<input>`selaimen tagille. Tämän seurauksena `Form`komponentti voi käyttää `<input>` DOM noodia ja kutsua[`focus()`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus)siihen.
135
135
136
-
Keep in mind that exposing a ref to the DOM node inside your component makes it harder to change your component's internals later. You will typically expose DOM nodes from reusable low-level components like buttons or text inputs, but you won't do it for application-level components like an avatar or a comment.
136
+
Pidä mielessä, että ref:n julkaiseminen komponenttisi sisällä olevaan DOM noodin tekee sen vaikeammaksi muuttaa komponenttisi sisäistä rakennetta myöhemmin. Yleensä julkaiset DOM noodin ref:n uudelleen käytettävistä matalan tason komponenteista, kuten painikkeista tai tekstisyötteistä, mutta et tee sitä sovellustason komponenteille, kuten avatarille tai kommentille.
137
137
138
138
<Recipestitle="Examples of forwarding a ref">
139
139
140
-
#### Focusing a text input {/*focusing-a-text-input*/}
Clicking the button will focus the input. The `Form`component defines a ref and passes it to the `MyInput`component. The `MyInput`component forwards that ref to the browser `<input>`. This lets the `Form`component focus the`<input>`.
142
+
Painiketta painaminen kohdistaa syöttökenttään. `Form`komponentti määrittelee ref:n ja välittää sen `MyInput`komponentille. `MyInput`komponentti välittää sen ref:n selaimen `<input>` tagille. Tämän avulla `Form`komponentti voi kohdistaa`<input>`:in.
143
143
144
144
<Sandpack>
145
145
@@ -191,9 +191,9 @@ input {
191
191
192
192
<Solution />
193
193
194
-
#### Playing and pausing a video {/*playing-and-pausing-a-video*/}
194
+
#### Videon toistaminen ja tauottaminen {/*playing-and-pausing-a-video*/}
195
195
196
-
Clicking the button will call [`play()`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/play)and[`pause()`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/pause)on a `<video>` DOM node. The `App`component defines a ref and passes it to the `MyVideoPlayer`component. The `MyVideoPlayer`component forwards that ref to the browser `<video>`node. This lets the `App`component play and pause the`<video>`.
196
+
Painikkeen painaminen kutsuu `<video>` DOM noodin [`play()`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/play)ja[`pause()`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/pause)metodeja. `App`komponentti määrittää ref:n ja välittää sen `MyVideoPlayer`komponentille. `MyVideoPlayer`komponentti välittää tuon ref:n selaimen `<video>`tagille. Tämän avulla `App`komponentti voi toistaa ja tauottaa`<video>`:n.
197
197
198
198
<Sandpack>
199
199
@@ -206,10 +206,10 @@ export default function App() {
If that`MyInput`component forwards a ref to its `<input>`, a ref to `FormField` will give you that `<input>`:
271
+
Jos tämä`MyInput`komponentti välittää ref:n`<input>`:lle, ref `FormField`:lle antaa sinulle tuon `<input>`:in:
272
272
273
273
```js {2,5,10}
274
274
functionForm() {
@@ -289,7 +289,7 @@ function Form() {
289
289
}
290
290
```
291
291
292
-
The `Form`component defines a ref and passes it to `FormField`. The `FormField`component forwards that ref to `MyInput`, which forwards it to a browser `<input>` DOM node. This is how `Form`accesses that DOM node.
292
+
`Form`komponentti määrittää refin ja välittää sen `FormField`:lle. `FormField`komponentti välittää tuon ref:n`MyInput`:lle, joka välittää sen selaimen `<input>` DOM noodille. Tämän avulla `Form`komponentti voi käsitellä tuota DOM noodia.
293
293
294
294
295
295
<Sandpack>
@@ -367,9 +367,9 @@ input, button {
367
367
368
368
---
369
369
370
-
### Exposing an imperative handle instead of a DOM node {/*exposing-an-imperative-handle-instead-of-a-dom-node*/}
370
+
### Imperatiivisen käsittelijän julkaiseminen DOM noden sijaan {/*exposing-an-imperative-handle-instead-of-a-dom-node*/}
371
371
372
-
Instead of exposing an entire DOM node, you can expose a custom object, called an *imperative handle,* with a more constrained set of methods. To do this, you'd need to define a separate ref to hold the DOM node:
372
+
Sen sijaan, että julkistaisit koko DOM noodin, voit julkistaa räätälöidyn olion, jota kutsutaan *imperatiiviseksi käsittelijäksi*, jolla on suppeampi joukko metodeja. Tämän toteuttamiseksi, sinun täytyy määrittää erillinen ref, joka pitää sisällään DOM noodin:
If some component gets a ref to `MyInput`, it will only receive your `{ focus, scrollIntoView }`object instead of the DOM node. This lets you limit the information you expose about your DOM node to the minimum.
407
+
Jos jokin komponentti saa refin `MyInput`:lle, saa se vain `{ focus, scrollIntoView }`olion koko DOM noodin sijaan. Tämän avulla voit rajoittaa DOM noodista julkistettavan informaation minimiin.
408
408
409
409
<Sandpack>
410
410
@@ -417,7 +417,7 @@ export default function Form() {
417
417
418
418
functionhandleClick() {
419
419
ref.current.focus();
420
-
//This won't work because the DOM node isn't exposed:
420
+
//Tämä ei toimi, koska DOM noodi ei ole julkistettu:
421
421
// ref.current.style.opacity = 0.5;
422
422
}
423
423
@@ -463,25 +463,25 @@ input {
463
463
464
464
</Sandpack>
465
465
466
-
[Read more about using imperative handles.](/reference/react/useImperativeHandle)
466
+
[Lue lisää imperatiivisista käsittelijöistä.](/reference/react/useImperativeHandle)
467
467
468
468
<Pitfall>
469
469
470
-
**Do not overuse refs.**You should only use refs for *imperative* behaviors that you can't express as props: for example, scrolling to a node, focusing a node, triggering an animation, selecting text, and so on.
470
+
**Älä käytä ref:iä liikaa.**Sinun tulisi käyttää ref:iä vain *imperatiivisiin* toimintoihin, joita et voi ilmaista propseina: esimerkiksi nodeen vierittäminen, noden kohdistaminen, animaation käynnistäminen, tekstin valitseminen jne.
471
471
472
-
**If you can express something as a prop, you should not use a ref.**For example, instead of exposing an imperative handle like`{ open, close }` from a `Modal` component, it is better to take `isOpen`as a prop like `<Modal isOpen={isOpen} />`. [Effects](/learn/synchronizing-with-effects)can help you expose imperative behaviors via props.
472
+
**Jos voit ilmaista jotain propseina, sinun ei tulisi käyttää ref:iä.**Esimerkiksi sen sijaan, että julkistaisit `Modal` komponentista *imperatiivisen käsittelijän* kuten`{ open, close }`, on parempi ottaa `isOpen`propsi kuten `<Modal isOpen={isOpen} />`. [Effectit](/learn/synchronizing-with-effects)voivat auttaa sinua julkistamaan imperatiivisia toimintoja propseina.
473
473
474
474
</Pitfall>
475
475
476
476
---
477
477
478
-
## Troubleshooting {/*troubleshooting*/}
478
+
## Vianmääritys {/*troubleshooting*/}
479
479
480
-
### My component is wrapped in `forwardRef`, but the `ref`to it is always`null` {/*my-component-is-wrapped-in-forwardref-but-the-ref-to-it-is-always-null*/}
480
+
### Komponenttini on kääritty `forwardRef`:iin, mutta `ref`siihen on aina`null` {/*my-component-is-wrapped-in-forwardref-but-the-ref-to-it-is-always-null*/}
481
481
482
-
This usually means that you forgot to actually use the `ref` that you received.
482
+
Usein tämä tarkoittaa, että unohdit käyttää `ref`:iä, jonka sait.
483
483
484
-
For example, this component doesn't do anything with its `ref`:
484
+
Esimerkiksi, tämä komponentti ei tee mitään sen `ref`:llä:
If`showInput`is`false`, then the ref won't be forwarded to any node, and a ref to `MyInput` will remain empty. This is particularly easy to miss if the condition is hidden inside another component, like`Panel`in this example:
523
+
Jos`showInput`on`false`, ref:iä ei välitetä millekään nodille, ja ref `MyInput`:lle pysyy tyhjänä. Tämä on erityisen helppo jättää huomaamatta, jos ehto on piilotettu toisen komponentin sisälle, kuten`Panel`tässä esimerkissä:
0 commit comments