IT docs translation

website/i18n/it/docusaurus-plugin-content-docs/current.json

@@ -3,6 +3,26 @@
     "message": "Prossimo",
     "description": "The label for version current"
   },
+  "sidebar.Sidebar.category.Introduction": {
+    "message": "Introduzione",
+    "description": "The label for category Introduction in sidebar Sidebar"
+  },
+  "sidebar.Sidebar.category.Riverpod for Provider Users": {
+    "message": "Riverpod per utenti di Provider",
+    "description": "The label for category Riverpod for Providers Users in sidebar Sidebar"
+  },
+  "sidebar.Sidebar.category.Essentials": {
+    "message": "Fondamentali",
+    "description": "The label for category Essentials in sidebar Sidebar"
+  },
+  "sidebar.Sidebar.category.Case studies": {
+    "message": "Argomenti di studio",
+    "description": "The label for category Case studies in sidebar Sidebar"
+  },
+  "sidebar.Sidebar.category.Advanced topics": {
+    "message": "Argomenti avanzati",
+    "description": "The label for category Case studies in sidebar Advanced topics"
+  },
   "sidebar.Sidebar.category.Guides": {
     "message": "Guide",
     "description": "The label for category Guides in sidebar Sidebar"

website/i18n/it/docusaurus-plugin-content-docs/current/advanced/select.mdx

@@ -0,0 +1,65 @@
+---
+title: Ottimizzare le performance
+---
+
+import { AutoSnippet } from "../../../../../src/components/CodeSnippet";
+import select from "./select/select";
+
+import selectAsync from "./select/select_async";
+
+Con tutto ciò che abbiamo visto fino ad ora, possiamo già costruire un'applicazione 
+completamente funzionante. Tuttavia, potresti avere delle domande riguardo alle performance.
+
+In questa pagina copriremo alcuni consigli e trucchi per ottimizzare possibilmente il tuo codice.
+
+:::caution
+Prima di fare qualsiasi ottimizzazione, assicurati di misurare le prestazioni della tua applicazione. 
+Potrebbe non essere conveniente affrontare la complessità delle ottimizzazioni se i benefici ottenuti sono limitati.
+:::
+
+## Filtrare i rebuild dei widget/provider usando "select".
+
+Avrai notato che, di default, usare `ref.watch` provoca la ricostruzione 
+dei consumer/provider ogni volta che _qualsiasi_ delle proprietà di un oggetto cambia.
+Per fare un esempio, osservare un oggetto `User` ed usare solo la sua proprietà "name" 
+causerà la ricostruzione del consumer anche se è solo la proprietà "age" a cambiare.
+
+Ma nel caso tu abbia un consumer che usa solo un subset di proprietà, vuoi 
+evitare di ricostruire il widget quando altre proprietà cambiano.
+
+Questo comportamento può essere ottenuto usando la funzionalità `select` dei provider.
+Quando lo si usa, `ref.watch` non restituirà più l'oggetto completo ma le proprietà selezionate.
+Ora i tuoi consumer/provider si ricostruiranno solo se quelle proprietà selezionate cambieranno.
+
+<AutoSnippet {...select} />
+
+:::info
+È possibile chiamare `select` quante volte si desidera.
+Sei libero di chiamarlo una volta per la proprietà che desideri.
+:::
+
+:::caution
+Si prevede che le proprietà selezionate siano immutabili.
+Restituire una `List` per poi mutarla non azionerà un rebuild.
+:::
+
+:::caution
+Usare `select` rallenta leggermente le singole operazioni di lettura ed 
+aumenterà di poco la complessità del tuo codice.
+Potrebbe non valere la pena usarlo se quelle "altre proprietà" cambiano raramente.
+:::
+
+### Selezionare proprietà asincrone
+
+Nel caso tu stia provando ad ottimizzare un provider che ascolta un altro provider, 
+potrebbe capitare che l'altro provider sia asincrono.
+
+Normalmente, useresti `ref.watch(anotherProvider.future)` per ottenere il valore.
+Il problema è che, `select` si applicherà solo su `AsyncValue`, il quale non è qualcosa 
+che puoi aspettare.
+
+A questo scopo è possibile utilizzare invece `selectAsync`. È unicamente per il 
+codice asincrono e permette di eseguire un'operazione `select` sul dato emesso da un provider.
+Il suo utilizzo è simile a quello di `select` ma restituisce un `Future`:
+
+<AutoSnippet {...selectAsync} />

website/i18n/it/docusaurus-plugin-content-docs/current/advanced/select/select/codegen.dart

@@ -0,0 +1,30 @@
+// ignore_for_file: unused_local_variable, avoid_multiple_declarations_per_line, omit_local_variable_types, prefer_final_locals, use_key_in_widget_constructors
+
+import 'package:flutter/widgets.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+
+part 'codegen.g.dart';
+
+/* SNIPPET START */
+class User {
+  late String firstName, lastName;
+}
+
+@riverpod
+User example(ExampleRef ref) => User()
+  ..firstName = 'John'
+  ..lastName = 'Doe';
+
+class ConsumerExample extends ConsumerWidget {
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    // Invece di scrivere:
+    // String name = ref.watch(provider).firstName!;
+    // Possiamo scrivere:
+    String name = ref.watch(exampleProvider.select((it) => it.firstName));
+    // In questo modo il widget ascolterà solo i cambiamenti della proprietà "firstName".
+
+    return Text('Hello $name');
+  }
+}

website/i18n/it/docusaurus-plugin-content-docs/current/advanced/select/select/index.ts

@@ -0,0 +1,4 @@
+import raw from '!!raw-loader!./raw.dart';
+import codegen from '!!raw-loader!./codegen.dart';
+
+export default { raw, codegen };

website/i18n/it/docusaurus-plugin-content-docs/current/advanced/select/select/raw.dart

@@ -0,0 +1,29 @@
+// ignore_for_file: unused_local_variable, avoid_multiple_declarations_per_line, omit_local_variable_types, prefer_final_locals, use_key_in_widget_constructors
+
+import 'package:flutter/widgets.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+
+/* SNIPPET START */
+class User {
+  late String firstName, lastName;
+}
+
+final provider = Provider(
+  (ref) => User()
+    ..firstName = 'John'
+    ..lastName = 'Doe',
+);
+
+class ConsumerExample extends ConsumerWidget {
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    // Invece di scrivere:
+    // String name = ref.watch(provider).firstName!;
+    // Possiamo scrivere:
+    String name = ref.watch(provider.select((it) => it.firstName));
+    // In questo modo il widget ascolterà solo i cambiamenti della proprietà "firstName".
+
+    return Text('Hello $name');
+  }
+}
+/* SNIPPET END */

website/i18n/it/docusaurus-plugin-content-docs/current/advanced/select/select_async/codegen.dart

@@ -0,0 +1,26 @@
+// ignore_for_file: unused_local_variable, avoid_multiple_declarations_per_line, omit_local_variable_types, prefer_final_locals, use_key_in_widget_constructors, body_might_complete_normally_nullable
+
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+
+part 'codegen.g.dart';
+
+class User {
+  late String firstName, lastName;
+}
+
+final userProvider = FutureProvider(
+  (ref) => User()
+    ..firstName = 'John'
+    ..lastName = 'Doe',
+);
+/* SNIPPET START */
+@riverpod
+Object? example(ExampleRef ref) async {
+  // Aspetta che un utente sia disponibile, ed ascolta solo la proprietà "firstName"
+  final firstName = await ref.watch(
+    userProvider.selectAsync((it) => it.firstName),
+  );
+
+  // TODO usa "firstName" per ottenere qualcos'altro
+}
+/* SNIPPET END */

website/i18n/it/docusaurus-plugin-content-docs/current/advanced/select/select_async/index.ts

@@ -0,0 +1,4 @@
+import raw from '!!raw-loader!./raw.dart';
+import codegen from '!!raw-loader!./codegen.dart';
+
+export default { raw, codegen };

website/i18n/it/docusaurus-plugin-content-docs/current/advanced/select/select_async/raw.dart

@@ -0,0 +1,23 @@
+// ignore_for_file: unused_local_variable, avoid_multiple_declarations_per_line, omit_local_variable_types, prefer_final_locals, use_key_in_widget_constructors
+
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+
+class User {
+  late String firstName, lastName;
+}
+
+final userProvider = FutureProvider(
+  (ref) => User()
+    ..firstName = 'John'
+    ..lastName = 'Doe',
+);
+/* SNIPPET START */
+final provider = FutureProvider((ref) async {
+  // Aspetta che un utente sia disponibile, ed ascolta solo la proprietà "firstName"
+  final firstName = await ref.watch(
+    userProvider.selectAsync((it) => it.firstName),
+  );
+
+  // TODO usa "firstName" per ottenere qualcos'altro
+});
+/* SNIPPET END */