AjaxOnLoad |
Charge AJAX |
| Lucee |
Syntaxe
|
AjaxOnLoad( functionname=any );
|
Paramètres
| Nom |
Description |
| functionname |
Ce paramètre permet de spécifier le nom de la fonction JavaScript devant être exécutée automatiquement au moment du chargement de la page. Il peut s'agir d'une fonction définie directement dans le code JavaScript de la page ou d'une fonction incluse via un fichier externe. |
Description
Cette fonction permet de provoquer l'exécution de la fonction JavaScript spécifiée lors du chargement de la page.
Remarques
- La fonction AjaxOnLoad() permettait d'exécuter automatiquement une fonction JavaScript au moment du chargement de la
page. Elle simplifiait l'initialisation des comportements dynamiques côté client, sans nécessiter d'attacher explicitement des événements onload via du code JavaScript natif.
Cependant, cette approche est aujourd'hui considérée comme obsolète.
- Le paramètre functionname spécifiait la fonction JavaScript à appeler lors du chargement. Cette fonction pouvait être définie directement dans la page ou
incluse via un fichier externe. L'utilisation de ce paramètre permettait de centraliser la logique côté client, mais limitait la flexibilité par rapport aux techniques modernes
de gestion d'événements.
- AjaxOnLoad() était utile pour initialiser des conteneurs AJAX, charger des données ou exécuter des scripts immédiatement après que le
DOM était prêt. Elle évitait de devoir écrire manuellement des appels window.onload ou document.addEventListener("DOMContentLoaded", ...), ce qui simplifiait le code pour les développeurs débutants.
- La fonction est désormais obsolète et n'est plus recommandée pour les nouvelles applications. Les pratiques modernes privilégient l'usage de
JavaScript natif (DOMContentLoaded, window.onload) ou de cadre d'application comme
jQuery, Vue ou React pour gérer l'exécution de fonctions au chargement, offrant plus de contrôle et de compatibilité.
- En termes de compatibilité, AjaxOnLoad() peut ne pas fonctionner correctement avec les navigateurs récents ou les versions modernes de Lucee. Son usage peut générer des
comportements imprévus, notamment si plusieurs fonctions doivent être exécutées lors du chargement de la page, car elle ne gère pas les files d'attente d'événements.
- La fonction illustre une approche historique de la programmation AJAX dans Lucee, visant à simplifier l'intégration
d'interactions asynchrones côté client. Elle montre comment les premières versions cherchaient à automatiser l'exécution de scripts sans nécessiter de connaissances avancées
en JavaScript.
- AjaxOnLoad() ne fournit aucun mécanisme de gestion des erreurs ou de contrôle sur le moment exact où la fonction est exécutée. Cela peut poser problème pour des scripts
dépendant du chargement complet de certaines ressources, contrairement aux événements modernes comme DOMContentLoaded ou aux promesses
JavaScript.
- Aujourd'hui, cette fonction ne devrait être utilisée que pour maintenir du code ancien. Pour les nouveaux développements, il est recommandé de migrer vers des méthodes
plus robustes et standards, garantissant une meilleure maintenabilité, compatibilité navigateur et intégration avec les cadres d'applications modernes de gestion d'interfaces
dynamiques.
Dernière mise à jour : Jeudi, le 14 Août 2025