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 :
pnpm add @univerjs/icons-vuenpm install @univerjs/icons-vueyarn add @univerjs/icons-vuebun add @univerjs/icons-vueAjouter 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.
<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 :
<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:
<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.
<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 ?