Files
afterwork/lib/presentation/widgets/fields/description_field.dart
dahoud 92612abbd7 fix(chat): Correction race condition + Implémentation TODOs
## Corrections Critiques

### Race Condition - Statuts de Messages
- Fix : Les icônes de statut (✓, ✓✓, ✓✓ bleu) ne s'affichaient pas
- Cause : WebSocket delivery confirmations arrivaient avant messages locaux
- Solution : Pattern Optimistic UI dans chat_bloc.dart
  - Création message temporaire immédiate
  - Ajout à la liste AVANT requête HTTP
  - Remplacement par message serveur à la réponse
- Fichier : lib/presentation/state_management/chat_bloc.dart

## Implémentation TODOs (13/21)

### Social (social_header_widget.dart)
-  Copier lien du post dans presse-papiers
-  Partage natif via Share.share()
-  Dialogue de signalement avec 5 raisons

### Partage (share_post_dialog.dart)
-  Interface sélection d'amis avec checkboxes
-  Partage externe via Share API

### Média (media_upload_service.dart)
-  Parsing JSON réponse backend
-  Méthode deleteMedia() pour suppression
-  Génération miniature vidéo

### Posts (create_post_dialog.dart, edit_post_dialog.dart)
-  Extraction URL depuis uploads
-  Documentation chargement médias

### Chat (conversations_screen.dart)
-  Navigation vers notifications
-  ConversationSearchDelegate pour recherche

## Nouveaux Fichiers

### Configuration
- build-prod.ps1 : Script build production avec dart-define
- lib/core/constants/env_config.dart : Gestion environnements

### Documentation
- TODOS_IMPLEMENTED.md : Documentation complète TODOs

## Améliorations

### Architecture
- Refactoring injection de dépendances
- Amélioration routing et navigation
- Optimisation providers (UserProvider, FriendsProvider)

### UI/UX
- Amélioration thème et couleurs
- Optimisation animations
- Meilleure gestion erreurs

### Services
- Configuration API avec env_config
- Amélioration datasources (events, users)
- Optimisation modèles de données
2026-01-10 10:43:17 +00:00

80 lines
3.5 KiB
Dart

import 'package:flutter/material.dart';
/// `DescriptionField` est un champ de texte utilisé pour saisir une description.
/// Ce champ fait partie d'un formulaire et est conçu pour accepter plusieurs lignes de texte.
/// Il est doté de validations et d'une logique d'enregistrement personnalisée via `onSaved`.
///
/// Ce widget utilise des icônes et un style personnalisé pour correspondre à l'apparence de l'application.
///
/// Arguments :
/// - `onSaved`: Une fonction callback utilisée pour enregistrer la valeur du champ de texte une fois que le formulaire est soumis.
/// ```
class DescriptionField extends StatelessWidget {
// Constructeur du widget DescriptionField
const DescriptionField({required this.onSaved, super.key});
// Callback utilisé pour enregistrer la valeur de la description
final FormFieldSetter<String> onSaved;
@override
Widget build(BuildContext context) {
// Log : Construction du champ DescriptionField
debugPrint('Construction du champ DescriptionField');
return TextFormField(
// Décoration du champ de texte
decoration: InputDecoration(
labelText: 'Description', // Texte étiquette affiché à l'utilisateur
labelStyle: const TextStyle(color: Colors.blueGrey), // Style de l'étiquette
filled: true, // Active le fond coloré
fillColor: Colors.blueGrey.withOpacity(0.1), // Couleur de fond plus douce et plus subtile
hintStyle: const TextStyle(color: Colors.blueGrey),
hintText: 'Entrez un la description ici...',
border: const OutlineInputBorder(
borderRadius: BorderRadius.all(Radius.circular(12)), // Bordure arrondie améliorée
borderSide: BorderSide.none, // Pas de bordure visible
),
enabledBorder: const OutlineInputBorder(
borderRadius: BorderRadius.all(Radius.circular(12)),
borderSide: BorderSide(
color: Colors.blueGrey, // Bordure de base en bleu gris
width: 2, // Largeur de la bordure
),
),
focusedBorder: const OutlineInputBorder(
borderRadius: BorderRadius.all(Radius.circular(12)),
borderSide: BorderSide(
color: Colors.blue, // Bordure bleue lors du focus
width: 2, // Épaisseur de la bordure lors du focus
),
),
prefixIcon: const Icon(Icons.description, color: Colors.blueGrey), // Icône de description avant le texte
),
// Style du texte dans le champ
style: const TextStyle(color: Colors.blueGrey, fontSize: 16),
// Limite le champ à 3 lignes, avec un retour à la ligne automatique
maxLines: 3,
// Autres configurations du champ
textInputAction: TextInputAction.done, // Permet de soumettre avec la touche "Done" du clavier
// Validation du champ : assure que le champ n'est pas vide
validator: (value) {
// Log : Validation du champ DescriptionField
debugPrint('Validation du champ DescriptionField');
if (value == null || value.isEmpty) {
return 'Veuillez entrer une description'; // Message d'erreur si la description est vide
}
return null; // Retourne null si la validation passe
},
// Lors de la soumission du formulaire, enregistre la valeur saisie
onSaved: (value) {
// Log : Sauvegarde de la valeur de la description
debugPrint('Valeur de la description sauvegardée : $value');
onSaved(value); // Appel de la fonction onSaved passée en paramètre
},
);
}
}