Aller à la liste des composantsAller au menu de la page
Contribuer
Un bug, une idée, un correctif : voici comment contribuer. Pas besoin de savoir coder pour signaler un problème.
| Vous voulez… | Aller sur… |
|---|---|
| Signaler un bug | Issues |
| Proposer une idée | Discussions, catégorie Ideas |
| Poser une question | Discussions, catégorie Q&A |
| Proposer un correctif | Une Pull Request |
- Cherchez d'abord : le sujet existe peut-être déjà.
- Pas de « +1 » : utilisez la réaction « pouce levé ».
- Un sujet par fil.
Une reproduction minimale est essentielle : le plus petit extrait HTML qui montre le problème, ou un lien CodePen ou StackBlitz. Précisez :
- la version de
@ariane-ui/core, le navigateur et le système ; - le comportement attendu et le comportement observé ;
- pour l'accessibilité, le lecteur d'écran utilisé (NVDA, VoiceOver…) et le zoom.
Ariane prend en charge les patterns dont l'implémentation accessible est difficile. Elle ne réécrit pas les éléments natifs qui fonctionnent bien. Un composant est envisagé si :
- sa complexité d'accessibilité est non triviale (stepper, datepicker, dialog) ;
- ou il est rarement bien fait, par difficulté d'implémentation ;
- ou il étend un natif insuffisant (
<dialog>,<ar-dialog>).
Décrivez le besoin avant l'API. Nous visons la plus petite surface possible, un comportement par défaut adapté au mobile, et des composants sans apparence imposée. Inutile de relancer : les réactions mesurent l'intérêt.
- Ouvrez d'abord une issue, sauf pour un correctif évident.
- Créez une branche
fix/<description>depuisdev, et ouvrez la Pull Request versdev. - Écrivez vos commits en Conventional Commits (vérifiés automatiquement).
- Ajoutez un test qui échoue sans votre correctif, quand c'est possible.
- Ne modifiez jamais
dist/: il est généré par le build.
fix(stepper): corrige la navigation au clavier
BREAKING CHANGE: <seulement si le changement est incompatible>Installation, architecture, conventions de code : voir le guide de développement.