Intégration dans Vue

Installez et utilisez les icônes Univer dans vos projets Vue 3.

Ajoutez des icônes à une interface Vue 3, puis ajustez leur taille et leurs couleurs pour correspondre aux commandes environnantes.

Installer le paquet

Installez le paquet d'icônes dans un projet Vue 3 :

Shell
pnpm add @univerjs/icons-vue

Ajouter une icône à un bouton

Sélectionnez un composant dans le aperçu de l'icône et importez-le par son nom. Le bouton Copie ci-dessous conserve une étiquette de texte à côté de son icône.

Vue
<script setup lang="ts">import { CopyIcon } from '@univerjs/icons-vue'const emit = defineEmits<{ copy: [] }>()</script><template>  <button type="button" @click="emit('copy')">    <CopyIcon aria-hidden="true" />    <span>Copier</span>  </button></template>

Gérez l’événement copy dans le composant parent. L’icône est décorative, car le texte décrit déjà l’action.

Régler la taille et la couleur

Une icône hérite de sa couleur à partir du texte environnant et de sa taille à partir de 1em. Définissez fontSize et color sur l'icône pour passer outre l'une ou l'autre valeur :

Vue
<script setup lang="ts">import { AddImageIcon } from '@univerjs/icons-vue'</script><template>  <AddImageIcon    aria-hidden="true"    :style="{ fontSize: '20px', color: '#27272a' }"  /></template>

Régler une icône à deux couleurs

Une icône bicolore utilise color pour sa couleur principale et extend.colorChannel1, pour son accent. L'exemple ci-dessous associe gris foncé avec un accent gris clair:

Vue
<script setup lang="ts">import { PaintBucketDoubleIcon } from '@univerjs/icons-vue'</script><template>  <PaintBucketDoubleIcon    aria-hidden="true"    :style="{ fontSize: '20px', color: '#27272a' }"    :extend="{ colorChannel1: '#d4d4d8' }"  /></template>

Les icônes multicolores, y compris les logos de marque, peuvent être livrées avec des couleurs fixes. Ces paramètres ne remplacent pas toutes les couleurs de ces icônes.

Conserver des traits fins à l’agrandissement

Si une icône agrandie apparaît trop lourde, utilisez preserveStrokeWidth. Les coups qui la supportent gardent la largeur qu'ils ont à 16 × 16, et les formes remplies ne sont pas affectées. Vérifiez le résultat avec le contrôle de course dans l'aperçu avant de l'appliquer.

Vue
<script setup lang="ts">import { ShapePieIcon } from '@univerjs/icons-vue'</script><template>  <ShapePieIcon    aria-hidden="true"    preserve-stroke-width    style="font-size: 48px"  /></template>

Nommer les boutons sans texte

Lorsqu'un bouton n'a pas de texte visible, ajoutez aria-label="Copy" au bouton et gardez aria-hidden="true" sur l'icône afin que les lecteurs d'écran puissent annoncer l'action.

Pour avoir un Agent AI trouver l'icône et écrire le code d'intégration, connectez MCP.

Que pensez-vous de ce guide ?

© 2026 DreamNum Co., Ltd.