Skip to content

Commit 111911b

Browse files
committed
fix(reference): align Fragment blockers with upstream rendering
Signed-off-by: Alessandro De Blasis <alex@deblasis.net>
1 parent fa5c343 commit 111911b

1 file changed

Lines changed: 12 additions & 12 deletions

File tree

src/content/reference/react/Fragment.md

Lines changed: 12 additions & 12 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 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.
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.
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 focusabile nel Fragment. Cerca i figli annidati in profondità (depth-first), poi itera in ordine inverso.
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.
146146

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

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

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.
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.
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 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`.
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`.
273273

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

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

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

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.
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.
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
---
@@ -349,7 +349,7 @@ function PostBody({ body }) {
349349

350350
<DeepDive>
351351

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

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

@@ -531,9 +531,9 @@ La chiamata `addEventListener` applica il listener a ogni figlio DOM di primo li
531531
532532
<DeepDive>
533533
534-
#### Which children does a Fragment ref target? {/*which-children-does-a-fragment-ref-target*/}
534+
#### Su quali figli agisce un ref di Fragment? {/*which-children-does-a-fragment-ref-target*/}
535535
536-
Un `FragmentInstance` targetta i **figli host (DOM) di primo livello** del Fragment. Considera questo albero:
536+
Un `FragmentInstance` opera sui **figli host (DOM) di primo livello** del Fragment. Considera questo albero:
537537
538538
```js
539539
<Fragment ref={ref}>
@@ -547,7 +547,7 @@ Un `FragmentInstance` targetta i **figli host (DOM) di primo livello** del Fragm
547547
</Fragment>
548548
```
549549
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`.
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`.
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

0 commit comments

Comments
 (0)