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:
| 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.
- 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
- 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.
- 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.
- Verifica tus cambios.Inicie la aplicación ejecutando el siguiente comando:
yarn start-appPara 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.
/* Overridding gray colour */
$gray-10: #2d74da;
$gray-10-15: #2d74da;
Creación de fuentes de iconos personalizadas
- Cree un icono personalizado como vector utilizando cualquier herramienta para generar un formato de archiv
.svg, u obtenga archivos.svgde cualquier otra fuente. - Utilice los archivos
.svgcreados y genere las fuentes de iconos personalizadas utilizando cualquier biblioteca de iconos SVG.Nota:- No utilice archivos
.svgque se hayan convertido a partir de archivos.pngo.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.
- No utilice archivos
- 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,.eoto.woff, incluidos los archivos SCSS o CSS de iconos personalizados de terceros, en esta carpeta. - 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'; - Utilice el selector de clase de icono personalizado en componentes personalizados.
- Verifica tus cambios.Inicie la aplicación ejecutando el siguiente comando:
yarn start-appPara 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
- 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. - Verifica tus cambios.Inicie la aplicación ejecutando el siguiente comando:
yarn start-appPara 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
- 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.
- Importe otros archivos SCCS en el archivo <store-temp>\extensions\libs\styles\src\styles\custom_styles.scss .
- Verifica tus cambios.Inicie la aplicación ejecutando el siguiente comando:
yarn start-appPara 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.