[{"data":1,"prerenderedAt":1507},["ShallowReactive",2],{"series-\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fbuilding-a-first-component-with-vuejs-and-tailwind-css":3,"series-context-\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library":1283},{"id":4,"title":5,"body":6,"contentId":1271,"date":1272,"description":1273,"extension":393,"github":1274,"meetTheInstructor":1274,"meta":1275,"navigation":286,"part":185,"path":1276,"rawbody":1277,"robots":1274,"schemaOrg":1274,"seo":1278,"seriesSlug":1279,"sitemap":1280,"stem":1281,"subtitle":1274,"topics":1274,"__hash__":1282},"series\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fbuilding-a-first-component-with-vuejs-and-tailwind-css.md","Construire un premier composant avec Vue.js et Tailwind CSS",{"type":7,"value":8,"toc":1265},"minimark",[9,18,39,44,52,95,106,130,137,141,144,147,156,224,236,256,378,395,398,507,515,578,594,597,670,673,709,712,716,726,738,751,754,770,776,969,972,975,994,1000,1009,1021,1024,1042,1049,1061,1064,1104,1107,1122,1132,1136,1151,1210,1235,1254,1261],[10,11,12,13,17],"p",{},"Avec notre bibliothèque de composants ",[14,15,16],"strong",{},"Vue.js"," configurée, il est temps de construire notre premier composant : un bouton simple. Cet exercice nous aidera à comprendre comment structurer nos composants.",[10,19,20,21,30,31,38],{},"Nous allons utiliser ",[22,23,27],"a",{"href":24,"rel":25},"https:\u002F\u002Ftailwindcss.com\u002F",[26],"nofollow",[14,28,29],{},"Tailwind CSS"," et ",[22,32,35],{"href":33,"rel":34},"https:\u002F\u002Fwww.tailwind-variants.org\u002F",[26],[14,36,37],{},"Tailwind Variants"," pour le style. Tailwind Variants aide à organiser les classes Tailwind CSS de manière structurée pour créer et combiner des variantes.",[40,41,43],"h2",{"id":42},"configuration-du-package","Configuration du package",[10,45,46,47,51],{},"Naviguez vers ",[48,49,50],"code",{},"packages\u002Fhuchet-vue"," et installez les dépendances nécessaires :",[53,54,60],"pre",{"className":55,"code":56,"filename":57,"language":58,"meta":59,"style":59},"language-bash shiki shiki-themes github-light github-light github-dark","cd packages\u002Fhuchet-vue && pnpm add -D vue vite\n","terminal","bash","",[48,61,62],{"__ignoreMap":59},[63,64,67,71,75,79,83,86,89,92],"span",{"class":65,"line":66},"line",1,[63,68,70],{"class":69},"sBjJW","cd",[63,72,74],{"class":73},"sIIMD"," packages\u002Fhuchet-vue",[63,76,78],{"class":77},"sxrX7"," && ",[63,80,82],{"class":81},"snPdu","pnpm",[63,84,85],{"class":73}," add",[63,87,88],{"class":69}," -D",[63,90,91],{"class":73}," vue",[63,93,94],{"class":73}," vite\n",[10,96,97,98,101,102,105],{},"Ensuite, créez un dossier ",[48,99,100],{},"src"," avec le composant ",[48,103,104],{},"Button\u002FButton.vue"," :",[53,107,109],{"className":55,"code":108,"filename":104,"language":58,"meta":59,"style":59},"mkdir -p src\u002FButton && touch src\u002FButton\u002FButton.vue\n",[48,110,111],{"__ignoreMap":59},[63,112,113,116,119,122,124,127],{"class":65,"line":66},[63,114,115],{"class":81},"mkdir",[63,117,118],{"class":69}," -p",[63,120,121],{"class":73}," src\u002FButton",[63,123,78],{"class":77},[63,125,126],{"class":81},"touch",[63,128,129],{"class":73}," src\u002FButton\u002FButton.vue\n",[10,131,132,133,136],{},"Ouvrez le fichier ",[48,134,135],{},"Button.vue"," et commençons à écrire notre composant.",[40,138,140],{"id":139},"écriture-du-composant-bouton","Écriture du composant bouton",[10,142,143],{},"Pour notre exemple, nous allons créer un bouton avec deux variantes : solide et contour. La variante solide aura une couleur de fond, tandis que la variante contour inclura une bordure.",[10,145,146],{},"Pour assurer l'absence de conflit de classes et simplifier le refactoring, la maintenabilité, la lisibilité et la structure, nous utiliserons Tailwind Variants. Nous allons organiser nos classes dans un objet, et Tailwind Variants appliquera les classes appropriées en fonction des props.",[10,148,149,150,153,154,105],{},"Ajoutez une balise ",[48,151,152],{},"script"," en haut du fichier ",[48,155,135],{},[53,157,161],{"className":158,"code":159,"filename":135,"language":160,"meta":59,"style":59},"language-vue shiki shiki-themes github-light github-light github-dark","\u003Cscript lang=\"ts\">\nimport type { VariantProps } from 'tailwind-variants'\nimport { tv } from 'tailwind-variants'\n\u003C\u002Fscript>\n","vue",[48,162,163,183,202,214],{"__ignoreMap":59},[63,164,165,168,171,174,177,180],{"class":65,"line":66},[63,166,167],{"class":77},"\u003C",[63,169,152],{"class":170},"sovSZ",[63,172,173],{"class":81}," lang",[63,175,176],{"class":77},"=",[63,178,179],{"class":73},"\"ts\"",[63,181,182],{"class":77},">\n",[63,184,186,190,193,196,199],{"class":65,"line":185},2,[63,187,189],{"class":188},"s8jYJ","import",[63,191,192],{"class":188}," type",[63,194,195],{"class":77}," { VariantProps } ",[63,197,198],{"class":188},"from",[63,200,201],{"class":73}," 'tailwind-variants'\n",[63,203,205,207,210,212],{"class":65,"line":204},3,[63,206,189],{"class":188},[63,208,209],{"class":77}," { tv } ",[63,211,198],{"class":188},[63,213,201],{"class":73},[63,215,217,220,222],{"class":65,"line":216},4,[63,218,219],{"class":77},"\u003C\u002F",[63,221,152],{"class":170},[63,223,182],{"class":77},[225,226,229],"callout",{"color":227,"icon":228},"primary","i-ph-info-duotone",[10,230,231,232,235],{},"Ne pas ajouter l'attribut ",[48,233,234],{},"setup",". Cette omission est volontaire.",[10,237,238,239,242,243,30,246,249,250,252,253,255],{},"La fonction ",[48,240,241],{},"tv"," est un helper pour organiser les classes. Elle accepte un objet avec des clés ",[48,244,245],{},"base",[48,247,248],{},"variants",". Le ",[48,251,245],{}," est une chaîne de classes partagées, tandis que ",[48,254,248],{}," est un enregistrement avec des clés de variante et des valeurs de classe.",[53,257,260],{"className":158,"code":258,"filename":259,"language":160,"meta":59,"style":59},"\u003Cscript lang=\"ts\">\n\u002F\u002F ...\n\nconst button = tv({\n  base: 'border-2 px-2.5 py-1.5 text-sm font-semibold focus:outline-none focus-visible:ring-2 focus-visible:ring-offset-2',\n  variants: {\n    variant: {\n      solid: 'border-transparent bg-blue-500 text-white hover:bg-blue-600 active:bg-blue-700',\n      outline: 'border-blue-500 text-blue-500 hover:bg-blue-50 active:bg-blue-100',\n    }\n  }\n})\n\u003C\u002Fscript>\n","Exemple",[48,261,262,276,282,288,305,317,323,329,340,351,357,363,369],{"__ignoreMap":59},[63,263,264,266,268,270,272,274],{"class":65,"line":66},[63,265,167],{"class":77},[63,267,152],{"class":170},[63,269,173],{"class":81},[63,271,176],{"class":77},[63,273,179],{"class":73},[63,275,182],{"class":77},[63,277,278],{"class":65,"line":185},[63,279,281],{"class":280},"sCsY4","\u002F\u002F ...\n",[63,283,284],{"class":65,"line":204},[63,285,287],{"emptyLinePlaceholder":286},true,"\n",[63,289,290,293,296,299,302],{"class":65,"line":216},[63,291,292],{"class":188},"const",[63,294,295],{"class":69}," button",[63,297,298],{"class":188}," =",[63,300,301],{"class":81}," tv",[63,303,304],{"class":77},"({\n",[63,306,308,311,314],{"class":65,"line":307},5,[63,309,310],{"class":77},"  base: ",[63,312,313],{"class":73},"'border-2 px-2.5 py-1.5 text-sm font-semibold focus:outline-none focus-visible:ring-2 focus-visible:ring-offset-2'",[63,315,316],{"class":77},",\n",[63,318,320],{"class":65,"line":319},6,[63,321,322],{"class":77},"  variants: {\n",[63,324,326],{"class":65,"line":325},7,[63,327,328],{"class":77},"    variant: {\n",[63,330,332,335,338],{"class":65,"line":331},8,[63,333,334],{"class":77},"      solid: ",[63,336,337],{"class":73},"'border-transparent bg-blue-500 text-white hover:bg-blue-600 active:bg-blue-700'",[63,339,316],{"class":77},[63,341,343,346,349],{"class":65,"line":342},9,[63,344,345],{"class":77},"      outline: ",[63,347,348],{"class":73},"'border-blue-500 text-blue-500 hover:bg-blue-50 active:bg-blue-100'",[63,350,316],{"class":77},[63,352,354],{"class":65,"line":353},10,[63,355,356],{"class":77},"    }\n",[63,358,360],{"class":65,"line":359},11,[63,361,362],{"class":77},"  }\n",[63,364,366],{"class":65,"line":365},12,[63,367,368],{"class":77},"})\n",[63,370,372,374,376],{"class":65,"line":371},13,[63,373,219],{"class":77},[63,375,152],{"class":170},[63,377,182],{"class":77},[10,379,380,381,383,384,387,388,30,391,394],{},"Dans la clé ",[48,382,248],{},", vous pourriez également inclure d'autres clés comme ",[48,385,386],{},"size"," avec des variantes ",[48,389,390],{},"sm",[48,392,393],{},"md",".",[10,396,397],{},"Ensuite, extrayez les variantes pour les utiliser dans les props de notre composant :",[53,399,401],{"className":158,"code":400,"filename":259,"language":160,"meta":59,"style":59},"\u003Cscript lang=\"ts\">\n\u002F\u002F ...\n\ntype ButtonVariantProps = VariantProps\u003Ctypeof button>\n\nexport interface ButtonProps {\n  label?: string\n  variant?: ButtonVariantProps['variant']\n}\n\u003C\u002Fscript>\n",[48,402,403,417,421,425,446,450,464,476,494,499],{"__ignoreMap":59},[63,404,405,407,409,411,413,415],{"class":65,"line":66},[63,406,167],{"class":77},[63,408,152],{"class":170},[63,410,173],{"class":81},[63,412,176],{"class":77},[63,414,179],{"class":73},[63,416,182],{"class":77},[63,418,419],{"class":65,"line":185},[63,420,281],{"class":280},[63,422,423],{"class":65,"line":204},[63,424,287],{"emptyLinePlaceholder":286},[63,426,427,430,433,435,438,440,443],{"class":65,"line":216},[63,428,429],{"class":188},"type",[63,431,432],{"class":81}," ButtonVariantProps",[63,434,298],{"class":188},[63,436,437],{"class":81}," VariantProps",[63,439,167],{"class":77},[63,441,442],{"class":188},"typeof",[63,444,445],{"class":77}," button>\n",[63,447,448],{"class":65,"line":307},[63,449,287],{"emptyLinePlaceholder":286},[63,451,452,455,458,461],{"class":65,"line":319},[63,453,454],{"class":188},"export",[63,456,457],{"class":188}," interface",[63,459,460],{"class":81}," ButtonProps",[63,462,463],{"class":77}," {\n",[63,465,466,470,473],{"class":65,"line":325},[63,467,469],{"class":468},"sP4rz","  label",[63,471,472],{"class":188},"?:",[63,474,475],{"class":69}," string\n",[63,477,478,481,483,485,488,491],{"class":65,"line":331},[63,479,480],{"class":468},"  variant",[63,482,472],{"class":188},[63,484,432],{"class":81},[63,486,487],{"class":77},"[",[63,489,490],{"class":73},"'variant'",[63,492,493],{"class":77},"]\n",[63,495,496],{"class":65,"line":342},[63,497,498],{"class":77},"}\n",[63,500,501,503,505],{"class":65,"line":353},[63,502,219],{"class":77},[63,504,152],{"class":170},[63,506,182],{"class":77},[10,508,509,510,512,513,105],{},"Ouvrez ensuite une nouvelle balise ",[48,511,152],{}," avec l'attribut ",[48,514,234],{},[53,516,518],{"className":158,"code":517,"filename":259,"language":160,"meta":59,"style":59},"\u003Cscript setup lang=\"ts\">\nwithDefaults(defineProps\u003CButtonProps>(), {\n  variant: 'solid',\n})\n\u003C\u002Fscript>\n",[48,519,520,537,556,566,570],{"__ignoreMap":59},[63,521,522,524,526,529,531,533,535],{"class":65,"line":66},[63,523,167],{"class":77},[63,525,152],{"class":170},[63,527,528],{"class":81}," setup",[63,530,173],{"class":81},[63,532,176],{"class":77},[63,534,179],{"class":73},[63,536,182],{"class":77},[63,538,539,542,545,548,550,553],{"class":65,"line":185},[63,540,541],{"class":81},"withDefaults",[63,543,544],{"class":77},"(",[63,546,547],{"class":81},"defineProps",[63,549,167],{"class":77},[63,551,552],{"class":81},"ButtonProps",[63,554,555],{"class":77},">(), {\n",[63,557,558,561,564],{"class":65,"line":204},[63,559,560],{"class":77},"  variant: ",[63,562,563],{"class":73},"'solid'",[63,565,316],{"class":77},[63,567,568],{"class":65,"line":216},[63,569,368],{"class":77},[63,571,572,574,576],{"class":65,"line":307},[63,573,219],{"class":77},[63,575,152],{"class":170},[63,577,182],{"class":77},[10,579,580,581,583,584,586,587,589,590,593],{},"Nous avons divisé la balise ",[48,582,152],{}," en deux parties pour permettre des exports nommés. L'interface ",[48,585,552],{}," est utilisée dans la fonction ",[48,588,547],{}," et est exportée afin que les développeurs puissent l'étendre pour créer un nouveau composant. Ce détail est crucial pour construire une ",[14,591,592],{},"bibliothèque de composants"," robuste.",[10,595,596],{},"Ajoutez le template du composant :",[53,598,600],{"className":158,"code":599,"filename":259,"language":160,"meta":59,"style":59},"\u003Ctemplate>\n  \u003Cbutton :class=\"button({ variant })\">\n    \u003Cslot>\n      {{ label }}\n    \u003C\u002Fslot>\n  \u003C\u002Fbutton>\n\u003C\u002Ftemplate>\n",[48,601,602,611,629,639,644,653,662],{"__ignoreMap":59},[63,603,604,606,609],{"class":65,"line":66},[63,605,167],{"class":77},[63,607,608],{"class":170},"template",[63,610,182],{"class":77},[63,612,613,616,619,622,624,627],{"class":65,"line":185},[63,614,615],{"class":77},"  \u003C",[63,617,618],{"class":170},"button",[63,620,621],{"class":81}," :class",[63,623,176],{"class":77},[63,625,626],{"class":73},"\"button({ variant })\"",[63,628,182],{"class":77},[63,630,631,634,637],{"class":65,"line":204},[63,632,633],{"class":77},"    \u003C",[63,635,636],{"class":170},"slot",[63,638,182],{"class":77},[63,640,641],{"class":65,"line":216},[63,642,643],{"class":77},"      {{ label }}\n",[63,645,646,649,651],{"class":65,"line":307},[63,647,648],{"class":77},"    \u003C\u002F",[63,650,636],{"class":170},[63,652,182],{"class":77},[63,654,655,658,660],{"class":65,"line":319},[63,656,657],{"class":77},"  \u003C\u002F",[63,659,618],{"class":170},[63,661,182],{"class":77},[63,663,664,666,668],{"class":65,"line":325},[63,665,219],{"class":77},[63,667,608],{"class":170},[63,669,182],{"class":77},[10,671,672],{},"Notre composant est prêt à être utilisé :",[53,674,678],{"className":675,"code":676,"filename":259,"language":677,"meta":59,"style":59},"language-html shiki shiki-themes github-light github-light github-dark","\u003CButton variant=\"outline\" label=\"Cliquez moi\" \u002F>\n","html",[48,679,680],{"__ignoreMap":59},[63,681,682,684,687,690,692,695,698,700,703,707],{"class":65,"line":66},[63,683,167],{"class":77},[63,685,686],{"class":170},"Button",[63,688,689],{"class":81}," variant",[63,691,176],{"class":77},[63,693,694],{"class":73},"\"outline\"",[63,696,697],{"class":81}," label",[63,699,176],{"class":77},[63,701,702],{"class":73},"\"Cliquez moi\"",[63,704,706],{"class":705},"sPrNH"," \u002F",[63,708,182],{"class":77},[10,710,711],{},"Cependant, il n'est pas utilisable tant que nous n'avons pas construit notre bibliothèque de composants.",[40,713,715],{"id":714},"construction-de-la-bibliothèque-de-composants","Construction de la bibliothèque de composants",[10,717,718,719,722,723,105],{},"Ensuite, nous allons construire la bibliothèque de composants. Commencez par créer un fichier ",[48,720,721],{},"vite.config.ts"," à la racine du package ",[48,724,725],{},"huchet-vue",[53,727,729],{"className":55,"code":728,"filename":721,"language":58,"meta":59,"style":59},"touch vite.config.ts\n",[48,730,731],{"__ignoreMap":59},[63,732,733,735],{"class":65,"line":66},[63,734,126],{"class":81},[63,736,737],{"class":73}," vite.config.ts\n",[10,739,740,741,744,745,747,748,750],{},"Cette configuration indique à ",[14,742,743],{},"Vite"," comment transpiler nos composants ",[14,746,16],{}," en JavaScript pour être utilisé dans d'autres projets. Par défaut, ",[14,749,743],{}," est conçu pour les applications web, pas pour les bibliothèques, donc nous allons l'ajuster à nos besoins.",[10,752,753],{},"Installez le plugin :",[53,755,757],{"className":55,"code":756,"filename":57,"language":58,"meta":59,"style":59},"pnpm add -D @vitejs\u002Fplugin-vue\n",[48,758,759],{"__ignoreMap":59},[63,760,761,763,765,767],{"class":65,"line":66},[63,762,82],{"class":81},[63,764,85],{"class":73},[63,766,88],{"class":69},[63,768,769],{"class":73}," @vitejs\u002Fplugin-vue\n",[10,771,772,773,775],{},"Modifiez le fichier ",[48,774,721],{}," avec la configuration suivante :",[53,777,781],{"className":778,"code":779,"filename":721,"language":780,"meta":59,"style":59},"language-ts shiki shiki-themes github-light github-light github-dark","import Vue from '@vitejs\u002Fplugin-vue'\nimport { defineConfig } from 'vite'\n\nexport default defineConfig({\n  plugins: [Vue()],\n  build: {\n    lib: {\n      formats: ['es'],\n      name: 'huchet-vue',\n      fileName: (_, name) => `${name}.mjs`,\n      entry: {\n        index: resolve(__dirname, 'src\u002Findex.ts'),\n      },\n    },\n    rollupOptions: {\n      external: ['vue', 'tailwind-variants'],\n    },\n  },\n})\n","ts",[48,782,783,795,807,811,823,834,839,844,855,865,898,903,920,925,931,937,953,958,964],{"__ignoreMap":59},[63,784,785,787,790,792],{"class":65,"line":66},[63,786,189],{"class":188},[63,788,789],{"class":77}," Vue ",[63,791,198],{"class":188},[63,793,794],{"class":73}," '@vitejs\u002Fplugin-vue'\n",[63,796,797,799,802,804],{"class":65,"line":185},[63,798,189],{"class":188},[63,800,801],{"class":77}," { defineConfig } ",[63,803,198],{"class":188},[63,805,806],{"class":73}," 'vite'\n",[63,808,809],{"class":65,"line":204},[63,810,287],{"emptyLinePlaceholder":286},[63,812,813,815,818,821],{"class":65,"line":216},[63,814,454],{"class":188},[63,816,817],{"class":188}," default",[63,819,820],{"class":81}," defineConfig",[63,822,304],{"class":77},[63,824,825,828,831],{"class":65,"line":307},[63,826,827],{"class":77},"  plugins: [",[63,829,830],{"class":81},"Vue",[63,832,833],{"class":77},"()],\n",[63,835,836],{"class":65,"line":319},[63,837,838],{"class":77},"  build: {\n",[63,840,841],{"class":65,"line":325},[63,842,843],{"class":77},"    lib: {\n",[63,845,846,849,852],{"class":65,"line":331},[63,847,848],{"class":77},"      formats: [",[63,850,851],{"class":73},"'es'",[63,853,854],{"class":77},"],\n",[63,856,857,860,863],{"class":65,"line":342},[63,858,859],{"class":77},"      name: ",[63,861,862],{"class":73},"'huchet-vue'",[63,864,316],{"class":77},[63,866,867,870,873,876,879,882,885,888,891,893,896],{"class":65,"line":353},[63,868,869],{"class":81},"      fileName",[63,871,872],{"class":77},": (",[63,874,875],{"class":468},"_",[63,877,878],{"class":77},", ",[63,880,881],{"class":468},"name",[63,883,884],{"class":77},") ",[63,886,887],{"class":188},"=>",[63,889,890],{"class":73}," `${",[63,892,881],{"class":77},[63,894,895],{"class":73},"}.mjs`",[63,897,316],{"class":77},[63,899,900],{"class":65,"line":359},[63,901,902],{"class":77},"      entry: {\n",[63,904,905,908,911,914,917],{"class":65,"line":365},[63,906,907],{"class":77},"        index: ",[63,909,910],{"class":81},"resolve",[63,912,913],{"class":77},"(__dirname, ",[63,915,916],{"class":73},"'src\u002Findex.ts'",[63,918,919],{"class":77},"),\n",[63,921,922],{"class":65,"line":371},[63,923,924],{"class":77},"      },\n",[63,926,928],{"class":65,"line":927},14,[63,929,930],{"class":77},"    },\n",[63,932,934],{"class":65,"line":933},15,[63,935,936],{"class":77},"    rollupOptions: {\n",[63,938,940,943,946,948,951],{"class":65,"line":939},16,[63,941,942],{"class":77},"      external: [",[63,944,945],{"class":73},"'vue'",[63,947,878],{"class":77},[63,949,950],{"class":73},"'tailwind-variants'",[63,952,854],{"class":77},[63,954,956],{"class":65,"line":955},17,[63,957,930],{"class":77},[63,959,961],{"class":65,"line":960},18,[63,962,963],{"class":77},"  },\n",[63,965,967],{"class":65,"line":966},19,[63,968,368],{"class":77},[10,970,971],{},"Nous choisissons de ne pas inclure Vue.js et Tailwind Variants dans le bundle final pour plus de flexibilité, permettant aux utilisateurs d'utiliser leurs propres versions. Cela évite également la duplication dans le bundle final si l'utilisateur a déjà ces dépendances.",[10,973,974],{},"Ajoutez-les comme dépendances peer :",[53,976,978],{"className":55,"code":977,"filename":57,"language":58,"meta":59,"style":59},"pnpm add --save-peer vue tailwind-variants\n",[48,979,980],{"__ignoreMap":59},[63,981,982,984,986,989,991],{"class":65,"line":66},[63,983,82],{"class":81},[63,985,85],{"class":73},[63,987,988],{"class":69}," --save-peer",[63,990,91],{"class":73},[63,992,993],{"class":73}," tailwind-variants\n",[225,995,997],{"color":996,"icon":228},"info",[10,998,999],{},"Une dépendance peer n'est pas installée par le package mais doit être présente dans le projet de l'utilisateur. Cette flexibilité est particulièrement utile lorsqu'un package peut fonctionner dans des contextes variés.",[10,1001,1002,1003,1006,1007,105],{},"Créez le fichier ",[48,1004,1005],{},"src\u002Findex.ts",", comme mentionné dans ",[48,1008,721],{},[53,1010,1012],{"className":55,"code":1011,"filename":721,"language":58,"meta":59,"style":59},"touch src\u002Findex.ts\n",[48,1013,1014],{"__ignoreMap":59},[63,1015,1016,1018],{"class":65,"line":66},[63,1017,126],{"class":81},[63,1019,1020],{"class":73}," src\u002Findex.ts\n",[10,1022,1023],{},"Ce fichier exporte tous les composants de la bibliothèque :",[53,1025,1027],{"className":778,"code":1026,"filename":259,"language":780,"meta":59,"style":59},"export * from '.\u002FButton'\n",[48,1028,1029],{"__ignoreMap":59},[63,1030,1031,1033,1036,1039],{"class":65,"line":66},[63,1032,454],{"class":188},[63,1034,1035],{"class":69}," *",[63,1037,1038],{"class":188}," from",[63,1040,1041],{"class":73}," '.\u002FButton'\n",[10,1043,1044,1045,1048],{},"Créez un nouveau ",[48,1046,1047],{},"index.ts"," au niveau du composant :",[53,1050,1052],{"className":55,"code":1051,"filename":1047,"language":58,"meta":59,"style":59},"touch src\u002FButton\u002Findex.ts\n",[48,1053,1054],{"__ignoreMap":59},[63,1055,1056,1058],{"class":65,"line":66},[63,1057,126],{"class":81},[63,1059,1060],{"class":73}," src\u002FButton\u002Findex.ts\n",[10,1062,1063],{},"Ce fichier sert d'API publique, exposant des éléments sélectionnés à l'utilisateur tout en gardant la structure interne cachée :",[53,1065,1067],{"className":778,"code":1066,"filename":259,"language":780,"meta":59,"style":59},"export {\n  default as Button,\n  type ButtonProps\n} from '.\u002FButton.vue'\n",[48,1068,1069,1075,1086,1094],{"__ignoreMap":59},[63,1070,1071,1073],{"class":65,"line":66},[63,1072,454],{"class":188},[63,1074,463],{"class":77},[63,1076,1077,1080,1083],{"class":65,"line":185},[63,1078,1079],{"class":188},"  default",[63,1081,1082],{"class":188}," as",[63,1084,1085],{"class":77}," Button,\n",[63,1087,1088,1091],{"class":65,"line":204},[63,1089,1090],{"class":188},"  type",[63,1092,1093],{"class":77}," ButtonProps\n",[63,1095,1096,1099,1101],{"class":65,"line":216},[63,1097,1098],{"class":77},"} ",[63,1100,198],{"class":188},[63,1102,1103],{"class":73}," '.\u002FButton.vue'\n",[10,1105,1106],{},"Enfin, construisez la bibliothèque :",[53,1108,1110],{"className":55,"code":1109,"filename":57,"language":58,"meta":59,"style":59},"pnpm run build\n",[48,1111,1112],{"__ignoreMap":59},[63,1113,1114,1116,1119],{"class":65,"line":66},[63,1115,82],{"class":81},[63,1117,1118],{"class":73}," run",[63,1120,1121],{"class":73}," build\n",[10,1123,1124,1125,1128,1129,394],{},"La bibliothèque se compile sous le répertoire ",[48,1126,1127],{},"dist"," sous le nom ",[48,1130,1131],{},"index.mjs",[40,1133,1135],{"id":1134},"exposition-des-composants","Exposition des composants",[10,1137,1138,1139,1142,1143,1146,1147,1150],{},"Notre bibliothèque de composants est construite, mais pour être utilisable comme un package ",[14,1140,1141],{},"npm",", nous devons définir certains champs dans le fichier ",[48,1144,1145],{},"package.json",". Ces champs fournissent des informations cruciales à ",[14,1148,1149],{},"Node"," sur la façon dont notre package doit être chargé :",[53,1152,1156],{"className":1153,"code":1154,"filename":1145,"language":1155,"meta":59,"style":59},"language-json shiki shiki-themes github-light github-light github-dark","{\n  \"exports\": {\n    \".\": {\n      \"import\": \".\u002Fdist\u002Findex.mjs\"\n    }\n  },\n  \"main\": \".\u002Fdist\u002Findex.mjs\"\n}\n","json",[48,1157,1158,1163,1171,1178,1189,1193,1197,1206],{"__ignoreMap":59},[63,1159,1160],{"class":65,"line":66},[63,1161,1162],{"class":77},"{\n",[63,1164,1165,1168],{"class":65,"line":185},[63,1166,1167],{"class":69},"  \"exports\"",[63,1169,1170],{"class":77},": {\n",[63,1172,1173,1176],{"class":65,"line":204},[63,1174,1175],{"class":69},"    \".\"",[63,1177,1170],{"class":77},[63,1179,1180,1183,1186],{"class":65,"line":216},[63,1181,1182],{"class":69},"      \"import\"",[63,1184,1185],{"class":77},": ",[63,1187,1188],{"class":73},"\".\u002Fdist\u002Findex.mjs\"\n",[63,1190,1191],{"class":65,"line":307},[63,1192,356],{"class":77},[63,1194,1195],{"class":65,"line":319},[63,1196,963],{"class":77},[63,1198,1199,1202,1204],{"class":65,"line":325},[63,1200,1201],{"class":69},"  \"main\"",[63,1203,1185],{"class":77},[63,1205,1188],{"class":73},[63,1207,1208],{"class":65,"line":331},[63,1209,498],{"class":77},[10,1211,1212,1213,1216,1217,1219,1220,1222,1223,1225,1226,1229,1230,1232,1233,394],{},"Simple, non ? Le champ ",[48,1214,1215],{},"exports"," informe ",[14,1218,1149],{}," des imports disponibles pour notre package. Dans notre cas, nous n'avons qu'un seul import, la racine de notre package, et c'est le fichier ",[48,1221,1131],{}," dans le dossier ",[48,1224,1127],{},". Le champ ",[48,1227,1228],{},"main"," spécifie le point d'entrée de notre package. Ici, le point d'entrée est le fichier ",[48,1231,1131],{}," situé dans le dossier ",[48,1234,1127],{},[225,1236,1237],{"color":996,"icon":228},[10,1238,1239,1240,1242,1243,1245,1246,1248,1249,1251,1252,394],{},"Puisque nous avons seulement un point d'entrée, nous pourrions nous fier uniquement au champ ",[48,1241,1228],{},". Cependant, il est bon de définir le champ ",[48,1244,1215],{}," pour garantir la compatibilité avec les versions passées de ",[14,1247,1149],{}," et préparer le support de points d'entrée multiples. Le champ ",[48,1250,1215],{}," est plus moderne et puissant que ",[48,1253,1228],{},[10,1255,1256,1257,1260],{},"Dans le prochain article, nous ajouterons des ",[14,1258,1259],{},"définitions de type"," à notre bibliothèque de composants pour offrir une meilleure expérience aux développeurs.",[1262,1263,1264],"style",{},"html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sovSZ, html code.shiki .sovSZ{--shiki-light:#22863A;--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sP4rz, html code.shiki .sP4rz{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#FFAB70}html pre.shiki code .sPrNH, html code.shiki .sPrNH{--shiki-light:#B31D28;--shiki-light-font-style:italic;--shiki-default:#B31D28;--shiki-default-font-style:italic;--shiki-dark:#FDAEB7;--shiki-dark-font-style:italic}",{"title":59,"searchDepth":185,"depth":185,"links":1266},[1267,1268,1269,1270],{"id":42,"depth":185,"text":43},{"id":139,"depth":185,"text":140},{"id":714,"depth":185,"text":715},{"id":1134,"depth":185,"text":1135},"24847f3a-2219-4e78-829b-0f5a08fa9baa","2024-11-24","Création d'un composant avec Vue.js en utilisant Tailwind CSS pour le style et les variantes, ainsi qu'une configuration du build avec Vite.",null,{},"\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fbuilding-a-first-component-with-vuejs-and-tailwind-css","---\ncontentId: 24847f3a-2219-4e78-829b-0f5a08fa9baa\npart: 2\ntitle: Construire un premier composant avec Vue.js et Tailwind CSS\ndescription: Création d'un composant avec Vue.js en utilisant Tailwind CSS pour le style et les variantes, ainsi qu'une configuration du build avec Vite.\ndate: 2024-11-24\nseriesSlug: the-complete-guide-to-building-a-vue-js-component-library\n---\n\nAvec notre bibliothèque de composants **Vue.js** configurée, il est temps de construire notre premier composant : un bouton simple. Cet exercice nous aidera à comprendre comment structurer nos composants.\n\nNous allons utiliser [**Tailwind CSS**](https:\u002F\u002Ftailwindcss.com\u002F) et [**Tailwind Variants**](https:\u002F\u002Fwww.tailwind-variants.org\u002F) pour le style. Tailwind Variants aide à organiser les classes Tailwind CSS de manière structurée pour créer et combiner des variantes.\n\n## Configuration du package\n\nNaviguez vers `packages\u002Fhuchet-vue` et installez les dépendances nécessaires :\n\n```bash [terminal]\ncd packages\u002Fhuchet-vue && pnpm add -D vue vite\n```\n\nEnsuite, créez un dossier `src` avec le composant `Button\u002FButton.vue` :\n\n```bash [Button\u002FButton.vue]\nmkdir -p src\u002FButton && touch src\u002FButton\u002FButton.vue\n```\n\nOuvrez le fichier `Button.vue` et commençons à écrire notre composant.\n\n## Écriture du composant bouton\n\nPour notre exemple, nous allons créer un bouton avec deux variantes : solide et contour. La variante solide aura une couleur de fond, tandis que la variante contour inclura une bordure.\n\nPour assurer l'absence de conflit de classes et simplifier le refactoring, la maintenabilité, la lisibilité et la structure, nous utiliserons Tailwind Variants. Nous allons organiser nos classes dans un objet, et Tailwind Variants appliquera les classes appropriées en fonction des props.\n\nAjoutez une balise `script` en haut du fichier `Button.vue` :\n\n```vue [Button.vue]\n\u003Cscript lang=\"ts\">\nimport type { VariantProps } from 'tailwind-variants'\nimport { tv } from 'tailwind-variants'\n\u003C\u002Fscript>\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"primary\"}\nNe pas ajouter l'attribut `setup`. Cette omission est volontaire.\n::\n\nLa fonction `tv` est un helper pour organiser les classes. Elle accepte un objet avec des clés `base` et `variants`. Le `base` est une chaîne de classes partagées, tandis que `variants` est un enregistrement avec des clés de variante et des valeurs de classe.\n\n```vue [Exemple]\n\u003Cscript lang=\"ts\">\n\u002F\u002F ...\n\nconst button = tv({\n  base: 'border-2 px-2.5 py-1.5 text-sm font-semibold focus:outline-none focus-visible:ring-2 focus-visible:ring-offset-2',\n  variants: {\n    variant: {\n      solid: 'border-transparent bg-blue-500 text-white hover:bg-blue-600 active:bg-blue-700',\n      outline: 'border-blue-500 text-blue-500 hover:bg-blue-50 active:bg-blue-100',\n    }\n  }\n})\n\u003C\u002Fscript>\n```\n\nDans la clé `variants`, vous pourriez également inclure d'autres clés comme `size` avec des variantes `sm` et `md`.\n\nEnsuite, extrayez les variantes pour les utiliser dans les props de notre composant :\n\n```vue [Exemple]\n\u003Cscript lang=\"ts\">\n\u002F\u002F ...\n\ntype ButtonVariantProps = VariantProps\u003Ctypeof button>\n\nexport interface ButtonProps {\n  label?: string\n  variant?: ButtonVariantProps['variant']\n}\n\u003C\u002Fscript>\n```\n\nOuvrez ensuite une nouvelle balise `script` avec l'attribut `setup` :\n\n```vue [Exemple]\n\u003Cscript setup lang=\"ts\">\nwithDefaults(defineProps\u003CButtonProps>(), {\n  variant: 'solid',\n})\n\u003C\u002Fscript>\n```\n\nNous avons divisé la balise `script` en deux parties pour permettre des exports nommés. L'interface `ButtonProps` est utilisée dans la fonction `defineProps` et est exportée afin que les développeurs puissent l'étendre pour créer un nouveau composant. Ce détail est crucial pour construire une **bibliothèque de composants** robuste.\n\nAjoutez le template du composant :\n\n```vue [Exemple]\n\u003Ctemplate>\n  \u003Cbutton :class=\"button({ variant })\">\n    \u003Cslot>\n      {{ label }}\n    \u003C\u002Fslot>\n  \u003C\u002Fbutton>\n\u003C\u002Ftemplate>\n```\n\nNotre composant est prêt à être utilisé :\n\n```html [Exemple]\n\u003CButton variant=\"outline\" label=\"Cliquez moi\" \u002F>\n```\n\nCependant, il n'est pas utilisable tant que nous n'avons pas construit notre bibliothèque de composants.\n\n## Construction de la bibliothèque de composants\n\nEnsuite, nous allons construire la bibliothèque de composants. Commencez par créer un fichier `vite.config.ts` à la racine du package `huchet-vue` :\n\n```bash [vite.config.ts]\ntouch vite.config.ts\n```\n\nCette configuration indique à **Vite** comment transpiler nos composants **Vue.js** en JavaScript pour être utilisé dans d'autres projets. Par défaut, **Vite** est conçu pour les applications web, pas pour les bibliothèques, donc nous allons l'ajuster à nos besoins.\n\nInstallez le plugin :\n\n```bash [terminal]\npnpm add -D @vitejs\u002Fplugin-vue\n```\n\nModifiez le fichier `vite.config.ts` avec la configuration suivante :\n\n```ts [vite.config.ts]\nimport Vue from '@vitejs\u002Fplugin-vue'\nimport { defineConfig } from 'vite'\n\nexport default defineConfig({\n  plugins: [Vue()],\n  build: {\n    lib: {\n      formats: ['es'],\n      name: 'huchet-vue',\n      fileName: (_, name) => `${name}.mjs`,\n      entry: {\n        index: resolve(__dirname, 'src\u002Findex.ts'),\n      },\n    },\n    rollupOptions: {\n      external: ['vue', 'tailwind-variants'],\n    },\n  },\n})\n```\n\nNous choisissons de ne pas inclure Vue.js et Tailwind Variants dans le bundle final pour plus de flexibilité, permettant aux utilisateurs d'utiliser leurs propres versions. Cela évite également la duplication dans le bundle final si l'utilisateur a déjà ces dépendances.\n\nAjoutez-les comme dépendances peer :\n\n```bash [terminal]\npnpm add --save-peer vue tailwind-variants\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nUne dépendance peer n'est pas installée par le package mais doit être présente dans le projet de l'utilisateur. Cette flexibilité est particulièrement utile lorsqu'un package peut fonctionner dans des contextes variés.\n::\n\nCréez le fichier `src\u002Findex.ts`, comme mentionné dans `vite.config.ts` :\n\n```bash [vite.config.ts]\ntouch src\u002Findex.ts\n```\n\nCe fichier exporte tous les composants de la bibliothèque :\n\n```ts [Exemple]\nexport * from '.\u002FButton'\n```\n\nCréez un nouveau `index.ts` au niveau du composant :\n\n```bash [index.ts]\ntouch src\u002FButton\u002Findex.ts\n```\n\nCe fichier sert d'API publique, exposant des éléments sélectionnés à l'utilisateur tout en gardant la structure interne cachée :\n\n```ts [Exemple]\nexport {\n  default as Button,\n  type ButtonProps\n} from '.\u002FButton.vue'\n```\n\nEnfin, construisez la bibliothèque :\n\n```bash [terminal]\npnpm run build\n```\n\nLa bibliothèque se compile sous le répertoire `dist` sous le nom `index.mjs`.\n\n## Exposition des composants\n\nNotre bibliothèque de composants est construite, mais pour être utilisable comme un package **npm**, nous devons définir certains champs dans le fichier `package.json`. Ces champs fournissent des informations cruciales à **Node** sur la façon dont notre package doit être chargé :\n\n```json [package.json]\n{\n  \"exports\": {\n    \".\": {\n      \"import\": \".\u002Fdist\u002Findex.mjs\"\n    }\n  },\n  \"main\": \".\u002Fdist\u002Findex.mjs\"\n}\n```\n\nSimple, non ? Le champ `exports` informe **Node** des imports disponibles pour notre package. Dans notre cas, nous n'avons qu'un seul import, la racine de notre package, et c'est le fichier `index.mjs` dans le dossier `dist`. Le champ `main` spécifie le point d'entrée de notre package. Ici, le point d'entrée est le fichier `index.mjs` situé dans le dossier `dist`.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nPuisque nous avons seulement un point d'entrée, nous pourrions nous fier uniquement au champ `main`. Cependant, il est bon de définir le champ `exports` pour garantir la compatibilité avec les versions passées de **Node** et préparer le support de points d'entrée multiples. Le champ `exports` est plus moderne et puissant que `main`.\n::\n\nDans le prochain article, nous ajouterons des **définitions de type** à notre bibliothèque de composants pour offrir une meilleure expérience aux développeurs.\n",{"title":5,"description":1273},"the-complete-guide-to-building-a-vue-js-component-library",{"loc":1276},"fr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fbuilding-a-first-component-with-vuejs-and-tailwind-css","JqAv16X4svvJ1iNStzK-nWcGsu-L5RWxcXbY12ach74",{"overview":1284,"chapters":1475},{"id":1285,"title":1286,"body":1287,"contentId":1460,"date":1272,"description":1461,"extension":393,"github":1462,"meetTheInstructor":1464,"meta":1465,"navigation":286,"part":1274,"path":1466,"rawbody":1467,"robots":1274,"schemaOrg":1274,"seo":1468,"seriesSlug":1279,"sitemap":1469,"stem":1470,"subtitle":1471,"topics":1472,"__hash__":1474},"series\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library.md","Guide pour construire une bibliothèque de composants Vue.js",{"type":7,"value":1288,"toc":1457},[1289,1292,1295,1307,1311,1314,1327,1330,1444,1447,1451],[10,1290,1291],{},"Bienvenue ! 👋",[10,1293,1294],{},"Au départ, cette série était censée être un seul article, mais il est rapidement devenu évident qu'elle serait trop longue. Même GitHub ne voulait pas l'afficher dans l'onglet des fichiers des pull requests. Par conséquent, j'ai décidé de la diviser en plusieurs articles pour la rendre plus digeste et pour me concentrer sur chaque partie individuellement.",[10,1296,1297,1298,1302,1303],{},"Cette série est en quelque sorte une suite de l'article ",[22,1299,1301],{"href":1300},"\u002Ffr\u002Fposts\u002Fthe-simplest-method-to-create-a-vue-js-component-library","La Méthode la Plus Simple pour Créer une Bibliothèque de Composants Vue.js",", mais elle adopte une approche plus professionnelle. ",[1304,1305,1306],"em",{},"Vous apprendrez comment les bibliothèques de composants les plus populaires sont construites dans les coulisses et comment créer la vôtre.",[1308,1309],"callout-read-more",{"id":1310},"75df6bff-de40-4056-af23-fae2401cd21a",[10,1312,1313],{},"Bien que ce soit toujours ma méthode préférée lorsque je suis certain de ce que je veux réaliser, j'ai également reçu des retours de lecteurs cherchant un comportement plus personnalisé et nécessitant des fonctionnalités plus complexes.",[10,1315,1316,1317,1322,1323,394],{},"C'est compréhensible. Bien que ",[22,1318,1321],{"href":1319,"rel":1320},"https:\u002F\u002Fgithub.com\u002Funjs\u002Funbuild",[26],"unbuild"," soit un outil puissant, il ne peut égaler la flexibilité, l'écosystème de plugins et l'adoption de ",[22,1324,743],{"href":1325,"rel":1326},"https:\u002F\u002Fvite.dev\u002F",[26],[10,1328,1329],{},"Tout au long de cette série, nous aborderons les sujets suivants :",[1331,1332,1333,1346,1373,1391,1408,1414,1426],"ol",{},[1334,1335,1336,1339,1340,1345],"li",{},[14,1337,1338],{},"Prise en Main avec Monorepo, Linter et Formatter"," : Nous mettrons en place un monorepo pour gérer notre bibliothèque de composants et tous les outils nécessaires pour garantir une bonne expérience de développement. Nous configurerons également ",[22,1341,1344],{"href":1342,"rel":1343},"https:\u002F\u002Feslint.org\u002F",[26],"ESLint"," pour assurer la cohérence du code.",[1334,1347,1348,1351,1352,878,1356,30,1359,1362,1363,30,1368,394],{},[14,1349,1350],{},"Création d'un Premier Composant avec Vue.js et Tailwind CSS"," : Nous créerons notre premier composant avec ",[22,1353,16],{"href":1354,"rel":1355},"https:\u002F\u002Fvuejs.org\u002F",[26],[22,1357,29],{"href":24,"rel":1358},[26],[22,1360,37],{"href":33,"rel":1361},[26]," en utilisant les techniques les plus avancées et puissantes employées dans des bibliothèques de composants populaires comme ",[22,1364,1367],{"href":1365,"rel":1366},"https:\u002F\u002Fwww.radix-vue.com\u002F",[26],"Radix Vue",[22,1369,1372],{"href":1370,"rel":1371},"https:\u002F\u002Fui.nuxt.com\u002F",[26],"Nuxt UI",[1334,1374,1375,1378,1379,1384,1385,1390],{},[14,1376,1377],{},"Une Meilleure Expérience de Développement avec TypeScript et TSConfig"," : Nous améliorerons notre expérience de développement en ajoutant ",[22,1380,1383],{"href":1381,"rel":1382},"https:\u002F\u002Fwww.typescriptlang.org\u002F",[26],"TypeScript"," à notre bibliothèque de composants et en configurant ",[22,1386,1389],{"href":1387,"rel":1388},"https:\u002F\u002Fwww.typescriptlang.org\u002Ftsconfig",[26],"TSConfig"," pour nous assurer que nos composants sont correctement typés et que nous pouvons tirer pleinement parti des fonctionnalités de TypeScript.",[1334,1392,1393,1396,1397,30,1402,1407],{},[14,1394,1395],{},"Tests Automatiques des Composants avec Vitest et Testing Library"," : Nous écrirons des tests pour nos composants en utilisant ",[22,1398,1401],{"href":1399,"rel":1400},"https:\u002F\u002Fvitest.dev\u002Fguide\u002F",[26],"Vitest",[22,1403,1406],{"href":1404,"rel":1405},"https:\u002F\u002Ftesting-library.com\u002F",[26],"Testing Library"," pour garantir que nos composants fonctionnent comme prévu. Cela est crucial pour une bibliothèque de composants professionnelle qui reste fiable dans le temps.",[1334,1409,1410,1413],{},[14,1411,1412],{},"Livraison Continue et Confiance dans les Composants"," : Nous établirons un processus d'intégration continue pour garantir que nos composants sont toujours livrés avec confiance. Pour chaque commit de chaque branche, nous exécuterons nos tests pour vérifier que tout fonctionne correctement. Nous établirons également un processus de publication pour publier nos composants sur npm.",[1334,1415,1416,1419,1420,1425],{},[14,1417,1418],{},"Création d'un Playground et d'un Storybook pour les Composants"," : Nous créerons un playground pour tester nos composants dans un environnement réel et un storybook avec ",[22,1421,1424],{"href":1422,"rel":1423},"https:\u002F\u002Fhistoire.dev\u002F",[26],"Histoire"," pour les documenter. Cela nous permettra de partager nos composants avec d'autres développeurs et de les tester dans divers scénarios, tant en isolation qu'en combinaison.",[1334,1427,1428,1431,1432,1437,1438,1443],{},[14,1429,1430],{},"Amélioration de l'Intégration avec Unplugin et le Module Nuxt"," : Nous améliorerons l'intégration de notre bibliothèque de composants avec l'écosystème en créant un plugin Vite avec ",[22,1433,1436],{"href":1434,"rel":1435},"https:\u002F\u002Fgithub.com\u002Funplugin\u002Funplugin-vue-components",[26],"Unplugin Vue Components"," et un ",[22,1439,1442],{"href":1440,"rel":1441},"https:\u002F\u002Fnuxt.com\u002Fdocs\u002Fguide\u002Fgoing-further\u002Fmodules",[26],"module Nuxt"," pour utiliser nos composants dans une application Nuxt.",[10,1445,1446],{},"À la fin de cette série, vous aurez une bibliothèque de composants Vue.js complète que vous pourrez utiliser dans vos projets ou partager avec la communauté, comme un développeur professionnel. N'est-ce pas excitant ? 😎",[40,1448,1450],{"id":1449},"chapitres","Chapitres",[1452,1453],"series-chapters-list",{"className":1454},[1455,1456],"mx-auto","max-w-5xl",{"title":59,"searchDepth":185,"depth":185,"links":1458},[1459],{"id":1449,"depth":185,"text":1450},"1fafed86-05bb-4de4-b7d0-bb0bd6abc9d2","Découvrez comment construire une bibliothèque de composants Vue.js en utilisant Vite avec un guide couvrant des techniques de développement web professionnel.",{"name":725,"repository":1463},"barbapapazes\u002Fhuchet-vue","J'ai créé cette série parce que j'aime \u003Cstrong>Vue.js\u003C\u002Fstrong> et que, depuis des années, je n'ai pas réussi à trouver un guide complet, à jour et \u003Cstrong>professionnel\u003C\u002Fstrong> sur la façon de construire une bibliothèque de composants Vue.js et que je veux que plus de développeurs de logiciels se sentent capables de créer leur propre bibliothèque.",{},"\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library","---\ncontentId: 1fafed86-05bb-4de4-b7d0-bb0bd6abc9d2\ntitle: Guide pour construire une bibliothèque de composants Vue.js\nsubtitle: Le cours le plus avancé et le plus professionnel pour créer une bibliothèque de composants Vue.js avec Vite.\ndescription: Découvrez comment construire une bibliothèque de composants Vue.js en utilisant Vite avec un guide couvrant des techniques de développement web professionnel.\ndate: 2024-11-24\ntopics:\n  - vue\n  - vite\n  - bibliothèque de composants\ngithub:\n  name: huchet-vue\n  repository: barbapapazes\u002Fhuchet-vue\nmeetTheInstructor: J'ai créé cette série parce que j'aime \u003Cstrong>Vue.js\u003C\u002Fstrong> et que, depuis des années, je n'ai pas réussi à trouver un guide complet, à jour et \u003Cstrong>professionnel\u003C\u002Fstrong> sur la façon de construire une bibliothèque de composants Vue.js et que je veux que plus de développeurs de logiciels se sentent capables de créer leur propre bibliothèque.\nseriesSlug: the-complete-guide-to-building-a-vue-js-component-library\n---\n\nBienvenue ! 👋\n\nAu départ, cette série était censée être un seul article, mais il est rapidement devenu évident qu'elle serait trop longue. Même GitHub ne voulait pas l'afficher dans l'onglet des fichiers des pull requests. Par conséquent, j'ai décidé de la diviser en plusieurs articles pour la rendre plus digeste et pour me concentrer sur chaque partie individuellement.\n\nCette série est en quelque sorte une suite de l'article [La Méthode la Plus Simple pour Créer une Bibliothèque de Composants Vue.js](\u002Ffr\u002Fposts\u002Fthe-simplest-method-to-create-a-vue-js-component-library), mais elle adopte une approche plus professionnelle. _Vous apprendrez comment les bibliothèques de composants les plus populaires sont construites dans les coulisses et comment créer la vôtre._\n\n\u003CCalloutReadMore id=\"75df6bff-de40-4056-af23-fae2401cd21a\" \u002F>\n\nBien que ce soit toujours ma méthode préférée lorsque je suis certain de ce que je veux réaliser, j'ai également reçu des retours de lecteurs cherchant un comportement plus personnalisé et nécessitant des fonctionnalités plus complexes.\n\nC'est compréhensible. Bien que [unbuild](https:\u002F\u002Fgithub.com\u002Funjs\u002Funbuild) soit un outil puissant, il ne peut égaler la flexibilité, l'écosystème de plugins et l'adoption de [Vite](https:\u002F\u002Fvite.dev\u002F).\n\nTout au long de cette série, nous aborderons les sujets suivants :\n\n1. **Prise en Main avec Monorepo, Linter et Formatter** : Nous mettrons en place un monorepo pour gérer notre bibliothèque de composants et tous les outils nécessaires pour garantir une bonne expérience de développement. Nous configurerons également [ESLint](https:\u002F\u002Feslint.org\u002F) pour assurer la cohérence du code.\n2. **Création d'un Premier Composant avec Vue.js et Tailwind CSS** : Nous créerons notre premier composant avec [Vue.js](https:\u002F\u002Fvuejs.org\u002F), [Tailwind CSS](https:\u002F\u002Ftailwindcss.com\u002F) et [Tailwind Variants](https:\u002F\u002Fwww.tailwind-variants.org\u002F) en utilisant les techniques les plus avancées et puissantes employées dans des bibliothèques de composants populaires comme [Radix Vue](https:\u002F\u002Fwww.radix-vue.com\u002F) et [Nuxt UI](https:\u002F\u002Fui.nuxt.com\u002F).\n3. **Une Meilleure Expérience de Développement avec TypeScript et TSConfig** : Nous améliorerons notre expérience de développement en ajoutant [TypeScript](https:\u002F\u002Fwww.typescriptlang.org\u002F) à notre bibliothèque de composants et en configurant [TSConfig](https:\u002F\u002Fwww.typescriptlang.org\u002Ftsconfig) pour nous assurer que nos composants sont correctement typés et que nous pouvons tirer pleinement parti des fonctionnalités de TypeScript.\n4. **Tests Automatiques des Composants avec Vitest et Testing Library** : Nous écrirons des tests pour nos composants en utilisant [Vitest](https:\u002F\u002Fvitest.dev\u002Fguide\u002F) et [Testing Library](https:\u002F\u002Ftesting-library.com\u002F) pour garantir que nos composants fonctionnent comme prévu. Cela est crucial pour une bibliothèque de composants professionnelle qui reste fiable dans le temps.\n5. **Livraison Continue et Confiance dans les Composants** : Nous établirons un processus d'intégration continue pour garantir que nos composants sont toujours livrés avec confiance. Pour chaque commit de chaque branche, nous exécuterons nos tests pour vérifier que tout fonctionne correctement. Nous établirons également un processus de publication pour publier nos composants sur npm.\n6. **Création d'un Playground et d'un Storybook pour les Composants** : Nous créerons un playground pour tester nos composants dans un environnement réel et un storybook avec [Histoire](https:\u002F\u002Fhistoire.dev\u002F) pour les documenter. Cela nous permettra de partager nos composants avec d'autres développeurs et de les tester dans divers scénarios, tant en isolation qu'en combinaison.\n7. **Amélioration de l'Intégration avec Unplugin et le Module Nuxt** : Nous améliorerons l'intégration de notre bibliothèque de composants avec l'écosystème en créant un plugin Vite avec [Unplugin Vue Components](https:\u002F\u002Fgithub.com\u002Funplugin\u002Funplugin-vue-components) et un [module Nuxt](https:\u002F\u002Fnuxt.com\u002Fdocs\u002Fguide\u002Fgoing-further\u002Fmodules) pour utiliser nos composants dans une application Nuxt.\n\nÀ la fin de cette série, vous aurez une bibliothèque de composants Vue.js complète que vous pourrez utiliser dans vos projets ou partager avec la communauté, comme un développeur professionnel. N'est-ce pas excitant ? 😎\n\n## Chapitres\n\n::series-chapters-list\n---\nclass: mx-auto max-w-5xl\n---\n::\n",{"title":1286,"description":1461},{"loc":1466},"fr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library","Le cours le plus avancé et le plus professionnel pour créer une bibliothèque de composants Vue.js avec Vite.",[160,1473,592],"vite","uPZbK53-TcUyWNHiN_UucohLqZHXH1ZV1Tpgk8hOc5c",[1476,1481,1482,1487,1492,1497,1502],{"contentId":1477,"title":1478,"description":1479,"path":1480,"part":66,"github":1274,"topics":1274},"bd5d11e9-876b-4ed0-b27b-ba400670de76","Bien démarrer avec un monorepo, un linter et un formatter","Commencez votre aventure avec le monorepo ! Apprenez à configurer un linter et un formatter pour un codage rationalisé et l'organisation de votre projet.","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fgetting-started-with-monorepo-linter-and-formatter",{"contentId":1271,"title":5,"description":1273,"path":1276,"part":185,"github":1274,"topics":1274},{"contentId":1483,"title":1484,"description":1485,"path":1486,"part":204,"github":1274,"topics":1274},"09cf0b6c-6e56-4718-85d2-784fc0337ebd","Une meilleure expérience avec TypeScript et TSConfig","Apprenez à configurer TypeScript avec plusieurs contextes et à générer des types pour une bibliothèque afin d'exposer des types aux développeurs.","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fa-better-development-experience-with-typescript-and-tsconfig",{"contentId":1488,"title":1489,"description":1490,"path":1491,"part":216,"github":1274,"topics":1274},"ebf9971d-0101-4d55-815b-87be77651be6","Test de composants automatisé avec Vitest et Testing Library","Apprenez à automatiser les tests pour les composants Vue.js en utilisant Vitest et Testing Library pour des tests efficaces et centrés sur l'utilisateur.","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fautomatic-component-testing-with-vitest-and-testing-library",{"contentId":1493,"title":1494,"description":1495,"path":1496,"part":307,"github":1274,"topics":1274},"e3477b60-7fca-49d3-a944-2bde3f39a3c1","Intégration continue et livraison simplifiée des composants","Implémentez un pipeline d'intégration continue avec GitHub Actions et automatisez le processus de publication sur npm","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fdelivering-components-continuously-and-with-confidence",{"contentId":1498,"title":1499,"description":1500,"path":1501,"part":319,"github":1274,"topics":1274},"0d31ab1a-2cc6-44d0-bdf5-31a5ecacd755","Créer un Playground et un Storybook pour les Composants","Découvrez comment créer un playground et utiliser Histoire pour visualiser et documenter vos composants dans des scénarios isolés et combinés.","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fcreating-a-playground-and-a-storybook-for-components",{"contentId":1503,"title":1504,"description":1505,"path":1506,"part":325,"github":1274,"topics":1274},"aa563897-2826-4726-bdaf-4441199328d8","Améliorer l'intégration avec Unplugin et Nuxt Module","Découvrez comment intégrer sans effort une bibliothèque de composants Vue.js en utilisant Unplugin Vue Components et Nuxt Module.","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fenhancing-integration-with-unplugin-and-nuxt-module",1795016703192]