README.md

La version française suit.

GC Design System Components – Vue

GC Design System Components – Vue provides the GC Design System Components within a Vue wrapper to ease integration of the components into Vue apps.

Documentation

You can find the full documentation for GC Design System Components on https://design-system.alpha.canada.ca/.

Installation

Install from npm

Navigate to the root folder of your project and run:

npm install @cdssnc/gcds-components-vue

In your main.js file, import the GC Design System components plugin and use it:

import { GcdsComponents } from '@cdssnc/gcds-components-vue';

createApp(App).use(GcdsComponents).mount('#app');

Add the global styles to your app. There are multiple ways to achieve this.

You can import it in your main.js file next to your style.css:

import '@cdssnc/gcds-components-vue/gcds.css';
import './style.css';

or in your App.vue using the html style tag.

<style src='@cdssnc/gcds-components-vue/gcds.css'>
    /* global styles */
</style> 

Using Vite

If using Vite, additional configuration will need to be added to vite.config.ts to prevent Vue from logging a warning about failing to resolve components (e.g. "Failed to resolve component: gcds-header").

export default defineConfig({
  plugins: [
    vue({
      template: {
        compilerOptions: {
          // treat all tags with a dash as custom elements
          isCustomElement: (tag) => tag.includes('-'),
        },
      },
    })
  ],
})

How to contribute

If you are interested in contributing to GC Design System Components, please read our contributing guidelines.

License

Code released under the MIT License.

---

Composants de Système de design GC — Vue

Composants de Système de design GC — Vue fournit des composants de Système de design GC dans un encapsulateur Vue afin de faciliter l’intégration dans les applications Vue.

Documentation

Toute la documentation sur les composants de Système de design GC est accessible à l’adresse https://systeme-design.alpha.canada.ca/.

Installation

Installer le paquet avec npm

Naviguez jusqu'au dossier racine de votre projet et exécutez :

npm install @cdssnc/gcds-components-vue

Dans votre fichier main.js, importez le plugiciel des composants Système de design GC et utilisez-le de la façon suivante :

import { GcdsComponents } from '@cdssnc/gcds-components-vue';

createApp(App).use(GcdsComponents).mount('#app');

Ajoutez les styles généraux à votre application. Vous pouvez les ajouter de plusieurs façons.

Vous pouvez soit les importer dans votre fichier main.js à côté de votre style.css :

import '@cdssnc/gcds-components-vue/gcds.css';
import './style.css';

ou les insérer dans votre App.vue à l'aide de la balise de style html.

<style src='@cdssnc/gcds-components-vue/gcds.css'>
    /* global styles */
</style> 

Utilisation de Vite

Si vous utilisez Vite, il faudra ajouter une configuration additionnelle à 'vite.config.ts' afin d’empêcher que Vue ne signale un avertissement d’échec pour la résolution de composants (p. ex. « Failed to resolve component: gcds-header » [Échec de la résolution du composant : gcds-header]).

export default defineConfig({
  plugins: [
    vue({
      template: {
        compilerOptions: {
          // treat all tags with a dash as custom elements
          isCustomElement: (tag) => tag.includes('-'),
        },
      },
    })
  ],
})

Apportez votre contribution

Si vous souhaitez contribuer aux unités de style de Système de design GC, veuillez lire nos lignes directrices sur la contribution.

Licence

Code publié en vertu de la licence MIT (en anglais).