Plataforma de nueva generación

Personalización del estilo de aplicación

Puede aplicar estilo a las pantallas nuevas en el formato .scss o modificar el estilo de una pantalla existente. Los estilos globales y comunes proporcionados por la aplicación están disponibles en la biblioteca @store/styles que está presente en el directorio <store-temp>/packages/libs/styles .

Puede modificar las variables de estilo proporcionadas por la aplicación e introducir estilos personalizados en la biblioteca @store-extensions/styles que están presentes en el directorio <store-temp>/extensions/libs/styles .

En la tabla siguiente se muestra el diseño del directorio:

Tabla 1. Personalizar el estilo de la aplicación
Vía de acceso del directorio Descripción
extensions/libs/styles La biblioteca se utiliza para anular las variables de estilo SASS proporcionadas por la aplicación y añadir estilos personalizados para utilizarlos en extensiones.
extensions/libs/styles/src/styles/custom_styles.scss Defina fuentes personalizadas, imágenes y selectores en este archivo.
extensions/libs/styles/src/styles/variables_extn.scss Los valores de variable SCSS proporcionados por la aplicación se pueden modificar y colocar en este archivo.
extensions/libs/styles/webpack.config.js Configuración de Webpack para compilar y generar archivos css de estilo personalizado.

Puede personalizar los estilos proporcionados por la aplicación y añadir estilos personalizados.

Los casos de uso de negocio soportados incluyen:
  • Alteración temporal de las variables SCSS existentes
  • Adición de fuentes de icono personalizadas
  • Adición de imágenes personalizadas
  • Adición de selectores SCSS personalizados

Asegúrese de seguir estas directrices al personalizar el estilo de aplicación.

  • No altere temporalmente los selectores existentes.
  • No cambie la configuración existente de <store-temp>/extensions/libs/styles/webpack.config.js, excepto cuando añada nuevos plug-ins para copiar imágenes.
  • No cambie los scripts en <store-temp>/extensions/libs/styles/package.json.

Alteración temporal de variables SCSS existentes

Puede personalizar el aspecto de la aplicación alterando temporalmente o añadiendo nuevas variables SCSS.

Las variables proporcionadas por la aplicación están presentes en <store-temp>\packages\libs\styles\src\styles\typography\_variables.scss

Para alterar temporalmente las variables SCCS existentes, realice los pasos siguientes:
  1. Identifique el nombre de variable SCSS proporcionado por la aplicación que desea modificar.

    Los nombres de variable SCSS proporcionados por la aplicación están presentes en <store-temp>\packages\libs\styles\src\styles\typography\_variables.scss.

  2. Copie el nombre de variable adecuado en el archivo <store-temp>\extensions\libs\styles\src\styles\variables_extn.scss y proporcione el valor adecuado en función de sus necesidades.
  3. Verifica tus cambios.
    Inicie la aplicación ejecutando el siguiente comando:
    yarn start-app

    Para verificar los cambios en el kit de herramientas del desarrollador, extraiga y despliegue las personalizaciones. Para obtener más información sobre la extracción e implantación de personalizaciones, consulte Extracción de personalizaciones.

Fragmento de código de ejemplo.

/* Overridding gray colour */
$gray-10: #2d74da;
$gray-10-15: #2d74da;

Creación de fuentes de iconos personalizadas

Para fuentes de iconos personalizadas, puede utilizar directamente bibliotecas de iconos de terceros o crear iconos personalizados siguiendo estos pasos:
  1. Cree un icono personalizado como vector utilizando cualquier herramienta para generar un formato de archiv .svg, u obtenga archivos .svg de cualquier otra fuente.
  2. Utilice los archivos .svg creados y genere las fuentes de iconos personalizadas utilizando cualquier biblioteca de iconos SVG.
    Nota:
    • No utilice archivos .svg que se hayan convertido a partir de archivos .png o .jpg.
    • Al generar iconos de fuentes, no utilice el nombre de fuente " app-glyphicons " que proporciona la aplicación. En su lugar, utilice el nombre de la fuente personalizada.
  3. Cree una nueva carpeta en la carpeta <store-temp>\extensions\libs\styles\src\styles\icons y copie todos los formatos de fuentes de iconos generados, como .ttf, .svg, .eot o .woff, incluidos los archivos SCSS o CSS de iconos personalizados de terceros, en esta carpeta.
  4. Importar la fuente de icono personalizada a un archiv <store-temp>\extensions\libs\styles\src\styles\custom_styles.scss.

    Por ejemplo: @import './icons/style.scss';

  5. Utilice el selector de clase de icono personalizado en componentes personalizados.
  6. Verifica tus cambios.
    Inicie la aplicación ejecutando el siguiente comando:
    yarn start-app

    Para verificar los cambios en el kit de herramientas del desarrollador, extraiga y despliegue las personalizaciones. Para obtener más información sobre la extracción e implantación de personalizaciones, consulte Extracción de personalizaciones.

Adición de imágenes personalizadas

Para añadir imágenes personalizadas para utilizarlas en las pantallas de componentes personalizados, realice los pasos siguientes:
  1. Puede añadir nuevas imágenes en el directorio <store-temp>\extensions\libs\styles\src\styles\images .

    Después de añadir nuevas imágenes a la extensión lib, puede incluir la imagen personalizada en los archivos de código fuente como HTML, SCSS o XSL utilizando la ruta relativa, como /assets/styles/images/custom-image.jpeg. Por ejemplo, <img src=“./assets/styles/images/sterling_login_dark_custom.svg”>.

    Nota: Asegúrese de que los nuevos nombres de clase no entren en conflicto con los nombres de clase CSS existentes.
  2. Verifica tus cambios.
    Inicie la aplicación ejecutando el siguiente comando:
    yarn start-app

    Para verificar los cambios en el kit de herramientas del desarrollador, extraiga y despliegue las personalizaciones. Para obtener más información sobre la extracción e implantación de personalizaciones, consulte Extracción de personalizaciones.

Adición de selectores SCSS personalizados

Para definir nuevos selectores globales para las características personalizadas, realice los pasos siguientes:
  1. Los selectores CSS personalizados se pueden definir en <store-temp>\extensions\libs\styles\src\styles\custom_styles.scss.
    Nota: Asegúrese de que los selectores CSS personalizados no entren en conflicto con los selectores existentes.
  2. Importe otros archivos SCCS en el archivo <store-temp>\extensions\libs\styles\src\styles\custom_styles.scss .
  3. Verifica tus cambios.
    Inicie la aplicación ejecutando el siguiente comando:
    yarn start-app

    Para verificar los cambios en el kit de herramientas del desarrollador, extraiga y despliegue las personalizaciones. Para obtener más información sobre cómo extraer e implementar personalizaciones, consulte Extraer personalizaciones.