desy-angular v7.0 - Manual de instalación

Owned by Servicios Digitales de Aragón
Last updated: 17 May 2023
4 min read

Prerrequisitos

  • node.js 16.17.1+

  • Angular 15 (instalar mediante npm install -g @angular/cli@^15.0.0, o bien npm install -g @angular/cli@^15.0.0 para instalar globalmente)

Dependencias

Para utilizar desy-angular es necesario instalar previamente las siguientes librerías:

Puedes instalarlas mediante el comando npm install desy-html@7.1.0 @angular/cdk@^15.1.5

Instalación

Si vas a crear un proyecto desde 0, puedes tomar el proyecto desy-angular-starter como punto de partida. Este proyecto viene con desy-angular configurado y listo para utilizarse. Puedes encontrarlo aquí: https://bitbucket.org/sdaragon/desy-angular-starter/

Después de instalar las dependencias anteriores, instale desy-angular través de:

npm install desy-angular

Una vez instalado, se debe importar el módulo principal DesyAngularModule y el módulo BrowserAnimationsModule en su módulo de aplicación:

app.module.ts
import { DesyAngularModule } from 'desy-angular'; @NgModule({ declarations: [AppComponent, ...], imports: [DesyAngularModule, BrowserAnimationsModule, ...], bootstrap: [AppComponent] }) export class AppModule { }

 

Si no se va a usar todos módulos de desy-angular, se puede instalar solo lo necesario de esta forma:

app.module.ts
import { DesyButtonsModule, DesyFormsModule, DesyNavModule, DesyTablesModule, DesyViewsModule, DesyModalsModule } from 'desy-angular'; @NgModule({ declarations: [AppComponent, ...], imports: [DesyButtonsModule, DesyFormsModule, DesyNavModule, DesyTablesModule, DesyViewsModule, DesyModalsModule, ...], bootstrap: [AppComponent] }) export class AppModule { }

 

 

Configuración de router

Para que funcionen correctamente los componentes de navegación (DesyNavModule) es necesario activar anchorScrolling en la configuración de router.

(ver https://angular.io/api/router/ExtraOptions#anchorScrolling )

 

Configuración de tailwindcss

Desy-angular usa las clases css que nos aporta desy-html, haciendo uso de la librería tailwindcss. Para su correcto funcionamiento y visualización es recomendable la siguiente configuración. 

Creamos el fichero tailwind.config.js mediante npx tailwindcss init y lo modificamos para utilizar la configuración de desy-html.

tailwind.config.js

 

Configuración de postcss

Instalamos como dependencia de desarrollo postcss-loader

Creamos el fichero postcss.config.js en la carpeta raíz del proyecto:

postcss.config.js

 

Por ultimo, importaremos en nuestro styles.css los estilos de tippy y desy-html e importamos la fuente Open Sans en nuestro index.html

styles.css
index.html

Creamos el fichero tailwind.config.js mediante npx tailwindcss init y lo modificamos para utilizar la configuración de desy-html.

tailwind.config.js

Instalamos como dependencia de desarrollo @angular-builders/custom-webpack y postcss-loader

Configuramos el custom-webpack, creando el fichero webpack.config.js en la carpeta raíz del proyecto:

webpack.config.js

En el atributo test: /\.css$/, se debe especificar la extensión del fichero styles en tailwind.

En nuestro angular.json modificamos el builder y agregamos la configuración.

angular.json

Por ultimo, importaremos en nuestro styles.css los estilos de tippy y desy-html e importamos la fuente Open Sans en nuestro index.html

styles.css
index.html