element-plus/website/docs/fr-FR/custom-theme.md
2020-10-16 11:26:39 +08:00

6.4 KiB
Raw Blame History

Thème

Element Plus utilise le style BEM pour le CSS afin que vous puissiez écraser les règles prédéfinies facilement. Mais si vous avez besoin de remplacer des styles à une plus grande échelle , e.g. changer le thème de bleu à orange ou vert, les modifier une par une serait fastidieux. Nous fournissons ttrtois méthodes pour changer les variables de style.

Theme Roller

Utilisez Online Theme Roller pour personnaliser les Design Tokens des variables globales et des composants, et prévisualisez le nouveau thème en temps réel. Il peut générer un package de style complet basé sur le nouveau thème que vous pouvez télécharger directement (pour importer de nouveaux fichiers de style dans votre projet, veuillez vous reporter à la partie 'Importer un thème personnalisé'' de cette section).

Also, use Theme Roller Chrome Extensionto customize theme and preview in real-time on any website developed by Element.

Changer la couleur du thème

Si vous avez juste besoin de changer la couleur du thème, le générateur de thème en ligne est recommandé. La couleur du thème d'Element Plus est un bleu clair et agréable. En le changeant, vous rendez Element Plus visuellement plus adapté à vos projets.

Le site précédent vous permet de visualiser et de télécharger un nouveau thème immédiatement (pour importer un nouveau thème, référez-vous à la partie 'Importer un thème personnalisé' or 'Importer un thème de composant à la demande' de cette section).

Mettre à jour les variables SCSS de votre projet

theme-chalk est écrit en SCSS. Si votre projet utilises SCSS, vous pouvez changer directement les variables d'Élément. Créez un nouveau fichier, e.g. element-variables.scss:

/* couleur du thème */
$--color-primary: teal;

/* chemin vers le fichier de police, requis */
$--font-path: '~element-plus/lib/theme-chalk/fonts';

@import "~element-plus/packages/theme-chalk/src/index";

Puis dans le fichier d'entrée, importez ce style au lieu de celui d'Element:

import Vue from 'vue'
import Element Plus from 'element-plus'
import './element-variables.scss'

Vue.use(Element)

:::tip Il est obligatoire de remplacer le chemin du fichier de police. :::

Outil de thème CLI

Si votre projet n'utilise pas SCSS, vous pouvez personnaliser le thème en utilisant notre outil en ligne de commande:

Installation

Installez le générateur de thème de manière globale ou locale. Une installation locale est recommandé afin que les personnes clonant votre dépôt bénéficient d'une installation automatique via npm.

npm i element-theme -g

Installer ensuite le thème chalk depuis npm ou GitHub.

# Via npm
npm i element-theme-chalk -D

# Via GitHub
npm i https://github.com/ElementUI/theme-chalk -D

Initialisation d'un fichier de variable

Après l'installation des paquets ci-dessus, une commande appelée et devient disponible dans le CLI (si les paquets sont installés localement, utilisez node_modules/.bin/et à la place). Utilisez -i pour initialiser le fichier de variables, element-variables.scss par défaut. Vous pouvez spécifier n'importe quel dossier comme sortie.

et -i [nom du fichier]

> ✔ Generator variables file

Dans element-variables.scss vous trouverez toutes les variables utilisées pour le style d'Element, définies en SCSS. Voici un snippet:

$--color-primary: #409EFF !default;
$--color-primary-light-1: mix($--color-white, $--color-primary, 10%) !default; /* 53a8ff */
$--color-primary-light-2: mix($--color-white, $--color-primary, 20%) !default; /* 66b1ff */
$--color-primary-light-3: mix($--color-white, $--color-primary, 30%) !default; /* 79bbff */
$--color-primary-light-4: mix($--color-white, $--color-primary, 40%) !default; /* 8cc5ff */
$--color-primary-light-5: mix($--color-white, $--color-primary, 50%) !default; /* a0cfff */
$--color-primary-light-6: mix($--color-white, $--color-primary, 60%) !default; /* b3d8ff */
$--color-primary-light-7: mix($--color-white, $--color-primary, 70%) !default; /* c6e2ff */
$--color-primary-light-8: mix($--color-white, $--color-primary, 80%) !default; /* d9ecff */
$--color-primary-light-9: mix($--color-white, $--color-primary, 90%) !default; /* ecf5ff */

$--color-success: #67c23a !default;
$--color-warning: #e6a23c !default;
$--color-danger: #f56c6c !default;
$--color-info: #909399 !default;

...

Modifier les variables

Éditer element-variables.scss, e.g. en changeant la couleur du thème pour du rouge:

$--color-primary: red;

Générer le thème

Après avoir sauvegardé le fichier de variables, utilisez et pour générer le thème. Vous pouvez activer le mode watch en ajoutant le paramètre -w. Si vous avez choisi le chemin du fichier de sortie, il vous faudra ajouter le paramètre -c avec le nom du fichier. Par défaut le thème généré est placé dans ./theme. Vous pouvez spécifier le dossier de sortie grâce à -o.

et

> ✔ build theme font
> ✔ build element theme

Use custom theme

Importer le thème

Importing your own theme is just like importing the default theme, only this time you import the file built from "Online Theme Roller" or "CLI tool":

import '../theme/index.css'
import ElementUI from 'element-plus'
import Vue from 'vue'

Vue.use(ElementUI)

Importer le thème d'un composant sur demande

Si vous utilisez babel-plugin-component pour les imports sur demande, modifiez .babelrc et spécifiez styleLibraryName avec le chemin où votre thème est localisé relativement à .babelrc. N'oubliez pas que ~ est requis:

{
  "plugins": [
    [
      "component",
      {
        "libraryName": "element-plus",
        "styleLibraryName": "~theme"
      }
    ]
  ]
}

Si vous n'êtes pas familier avec babel-plugin-component, référez-vous à la page Guide. Pour plus d'informations, jetez un oeil au dépôt du projet de element-theme.