Comment j'ai créé Vanilla Calendar Pro – Un calendrier JavaScript léger et flexible avec TypeScript

Bonjour, communauté des développeurs !

Honnêtement, j’ai longtemps hésité avant d’écrire cet article. Je comprends qu'il puisse y avoir des commentaires disant : "Juste un autre sélecteur de date inutile." Mais aujourd'hui, avec Vanilla Calendar Pro, il gagne plus de 480 étoiles sur GitHub et reçoit 17 000 téléchargements par mois. , j'ai décidé de partager mon histoire.

Permettez-moi de clarifier d'emblée : je ne prétends pas être le meilleur développeur de calendriers ou de sélecteurs de dates. Cet article raconte ma première expérience avec l'open source, comment j'ai créé un projet à partir de zéro et comment il est devenu utile à d'autres développeurs.

---

Comment tout a commencé

À l'été 2022, j'avais besoin de mettre en place un calendrier d'événements pour un projet. Les exigences étaient simples :

• Cela devait fonctionner de manière transparente dans une fenêtre modale.
• Il devait prendre en charge un style personnalisé pour correspondre au design.
• Cliquer sur une date redirigerait l'utilisateur vers une page d'événement.

À première vue, cela semblait être une tâche simple. Mais je n’ai pas trouvé de solution adaptée. La plupart des calendriers existants manquaient des fonctionnalités nécessaires ou étaient trop volumineux, avec des styles difficiles à adapter à la conception du projet.

Bien sûr, j'aurais pu demander au concepteur de simplifier la mise en page ou simplement accepter un problème de formatage mineur. Mais honnêtement, j'étais intrigué : Et si je construisais mon propre calendrier ?

C'est ainsi qu'est née la première version de Vanilla Calendar Pro. Le terme "Vanilla" fait référence à du JavaScript natif, exempt de dépendances externes. Pour faciliter l'intégration dans d'autres projets, j'ai écrit un README avec de la documentation et des exemples d'API et je l'ai publié sur NPM.

---

Le premier utilisateur – et la première étoile

Peu de temps après, j'ai reçu une notification concernant le premier numéro du référentiel. Cela vient d'un développeur norvégien, qui a posé une question inattendue :

"Envisagez-vous d'ajouter des numéros de semaine au calendrier ? Ici en Norvège, l'utilisation des numéros de semaine est très courante et ce serait une fonctionnalité utile."

Ce moment m'a fait réaliser que le calendrier pouvait être utile non seulement pour moi, mais aussi pour les autres. Mais ensuite je me suis demandé : Qu'est-ce que je gagne de tous ces efforts ? Pourquoi devrais-je consacrer mon temps libre à ce qu'un gars en Norvège puisse utiliser mon calendrier ? La réponse était : Rien de tangible !

Cependant, l'idée que j'avais créé quelque chose de véritablement utile – que quelqu'un puisse télécharger mon calendrier, gagner du temps sur le développement et se concentrer sur des tâches plus importantes – était incroyablement inspirante. Même si cela ne m’a apporté aucune récompense matérielle, j’ai ressenti un profond sentiment de satisfaction sachant que mon projet aidait les autres.

J'ai donc commencé à améliorer activement le calendrier, en le transformant en une solution plus universelle et plus flexible. J'ai également conçu l'interface moi-même, dans le but de la rendre non seulement fonctionnelle mais aussi conviviale.

---

Qu'est-ce qui distingue Vanilla Calendar Pro ?

• Mises en page flexibles : Personnalisez complètement la structure HTML du calendrier, en ajoutant des boutons ou des éléments personnalisés selon vos besoins.
• Contrôle complet du style : Remplacez facilement toutes les classes CSS, permettant une intégration transparente avec des frameworks comme Tailwind CSS.
• Accessibilité (a11y) :Tous les éléments sont équipés d'étiquettes aria et prennent en charge la navigation au clavier.
• Popups interactifs : Mettez en surbrillance des jours spécifiques et affichez des informations supplémentaires directement dans le calendrier.
• Numéros de semaine : Prend en charge les formats de date basés sur la semaine, populaires dans de nombreux pays.
• Sélection de l'heure : Offre les formats 12 heures et 24 heures, avec curseurs ou saisie manuelle.
• Thèmes : Bascule automatiquement entre les thèmes clairs et sombres et prend en charge les thèmes personnalisés.
• Localisation et internationalisation : Ajustez facilement le premier jour de la semaine, les week-ends et les jours fériés pour n'importe quelle région.
• Compatibilité du framework : Fonctionne avec React, Vue, Angular et tout autre framework grâce à sa fondation JavaScript native.

Et ce n’est pas tout ! Je n'ai même pas mentionné les utilitaires, les méthodes, les actions et les options de configuration étendues qui vous permettent de personnaliser le calendrier pour l'adapter à pratiquement toutes les exigences.

---

Numéros et documentation

Vanilla Calendar Pro est entièrement écrit en TypeScript, sans dépendances externes. Le fichier minifié ne fait que ~49,33 Ko (ou 13,52 Ko gzip).

J'ai également préparé une documentation détaillée, qui comprend :

• Une référence API.
• Une Page d'apprentissage avec des bacs à sable interactifs.

? Site Web du projet

? Dépôt GitHub

---

Conclusion

Non, ce n'est pas un produit révolutionnaire. C'est juste un autre calendrier/datepicker. Mais pour moi, c’est devenu une étape importante dans mon parcours avec l’open source. Je suis heureux d'avoir créé quelque chose d'utile qui pourrait aider d'autres développeurs.

J'espère que Vanilla Calendar Pro vous sera également utile. Merci d'avoir lu !

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!