sisdai-graficas
El proyecto sisdai-graficas es una biblioteca de componentes reutilizables de visualización de datos, desarrollados en de Vue y construidos con D3.js. Esta biblioteca sigue las pautas del Sistema de Diseño y Accesibilidad para la Investigación Sisdai.
Se recomienda utilizar Vue 3.4.36 con el soporte para Composition Api para garantizar la compatibilidad.
Instalación
En la carpeta raíz de tu proyecto Vue, instala la biblioteca como una dependencia utilizando el siguiente comando npm:
npm install git+https://codigo.conahcyt.mx/sisdai/sisdai-graficas
Si necesitas instalar una versión específica de la biblioteca, reemplaza N.N.N con el número de versión deseado, por ejemplo v5.0.0:
npm install git+https://codigo.conahcyt.mx/sisdai/sisdai-graficas#vN.N.N
Instalación de estilos
Dado que los componentes están ligados con el estilo visual de Sisdai, es necesario incluir los estilos correspondientes. Lo siguiente es dar de alta los estilos de Sisdai Css en el archivo de inicialización del proyecto.
Sigue estos pasos:
- Abre el archivo de inicialización de tu proyecto, generalmente
src/main.js
. - Agrega la siguiente línea de importación para cargar los estilos:
import 'sisdai-css/dist/sisdai.min.css'
Importación de componentes
Registro de componentes específicos
Si no necesitas todos los componentes de la biblioteca, es recomendable importar y registrar solo aquellos que vas a utilizar. Para dar de alta de manera global en toda la aplicación:
- Abre el archivo de inicialización de tu proyecto, generalmente
src/main.js
- Importa los componentes específicos y registrarlos
import { createApp } from 'vue'
import App from './App.vue'
const app = createApp(App)
import { SisdaiGraficas, SisdaiDona } from 'sisdai-graficas/src/componentes'
app.use(SisdaiGraficas)
app.use(SisdaiDona)
app.mount('#app')
Por otra parte, si deseas usar estos componentes en un archivo, puedes importarlos de la siguiente manera en un archivo .vue
:
<script setup>
import SisdaiGraficas from 'sisdai-graficas/src/componentes/sisdai-graficas/SisdaiGraficas.vue'
import SisdaiDona from 'sisdai-graficas/src/componentes/sisdai-dona/SisdaiDona.vue'
<script>
<template>
<SisdaiGraficas>
<SisdaiDona/>
</SisdaiGraficas>
</template>
Registro global de todos los componentes
Si planeas utilizar la mayoría o todos los componentes de la biblioteca, puedes registrarlos globalmente en tu aplicación para simplificar el proceso. Esta opción es conveniente debido a su simplicidad, pero solo se recomienda si realmente necesitas la mayoría de los componentes.
- Abre el archivo de inicialización de tu proyecto, generalmente
src/main.js
. - Agrega la siguiente línea para registrar todos los componentes:
import SisdaiGraficas from 'sisdai-graficas'
Vue.use(SisdaiGraficas)
Aunque esta forma es la más limpia en el código , solo es recomendable si se tiene claro que se están usando todos o la mayoría de los componentes.