Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Tabla de contenidos | ||||||
---|---|---|---|---|---|---|
|
Advertencia |
---|
Las normas expuestas son de obligado cumplimiento. La STIC podrá estudiar los casos excepcionales los cuales serán gestionados a través de los responsables del proyecto correspondiente y autorizados por el Área de Gobernanza de la STIC. Asimismo cualquier aspecto no recogido en estas normas deberá regirse en primera instancia por las guías técnicas correspondientes al esquema nacional de seguridad y esquema nacional de interoperabilidad según correspondencia y en su defecto a los marcos normativos y de desarrollo software establecidos por la Junta de Andalucía, debiendo ser puesto de manifiesto ante la STIC. La STIC se reserva el derecho a la modificación de la norma sin previo aviso, tras lo cual, notificará del cambio a los actores implicados para su adopción inmediata según la planificación de cada proyecto. En el caso de que algún actor considere conveniente y/o necesario el incumplimiento de alguna de las normas y/o recomendaciones, deberá aportar previamente la correspondiente justificación fehaciente documentada de la solución alternativa propuesta, así como toda aquella documentación que le sea requerida por la STIC para proceder a su validación técnica. Contacto Arquitectura: l-arquitectura.stic@juntadeandalucia.es |
Los cambios en la normativa vendrán acompañados de un registro de las modificaciones. De este modo se podrá realizar un seguimiento y consultar su evolución. Ordenándose de mas recientes a menos recientes, prestando especial cuidado a las cabeceras de la tablas dónde se indican las fechas de entrada en vigor y versión.
Expandir | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Esta guía técnica aporta información sobre cómo realizar el desarrollo de los distintos themes en los ámbitos establecidos:
Los nombres de los componentes, deberían las nuevas variables creadas deberán seguir el siguiente esquema:
<area<área_de_negocio> se sustituirá por las siguientes letras:
Advertencia | ||
---|---|---|
| ||
La modificación visual cualquier propuesta del Sistema de Diseño ha de estar regida por la creación de un DDR por parte del equipo de desarrollo del proyecto. Para ello, dentro del espacio de confluence del proyecto, sección Arquitectura, se creará una nueva subsección llamada 🎨DDL, y dentro de esta otra llamada DDR - Modificación theme <nombre(negocio|app)> con la estructura definida para los DDR por el Área de Arquitectura, especificando la justificación de la modificación. |
De manera general se define un sistema de diseño como un conjunto de reglas y normas que el equipo de una organización establece internamente y que les permite trabajar de forma alineada a través de un lenguaje común.
El Sistema de Diseño STIC proporciona pautas, componentes y plantillas para el desarrollo homogéneo de
De manera general se define un sistema de diseño como un conjunto de reglas y normas que el equipo de una organización establece internamente y que les permite trabajar de forma alineada a través de un lenguaje común.
El Sistema de Diseño STIC proporciona pautas, componentes y plantillas para el desarrollo homogéneo de las aplicaciones del SAS.
El Sistema de Diseño STIC se basa en las directivas de Material Design, adaptando sus pautas a las normativas a seguir en el SAS para el desarrollo de aplicaciones web.
Material Design v2 es un sistema de diseño creado por Google en distintos lenguajes, pero el que nos impacta es la parte web. Ofrece una serie de componentes e indicaciones sobre el diseño y personalización de estos, a cerca de su entorno, interacción, características propias de los componentes... y todo esto trasladado a la visión de UX/UI para mejorar la interactuación con el usuario en nuestras aplicaciones, intentando equilibrar el impacto visual entre todaslas aplicaciones del SAS.
Los objetivos del Sistema del Sistema de Diseño STIC son los siguientes:
El Sistema de Diseño STIC basa su construcción en el paradigma Atomic Design. Para más información acerca del paradigma Atomic Design puede consultar su sección dentro de nuestra normativa de front.
El theme es la instancia técnica del sistema de diseño. Mediante el mismo se logra la homogeneización visual de todos los componentes, pudiéndose extender para adaptarlo a nuestros diseños particulares.
El principal objetivo del theme es definir una api de diseño y desarrollo con la cual lograr que todas las aplicaciones/componentes creados en la STIC tengan una visualización homogénea.
Como se ha visto anteriormente en punto 1, se tendrán tres tipos de componentes theme:
Theme STIC nos proporciona una serie de variables custom CSS a través de su API con los que homogeneizar los estilos de todos los componentes/aplicaciones desarrollados.
El theme STIC se organiza en una serie de carpetas y archivos para facilitar su comprensión y desarrollo, y cuya estructura es la siguiente:
De dicha estructura, destacan los siguientes carpetas/ficheros:
Definición | |||
---|---|---|---|
src | Carpeta que contiene todo el código fuente del theme | ||
css | Carpeta que contiene todos los ficheros referentes a las variables custom CSS del theme | ||
border-sd.css.ts |
Fichero que incluye todas las variables |
Theme STIC nos proporciona una serie de variables custom CSS a través de su API con los que homogeneizar los estilos de todos los componentes/aplicaciones desarrollados.
El theme STIC se organiza en una serie de carpetas y archivos para facilitar su comprensión y desarrollo, y cuya estructura es la siguiente:
De dicha estructura, destacan l@s siguientes carpetas/ficheros:
relacionadas con los bordes definidos por el sistema de diseño | |||||||||||
color-sd.css.ts | Fichero que incluye todas las variables relacionadas con los colores definidos por el sistema de diseño | ||||||||||
dimension-sd.css.ts | Fichero que incluye todas las variables relacionadas con las dimensiones definidas por el sistema de diseño | ||||||||||
font-sd.css.ts | Fichero que incluye todas las variables relacionadas con la tipografía definida por el sistema de diseño | ||||||||||
grid-sd | Definición | src | Carpeta que contiene todo el código fuente del theme | css | Carpeta que contiene todos los ficheros referentes a las variables custom CSS del theme | typo | Carpeta en la que se incluyen todas los ficheros que incluyen variables para cada elemento tipográfico (p.e. typo.body.css.ts) | typo.bundle.css.ts | Fichero que incluye todas las variables relacionadas con el layout definido por el sistema de diseño | ||
---|---|---|---|---|---|---|---|---|---|---|---|
opacity-sd. | la exportación de manera única de todos los elementos tipográficostypo.base.css.ts | Fichero que | actúa como base de todos los elementos tipográficos disponibles, y cuyas propiedades son comunes a todos ellos.incluye todas las variables relacionadas con la opacidad definida por el sistema de diseño | ||||||||
overlay-sd | color.css.ts | Fichero que incluye todas las variables relacionadas con | los colores usados en el themela superposición definida por el sistema de diseño | ||||||||
shadow-sd | shape.css.ts | Fichero que incluye todas las variables relacionadas con | las formas usadas en el themela sombra definida por el sistema de diseño | ||||||||
shape-sd | state.css.ts | Fichero que incluye todas las variables relacionadas con los estados usados en el themelas formas definidas por el sistema de diseño | |||||||||
sizing-sd | shared.css.ts | Fichero que incluye todas las variables compartidas por los distintos ficheros CSS que se usan en el theme | WcTheme.ts | Incluye la clase exportable del theme | stories | Carpeta que contiene los ficheros |
color.css.ts (Colores)
La aplicación de un modelo de color para el theme ha pasado por varias fases. En una primera fase se aplicó el modelo de color Hexadecimal. Posteriormente se pasó al modelo de color RGBA ya que se necesitaba aplicar transparencia sobre los colores, cosa que con el modelo hexadecimal no se podía. En una tercera fase se decidió usar el modelo de color HSL frente al modelo RGBA ya que HSL nos permite la creación de colores sólidos aplicando una opacidad (mediante la luminosidad), mientras que con RGBA no se podía lograr esto ya que la aplicación de la opacidad sobre el color en RGBA se logra mediante la transparencia, no obteniendo colores sólidos. [hsl( hue , saturation , lightness )]. Puede encontrar más información en normativa → sección theming → color.
En este fichero hay definidos dos bloques:
shape.css.ts (Formas)
Este fichero incluye un bloque con las variables usadas en el ámbito de las formas del theming, cada una de ellas usadas para las distintas categorías establecidas dentro de esta parte (más información en normativa → sección theming → formas).
state.css.ts (Formas)
Este fichero incluye un bloque con las variables custom css usadas en el ámbito de los estados del theming, organizados por cada uno de los estados disponibles [Disabled, Hover, Focus, Selected, Activated, Pressed, Dragged] (más información en normativa → sección theming → estados).
Las variables correspondientes al color (estado disabled) se definen de la misma forma que las definidas en el archivo color.css.ts, mientras que las variables correspondientes a la elevación usan las variables creadas en fichero shared.css.ts dentro del bloque de estados, y correspondientes a los distintos dp (elevation - shadows) definidos.
ejemplo color: --theme-state-disabled-color: hsl ( 0 , 0% , var ( --theme-hsl-color-luminance-900 ));ejemplo elevación: --theme-state-hover-elevation: var ( --dp-4 );Carpeta typo (Tipografías)
En la tabla anterior se ha hecho referencia a dos ficheros concretos que son la base de esta carpeta, pero en esta sección se va a comentar sobre los distintos bloques que forman parte de los ficheros de los distintos elementos tipográficos (más información en normativa → sección theming → tipografías).
Se tienen dos casos de usos posibles:
shared.css.ts (Compartidos)
Este fichero incluye varios bloques con las variables custom css usadas en los otros ficheros, de modo de se podrán compartir entre los mis mos :
relacionadas con las dimensiones definidas por el sistema de diseño | |||
spacing-sd.css.ts | Fichero que incluye todas las variables relacionadas con el espaciado definido por el sistema de diseño | ||
state-layer-sd.css.ts | Fichero que incluye todas las variables relacionadas con el sistema de interacción definido por el sistema de diseño | ||
zindex-sd.css.ts | Fichero que incluye todas las variables relacionadas con la profundidad definida por el sistema de diseño |
En esta sección se describirán los diferentes usos del theme según su utilización en una aplicación o componente, distinguiendo los casos de usos en los mismos, y explicando su instalación y configuración en cada uno de ellos.
1) Casos de uso : Se distinguen tres casos de uso del theme dentro de una aplicación:
Caso de uso 1: Aplicaciones desarrolladas solo con web components | ||
---|---|---|
En la aplicaciones desarrolladas solo con web components solo se deberá realizar la carga del theme (Variables Custom CSS) dentro de la aplicación. El consumo de dichas variables se realizará directamente en los componentes. | ||
Paso | Descripción | Enlace |
P1 | Instalación del theme | |
P2 | Carga del theme |
Caso de uso 2: Aplicaciones que usan web components dentro de otros desarrollos en los que no se usaban web components | ||||||||
---|---|---|---|---|---|---|---|---|
El uso de web components en una aplicación que utiliza elementos HTML implica la instalación del componente stic-theme. Todos los desarrollos anteriores tendrán definidos unos estilos, de manera inline o con fichero(s) CSS, y para no crear conflicto con ellos, será la aplicación la encargada de gestionar dichos estilos redefiniendo todos los tags html que se usen en el theme. | ||||||||
Paso | Descripción | Enlace | ||||||
P1 | Instalación del theme | |||||||
P2 | Carga del theme | |||||||
P3.1 | Configuración si se usan estilos INLINE | Ir al contenido | ||||||
P3.2 | Configuración si se usan ficheros CSS (Typescript) | Ir al contenido | ||||||
P4 | Definición
| Ir al contenido | ||||||
NOTA P4 | La definición se limita incluir la clase stic-theme dentro del tag body del HTML de nuestro desarrollo. |
Caso de uso 3: Aplicaciones sin web components | ||
---|---|---|
Si no se tienen web components no es necesario, por normativa, aplicar el theme, por lo que el desarrollo anterior podrá continuar con sus estilos de la manera que lo hacía anteriormente. En el caso que se quiera incluir el theme para usar las variables que ofrece: | ||
Paso | Descripción | Enlace |
P1 | Instalación del theme | |
P2 | Carga del theme |
En esta sección se explica cómo customizar el theme de la STIC en todos los ámbitos disponibles, ya sea para modificar los valores de sus variables como para crear variables nuevas.
La creación de un theme de negocio/aplicación es necesaria cuando por requisito de diseño o bien necesito modificar alguno de los valores de las variables expuestas o bien necesito crear alguna variable que no exista el el theme.
La base técnica para realizar esta customización puede encontrarse en el siguiente repositorio: scaffolding-vite
Pasos para crear un theme de negocio | |||
---|---|---|---|
Paso | Descripción | Enlace | |
P1 | Creación de nuevo componente theme | ||
P2 | Instalación del theme | ||
P3 | Extender theme STIC | ||
NOTA | Modificar el fichero ./src/<nombre_theme>Theme.ts y, en él, realizar las importaciones del tema de la STIC para poder extenderlo (se usará CamelCase para el nombre de la clase) |
Pasos para crear un theme de aplicación | |||
---|---|---|---|
Paso | Descripción | Enlace | |
P1 | Descargar el repositorio | ||
P2 | Renombrar el fichero ./src/shared/theme/stic-appname-theme.ts y sustituir appname por el nombre de la aplicación: ejemplo: ./src/shared/theme/stic-tsv-theme.ts | ||
P3 | Extender theme STIC | ||
NOTA | Las modificaciones para extensión del theme se ha de realizar en el fichero renombrado en P2 |
Customización de variables | |||
---|---|---|---|
Paso | Descripción | Enlace | |
P1 | Customizar variables | ||
NOTA P1 | Las modificaciones para customización de variables del theme se ha de realizar en el fichero renombrado en P2 de la fase de creación del theme |
Creación de variables | |||
---|---|---|---|
En el caso justificado de tener que crear nuevas variables para exponerlas en nuestro theme creado, se procederá de la siguiente manera: | |||
Paso | Descripción | Enlace | |
P1 | Creación de nuevas variables dentro de los distintos ámbitos | ||
NOTA P1 | Las modificaciones para customización de variables del theme se ha de realizar en el fichero renombrado en P2 de la fase de creación del theme |
Ancla | ||||
---|---|---|---|---|
|
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
npm install @sas/wc-stic-theme |
Ancla | ||||
---|---|---|---|---|
|
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
// Patrón - Carga de un theme creado en el ámbito de negocio |
En esta sección se describirán los diferentes usos del theme según su utilización en una aplicación o componente, distinguiendo los casos de usos en los mismos, y explicando su instalación y configuración en cada uno de ellos.
1) Casos de uso : Se distinguen tres casos de uso del theme dentro de una aplicación:
Caso de uso 1: Aplicaciones desarrolladas solo con web components
En la aplicaciones desarrolladas solo con web components solo se deberá realizar la carga del theme (Variables Custom CSS) dentro de la aplicación. El consumo de dichas variables se realizará directamente en los componentes.
Paso
Descripción
P1
Instalación del theme
P2
Carga del theme
Caso de uso 2: Aplicaciones que usan web components dentro de otros desarrollos en los que no se usaban web components
El uso de web components en una aplicación que utiliza elementos HTML implica la instalación del componente stic-theme. Todos los desarrollos anteriores tendrán definidos unos estilos, de manera inline o con fichero(s) CSS, y para no crear conflicto con ellos, será la aplicación la encargada de gestionar dichos estilos redefiniendo todos los tags html que se usen en el theme.
Paso
Descripción
P1
Instalación del theme
P2
Carga del theme
Definición
Estado | ||||
---|---|---|---|---|
|
Caso de uso 3: Aplicaciones sin web components
Si no se tienen web components no es necesario, por normativa, aplicar el theme, por lo que el desarrollo anterior podrá continuar con sus estilos de la manera que lo hacía anteriormente.
En el caso que se quiera incluir el theme para usar las variables que ofrece:
Paso
Descripción
P1
Instalación del theme
P2
Carga del theme
1) Casos de uso: El único caso de uso posible es aquel en el que se tenga que aplicar el theme sobre web components.
Caso de uso 1: Aplicación en web components
En este caso de uso no es necesaria la instalación ni carga del theme, ya que esto será responsabilidad única de la aplicación.
Paso
Descripción
P1
Redefinición de variables custom CSS expuestas por el componente
P2
Sobreescritura de valores de un HTML tag en el componente
Anexo Caso de uso 1: Instalación del theme en web components para verificar su desarrollo
Para instalar el theme y poder verificar la correcta aplicación del mismo en fase de desarrollo de web components:
Paso
Descripción
P1
Instalación del theme (dependencia de desarrollo)
P2
Carga del theme
En esta sección se explica cómo customizar el theme de la STIC en todos los ámbitos disponibles, ya sea para modificar los valores de sus variables como para crear variables nuevas.
La creación de un theme de negocio/aplicación es necesaria cuando por requisito de diseño o bien necesito modificar alguno de los valores de las variables expuestas o bien necesito crear alguna variable que no exista el el theme.
Como se dijo anteriormente, el theme de la STIC se usa para poder consumir las variables definidas en él. Al heredar todas las variables del theme de la STIC, solo se tendrán que incluir en el theme creado las variables que se necesiten sobrescribir, y las que no se incluyan tomarán el valor que tienen del theme de la STIC.
Pasos para crear un theme
Los pasos necesarios para crear un theme se detallan a continuación. En cada paso, en caso que se necesario, se especificando dos soluciones, una por cada ámbito posible: Negocio / Aplicación
Paso
Descripción
P1
Crear el componente
Ámbito de negocio
Ámbito de aplicación
P2
Instalación del theme
P3
Extender theme STIC
Customización de variables
Paso
Descripción
P1
Customizar variables
Creación de variables
En el caso justificado de tener que crear nuevas variables para exponerlas en nuestro theme creado, se procederá de la siguiente manera:
Paso
Descripción
P1
Creación de nuevas variables dentro de los distintos ámbitos
Ámbito de negocio
Ámbito de aplicación
P2
Redefinición y valor por defecto de las variables en los distintos ámbitos
Estado | ||||
---|---|---|---|---|
|
Ámbito de negocio
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
npm install @sas/wc-stic-theme |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
// Patrón - Carga de un theme creado en el ámbito de negocio <body> ... <script type="module"> import { STICTheme } from '@sas/wc-stic-theme'; import { STIC<nombre_area_negocio>Theme } from '@sas/wc-stic-<nombre_area_negocio>-theme'; new STICTheme().loadHeadStyles(); new STIC<nombre_area_negocio>Theme().loadHeadStyles(); </script> </body> // Patrón - Carga de un theme creado en el ámbito de aplicación <body> ... <script type="module"> import { STICTheme } from '@sas/wc-stic-theme'; // Si existe el theme del área de negocio import { STIC<nombre_area_negocio>Theme } from '@sas/wc-stic-<nombre_area_negocio>-theme'; import { STIC<nombre_aplicacion>Theme } from '@sas/wc-stic-<nombre_aplicacion>-theme'; new STICTheme().loadHeadStyles(); // Si existe el theme del área de negocio new STIC<nombre_area_negocio>Theme().loadHeadStyles(); new STIC<nombre_aplicacion>Theme().loadHeadStyles(); </script> </body> // Ejemplo de carga - Theme STIC <body> ... <script type="module"> import { STICTheme } from '@sas/wc-stic-theme'; new STICTheme().loadHeadStyles(); </script> </body> // Ejemplo de carga - Theme área de Negocio (RRHH) <body> ... <script type="module"> import { STICTheme } from '@sas/wc-stic-theme'; import { STICRRHHTheme } from '@sas/wc-stic-rrhh-theme'; new STICTheme().loadHeadStyles(); new STICRRHHTheme().loadHeadStyles(); </script> </body> // Ejemplo de carga - Theme aplicación (Gerhonte - RRHH) <body> ... <script type="module"> import { STICTheme } from '@sas/wc-stic-theme'; import { STICRRHHTheme"module"> import { STICTheme } from '@sas/wc-stic-rrhh-theme'; importimport { STICGehonteThemeSTIC<nombre_area_negocio>Theme } from '@sas/wc-stic-gerhonte<nombre_area_negocio>-theme'; new STICTheme().loadHeadStyles(); new STICRRHHThemeSTIC<nombre_area_negocio>Theme().loadHeadStyles(); new STICGehonteTheme().loadHeadStyles(); </script> </body> |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
/body> // Patrón - ConfiguraciónCarga mediantede estilos inline <!doctype html> <html lang="en"> <head> un theme creado en el ámbito de aplicación <body> ... <script type="module"> <style> import { STICTheme } ... .theme-stic <tag_html>{ from '@sas/wc-stic-theme'; // Si existe el theme del área de negocio import { <propiedad_css>: var(--theme-<tipo_css>-<nombre_theme_tag_html>-<propiedad_css>);STIC<nombre_area_negocio>Theme } from '@sas/wc-stic-<nombre_area_negocio>-theme'; import { STIC<nombre_aplicacion>Theme } </style> </head>from '@sas/wc-stic-<nombre_aplicacion>-theme'; <body> new ... </body> </html> STICTheme().loadHeadStyles(); // EjemploSi -existe Configuraciónel mediantetheme estilosdel inlineárea (tagde H1) <!doctype html> <html lang="en"> <head> ... <style> negocio new STIC<nombre_area_negocio>Theme().loadHeadStyles(); new STIC<nombre_aplicacion>Theme().loadHeadStyles(); </script> </body> // Ejemplo de carga - Theme STIC <body> ... .theme-stic h1{<script type="module"> import { STICTheme } from font-size: var(--theme-typography-headline1-font-size);'@sas/wc-stic-theme'; new STICTheme().loadHeadStyles(); }</script> </body> // Ejemplo de carga - </style> Theme área </head> de Negocio (RRHH) <body> ... </body> </html> |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
// Patrón - Configuración mediante fichero CSS (TS)
import { css } from "lit";
...
AppTheme.cssBase = css `
.theme-stic <tag_html>{
<propiedad_css>: var(--theme-<tipo_css>-<nombre_theme_tag_html>-<propiedad_css>);
}
}
...
`;
// Ejemplo - Configuración mediante fichero CSS (tag H1)
import { css } from "lit";
...
AppTheme.cssBase = css `
.theme-stic h1{
font-size: var(--theme-typography-headline1-font-size);
}
}
...
`; |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
...
<body class="stic-theme">
...
</body>
... |
Advertencia | ||
---|---|---|
| ||
El siguiente contenido (Redefinición de variables Custom CSS) está marcado como deprecado y no deberá usarse. |
<script type="module">
import { STICTheme } from '@sas/wc-stic-theme';
import { STICRRHHTheme } from '@sas/wc-stic-rrhh-theme';
new STICTheme().loadHeadStyles();
new STICRRHHTheme().loadHeadStyles();
</script>
</body>
// Ejemplo de carga - Theme aplicación (Gerhonte - RRHH)
<body>
...
<script type="module">
import { STICTheme } from '@sas/wc-stic-theme';
import { STICRRHHTheme } from '@sas/wc-stic-rrhh-theme';
import { STICGehonteTheme } from '@sas/wc-stic-gerhonte-theme';
new STICTheme().loadHeadStyles();
new STICRRHHTheme().loadHeadStyles();
new STICGehonteTheme().loadHeadStyles();
</script>
</body> |
Ancla | ||||
---|---|---|---|---|
|
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Bloque de código | ||||||||
| ||||||||
// Patrón - Redefinición de variables Custom CSS static cssBase: CSSResult = css` Configuración mediante estilos inline <!doctype html> <html lang="en"> <head> ... :host {<style> ... .theme-stic <tag_html>{ --<nombre-componente>-<tipo_css>- <propiedad_css>: var(--theme-<tipo_css>-<nombre_theme_tag_html>-<propiedad_css>); } </style> </head> <body> ... `; </body> </html> // Ejemplo - RedefiniciónConfiguración demediante variablesestilos Custominline CSS - componente boton - propiedad shape top left static cssBase: CSSResult = css`(tag H1) <!doctype html> <html lang="en"> <head> ... :host {<style> ... .theme--stic-button-shape-top-leftstic h1{ font-size: var(--theme-typography-shape-small);headline1-font-size); } </style> </head> <body> ... `; </body> </html> |
Ancla | ||||
---|---|---|---|---|
|
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
// Patrón - SobreescrituraConfiguración demediante valores static cssBase: CSSResult = css` fichero CSS (TS) import { css } from "lit"; ... AppTheme.cssBase = :host <tag_html>{css ` ... .theme-stic <tag_html>{ <propiedad_css>: var(--<nombre_componente>-<nombre_theme_tag_html>-<propiedad_css>, var(--theme-<tipo_css>-<nombre_theme_tag_html>-<propiedad_css>)); ... } `; // Ejemplo - Sobreescritura de valores aplicada al tag H1 en la propiedad font-size static cssBase: CSSResult = css` ... :host h1{ ... font-size: var(--stic-radio-button-headline1-font-size, var(--theme-typography-headline1-font-size)); ... } `; |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
npm install @sas/wc-stic-theme --save-dev |
);
}
}
...
`;
// Ejemplo - Configuración mediante fichero CSS (tag H1)
import { css } from "lit";
...
AppTheme.cssBase = css `
.theme-stic h1{
font-size: var(--theme-typography-headline1-font-size);
}
}
...
`; |
Ancla | ||||
---|---|---|---|---|
|
Bloque de código | ||
---|---|---|
|
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
sas-cli wc:create theme... <body class="stic-theme"> ... </body> ... |
Ancla | ||||
---|---|---|---|---|
|
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
// Patrón - Creación de una aplicación sas-cli wc:create <nombre_app>-theme// Patrón - Sobreescritura de valores static cssBase: CSSResult = css` ... :host <tag_html>{ ... <propiedad_css>: var(--<nombre_componente>-<nombre_theme_tag_html>-<propiedad_css>, var(--theme-<tipo_css>-<nombre_theme_tag_html>-<propiedad_css>)); ... } `; // Ejemplo - CreaciónSobreescritura de lavalores aplicación gerhonte sas-cli wc:create gerhonte-theme |
aplicada al tag H1 en la propiedad font-size
static cssBase: CSSResult = css`
...
:host h1{
...
font-size: var(--stic-radio-button-headline1-font-size, var(--theme-typography-headline1-font-size));
...
}
`; |
Ancla | ||||
---|---|---|---|---|
|
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
npm install |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
// Patrón - Extender Theme STIC import { WcSTICTheme } from '@sas/wc-stic-theme'; export class Wc<nombre_theme>Theme extends WcSTICTheme { ... } // Ejemplo - Extender Theme STIC desde el área de Negocio RRHH import { WcSTICTheme } from '@sas/wc-stic-theme'; export class WcRRHHTheme extends WcSTICTheme { ... } --save-dev |
Ancla | ||||
---|---|---|---|---|
|
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
// Patrón sas- Customización de variables import { css, CSSResult } from "lit"; export const theme<tipo_css>: CSSResult = css` :root { --theme-<tipo_css>-<propiedad>: <nuevo_valor>; } ` // Ejemplo - Customización de una variable del tipo color import { css, CSSResult } from "lit"; export const themeColor: CSSResult = css` :root { --theme-color-primary: hsl(0, 100%, 70%); } ` |
cli wc:create theme |
Ancla | ||||
---|---|---|---|---|
|
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
git clone http://git.sas.junta-andalucia.es/gobernanza/ArchivosDeDesarrollo/nodejs/scaffolding-vite.git |
Ancla | ||||
---|---|---|---|---|
|
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
// Patrón - Extender Theme STIC
import { STICTheme } from '@sas/wc-stic-theme';
export class Stic<nombre_theme>Theme extends STICTheme {
themeStyles(): Array<CSSResultOrNative> {
return [...super.themeStyles(), <listado_const_theme>];
}
}
// Ejemplo 1 - Extender Theme STIC desde el área de Negocio RRHH
import { STICTheme } from '@sas/wc-stic-theme';
export class SticRRHHTheme extends STICTheme {
themeStyles(): Array<CSSResultOrNative> {
return [...super.themeStyles(), <listado_const_theme>];
}
}
// Ejemplo 2 - Extender Theme STIC desde la aplicacion TSV
import { STICTheme } from '@sas/wc-stic-theme';
export class SticTSVTheme extends STICTheme {
themeStyles(): Array<CSSResultOrNative> {
return [...super.themeStyles(), <listado_const_theme>];
}
} |
Ancla | ||||
---|---|---|---|---|
|
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
// Patrón - Creación de variables en el ámbito de Negocio
--<área_de_negocio>-theme-<propiedad_css>: <valor>;
// Ejemplo - Creación de una variable en el ámbito de Negocio RRHH
--rrhh-theme-shape-small: 8px; |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
// Patrón - Creación de variables en el ámbito de Aplicación
--<área_de_negocio>-<app>-theme-<propiedad_css>: <valor>;
// Ejemplo - Creación de una variable en el ámbito de Aplicación Gerhonte (RRHH)
--rrhh-gerhonte-theme-shape-small: 10px; |
Ancla | ||
---|---|---|
|
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
// Patrón - RedefiniciónCustomización de variables import en{ elcss, ámbitoCSSResult, de Negocio --theme-<propiedad_css>: var(--<área_de_negocio>-theme-<propiedad_css>, var(--theme-<propiedad_css>)) // Ejemplo - Redefinición de una variable en el ámbito de Negocio RRHH --theme-shape-small: var(--rrhh-theme-shape-small, var(--theme-shape-small)); |
Advertencia | ||
---|---|---|
| ||
El siguiente contenido (Redefinicion de Variables en el ámbito de Aplicación (caso 1)) está marcado como deprecado y no deberá usarse. |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
// Patrón - Redefinición de variables en el ámbito de Aplicación y estando definido el theme del área de Negocio --<área_de_negocio>-theme-<propiedad_css>: var(--<área_de_negocio>-<app>-theme-<propiedad_css>, var(--<área_de_negocio>-theme-<propiedad_css>))CSSResultOrNative } from 'lit'; export const <tipo_css>Theme: CSSResult = css` :root { <variable_theme_stic>: <nuevo_valor>; } ` // Ejemplo - Customización de una variable de color para el ámbito de negocio de RRHH import { css, CSSResult, CSSResultOrNative } from 'lit'; export const colorTheme: CSSResult = css` :root { --color-background-action-primary-default: #ff0000; } `; // Ejemplo - Redefinición Customización de una variable de variablestipografía enpara el ámbito de Aplicación Gerhonte y estando definido el theme del área de Negocio (RRHH) --rrhh-theme-shape-small: var(--rrhh-gerhonte-theme-shape-small, var(--rrhh-theme-shape-small)); |
title | Contenido deprecado |
---|
la aplicación TSV
import { css, CSSResult, CSSResultOrNative } from 'lit';
export const fontTheme: CSSResult = css`
:root {
--font-size-sm: 20px;
}
`; |
Ancla | ||||
---|---|---|---|---|
|
Bloque de código | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||
// Patrón - Creación de variables en el ámbito de Negocio --<área_de_negocio>-<variable_theme_stic>: <valor>; // Patrón - RedefiniciónCreación de variables en el ámbito de Aplicación y NO estando definido el theme del área --<área_de_negocio>-<app>-<variable_theme_stic>: <valor>; // Ejemplo - Creación de una variable en el ámbito de Negocio RRHH --theme-<propiedad_css>: var(--<área_de_negocio>-<app>-theme-<propiedad_css>, var(--theme-<propiedad_css>))rrhh-color-background-action-primary-default: #ff0000; // Ejemplo - RedefiniciónCreación de una variablesvariable en el ámbito de Aplicaciónla Gerhonte y NO estando definido el theme del área de Negocio (RRHH) --theme-shape-small: var(aplicación TSV --rrhh-gerhontetsv-themefont-shapesize-small, var(--theme-shape-small))sm: 20px; |