[{"data":1,"prerenderedAt":2232},["ShallowReactive",2],{"series-\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fcreating-a-playground-and-a-storybook-for-components":3,"series-context-\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library":2007},{"id":4,"title":5,"body":6,"contentId":1989,"date":1990,"description":1991,"extension":1992,"github":1993,"meetTheInstructor":1993,"meta":1994,"navigation":373,"part":387,"path":1995,"rawbody":1996,"robots":1993,"schemaOrg":1993,"seo":1997,"seriesSlug":1998,"sitemap":1999,"stem":2005,"subtitle":1993,"topics":1993,"__hash__":2006},"series\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fcreating-a-playground-and-a-storybook-for-components.md","Créer un Playground et un Storybook pour les Composants",{"type":7,"value":8,"toc":1979},"minimark",[9,18,38,43,50,73,80,113,120,131,167,170,182,185,234,263,266,281,288,298,302,305,316,465,468,480,483,495,507,510,521,525,528,534,540,561,568,661,668,686,689,697,701,708,723,728,734,737,767,775,778,796,799,828,833,843,856,859,898,1149,1163,1169,1207,1215,1221,1286,1289,1299,1307,1311,1321,1333,1336,1350,1363,1585,1593,1596,1604,1612,1616,1619,1624,1636,1650,1728,1758,1763,1775,1778,1803,1809,1898,1907,1967,1972,1975],[10,11,12,13,17],"p",{},"Nous avons des composants et des tests, mais jusqu'à présent, nous n'avons pas pu les voir en action. Il est temps de créer un ",[14,15,16],"strong",{},"playground"," pour deux raisons principales :",[19,20,21,28],"ol",{},[22,23,24,27],"li",{},[14,25,26],{},"Tests"," : Nous devons tester nos composants dans un environnement réel pour nous assurer qu'ils fonctionnent comme prévu. Écrire une page avec tous les composants, leurs props et slots aide à créer la meilleure API et à l'implémenter efficacement. Cette approche minimise les refactorisations fréquentes en fournissant une vue d'ensemble des composants.",[22,29,30,33,34,37],{},[14,31,32],{},"Visualisation"," : La visualisation des composants est essentielle. Bien que ",[14,35,36],{},"Tailwind CSS"," simplifie le style, il est impossible de bien saisir un composant par le code, en particulier les composants complexes avec de nombreuses variantes ou slots. Un playground nous permet de voir les composants en action et de les tester dans divers scénarios.",[39,40,42],"h2",{"id":41},"configuration-du-playground","Configuration du playground",[10,44,45,46,49],{},"Tout d'abord, créez un nouveau dossier nommé ",[47,48,16],"code",{}," à la racine de votre projet.",[51,52,58],"pre",{"className":53,"code":54,"filename":55,"language":56,"meta":57,"style":57},"language-bash shiki shiki-themes github-light github-light github-dark","mkdir playground\n","terminal","bash","",[47,59,60],{"__ignoreMap":57},[61,62,65,69],"span",{"class":63,"line":64},"line",1,[61,66,68],{"class":67},"snPdu","mkdir",[61,70,72],{"class":71},"sIIMD"," playground\n",[10,74,75,76,79],{},"Ensuite, créez un nouveau projet ",[14,77,78],{},"Vite"," dans ce dossier, qui dépendra de notre bibliothèque de composants. Être dans un monorepo simplifie ce processus.",[51,81,83],{"className":53,"code":82,"filename":55,"language":56,"meta":57,"style":57},"cd playground && pnpm create vite --template vue-ts\n",[47,84,85],{"__ignoreMap":57},[61,86,87,91,94,98,101,104,107,110],{"class":63,"line":64},[61,88,90],{"class":89},"sBjJW","cd",[61,92,93],{"class":71}," playground",[61,95,97],{"class":96},"sxrX7"," && ",[61,99,100],{"class":67},"pnpm",[61,102,103],{"class":71}," create",[61,105,106],{"class":71}," vite",[61,108,109],{"class":89}," --template",[61,111,112],{"class":71}," vue-ts\n",[10,114,115,116,119],{},"Nommez ce projet ",[47,117,118],{},"vue",".",[10,121,122,123,126,127,130],{},"Avant d'installer les dépendances, mettez à jour le ",[47,124,125],{},"pnpm-workspace.yaml"," pour inclure le package ",[47,128,129],{},"playground\u002Fvue",". Cela permet au playground d'accéder à la bibliothèque de composants.",[51,132,136],{"className":133,"code":134,"filename":125,"language":135,"meta":57,"style":57},"language-yaml shiki shiki-themes github-light github-light github-dark has-diff","packages:\n  - 'packages\u002F*'\n  - 'playground\u002F*' # [!code ++]\n","yaml",[47,137,138,147,156],{"__ignoreMap":57},[61,139,140,144],{"class":63,"line":64},[61,141,143],{"class":142},"sovSZ","packages",[61,145,146],{"class":96},":\n",[61,148,150,153],{"class":63,"line":149},2,[61,151,152],{"class":96},"  - ",[61,154,155],{"class":71},"'packages\u002F*'\n",[61,157,162,164],{"class":158,"line":161},[63,159,160],"diff","add",3,[61,163,152],{"class":96},[61,165,166],{"class":71},"'playground\u002F*'",[10,168,169],{},"Installez les dépendances du playground :",[51,171,173],{"className":53,"code":172,"filename":55,"language":56,"meta":57,"style":57},"pnpm install\n",[47,174,175],{"__ignoreMap":57},[61,176,177,179],{"class":63,"line":64},[61,178,100],{"class":67},[61,180,181],{"class":71}," install\n",[10,183,184],{},"Dans ce playground Vue.js, supprimez les fichiers, dossiers et contenus inutiles :",[51,186,188],{"className":53,"code":187,"filename":55,"language":56,"meta":57,"style":57},"rm -rf .vscode .public src\u002F{assets,components}\necho \"\u003Ctemplate>\u003C\u002Ftemplate>\" > src\u002FApp.vue\necho \"\" > src\u002Fstyle.css\n",[47,189,190,207,222],{"__ignoreMap":57},[61,191,192,195,198,201,204],{"class":63,"line":64},[61,193,194],{"class":67},"rm",[61,196,197],{"class":89}," -rf",[61,199,200],{"class":71}," .vscode",[61,202,203],{"class":71}," .public",[61,205,206],{"class":71}," src\u002F{assets,components}\n",[61,208,209,212,215,219],{"class":63,"line":149},[61,210,211],{"class":89},"echo",[61,213,214],{"class":71}," \"\u003Ctemplate>\u003C\u002Ftemplate>\"",[61,216,218],{"class":217},"s8jYJ"," >",[61,220,221],{"class":71}," src\u002FApp.vue\n",[61,223,224,226,229,231],{"class":63,"line":161},[61,225,211],{"class":89},[61,227,228],{"class":71}," \"\"",[61,230,218],{"class":217},[61,232,233],{"class":71}," src\u002Fstyle.css\n",[10,235,236,237,240,241,244,245,248,249,252,253,256,257,248,260,119],{},"Supprimez le dossier ",[47,238,239],{},".vscode",", le dossier ",[47,242,243],{},"public",", les dossiers ",[47,246,247],{},"assets"," et ",[47,250,251],{},"components"," dans ",[47,254,255],{},"src",", ainsi que le contenu de ",[47,258,259],{},"App.vue",[47,261,262],{},"style.css",[10,264,265],{},"Maintenant, installez la bibliothèque de composants dans le playground :",[51,267,269],{"className":53,"code":268,"filename":262,"language":56,"meta":57,"style":57},"pnpm add ..\u002F..\u002Fpackages\u002Fhuchet-vue\n",[47,270,271],{"__ignoreMap":57},[61,272,273,275,278],{"class":63,"line":64},[61,274,100],{"class":67},[61,276,277],{"class":71}," add",[61,279,280],{"class":71}," ..\u002F..\u002Fpackages\u002Fhuchet-vue\n",[10,282,283,284,287],{},"Cette commande installe la bibliothèque de composants en créant un lien symbolique vers celle-ci dans ",[47,285,286],{},"node_modules",". Ainsi, toute importation effectuée dans le playground résout la bibliothèque de composants dans le monorepo, permettant des modifications en temps réel pendant le développement.",[10,289,290,291,294,295,297],{},"Démarrez le script de surveillance dans le dossier du package ",[47,292,293],{},"huchet-vue"," et le script de développement dans le dossier ",[47,296,129],{},". Tout changement dans la bibliothèque de composants se reflétera dans le playground.",[39,299,301],{"id":300},"utilisation-du-playground","Utilisation du playground",[10,303,304],{},"Avec la bibliothèque de composants installée dans le playground, vous pouvez commencer à l'utiliser.",[10,306,307,308,311,312,315],{},"Dans le fichier ",[47,309,310],{},"src\u002FApp.vue",", importez le composant ",[47,313,314],{},"Button"," et utilisez-le :",[51,317,320],{"className":318,"code":319,"filename":310,"language":118,"meta":57,"style":57},"language-vue shiki shiki-themes github-light github-light github-dark","\u003Cscript lang=\"ts\" setup>\nimport { Button } from '@barbapapazes\u002Fhuchet-vue'\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003Cdiv class=\"flex gap-6 p-6\">\n    \u003CButton label=\"Hello World\" \u002F>\n    \u003CButton label=\"Hello World\" variant=\"outline\" \u002F>\n  \u003C\u002Fdiv>\n\u003C\u002Ftemplate>\n",[47,321,322,345,359,368,375,385,404,423,446,456],{"__ignoreMap":57},[61,323,324,327,330,333,336,339,342],{"class":63,"line":64},[61,325,326],{"class":96},"\u003C",[61,328,329],{"class":142},"script",[61,331,332],{"class":67}," lang",[61,334,335],{"class":96},"=",[61,337,338],{"class":71},"\"ts\"",[61,340,341],{"class":67}," setup",[61,343,344],{"class":96},">\n",[61,346,347,350,353,356],{"class":63,"line":149},[61,348,349],{"class":217},"import",[61,351,352],{"class":96}," { Button } ",[61,354,355],{"class":217},"from",[61,357,358],{"class":71}," '@barbapapazes\u002Fhuchet-vue'\n",[61,360,361,364,366],{"class":63,"line":161},[61,362,363],{"class":96},"\u003C\u002F",[61,365,329],{"class":142},[61,367,344],{"class":96},[61,369,371],{"class":63,"line":370},4,[61,372,374],{"emptyLinePlaceholder":373},true,"\n",[61,376,378,380,383],{"class":63,"line":377},5,[61,379,326],{"class":96},[61,381,382],{"class":142},"template",[61,384,344],{"class":96},[61,386,388,391,394,397,399,402],{"class":63,"line":387},6,[61,389,390],{"class":96},"  \u003C",[61,392,393],{"class":142},"div",[61,395,396],{"class":67}," class",[61,398,335],{"class":96},[61,400,401],{"class":71},"\"flex gap-6 p-6\"",[61,403,344],{"class":96},[61,405,407,410,412,415,417,420],{"class":63,"line":406},7,[61,408,409],{"class":96},"    \u003C",[61,411,314],{"class":142},[61,413,414],{"class":67}," label",[61,416,335],{"class":96},[61,418,419],{"class":71},"\"Hello World\"",[61,421,422],{"class":96}," \u002F>\n",[61,424,426,428,430,432,434,436,439,441,444],{"class":63,"line":425},8,[61,427,409],{"class":96},[61,429,314],{"class":142},[61,431,414],{"class":67},[61,433,335],{"class":96},[61,435,419],{"class":71},[61,437,438],{"class":67}," variant",[61,440,335],{"class":96},[61,442,443],{"class":71},"\"outline\"",[61,445,422],{"class":96},[61,447,449,452,454],{"class":63,"line":448},9,[61,450,451],{"class":96},"  \u003C\u002F",[61,453,393],{"class":142},[61,455,344],{"class":96},[61,457,459,461,463],{"class":63,"line":458},10,[61,460,363],{"class":96},[61,462,382],{"class":142},[61,464,344],{"class":96},[10,466,467],{},"Pour voir le résultat, démarrez Vite dans le playground :",[51,469,471],{"className":53,"code":470,"filename":55,"language":56,"meta":57,"style":57},"pnpm dev\n",[47,472,473],{"__ignoreMap":57},[61,474,475,477],{"class":63,"line":64},[61,476,100],{"class":67},[61,478,479],{"class":71}," dev\n",[10,481,482],{},"Ensuite, démarrez Vite dans la bibliothèque de composants :",[51,484,486],{"className":53,"code":485,"filename":55,"language":56,"meta":57,"style":57},"pnpm watch\n",[47,487,488],{"__ignoreMap":57},[61,489,490,492],{"class":63,"line":64},[61,491,100],{"class":67},[61,493,494],{"class":71}," watch\n",[496,497,500],"callout",{"color":498,"icon":499},"primary","i-ph-info-duotone",[10,501,502,503,506],{},"Plus votre bibliothèque contient de composants, plus il faudra de temps pour refléter les changements dans le playground. Si cela commence à ralentir, envisagez d'importer directement le composant depuis la bibliothèque avec un chemin relatif ou d'utiliser un storybook comme ",[14,504,505],{},"Histoire",", que nous allons aborder ensuite.",[10,508,509],{},"Dans votre navigateur, vous devriez voir deux boutons, non stylisés.",[511,512,513,518],"figure",{},[514,515],"img",{"alt":516,"src":517},"Deux boutons, non stylisés.","\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fcreating-a-playground-and-a-storybook-for-components\u002Ftwo-buttons-unstyled.png",[519,520,516],"figcaption",{},[39,522,524],{"id":523},"styliser-le-playground","Styliser le playground",[10,526,527],{},"Nos composants sont non stylisés. Pour réduire la taille du bundle et permettre la génération côté utilisateur, nous ne fournissons pas de CSS avec la bibliothèque de composants.",[496,529,531],{"color":530,"icon":499},"info",[10,532,533],{},"Nous pourrions expédier une configuration Tailwind CSS avec la bibliothèque de composants pour garantir que les composants sont correctement stylés dans le playground.",[10,535,536,537,539],{},"Nous allons utiliser ",[14,538,36],{}," 4, même s'il n'est pas encore sorti, car il est accompagné d'un plugin Vite qui simplifie son utilisation et aucun autre changement cassant n'est attendue.",[51,541,543],{"className":53,"code":542,"filename":55,"language":56,"meta":57,"style":57},"pnpm i -D tailwindcss@next @tailwindcss\u002Fvite@next\n",[47,544,545],{"__ignoreMap":57},[61,546,547,549,552,555,558],{"class":63,"line":64},[61,548,100],{"class":67},[61,550,551],{"class":71}," i",[61,553,554],{"class":89}," -D",[61,556,557],{"class":71}," tailwindcss@next",[61,559,560],{"class":71}," @tailwindcss\u002Fvite@next\n",[10,562,563,564,567],{},"Ensuite, enregistrez le plugin Tailwind CSS dans le fichier ",[47,565,566],{},"vite.config.ts"," :",[51,569,573],{"className":570,"code":571,"filename":566,"language":572,"meta":57,"style":57},"language-ts shiki shiki-themes github-light github-light github-dark has-diff","import Tailwindcss from '@tailwindcss\u002Fvite'\nimport Vue from '@vitejs\u002Fplugin-vue'\nimport { defineConfig } from 'vite'\n\nexport default defineConfig({\n  plugins: [\n    Vue(),\n    Tailwindcss(), \u002F\u002F [!code ++]\n  ],\n})\n","ts",[47,574,575,587,599,611,615,629,634,642,651,656],{"__ignoreMap":57},[61,576,577,579,582,584],{"class":63,"line":64},[61,578,349],{"class":217},[61,580,581],{"class":96}," Tailwindcss ",[61,583,355],{"class":217},[61,585,586],{"class":71}," '@tailwindcss\u002Fvite'\n",[61,588,589,591,594,596],{"class":63,"line":149},[61,590,349],{"class":217},[61,592,593],{"class":96}," Vue ",[61,595,355],{"class":217},[61,597,598],{"class":71}," '@vitejs\u002Fplugin-vue'\n",[61,600,601,603,606,608],{"class":63,"line":161},[61,602,349],{"class":217},[61,604,605],{"class":96}," { defineConfig } ",[61,607,355],{"class":217},[61,609,610],{"class":71}," 'vite'\n",[61,612,613],{"class":63,"line":370},[61,614,374],{"emptyLinePlaceholder":373},[61,616,617,620,623,626],{"class":63,"line":377},[61,618,619],{"class":217},"export",[61,621,622],{"class":217}," default",[61,624,625],{"class":67}," defineConfig",[61,627,628],{"class":96},"({\n",[61,630,631],{"class":63,"line":387},[61,632,633],{"class":96},"  plugins: [\n",[61,635,636,639],{"class":63,"line":406},[61,637,638],{"class":67},"    Vue",[61,640,641],{"class":96},"(),\n",[61,643,645,648],{"class":644,"line":425},[63,159,160],[61,646,647],{"class":67},"    Tailwindcss",[61,649,650],{"class":96},"(), ",[61,652,653],{"class":63,"line":448},[61,654,655],{"class":96},"  ],\n",[61,657,658],{"class":63,"line":458},[61,659,660],{"class":96},"})\n",[10,662,663,664,667],{},"Dans le ",[47,665,666],{},"src\u002Fstyle.css",", importez les styles Tailwind CSS :",[51,669,673],{"className":670,"code":671,"filename":666,"language":672,"meta":57,"style":57},"language-css shiki shiki-themes github-light github-light github-dark","@import \"tailwindcss\";\n","css",[47,674,675],{"__ignoreMap":57},[61,676,677,680,683],{"class":63,"line":64},[61,678,679],{"class":217},"@import",[61,681,682],{"class":71}," \"tailwindcss\"",[61,684,685],{"class":96},";\n",[10,687,688],{},"Automatiquement, les boutons sont stylés comme prévu.",[511,690,691,695],{},[514,692],{"alt":693,"src":694},"Deux boutons, stylisés.","\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fcreating-a-playground-and-a-storybook-for-components\u002Ftwo-buttons-styled.png",[519,696,693],{},[39,698,700],{"id":699},"le-storybook-histoire","Le Storybook Histoire",[10,702,703,704,707],{},"Parfois, un playground ne suffit pas. Vous avez besoin de documenter vos composants, de les visualiser dans divers scénarios et de les isoler pour vous assurer que les problèmes proviennent du composant et non de l'intégration. C'est ici qu'un ",[14,705,706],{},"storybook"," entre en jeu.",[10,709,536,710,718,719,722],{},[711,712,716],"a",{"href":713,"rel":714},"https:\u002F\u002Fhistoire.dev\u002F",[715],"nofollow",[14,717,505],{},", un outil similaire à ",[14,720,721],{},"Storybook"," qui est léger, basé sur Vite et optimisé pour Vue.js.",[724,725,727],"h3",{"id":726},"configuration-de-histoire","Configuration de Histoire",[10,729,730,731,733],{},"La configuration de Histoire est simple, surtout avec ",[14,732,36],{}," 4.",[10,735,736],{},"Tout d'abord, créez un nouveau dossier depuis la racine du projet :",[51,738,740],{"className":53,"code":739,"filename":55,"language":56,"meta":57,"style":57},"mkdir .histoire && cd .histoire && echo '{\\n\"name\": \"huchet-vue-histoire\",\\n\"private\": true\\n}' > package.json\n",[47,741,742],{"__ignoreMap":57},[61,743,744,746,749,751,753,755,757,759,762,764],{"class":63,"line":64},[61,745,68],{"class":67},[61,747,748],{"class":71}," .histoire",[61,750,97],{"class":96},[61,752,90],{"class":89},[61,754,748],{"class":71},[61,756,97],{"class":96},[61,758,211],{"class":89},[61,760,761],{"class":71}," '{\\n\"name\": \"huchet-vue-histoire\",\\n\"private\": true\\n}'",[61,763,218],{"class":217},[61,765,766],{"class":71}," package.json\n",[496,768,769],{"color":530,"icon":499},[10,770,771,772,774],{},"J'ai placé le dossier Histoire à la racine du projet au lieu du dossier ",[47,773,143],{}," car c'est un outil de développement, et non un package npm publiable.",[10,776,777],{},"Ajoutez le dossier au workspace :",[51,779,781],{"className":53,"code":780,"filename":55,"language":56,"meta":57,"style":57},"echo \"  - .histoire\" >> ..\u002Fpnpm-workspace.yaml\n",[47,782,783],{"__ignoreMap":57},[61,784,785,787,790,793],{"class":63,"line":64},[61,786,211],{"class":89},[61,788,789],{"class":71}," \"  - .histoire\"",[61,791,792],{"class":217}," >>",[61,794,795],{"class":71}," ..\u002Fpnpm-workspace.yaml\n",[10,797,798],{},"Installez Histoire et Tailwind CSS :",[51,800,802],{"className":53,"code":801,"filename":55,"language":56,"meta":57,"style":57},"pnpm i -D histoire @histoire\u002Fplugin-vue @vitejs\u002Fplugin-vue vue tailwindcss@next @tailwindcss\u002Fvite@next\n",[47,803,804],{"__ignoreMap":57},[61,805,806,808,810,812,815,818,821,824,826],{"class":63,"line":64},[61,807,100],{"class":67},[61,809,551],{"class":71},[61,811,554],{"class":89},[61,813,814],{"class":71}," histoire",[61,816,817],{"class":71}," @histoire\u002Fplugin-vue",[61,819,820],{"class":71}," @vitejs\u002Fplugin-vue",[61,822,823],{"class":71}," vue",[61,825,557],{"class":71},[61,827,560],{"class":71},[496,829,830],{"color":530,"icon":499},[10,831,832],{},"Nous installons maintenant Tailwind CSS car nous en aurons besoin, comme nous l'avons vu dans le playground.",[10,834,835,836,839,840,567],{},"Histoire utilise un fichier de configuration nommé ",[47,837,838],{},"histoire.config.ts",", que nous allons créer dans le dossier ",[47,841,842],{},".histoire",[51,844,846],{"className":53,"code":845,"filename":838,"language":56,"meta":57,"style":57},"touch histoire.config.ts\n",[47,847,848],{"__ignoreMap":57},[61,849,850,853],{"class":63,"line":64},[61,851,852],{"class":67},"touch",[61,854,855],{"class":71}," histoire.config.ts\n",[10,857,858],{},"La configuration comprend plusieurs clés :",[860,861,862,868,877,886,892],"ul",{},[22,863,864,867],{},[47,865,866],{},"plugins"," : Plugins pour Histoire, comme le plugin Vue Histoire.",[22,869,870,873,874,119],{},[47,871,872],{},"storyMatch"," : Fichiers à correspondre pour créer des histoires, comme les fichiers ",[47,875,876],{},"*.story.vue",[22,878,879,882,883,119],{},[47,880,881],{},"setupFile"," : Fichier de configuration à utiliser avec Histoire, où nous allons créer un ",[47,884,885],{},"setup.ts",[22,887,888,891],{},[47,889,890],{},"theme"," : Options de personnalisation comme le titre, le logo, le favicon pour l'interface Histoire.",[22,893,894,897],{},[47,895,896],{},"vite"," : Configuration Vite utilisant les plugins Vue et Tailwind CSS.",[51,899,902],{"className":900,"code":901,"filename":885,"language":572,"meta":57,"style":57},"language-ts shiki shiki-themes github-light github-light github-dark","import { resolve } from 'node:path'\nimport { HstVue } from '@histoire\u002Fplugin-vue'\nimport Tailwind from '@tailwindcss\u002Fvite'\nimport Vue from '@vitejs\u002Fplugin-vue'\nimport { defineConfig } from 'histoire'\n\nexport default defineConfig({\n  plugins: [HstVue()],\n\n  storyMatch: [\n    resolve(__dirname, '..\u002Fpackages\u002Fhuchet-vue\u002Fsrc\u002F**\u002F*.story.vue'),\n  ],\n\n  setupFile: resolve(__dirname, 'setup.ts'),\n\n  theme: {\n    title: 'Huchet Vue',\n  },\n\n  vite: {\n    plugins: [\n      Vue(),\n      Tailwind(),\n    ],\n    server: {\n      fs: {\n        allow: ['..'],\n      },\n    },\n  },\n})\n",[47,903,904,916,928,939,949,960,964,974,985,989,994,1009,1014,1019,1035,1040,1046,1058,1064,1069,1075,1081,1089,1097,1103,1109,1115,1127,1133,1139,1144],{"__ignoreMap":57},[61,905,906,908,911,913],{"class":63,"line":64},[61,907,349],{"class":217},[61,909,910],{"class":96}," { resolve } ",[61,912,355],{"class":217},[61,914,915],{"class":71}," 'node:path'\n",[61,917,918,920,923,925],{"class":63,"line":149},[61,919,349],{"class":217},[61,921,922],{"class":96}," { HstVue } ",[61,924,355],{"class":217},[61,926,927],{"class":71}," '@histoire\u002Fplugin-vue'\n",[61,929,930,932,935,937],{"class":63,"line":161},[61,931,349],{"class":217},[61,933,934],{"class":96}," Tailwind ",[61,936,355],{"class":217},[61,938,586],{"class":71},[61,940,941,943,945,947],{"class":63,"line":370},[61,942,349],{"class":217},[61,944,593],{"class":96},[61,946,355],{"class":217},[61,948,598],{"class":71},[61,950,951,953,955,957],{"class":63,"line":377},[61,952,349],{"class":217},[61,954,605],{"class":96},[61,956,355],{"class":217},[61,958,959],{"class":71}," 'histoire'\n",[61,961,962],{"class":63,"line":387},[61,963,374],{"emptyLinePlaceholder":373},[61,965,966,968,970,972],{"class":63,"line":406},[61,967,619],{"class":217},[61,969,622],{"class":217},[61,971,625],{"class":67},[61,973,628],{"class":96},[61,975,976,979,982],{"class":63,"line":425},[61,977,978],{"class":96},"  plugins: [",[61,980,981],{"class":67},"HstVue",[61,983,984],{"class":96},"()],\n",[61,986,987],{"class":63,"line":448},[61,988,374],{"emptyLinePlaceholder":373},[61,990,991],{"class":63,"line":458},[61,992,993],{"class":96},"  storyMatch: [\n",[61,995,997,1000,1003,1006],{"class":63,"line":996},11,[61,998,999],{"class":67},"    resolve",[61,1001,1002],{"class":96},"(__dirname, ",[61,1004,1005],{"class":71},"'..\u002Fpackages\u002Fhuchet-vue\u002Fsrc\u002F**\u002F*.story.vue'",[61,1007,1008],{"class":96},"),\n",[61,1010,1012],{"class":63,"line":1011},12,[61,1013,655],{"class":96},[61,1015,1017],{"class":63,"line":1016},13,[61,1018,374],{"emptyLinePlaceholder":373},[61,1020,1022,1025,1028,1030,1033],{"class":63,"line":1021},14,[61,1023,1024],{"class":96},"  setupFile: ",[61,1026,1027],{"class":67},"resolve",[61,1029,1002],{"class":96},[61,1031,1032],{"class":71},"'setup.ts'",[61,1034,1008],{"class":96},[61,1036,1038],{"class":63,"line":1037},15,[61,1039,374],{"emptyLinePlaceholder":373},[61,1041,1043],{"class":63,"line":1042},16,[61,1044,1045],{"class":96},"  theme: {\n",[61,1047,1049,1052,1055],{"class":63,"line":1048},17,[61,1050,1051],{"class":96},"    title: ",[61,1053,1054],{"class":71},"'Huchet Vue'",[61,1056,1057],{"class":96},",\n",[61,1059,1061],{"class":63,"line":1060},18,[61,1062,1063],{"class":96},"  },\n",[61,1065,1067],{"class":63,"line":1066},19,[61,1068,374],{"emptyLinePlaceholder":373},[61,1070,1072],{"class":63,"line":1071},20,[61,1073,1074],{"class":96},"  vite: {\n",[61,1076,1078],{"class":63,"line":1077},21,[61,1079,1080],{"class":96},"    plugins: [\n",[61,1082,1084,1087],{"class":63,"line":1083},22,[61,1085,1086],{"class":67},"      Vue",[61,1088,641],{"class":96},[61,1090,1092,1095],{"class":63,"line":1091},23,[61,1093,1094],{"class":67},"      Tailwind",[61,1096,641],{"class":96},[61,1098,1100],{"class":63,"line":1099},24,[61,1101,1102],{"class":96},"    ],\n",[61,1104,1106],{"class":63,"line":1105},25,[61,1107,1108],{"class":96},"    server: {\n",[61,1110,1112],{"class":63,"line":1111},26,[61,1113,1114],{"class":96},"      fs: {\n",[61,1116,1118,1121,1124],{"class":63,"line":1117},27,[61,1119,1120],{"class":96},"        allow: [",[61,1122,1123],{"class":71},"'..'",[61,1125,1126],{"class":96},"],\n",[61,1128,1130],{"class":63,"line":1129},28,[61,1131,1132],{"class":96},"      },\n",[61,1134,1136],{"class":63,"line":1135},29,[61,1137,1138],{"class":96},"    },\n",[61,1140,1142],{"class":63,"line":1141},30,[61,1143,1063],{"class":96},[61,1145,1147],{"class":63,"line":1146},31,[61,1148,660],{"class":96},[10,1150,1151,1152,1155,1156,1158,1159,1162],{},"Puisque les histoires se trouvent dans la bibliothèque de composants, nous devons explicitement indiquer à Histoire de les chercher dans le dossier ",[47,1153,1154],{},"packages\u002Fhuchet-vue\u002Fsrc"," à l'aide de la clé ",[47,1157,872],{},". Pendant ce temps, nous permettons au serveur Histoire d'accéder au dossier parent via la clé ",[47,1160,1161],{},"server.fs.allow",", empêchant ainsi les problèmes d'accessibilité aux fichiers.",[10,1164,1165,1166,1168],{},"Pour implémenter Tailwind CSS dans Histoire, importez le CSS dans le fichier ",[47,1167,885],{},", de la même manière que dans le playground :",[51,1170,1172],{"className":53,"code":1171,"filename":885,"language":56,"meta":57,"style":57},"touch setup.ts style.css\necho \"import '.\u002Fstyle.css';\" > setup.ts\necho \"@import 'tailwindcss';\" > style.css\n",[47,1173,1174,1184,1196],{"__ignoreMap":57},[61,1175,1176,1178,1181],{"class":63,"line":64},[61,1177,852],{"class":67},[61,1179,1180],{"class":71}," setup.ts",[61,1182,1183],{"class":71}," style.css\n",[61,1185,1186,1188,1191,1193],{"class":63,"line":149},[61,1187,211],{"class":89},[61,1189,1190],{"class":71}," \"import '.\u002Fstyle.css';\"",[61,1192,218],{"class":217},[61,1194,1195],{"class":71}," setup.ts\n",[61,1197,1198,1200,1203,1205],{"class":63,"line":161},[61,1199,211],{"class":89},[61,1201,1202],{"class":71}," \"@import 'tailwindcss';\"",[61,1204,218],{"class":217},[61,1206,1183],{"class":71},[496,1208,1209],{"color":530,"icon":499},[10,1210,1211,1212,1214],{},"Le fichier ",[47,1213,885],{}," est exécuté au démarrage de Histoire et est un endroit idéal pour la personnalisation ou les styles globaux.",[10,1216,1217,1218,567],{},"Pour commencer avec Histoire, ajoutez trois scripts au ",[47,1219,1220],{},"package.json",[51,1222,1226],{"className":1223,"code":1224,"filename":1220,"language":1225,"meta":57,"style":57},"language-json shiki shiki-themes github-light github-light github-dark","{\n  \"scripts\": {\n    \"dev\": \"histoire dev\",\n    \"build\": \"histoire build\",\n    \"serve\": \"histoire serve\"\n  }\n}\n","json",[47,1227,1228,1233,1241,1254,1266,1276,1281],{"__ignoreMap":57},[61,1229,1230],{"class":63,"line":64},[61,1231,1232],{"class":96},"{\n",[61,1234,1235,1238],{"class":63,"line":149},[61,1236,1237],{"class":89},"  \"scripts\"",[61,1239,1240],{"class":96},": {\n",[61,1242,1243,1246,1249,1252],{"class":63,"line":161},[61,1244,1245],{"class":89},"    \"dev\"",[61,1247,1248],{"class":96},": ",[61,1250,1251],{"class":71},"\"histoire dev\"",[61,1253,1057],{"class":96},[61,1255,1256,1259,1261,1264],{"class":63,"line":370},[61,1257,1258],{"class":89},"    \"build\"",[61,1260,1248],{"class":96},[61,1262,1263],{"class":71},"\"histoire build\"",[61,1265,1057],{"class":96},[61,1267,1268,1271,1273],{"class":63,"line":377},[61,1269,1270],{"class":89},"    \"serve\"",[61,1272,1248],{"class":96},[61,1274,1275],{"class":71},"\"histoire serve\"\n",[61,1277,1278],{"class":63,"line":387},[61,1279,1280],{"class":96},"  }\n",[61,1282,1283],{"class":63,"line":406},[61,1284,1285],{"class":96},"}\n",[10,1287,1288],{},"Maintenant, nous pouvons démarrer Histoire :",[51,1290,1291],{"className":53,"code":470,"filename":55,"language":56,"meta":57,"style":57},[47,1292,1293],{"__ignoreMap":57},[61,1294,1295,1297],{"class":63,"line":64},[61,1296,100],{"class":67},[61,1298,479],{"class":71},[511,1300,1301,1305],{},[514,1302],{"alt":1303,"src":1304},"Histoire en cours d'exécution.","\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fcreating-a-playground-and-a-storybook-for-components\u002Fhistoire-running.png",[519,1306,1303],{},[724,1308,1310],{"id":1309},"création-dune-histoire","Création d'une histoire",[10,1312,1313,1314,1317,1318,567],{},"En revenant à ",[47,1315,1316],{},"packages\u002Fhuchet-vue",", nous pouvons créer notre premier fichier d'histoire, ",[47,1319,1320],{},"Button\u002FButton.story.vue",[51,1322,1324],{"className":53,"code":1323,"filename":1320,"language":56,"meta":57,"style":57},"touch src\u002FButton\u002FButton.story.vue\n",[47,1325,1326],{"__ignoreMap":57},[61,1327,1328,1330],{"class":63,"line":64},[61,1329,852],{"class":67},[61,1331,1332],{"class":71}," src\u002FButton\u002FButton.story.vue\n",[10,1334,1335],{},"Histoire propose des composants prédéfinis pour créer une histoire avec des variantes.",[19,1337,1338,1344],{},[22,1339,1340,1343],{},[47,1341,1342],{},"Story"," : Le composant principal pour créer une histoire.",[22,1345,1346,1349],{},[47,1347,1348],{},"Variant"," : Un composant pour créer une variante d'un composant au sein de l'histoire.",[10,1351,1352,1353,1356,1357,248,1360,119],{},"Dans notre scénario, nous créons une histoire dans ",[47,1354,1355],{},"Button.story.vue"," avec deux variantes : ",[47,1358,1359],{},"solid",[47,1361,1362],{},"outline",[51,1364,1366],{"className":318,"code":1365,"filename":1355,"language":118,"meta":57,"style":57},"\u003Cscript lang=\"ts\" setup>\nimport { logEvent } from 'histoire\u002Fclient'\nimport Button from '.\u002FButton.vue'\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003CStory>\n    \u003CVariant title=\"Solid\">\n      \u003CButton variant=\"solid\" label=\"Hello World\" @click=\"logEvent('Click', $event)\" \u002F>\n    \u003C\u002FVariant>\n    \u003CVariant title=\"Outline\">\n      \u003CButton variant=\"outline\" label=\"Hello World\" @click=\"logEvent('Click', $event)\" \u002F>\n    \u003C\u002FVariant>\n  \u003C\u002FStory>\n\u003C\u002Ftemplate>\n",[47,1367,1368,1384,1396,1408,1416,1420,1428,1436,1452,1499,1508,1523,1561,1569,1577],{"__ignoreMap":57},[61,1369,1370,1372,1374,1376,1378,1380,1382],{"class":63,"line":64},[61,1371,326],{"class":96},[61,1373,329],{"class":142},[61,1375,332],{"class":67},[61,1377,335],{"class":96},[61,1379,338],{"class":71},[61,1381,341],{"class":67},[61,1383,344],{"class":96},[61,1385,1386,1388,1391,1393],{"class":63,"line":149},[61,1387,349],{"class":217},[61,1389,1390],{"class":96}," { logEvent } ",[61,1392,355],{"class":217},[61,1394,1395],{"class":71}," 'histoire\u002Fclient'\n",[61,1397,1398,1400,1403,1405],{"class":63,"line":161},[61,1399,349],{"class":217},[61,1401,1402],{"class":96}," Button ",[61,1404,355],{"class":217},[61,1406,1407],{"class":71}," '.\u002FButton.vue'\n",[61,1409,1410,1412,1414],{"class":63,"line":370},[61,1411,363],{"class":96},[61,1413,329],{"class":142},[61,1415,344],{"class":96},[61,1417,1418],{"class":63,"line":377},[61,1419,374],{"emptyLinePlaceholder":373},[61,1421,1422,1424,1426],{"class":63,"line":387},[61,1423,326],{"class":96},[61,1425,382],{"class":142},[61,1427,344],{"class":96},[61,1429,1430,1432,1434],{"class":63,"line":406},[61,1431,390],{"class":96},[61,1433,1342],{"class":142},[61,1435,344],{"class":96},[61,1437,1438,1440,1442,1445,1447,1450],{"class":63,"line":425},[61,1439,409],{"class":96},[61,1441,1348],{"class":142},[61,1443,1444],{"class":67}," title",[61,1446,335],{"class":96},[61,1448,1449],{"class":71},"\"Solid\"",[61,1451,344],{"class":96},[61,1453,1454,1457,1459,1461,1463,1466,1468,1470,1472,1475,1478,1480,1483,1486,1489,1492,1495,1497],{"class":63,"line":448},[61,1455,1456],{"class":96},"      \u003C",[61,1458,314],{"class":142},[61,1460,438],{"class":67},[61,1462,335],{"class":96},[61,1464,1465],{"class":71},"\"solid\"",[61,1467,414],{"class":67},[61,1469,335],{"class":96},[61,1471,419],{"class":71},[61,1473,1474],{"class":96}," @",[61,1476,1477],{"class":67},"click",[61,1479,335],{"class":96},[61,1481,1482],{"class":71},"\"",[61,1484,1485],{"class":67},"logEvent",[61,1487,1488],{"class":96},"(",[61,1490,1491],{"class":71},"'Click'",[61,1493,1494],{"class":96},", $event)",[61,1496,1482],{"class":71},[61,1498,422],{"class":96},[61,1500,1501,1504,1506],{"class":63,"line":458},[61,1502,1503],{"class":96},"    \u003C\u002F",[61,1505,1348],{"class":142},[61,1507,344],{"class":96},[61,1509,1510,1512,1514,1516,1518,1521],{"class":63,"line":996},[61,1511,409],{"class":96},[61,1513,1348],{"class":142},[61,1515,1444],{"class":67},[61,1517,335],{"class":96},[61,1519,1520],{"class":71},"\"Outline\"",[61,1522,344],{"class":96},[61,1524,1525,1527,1529,1531,1533,1535,1537,1539,1541,1543,1545,1547,1549,1551,1553,1555,1557,1559],{"class":63,"line":1011},[61,1526,1456],{"class":96},[61,1528,314],{"class":142},[61,1530,438],{"class":67},[61,1532,335],{"class":96},[61,1534,443],{"class":71},[61,1536,414],{"class":67},[61,1538,335],{"class":96},[61,1540,419],{"class":71},[61,1542,1474],{"class":96},[61,1544,1477],{"class":67},[61,1546,335],{"class":96},[61,1548,1482],{"class":71},[61,1550,1485],{"class":67},[61,1552,1488],{"class":96},[61,1554,1491],{"class":71},[61,1556,1494],{"class":96},[61,1558,1482],{"class":71},[61,1560,422],{"class":96},[61,1562,1563,1565,1567],{"class":63,"line":1016},[61,1564,1503],{"class":96},[61,1566,1348],{"class":142},[61,1568,344],{"class":96},[61,1570,1571,1573,1575],{"class":63,"line":1021},[61,1572,451],{"class":96},[61,1574,1342],{"class":142},[61,1576,344],{"class":96},[61,1578,1579,1581,1583],{"class":63,"line":1037},[61,1580,363],{"class":96},[61,1582,382],{"class":142},[61,1584,344],{"class":96},[496,1586,1587],{"color":530,"icon":499},[10,1588,1589,1590,1592],{},"La fonction ",[47,1591,1485],{}," enregistre les événements dans l'interface, aidant les développeurs à comprendre la sortie du composant.",[10,1594,1595],{},"Et cela fonctionne !",[511,1597,1598,1602],{},[514,1599],{"alt":1600,"src":1601},"Histoire avec le composant Button.","\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fcreating-a-playground-and-a-storybook-for-components\u002Fhistoire-button-component-styled.png",[519,1603,1600],{},[10,1605,1606,1607,248,1609,1611],{},"Cependant, un problème majeur persiste : les composants ",[47,1608,1342],{},[47,1610,1348],{}," ne sont pas reconnus par notre éditeur.",[724,1613,1615],{"id":1614},"ajout-des-types-histoire","Ajout des types Histoire",[10,1617,1618],{},"Heureusement, nous pouvons résoudre ce problème facilement car Histoire fournit les outils nécessaires.",[10,1620,1621,1622,567],{},"Histoire introduit un nouveau contexte TypeScript dans notre projet, nous devons donc créer un nouveau fichier TSConfig dans le dossier ",[47,1623,1316],{},[51,1625,1627],{"className":53,"code":1626,"filename":55,"language":56,"meta":57,"style":57},"touch tsconfig.story.json\n",[47,1628,1629],{"__ignoreMap":57},[61,1630,1631,1633],{"class":63,"line":64},[61,1632,852],{"class":67},[61,1634,1635],{"class":71}," tsconfig.story.json\n",[10,1637,1638,1639,1642,1643,1646,1647,567],{},"Ce fichier étend ",[47,1640,1641],{},"tsconfig.app.json"," mais capture uniquement les fichiers ",[47,1644,1645],{},"story.vue"," et un nouveau fichier ",[47,1648,1649],{},"histoire.d.ts",[51,1651,1653],{"className":1223,"code":1652,"filename":1649,"language":1225,"meta":57,"style":57},"{\n  \"extends\": \".\u002Ftsconfig.app.json\",\n  \"compilerOptions\": {\n    \"moduleResolution\": \"node\"\n  },\n  \"include\": [\n    \"histoire.d.ts\",\n    \"src\u002F**\u002F*.story.vue\"\n  ],\n  \"exclude\": []\n}\n",[47,1654,1655,1659,1671,1678,1688,1692,1700,1707,1712,1716,1724],{"__ignoreMap":57},[61,1656,1657],{"class":63,"line":64},[61,1658,1232],{"class":96},[61,1660,1661,1664,1666,1669],{"class":63,"line":149},[61,1662,1663],{"class":89},"  \"extends\"",[61,1665,1248],{"class":96},[61,1667,1668],{"class":71},"\".\u002Ftsconfig.app.json\"",[61,1670,1057],{"class":96},[61,1672,1673,1676],{"class":63,"line":161},[61,1674,1675],{"class":89},"  \"compilerOptions\"",[61,1677,1240],{"class":96},[61,1679,1680,1683,1685],{"class":63,"line":370},[61,1681,1682],{"class":89},"    \"moduleResolution\"",[61,1684,1248],{"class":96},[61,1686,1687],{"class":71},"\"node\"\n",[61,1689,1690],{"class":63,"line":377},[61,1691,1063],{"class":96},[61,1693,1694,1697],{"class":63,"line":387},[61,1695,1696],{"class":89},"  \"include\"",[61,1698,1699],{"class":96},": [\n",[61,1701,1702,1705],{"class":63,"line":406},[61,1703,1704],{"class":71},"    \"histoire.d.ts\"",[61,1706,1057],{"class":96},[61,1708,1709],{"class":63,"line":425},[61,1710,1711],{"class":71},"    \"src\u002F**\u002F*.story.vue\"\n",[61,1713,1714],{"class":63,"line":448},[61,1715,655],{"class":96},[61,1717,1718,1721],{"class":63,"line":458},[61,1719,1720],{"class":89},"  \"exclude\"",[61,1722,1723],{"class":96},": []\n",[61,1725,1726],{"class":63,"line":996},[61,1727,1285],{"class":96},[496,1729,1730],{"color":530,"icon":499},[10,1731,1732,1733,1736,1737,1740,1741,1744,1745,1748,1749,1752,1753,252,1756,119],{},"L'option ",[47,1734,1735],{},"moduleResolution"," est essentielle pour une résolution correcte des modules. Le package ",[47,1738,1739],{},"@vue\u002Ftsconfig"," utilise ",[47,1742,1743],{},"Bundler",", mais nous avons besoin de ",[47,1746,1747],{},"Node"," pour notre cas d'utilisation. Assurez-vous que ",[47,1750,1751],{},"\"exclude\": []"," écrase l'option ",[47,1754,1755],{},"exclude",[47,1757,1641],{},[10,1759,1760,1761,567],{},"Créez le fichier ",[47,1762,1649],{},[51,1764,1766],{"className":53,"code":1765,"filename":1649,"language":56,"meta":57,"style":57},"touch histoire.d.ts\n",[47,1767,1768],{"__ignoreMap":57},[61,1769,1770,1772],{"class":63,"line":64},[61,1771,852],{"class":67},[61,1773,1774],{"class":71}," histoire.d.ts\n",[10,1776,1777],{},"Référencez les types d'Histoire dans ce fichier :",[51,1779,1782],{"className":900,"code":1780,"filename":1781,"language":572,"meta":57,"style":57},"\u002F\u002F\u002F \u003Creference types=\"@histoire\u002Fplugin-vue\u002Fcomponents\" \u002F>\n","Exemple",[47,1783,1784],{"__ignoreMap":57},[61,1785,1786,1790,1793,1796,1798,1801],{"class":63,"line":64},[61,1787,1789],{"class":1788},"sCsY4","\u002F\u002F\u002F \u003C",[61,1791,1792],{"class":142},"reference",[61,1794,1795],{"class":67}," types",[61,1797,335],{"class":217},[61,1799,1800],{"class":71},"\"@histoire\u002Fplugin-vue\u002Fcomponents\"",[61,1802,422],{"class":1788},[10,1804,1805,1806,567],{},"Enregistrez le nouveau TSConfig dans le ",[47,1807,1808],{},"tsconfig.json",[51,1810,1813],{"className":1811,"code":1812,"filename":1808,"language":1225,"meta":57,"style":57},"language-json shiki shiki-themes github-light github-light github-dark has-diff","{\n  \"files\": [],\n  \"references\": [\n    {\n      \"path\": \".\u002Ftsconfig.app.json\"\n    },\n    {\n      \"path\": \".\u002Ftsconfig.node.json\"\n    },\n    {\n      \"path\": \".\u002Ftsconfig.story.json\" \u002F\u002F [!code ++]\n    }\n  ]\n}\n",[47,1814,1815,1819,1827,1834,1839,1849,1853,1857,1866,1870,1874,1884,1889,1894],{"__ignoreMap":57},[61,1816,1817],{"class":63,"line":64},[61,1818,1232],{"class":96},[61,1820,1821,1824],{"class":63,"line":149},[61,1822,1823],{"class":89},"  \"files\"",[61,1825,1826],{"class":96},": [],\n",[61,1828,1829,1832],{"class":63,"line":161},[61,1830,1831],{"class":89},"  \"references\"",[61,1833,1699],{"class":96},[61,1835,1836],{"class":63,"line":370},[61,1837,1838],{"class":96},"    {\n",[61,1840,1841,1844,1846],{"class":63,"line":377},[61,1842,1843],{"class":89},"      \"path\"",[61,1845,1248],{"class":96},[61,1847,1848],{"class":71},"\".\u002Ftsconfig.app.json\"\n",[61,1850,1851],{"class":63,"line":387},[61,1852,1138],{"class":96},[61,1854,1855],{"class":63,"line":406},[61,1856,1838],{"class":96},[61,1858,1859,1861,1863],{"class":63,"line":425},[61,1860,1843],{"class":89},[61,1862,1248],{"class":96},[61,1864,1865],{"class":71},"\".\u002Ftsconfig.node.json\"\n",[61,1867,1868],{"class":63,"line":448},[61,1869,1138],{"class":96},[61,1871,1872],{"class":63,"line":458},[61,1873,1838],{"class":96},[61,1875,1877,1879,1881],{"class":1876,"line":996},[63,159,160],[61,1878,1843],{"class":89},[61,1880,1248],{"class":96},[61,1882,1883],{"class":71},"\".\u002Ftsconfig.story.json\"",[61,1885,1886],{"class":63,"line":1011},[61,1887,1888],{"class":96},"    }\n",[61,1890,1891],{"class":63,"line":1016},[61,1892,1893],{"class":96},"  ]\n",[61,1895,1896],{"class":63,"line":1021},[61,1897,1285],{"class":96},[10,1899,1900,1901,1903,1904,1906],{},"Mettez à jour ",[47,1902,1641],{}," avec une option ",[47,1905,1755],{}," pour éviter la capture de TSConfig qui se chevauche :",[51,1908,1910],{"className":1223,"code":1909,"filename":1641,"language":1225,"meta":57,"style":57},"{\n  \"extends\": \"@vue\u002Ftsconfig\u002Ftsconfig.dom.json\",\n  \"include\": [\n    \"src\u002F**\u002F*.ts\",\n    \"src\u002F**\u002F*.vue\"\n  ],\n  \"exclude\": [\n    \"src\u002F**\u002F*.story.vue\"\n  ]\n}\n",[47,1911,1912,1916,1927,1933,1940,1945,1949,1955,1959,1963],{"__ignoreMap":57},[61,1913,1914],{"class":63,"line":64},[61,1915,1232],{"class":96},[61,1917,1918,1920,1922,1925],{"class":63,"line":149},[61,1919,1663],{"class":89},[61,1921,1248],{"class":96},[61,1923,1924],{"class":71},"\"@vue\u002Ftsconfig\u002Ftsconfig.dom.json\"",[61,1926,1057],{"class":96},[61,1928,1929,1931],{"class":63,"line":161},[61,1930,1696],{"class":89},[61,1932,1699],{"class":96},[61,1934,1935,1938],{"class":63,"line":370},[61,1936,1937],{"class":71},"    \"src\u002F**\u002F*.ts\"",[61,1939,1057],{"class":96},[61,1941,1942],{"class":63,"line":377},[61,1943,1944],{"class":71},"    \"src\u002F**\u002F*.vue\"\n",[61,1946,1947],{"class":63,"line":387},[61,1948,655],{"class":96},[61,1950,1951,1953],{"class":63,"line":406},[61,1952,1720],{"class":89},[61,1954,1699],{"class":96},[61,1956,1957],{"class":63,"line":425},[61,1958,1711],{"class":71},[61,1960,1961],{"class":63,"line":448},[61,1962,1893],{"class":96},[61,1964,1965],{"class":63,"line":458},[61,1966,1285],{"class":96},[496,1968,1969],{"color":530,"icon":499},[10,1970,1971],{},"Les captures TSConfig qui se chevauchent peuvent entraîner des comportements inattendus et de nombreux problèmes. Assurez-vous de définir des limites claires entre les TSConfigs pour éviter des conflits.",[10,1973,1974],{},"Dans le prochain article, nous améliorerons l'intégration avec l'écosystème Vue.js en créant un résolveur pour Unplugin Vue Component et un module Nuxt.",[1976,1977,1978],"style",{},"html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}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 .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}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}",{"title":57,"searchDepth":149,"depth":149,"links":1980},[1981,1982,1983,1984],{"id":41,"depth":149,"text":42},{"id":300,"depth":149,"text":301},{"id":523,"depth":149,"text":524},{"id":699,"depth":149,"text":700,"children":1985},[1986,1987,1988],{"id":726,"depth":161,"text":727},{"id":1309,"depth":161,"text":1310},{"id":1614,"depth":161,"text":1615},"0d31ab1a-2cc6-44d0-bdf5-31a5ecacd755","2024-11-24","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.","md",null,{},"\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fcreating-a-playground-and-a-storybook-for-components","---\ncontentId: 0d31ab1a-2cc6-44d0-bdf5-31a5ecacd755\npart: 6\ntitle: \"Créer un Playground et un Storybook pour les Composants\"\ndescription: \"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.\"\ndate: 2024-11-24\nseriesSlug: the-complete-guide-to-building-a-vue-js-component-library\n---\n\nNous avons des composants et des tests, mais jusqu'à présent, nous n'avons pas pu les voir en action. Il est temps de créer un **playground** pour deux raisons principales :\n\n1. **Tests** : Nous devons tester nos composants dans un environnement réel pour nous assurer qu'ils fonctionnent comme prévu. Écrire une page avec tous les composants, leurs props et slots aide à créer la meilleure API et à l'implémenter efficacement. Cette approche minimise les refactorisations fréquentes en fournissant une vue d'ensemble des composants.\n2. **Visualisation** : La visualisation des composants est essentielle. Bien que **Tailwind CSS** simplifie le style, il est impossible de bien saisir un composant par le code, en particulier les composants complexes avec de nombreuses variantes ou slots. Un playground nous permet de voir les composants en action et de les tester dans divers scénarios.\n\n## Configuration du playground\n\nTout d'abord, créez un nouveau dossier nommé `playground` à la racine de votre projet.\n\n```bash [terminal]\nmkdir playground\n```\n\nEnsuite, créez un nouveau projet **Vite** dans ce dossier, qui dépendra de notre bibliothèque de composants. Être dans un monorepo simplifie ce processus.\n\n```bash [terminal]\ncd playground && pnpm create vite --template vue-ts\n```\n\nNommez ce projet `vue`.\n\nAvant d'installer les dépendances, mettez à jour le `pnpm-workspace.yaml` pour inclure le package `playground\u002Fvue`. Cela permet au playground d'accéder à la bibliothèque de composants.\n\n```yaml [pnpm-workspace.yaml]\npackages:\n  - 'packages\u002F*'\n  - 'playground\u002F*' # [!code ++]\n```\n\nInstallez les dépendances du playground :\n\n```bash [terminal]\npnpm install\n```\n\nDans ce playground Vue.js, supprimez les fichiers, dossiers et contenus inutiles :\n\n```bash [terminal]\nrm -rf .vscode .public src\u002F{assets,components}\necho \"\u003Ctemplate>\u003C\u002Ftemplate>\" > src\u002FApp.vue\necho \"\" > src\u002Fstyle.css\n```\n\nSupprimez le dossier `.vscode`, le dossier `public`, les dossiers `assets` et `components` dans `src`, ainsi que le contenu de `App.vue` et `style.css`.\n\nMaintenant, installez la bibliothèque de composants dans le playground :\n\n```bash [style.css]\npnpm add ..\u002F..\u002Fpackages\u002Fhuchet-vue\n```\n\nCette commande installe la bibliothèque de composants en créant un lien symbolique vers celle-ci dans `node_modules`. Ainsi, toute importation effectuée dans le playground résout la bibliothèque de composants dans le monorepo, permettant des modifications en temps réel pendant le développement.\n\nDémarrez le script de surveillance dans le dossier du package `huchet-vue` et le script de développement dans le dossier `playground\u002Fvue`. Tout changement dans la bibliothèque de composants se reflétera dans le playground.\n\n## Utilisation du playground\n\nAvec la bibliothèque de composants installée dans le playground, vous pouvez commencer à l'utiliser.\n\nDans le fichier `src\u002FApp.vue`, importez le composant `Button` et utilisez-le :\n\n```vue [src\u002FApp.vue]\n\u003Cscript lang=\"ts\" setup>\nimport { Button } from '@barbapapazes\u002Fhuchet-vue'\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003Cdiv class=\"flex gap-6 p-6\">\n    \u003CButton label=\"Hello World\" \u002F>\n    \u003CButton label=\"Hello World\" variant=\"outline\" \u002F>\n  \u003C\u002Fdiv>\n\u003C\u002Ftemplate>\n```\n\nPour voir le résultat, démarrez Vite dans le playground :\n\n```bash [terminal]\npnpm dev\n```\n\nEnsuite, démarrez Vite dans la bibliothèque de composants :\n\n```bash [terminal]\npnpm watch\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"primary\"}\nPlus votre bibliothèque contient de composants, plus il faudra de temps pour refléter les changements dans le playground. Si cela commence à ralentir, envisagez d'importer directement le composant depuis la bibliothèque avec un chemin relatif ou d'utiliser un storybook comme **Histoire**, que nous allons aborder ensuite.\n::\n\nDans votre navigateur, vous devriez voir deux boutons, non stylisés.\n\n![Deux boutons, non stylisés.](\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fcreating-a-playground-and-a-storybook-for-components\u002Ftwo-buttons-unstyled.png)\n\n## Styliser le playground\n\nNos composants sont non stylisés. Pour réduire la taille du bundle et permettre la génération côté utilisateur, nous ne fournissons pas de CSS avec la bibliothèque de composants.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nNous pourrions expédier une configuration Tailwind CSS avec la bibliothèque de composants pour garantir que les composants sont correctement stylés dans le playground.\n::\n\nNous allons utiliser **Tailwind CSS** 4, même s'il n'est pas encore sorti, car il est accompagné d'un plugin Vite qui simplifie son utilisation et aucun autre changement cassant n'est attendue.\n\n```bash [terminal]\npnpm i -D tailwindcss@next @tailwindcss\u002Fvite@next\n```\n\nEnsuite, enregistrez le plugin Tailwind CSS dans le fichier `vite.config.ts` :\n\n```ts [vite.config.ts]\nimport Tailwindcss from '@tailwindcss\u002Fvite'\nimport Vue from '@vitejs\u002Fplugin-vue'\nimport { defineConfig } from 'vite'\n\nexport default defineConfig({\n  plugins: [\n    Vue(),\n    Tailwindcss(), \u002F\u002F [!code ++]\n  ],\n})\n```\n\nDans le `src\u002Fstyle.css`, importez les styles Tailwind CSS :\n\n```css [src\u002Fstyle.css]\n@import \"tailwindcss\";\n```\n\nAutomatiquement, les boutons sont stylés comme prévu.\n\n![Deux boutons, stylisés.](\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fcreating-a-playground-and-a-storybook-for-components\u002Ftwo-buttons-styled.png)\n\n## Le Storybook Histoire\n\nParfois, un playground ne suffit pas. Vous avez besoin de documenter vos composants, de les visualiser dans divers scénarios et de les isoler pour vous assurer que les problèmes proviennent du composant et non de l'intégration. C'est ici qu'un **storybook** entre en jeu.\n\nNous allons utiliser [**Histoire**](https:\u002F\u002Fhistoire.dev\u002F), un outil similaire à **Storybook** qui est léger, basé sur Vite et optimisé pour Vue.js.\n\n### Configuration de Histoire\n\nLa configuration de Histoire est simple, surtout avec **Tailwind CSS** 4.\n\nTout d'abord, créez un nouveau dossier depuis la racine du projet :\n\n```bash [terminal]\nmkdir .histoire && cd .histoire && echo '{\\n\"name\": \"huchet-vue-histoire\",\\n\"private\": true\\n}' > package.json\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nJ'ai placé le dossier Histoire à la racine du projet au lieu du dossier `packages` car c'est un outil de développement, et non un package npm publiable.\n::\n\nAjoutez le dossier au workspace :\n\n```bash [terminal]\necho \"  - .histoire\" >> ..\u002Fpnpm-workspace.yaml\n```\n\nInstallez Histoire et Tailwind CSS :\n\n```bash [terminal]\npnpm i -D histoire @histoire\u002Fplugin-vue @vitejs\u002Fplugin-vue vue tailwindcss@next @tailwindcss\u002Fvite@next\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nNous installons maintenant Tailwind CSS car nous en aurons besoin, comme nous l'avons vu dans le playground.\n::\n\nHistoire utilise un fichier de configuration nommé `histoire.config.ts`, que nous allons créer dans le dossier `.histoire` :\n\n```bash [histoire.config.ts]\ntouch histoire.config.ts\n```\n\nLa configuration comprend plusieurs clés :\n\n- `plugins` : Plugins pour Histoire, comme le plugin Vue Histoire.\n- `storyMatch` : Fichiers à correspondre pour créer des histoires, comme les fichiers `*.story.vue`.\n- `setupFile` : Fichier de configuration à utiliser avec Histoire, où nous allons créer un `setup.ts`.\n- `theme` : Options de personnalisation comme le titre, le logo, le favicon pour l'interface Histoire.\n- `vite` : Configuration Vite utilisant les plugins Vue et Tailwind CSS.\n\n```ts [setup.ts]\nimport { resolve } from 'node:path'\nimport { HstVue } from '@histoire\u002Fplugin-vue'\nimport Tailwind from '@tailwindcss\u002Fvite'\nimport Vue from '@vitejs\u002Fplugin-vue'\nimport { defineConfig } from 'histoire'\n\nexport default defineConfig({\n  plugins: [HstVue()],\n\n  storyMatch: [\n    resolve(__dirname, '..\u002Fpackages\u002Fhuchet-vue\u002Fsrc\u002F**\u002F*.story.vue'),\n  ],\n\n  setupFile: resolve(__dirname, 'setup.ts'),\n\n  theme: {\n    title: 'Huchet Vue',\n  },\n\n  vite: {\n    plugins: [\n      Vue(),\n      Tailwind(),\n    ],\n    server: {\n      fs: {\n        allow: ['..'],\n      },\n    },\n  },\n})\n```\n\nPuisque les histoires se trouvent dans la bibliothèque de composants, nous devons explicitement indiquer à Histoire de les chercher dans le dossier `packages\u002Fhuchet-vue\u002Fsrc` à l'aide de la clé `storyMatch`. Pendant ce temps, nous permettons au serveur Histoire d'accéder au dossier parent via la clé `server.fs.allow`, empêchant ainsi les problèmes d'accessibilité aux fichiers.\n\nPour implémenter Tailwind CSS dans Histoire, importez le CSS dans le fichier `setup.ts`, de la même manière que dans le playground :\n\n```bash [setup.ts]\ntouch setup.ts style.css\necho \"import '.\u002Fstyle.css';\" > setup.ts\necho \"@import 'tailwindcss';\" > style.css\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nLe fichier `setup.ts` est exécuté au démarrage de Histoire et est un endroit idéal pour la personnalisation ou les styles globaux.\n::\n\nPour commencer avec Histoire, ajoutez trois scripts au `package.json` :\n\n```json [package.json]\n{\n  \"scripts\": {\n    \"dev\": \"histoire dev\",\n    \"build\": \"histoire build\",\n    \"serve\": \"histoire serve\"\n  }\n}\n```\n\nMaintenant, nous pouvons démarrer Histoire :\n\n```bash [terminal]\npnpm dev\n```\n\n![Histoire en cours d'exécution.](\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fcreating-a-playground-and-a-storybook-for-components\u002Fhistoire-running.png)\n\n### Création d'une histoire\n\nEn revenant à `packages\u002Fhuchet-vue`, nous pouvons créer notre premier fichier d'histoire, `Button\u002FButton.story.vue` :\n\n```bash [Button\u002FButton.story.vue]\ntouch src\u002FButton\u002FButton.story.vue\n```\n\nHistoire propose des composants prédéfinis pour créer une histoire avec des variantes.\n\n1. `Story` : Le composant principal pour créer une histoire.\n2. `Variant` : Un composant pour créer une variante d'un composant au sein de l'histoire.\n\nDans notre scénario, nous créons une histoire dans `Button.story.vue` avec deux variantes : `solid` et `outline`.\n\n```vue [Button.story.vue]\n\u003Cscript lang=\"ts\" setup>\nimport { logEvent } from 'histoire\u002Fclient'\nimport Button from '.\u002FButton.vue'\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003CStory>\n    \u003CVariant title=\"Solid\">\n      \u003CButton variant=\"solid\" label=\"Hello World\" @click=\"logEvent('Click', $event)\" \u002F>\n    \u003C\u002FVariant>\n    \u003CVariant title=\"Outline\">\n      \u003CButton variant=\"outline\" label=\"Hello World\" @click=\"logEvent('Click', $event)\" \u002F>\n    \u003C\u002FVariant>\n  \u003C\u002FStory>\n\u003C\u002Ftemplate>\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nLa fonction `logEvent` enregistre les événements dans l'interface, aidant les développeurs à comprendre la sortie du composant.\n::\n\nEt cela fonctionne !\n\n![Histoire avec le composant Button.](\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fcreating-a-playground-and-a-storybook-for-components\u002Fhistoire-button-component-styled.png)\n\nCependant, un problème majeur persiste : les composants `Story` et `Variant` ne sont pas reconnus par notre éditeur.\n\n### Ajout des types Histoire\n\nHeureusement, nous pouvons résoudre ce problème facilement car Histoire fournit les outils nécessaires.\n\nHistoire introduit un nouveau contexte TypeScript dans notre projet, nous devons donc créer un nouveau fichier TSConfig dans le dossier `packages\u002Fhuchet-vue` :\n\n```bash [terminal]\ntouch tsconfig.story.json\n```\n\nCe fichier étend `tsconfig.app.json` mais capture uniquement les fichiers `story.vue` et un nouveau fichier `histoire.d.ts` :\n\n```json [histoire.d.ts]\n{\n  \"extends\": \".\u002Ftsconfig.app.json\",\n  \"compilerOptions\": {\n    \"moduleResolution\": \"node\"\n  },\n  \"include\": [\n    \"histoire.d.ts\",\n    \"src\u002F**\u002F*.story.vue\"\n  ],\n  \"exclude\": []\n}\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nL'option `moduleResolution` est essentielle pour une résolution correcte des modules. Le package `@vue\u002Ftsconfig` utilise `Bundler`, mais nous avons besoin de `Node` pour notre cas d'utilisation. Assurez-vous que `\"exclude\": []` écrase l'option `exclude` dans `tsconfig.app.json`.\n::\n\nCréez le fichier `histoire.d.ts` :\n\n```bash [histoire.d.ts]\ntouch histoire.d.ts\n```\n\nRéférencez les types d'Histoire dans ce fichier :\n\n```ts [Exemple]\n\u002F\u002F\u002F \u003Creference types=\"@histoire\u002Fplugin-vue\u002Fcomponents\" \u002F>\n```\n\nEnregistrez le nouveau TSConfig dans le `tsconfig.json` :\n\n```json [tsconfig.json]\n{\n  \"files\": [],\n  \"references\": [\n    {\n      \"path\": \".\u002Ftsconfig.app.json\"\n    },\n    {\n      \"path\": \".\u002Ftsconfig.node.json\"\n    },\n    {\n      \"path\": \".\u002Ftsconfig.story.json\" \u002F\u002F [!code ++]\n    }\n  ]\n}\n```\n\nMettez à jour `tsconfig.app.json` avec une option `exclude` pour éviter la capture de TSConfig qui se chevauche :\n\n```json [tsconfig.app.json]\n{\n  \"extends\": \"@vue\u002Ftsconfig\u002Ftsconfig.dom.json\",\n  \"include\": [\n    \"src\u002F**\u002F*.ts\",\n    \"src\u002F**\u002F*.vue\"\n  ],\n  \"exclude\": [\n    \"src\u002F**\u002F*.story.vue\"\n  ]\n}\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nLes captures TSConfig qui se chevauchent peuvent entraîner des comportements inattendus et de nombreux problèmes. Assurez-vous de définir des limites claires entre les TSConfigs pour éviter des conflits.\n::\n\nDans le prochain article, nous améliorerons l'intégration avec l'écosystème Vue.js en créant un résolveur pour Unplugin Vue Component et un module Nuxt.\n",{"title":5,"description":1991},"the-complete-guide-to-building-a-vue-js-component-library",{"loc":1995,"images":2000},[2001,2002,2003,2004],{"loc":517},{"loc":694},{"loc":1304},{"loc":1601},"fr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fcreating-a-playground-and-a-storybook-for-components","svBICzGmb12383V2BlEcJNtpZSmH0tNTuMg2vTSxm04",{"overview":2008,"chapters":2200},{"id":2009,"title":2010,"body":2011,"contentId":2185,"date":1990,"description":2186,"extension":1992,"github":2187,"meetTheInstructor":2189,"meta":2190,"navigation":373,"part":1993,"path":2191,"rawbody":2192,"robots":1993,"schemaOrg":1993,"seo":2193,"seriesSlug":1998,"sitemap":2194,"stem":2195,"subtitle":2196,"topics":2197,"__hash__":2199},"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":2012,"toc":2182},[2013,2016,2019,2031,2035,2038,2051,2054,2169,2172,2176],[10,2014,2015],{},"Bienvenue ! 👋",[10,2017,2018],{},"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,2020,2021,2022,2026,2027],{},"Cette série est en quelque sorte une suite de l'article ",[711,2023,2025],{"href":2024},"\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. ",[2028,2029,2030],"em",{},"Vous apprendrez comment les bibliothèques de composants les plus populaires sont construites dans les coulisses et comment créer la vôtre.",[2032,2033],"callout-read-more",{"id":2034},"75df6bff-de40-4056-af23-fae2401cd21a",[10,2036,2037],{},"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,2039,2040,2041,2046,2047,119],{},"C'est compréhensible. Bien que ",[711,2042,2045],{"href":2043,"rel":2044},"https:\u002F\u002Fgithub.com\u002Funjs\u002Funbuild",[715],"unbuild"," soit un outil puissant, il ne peut égaler la flexibilité, l'écosystème de plugins et l'adoption de ",[711,2048,78],{"href":2049,"rel":2050},"https:\u002F\u002Fvite.dev\u002F",[715],[10,2052,2053],{},"Tout au long de cette série, nous aborderons les sujets suivants :",[19,2055,2056,2068,2100,2118,2135,2141,2151],{},[22,2057,2058,2061,2062,2067],{},[14,2059,2060],{},"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 ",[711,2063,2066],{"href":2064,"rel":2065},"https:\u002F\u002Feslint.org\u002F",[715],"ESLint"," pour assurer la cohérence du code.",[22,2069,2070,2073,2074,2079,2080,248,2084,2089,2090,248,2095,119],{},[14,2071,2072],{},"Création d'un Premier Composant avec Vue.js et Tailwind CSS"," : Nous créerons notre premier composant avec ",[711,2075,2078],{"href":2076,"rel":2077},"https:\u002F\u002Fvuejs.org\u002F",[715],"Vue.js",", ",[711,2081,36],{"href":2082,"rel":2083},"https:\u002F\u002Ftailwindcss.com\u002F",[715],[711,2085,2088],{"href":2086,"rel":2087},"https:\u002F\u002Fwww.tailwind-variants.org\u002F",[715],"Tailwind Variants"," en utilisant les techniques les plus avancées et puissantes employées dans des bibliothèques de composants populaires comme ",[711,2091,2094],{"href":2092,"rel":2093},"https:\u002F\u002Fwww.radix-vue.com\u002F",[715],"Radix Vue",[711,2096,2099],{"href":2097,"rel":2098},"https:\u002F\u002Fui.nuxt.com\u002F",[715],"Nuxt UI",[22,2101,2102,2105,2106,2111,2112,2117],{},[14,2103,2104],{},"Une Meilleure Expérience de Développement avec TypeScript et TSConfig"," : Nous améliorerons notre expérience de développement en ajoutant ",[711,2107,2110],{"href":2108,"rel":2109},"https:\u002F\u002Fwww.typescriptlang.org\u002F",[715],"TypeScript"," à notre bibliothèque de composants et en configurant ",[711,2113,2116],{"href":2114,"rel":2115},"https:\u002F\u002Fwww.typescriptlang.org\u002Ftsconfig",[715],"TSConfig"," pour nous assurer que nos composants sont correctement typés et que nous pouvons tirer pleinement parti des fonctionnalités de TypeScript.",[22,2119,2120,2123,2124,248,2129,2134],{},[14,2121,2122],{},"Tests Automatiques des Composants avec Vitest et Testing Library"," : Nous écrirons des tests pour nos composants en utilisant ",[711,2125,2128],{"href":2126,"rel":2127},"https:\u002F\u002Fvitest.dev\u002Fguide\u002F",[715],"Vitest",[711,2130,2133],{"href":2131,"rel":2132},"https:\u002F\u002Ftesting-library.com\u002F",[715],"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.",[22,2136,2137,2140],{},[14,2138,2139],{},"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.",[22,2142,2143,2146,2147,2150],{},[14,2144,2145],{},"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 ",[711,2148,505],{"href":713,"rel":2149},[715]," 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.",[22,2152,2153,2156,2157,2162,2163,2168],{},[14,2154,2155],{},"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 ",[711,2158,2161],{"href":2159,"rel":2160},"https:\u002F\u002Fgithub.com\u002Funplugin\u002Funplugin-vue-components",[715],"Unplugin Vue Components"," et un ",[711,2164,2167],{"href":2165,"rel":2166},"https:\u002F\u002Fnuxt.com\u002Fdocs\u002Fguide\u002Fgoing-further\u002Fmodules",[715],"module Nuxt"," pour utiliser nos composants dans une application Nuxt.",[10,2170,2171],{},"À 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 ? 😎",[39,2173,2175],{"id":2174},"chapitres","Chapitres",[2177,2178],"series-chapters-list",{"className":2179},[2180,2181],"mx-auto","max-w-5xl",{"title":57,"searchDepth":149,"depth":149,"links":2183},[2184],{"id":2174,"depth":149,"text":2175},"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":293,"repository":2188},"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":2010,"description":2186},{"loc":2191},"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.",[118,896,2198],"bibliothèque de composants","uPZbK53-TcUyWNHiN_UucohLqZHXH1ZV1Tpgk8hOc5c",[2201,2206,2211,2216,2221,2226,2227],{"contentId":2202,"title":2203,"description":2204,"path":2205,"part":64,"github":1993,"topics":1993},"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":2207,"title":2208,"description":2209,"path":2210,"part":149,"github":1993,"topics":1993},"24847f3a-2219-4e78-829b-0f5a08fa9baa","Construire un premier composant avec Vue.js et Tailwind CSS","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.","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fbuilding-a-first-component-with-vuejs-and-tailwind-css",{"contentId":2212,"title":2213,"description":2214,"path":2215,"part":161,"github":1993,"topics":1993},"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":2217,"title":2218,"description":2219,"path":2220,"part":370,"github":1993,"topics":1993},"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":2222,"title":2223,"description":2224,"path":2225,"part":377,"github":1993,"topics":1993},"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":1989,"title":5,"description":1991,"path":1995,"part":387,"github":1993,"topics":1993},{"contentId":2228,"title":2229,"description":2230,"path":2231,"part":406,"github":1993,"topics":1993},"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",1795016703602]