Regles du jeu
Par Mister V, jeudi 19 janvier 2006 à 22:19 :: JS Lab :: #4 :: rss
Ici, je fais du JavaScript. Mais lors de mes développements, je cherche à respecter un certain nombre de règles, ou je me fixe certains but, qui feront je l'espères de ces script des scripts de qualité.
Règle numéro 1 : Des scripts non intrusif
On ne trouvera dans le document HTML aucun code Javascript. Une simple balise dans l'entête du HTML appellera les script JS qui seront donc indépendant des pages.
Règle numéro 2 : Des scripts facultatifs
Si l'utilisateur désactive le support du JS dans son navigateur, le document HTML sera utilisable. Celui-ci ne doit donc pas reposer sur l'utilisation du JS, et inversement le JS ne doit rien imposer au HTML.
Règle numéro 3 : Des scripts cumulable
Il doit être possible d'utiliser plusieurs des scripts en même temps. Il ne faut donc pas rencontrer de problèmes de variables communes ou autre. Il faut également veiller à la gestions des dépendences dans le cas ou certains scripts en utilisent d'autres.
Règle numéro 4 : Des controles d'erreurs
Les erreurs doivent être gérées au mieux, et rester discrètes. Une dépendence non satisfaite doit annuler completement l'utilisation du script, une incompatibilité avec le navigateur doit permettre une alerte désactivable...
Règle numéro 5 : Des commentaires
Les scripts doivent être utilisable par n'importe qui. Il faut donc une description du fonctionnement et des commentaires complets.
Pour certains point, y a encore beaucoup de boulot, je pense surtout aux commentaires :). Mais sinon voila, c'est les règles que je vais chercher à suivre.
Si d'autres règles me viennent à l'esprit, ou si vous pensez que j'ai oublié quelque-chose, je pourrais rajouter ce qu'il faut. Ce billet me servira donc de reglement et sera autant que possible à jour.
Commentaires
Aucun commentaire pour le moment.
Ajouter un commentaire
Les commentaires pour ce billet sont fermés.