Skip to content

Commit 97f8be0

Browse files
deblasiscursoragent
andcommitted
translate(reference): Fragment
Signed-off-by: Alessandro De Blasis <alex@deblasis.net> Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent ac5df62 commit 97f8be0

1 file changed

Lines changed: 21 additions & 21 deletions

File tree

‎src/content/reference/react/Fragment.md‎

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -124,7 +124,7 @@ fragmentRef.current.dispatchEvent(new Event('custom', { bubbles: true }));
124124

125125
#### `focus(options?)` {/*focus*/}
126126

127-
Imposta il focus sul primo nodo DOM che può ricevere il focus nel Fragment. A differenza di chiamare `element.focus()` su un elemento DOM, questo metodo cerca *tutti* i figli annidati in profondità (depth-first) finché non trova un elemento che può ricevere il focus — non solo l'elemento stesso o i suoi figli diretti.
127+
Imposta il focus sul primo nodo DOM focusabile nel Fragment. A differenza di chiamare `element.focus()` su un elemento DOM, questo metodo cerca *tutti* i figli annidati in profondità (depth-first) finché non trova un elemento focusabile — non solo l'elemento stesso o i suoi figli diretti.
128128

129129
```js
130130
fragmentRef.current.focus();
@@ -142,7 +142,7 @@ fragmentRef.current.focus();
142142

143143
#### `focusLast(options?)` {/*focuslast*/}
144144

145-
Imposta il focus sull'ultimo nodo DOM che può ricevere il focus nel Fragment. Cerca i figli annidati in profondità (depth-first), poi itera in ordine inverso.
145+
Imposta il focus sull'ultimo nodo DOM focusabile nel Fragment. Cerca i figli annidati in profondità (depth-first), poi itera in ordine inverso.
146146

147147
```js
148148
fragmentRef.current.focusLast();
@@ -211,7 +211,7 @@ fragmentRef.current.unobserveUsing(observer);
211211

212212
#### `getClientRects()` {/*getclientrects*/}
213213

214-
Restituisce un array piatto di oggetti [`DOMRect`](https://developer.mozilla.org/it/docs/Web/API/DOMRect) che rappresentano i rettangoli di delimitazione di tutti i figli DOM di primo livello.
214+
Restituisce un array flat di oggetti [`DOMRect`](https://developer.mozilla.org/it/docs/Web/API/DOMRect) che rappresentano i rettangoli di delimitazione di tutti i figli DOM di primo livello.
215215

216216
```js
217217
const rects = fragmentRef.current.getClientRects();
@@ -269,7 +269,7 @@ fragmentRef.current.scrollIntoView();
269269

270270
##### Parameters {/*scrollintoview-parameters*/}
271271

272-
* **optional** `alignToTop`: Un booleano. Se `true` *(il valore predefinito)*, scorre il primo figlio in alto nell'area scrollabile. Se `false`, scorre l'ultimo figlio in basso. A differenza di [`Element.scrollIntoView()`](https://developer.mozilla.org/it/docs/Web/API/Element/scrollIntoView), questo metodo non accetta un oggetto `ScrollIntoViewOptions`.
272+
* **optional** `alignToTop`: Un booleano. Se `true` (il default), scorre il primo figlio in alto nell'area scrollabile. Se `false`, scorre l'ultimo figlio in basso. A differenza di [`Element.scrollIntoView()`](https://developer.mozilla.org/it/docs/Web/API/Element/scrollIntoView), questo metodo non accetta un oggetto `ScrollIntoViewOptions`.
273273

274274
##### Returns {/*scrollintoview-returns*/}
275275

@@ -284,17 +284,17 @@ fragmentRef.current.scrollIntoView();
284284

285285
#### `FragmentInstance` Caveats {/*fragmentinstance-caveats*/}
286286

287-
* I metodi che operano sui figli (come `addEventListener`, `observeUsing` e `getClientRects`) operano sui *figli host (DOM) di primo livello* del Fragment. Non agiscono direttamente sui figli annidati all'interno di un altro elemento DOM.
288-
* `focus` e `focusLast` cercano i figli annidati in profondità (depth-first) per trovare elementi che possono ricevere il focus, a differenza dei metodi per eventi e observer che operano solo sui figli host di primo livello.
289-
* `observeUsing` non funziona sui nodi di testo. React registra un warning in sviluppo se il Fragment contiene solo figli di testo.
290-
* React non applica i listener di eventi aggiunti tramite `addEventListener` agli alberi [`<Activity>`](/reference/react/Activity) nascosti. Quando un boundary `Activity` passa da nascosto a visibile, i listener vengono applicati automaticamente.
287+
* I metodi che targettano i figli (come `addEventListener`, `observeUsing` e `getClientRects`) operano sui *figli host (DOM) di primo livello* del Fragment. Non targettano direttamente i figli annidati all'interno di un altro elemento DOM.
288+
* `focus` e `focusLast` cercano i figli annidati in profondità (depth-first) per trovare elementi focusabili, a differenza dei metodi per eventi e observer che targettano solo i figli host di primo livello.
289+
* `observeUsing` non funziona sui nodi di testo. React registra un warning in development se il Fragment contiene solo figli di testo.
290+
* React non applica i listener di eventi aggiunti tramite `addEventListener` agli alberi [`<Activity>`](/reference/react/Activity) nascosti. Quando un confine `Activity` passa da nascosto a visibile, i listener vengono applicati automaticamente.
291291
* Ogni figlio DOM di primo livello di un Fragment con un `ref` ottiene una proprietà `reactFragments` — un `Set<FragmentInstance>` contenente tutte le istanze Fragment che possiedono l'elemento. Questo consente di [memorizzare nella cache un observer condiviso](#caching-global-intersection-observer) tra più Fragment.
292292

293293
---
294294

295295
## Usage {/*usage*/}
296296

297-
### Restituire più elementi {/*returning-multiple-elements*/}
297+
### Returning multiple elements {/*returning-multiple-elements*/}
298298

299299
Usa `Fragment`, o l'equivalente sintassi `<>...</>`, per raggruppare più elementi insieme. Puoi usarlo per mettere più elementi in qualsiasi punto in cui può andare un singolo elemento. Ad esempio, un componente può restituire solo un elemento, ma usando un Fragment puoi raggruppare più elementi e restituirli come gruppo:
300300

@@ -349,7 +349,7 @@ function PostBody({ body }) {
349349

350350
<DeepDive>
351351

352-
#### Come scrivere un Fragment senza la sintassi speciale? {/*how-to-write-a-fragment-without-the-special-syntax*/}
352+
#### How to write a Fragment without the special syntax? {/*how-to-write-a-fragment-without-the-special-syntax*/}
353353

354354
L'esempio sopra è equivalente a importare `Fragment` da React:
355355

@@ -372,7 +372,7 @@ Di solito non ne avrai bisogno a meno che tu non debba [passare una `key` al tuo
372372

373373
---
374374

375-
### Assegnare più elementi a una variabile {/*assigning-multiple-elements-to-a-variable*/}
375+
### Assigning multiple elements to a variable {/*assigning-multiple-elements-to-a-variable*/}
376376

377377
Come qualsiasi altro elemento, puoi assegnare elementi Fragment a variabili, passarli come props e così via:
378378

@@ -394,7 +394,7 @@ function CloseDialog() {
394394
395395
---
396396
397-
### Raggruppare elementi con del testo {/*grouping-elements-with-text*/}
397+
### Grouping elements with text {/*grouping-elements-with-text*/}
398398
399399
Puoi usare `Fragment` per raggruppare testo insieme a componenti:
400400
@@ -413,7 +413,7 @@ function DateRangePicker({ start, end }) {
413413
414414
---
415415
416-
### Renderizzare un elenco di Fragment {/*rendering-a-list-of-fragments*/}
416+
### Rendering a list of Fragments {/*rendering-a-list-of-fragments*/}
417417
418418
Ecco una situazione in cui devi scrivere `Fragment` esplicitamente invece di usare la sintassi `<></>`. Quando [renderizzi più elementi in un loop](/learn/rendering-lists), devi assegnare una `key` a ogni elemento. Se gli elementi all'interno del loop sono Fragment, devi usare la normale sintassi degli elementi JSX per fornire l'attributo `key`:
419419
@@ -466,7 +466,7 @@ function PostBody({ body }) {
466466
467467
---
468468
469-
### Aggiungere listener di eventi senza un elemento wrapper {/*adding-event-listeners-without-wrapper*/}
469+
### Adding event listeners without a wrapper element {/*adding-event-listeners-without-wrapper*/}
470470
471471
I ref dei Fragment ti permettono di aggiungere listener di eventi a un gruppo di elementi senza aggiungere un nodo DOM wrapper. Usa una [ref callback](/reference/react-dom/components/common#ref-callback) per collegare e ripulire i listener:
472472
@@ -531,9 +531,9 @@ La chiamata `addEventListener` applica il listener a ogni figlio DOM di primo li
531531
532532
<DeepDive>
533533
534-
#### Su quali figli agisce un ref di Fragment? {/*which-children-does-a-fragment-ref-target*/}
534+
#### Which children does a Fragment ref target? {/*which-children-does-a-fragment-ref-target*/}
535535
536-
Un `FragmentInstance` opera sui **figli host (DOM) di primo livello** del Fragment. Considera questo albero:
536+
Un `FragmentInstance` targetta i **figli host (DOM) di primo livello** del Fragment. Considera questo albero:
537537
538538
```js
539539
<Fragment ref={ref}>
@@ -547,15 +547,15 @@ Un `FragmentInstance` opera sui **figli host (DOM) di primo livello** del Fragme
547547
</Fragment>
548548
```
549549
550-
`Wrapper` è un componente React, quindi il `FragmentInstance` lo attraversa per trovare i nodi DOM. I figli interessati sono `A`, `B` e `D`. `C` non è interessato perché è annidato all'interno dell'elemento DOM `B`.
550+
`Wrapper` è un componente React, quindi il `FragmentInstance` lo attraversa per trovare i nodi DOM. I figli targettati sono `A`, `B` e `D`. `C` non è targettato perché è annidato all'interno dell'elemento DOM `B`.
551551
552552
Metodi come `addEventListener`, `observeUsing` e `getClientRects` operano su questi figli DOM di primo livello. `focus` e `focusLast` sono diversi — cercano *tutti* i figli annidati in profondità (depth-first) per trovare elementi focusabili.
553553
554554
</DeepDive>
555555
556556
---
557557
558-
### Gestire il focus su un gruppo di elementi {/*managing-focus-across-elements*/}
558+
### Managing focus across a group of elements {/*managing-focus-across-elements*/}
559559
560560
I ref dei Fragment forniscono i metodi `focus`, `focusLast` e `blur` che operano su tutti i nodi DOM all'interno del Fragment:
561561
@@ -640,7 +640,7 @@ Chiamare `focus()` imposta il focus sull'input `street` — anche se è annidato
640640
641641
---
642642
643-
### Scorrere un gruppo di elementi nella vista {/*scrolling-group-into-view*/}
643+
### Scrolling a group of elements into view {/*scrolling-group-into-view*/}
644644
645645
Usa `scrollIntoView` per scorrere i figli di un Fragment nella vista senza un elemento wrapper. Passa `true` (o ometti l'argomento) per scorrere il primo figlio in alto. Passa `false` per scorrere l'ultimo figlio in basso:
646646
@@ -734,7 +734,7 @@ p {
734734
735735
---
736736
737-
### Osservare la visibilità senza un elemento wrapper {/*observing-visibility-without-wrapper*/}
737+
### Observing visibility without a wrapper element {/*observing-visibility-without-wrapper*/}
738738
739739
Usa `observeUsing` per collegare un `IntersectionObserver` a tutti i figli DOM di primo livello di un Fragment. Questo ti permette di tracciare la visibilità senza richiedere ai componenti figli di esporre ref o aggiungere un elemento wrapper:
740740
@@ -846,7 +846,7 @@ export default function Card({ title }) {
846846
847847
---
848848
849-
### Memorizzare nella cache un IntersectionObserver globale {/*caching-global-intersection-observer*/}
849+
### Caching a global IntersectionObserver {/*caching-global-intersection-observer*/}
850850
851851
Un'ottimizzazione delle performance comune per siti con molti observer è condividere un singolo `IntersectionObserver` per configurazione e instradare le sue entry ai callback corretti in base a quale elemento ha intersecato. I ref dei Fragment supportano lo stesso pattern tramite la proprietà `reactFragments`.
852852

0 commit comments

Comments
 (0)