Parte 2: Cimientos de estilo¶
Esta versión pública conserva las explicaciones y omite fragmentos que reproducen o adaptan la plantilla comercial.
Esta parte deja la base sobre la que se construye toda la interfaz: Bootstrap
instalado por partes en vez de entero, una carpeta src/styles/ con las
variables, los tokens de color, las fuentes y las reglas base, un único
archivo src/styles.scss que los ordena, los alias de importación y el
esqueleto de página de Portify (encabezado, navegación vertical y columna de
contenido). Cada sección que se estilice después importa estas piezas y se
coloca dentro de ese esqueleto; por eso van primero.
Si llegaste aquí desde un buscador. Esta página es una parte de la guía «Cómo se construye este sitio», escrita sobre el repositorio de janioisacura.com, un portfolio hecho con Angular que se publica como HTML estático. El punto de partida visual es Portify, una plantilla HTML con Bootstrap 5 y SCSS que aquí se reconstruye en Angular. Cada módulo explica el problema, muestra el código completo y lo que enseña sirve para cualquier proyecto que use Bootstrap con Sass, con Angular o sin él. Para seguirla necesitas Node.js y el CLI de Angular.
Proyecto: src/styles/, src/styles.scss, el bloque "styles" de
angular.json, tsconfig.json y src/app/shared/. Sitio publicado:
janioisacura.com; el fondo amarillo, la
navegación vertical y el menú móvil son lo que esta parte construye (si aún no
se ven, la rama de trabajo no se ha publicado).
Qué vas a aprender:
- Módulo E1:
Bootstrap por partes. Por qué el CSS de Portify pesa 4 MB, qué partes de
Bootstrap usa el sitio, cómo queda la carpeta
src/styles/y en qué orden las importastyles.scss. - Módulo E2:
Variables sin CSS. El archivo
_tools.scssque los componentes importan sin duplicar Bootstrap, el mixin de breakpoints y la pregunta que siempre aparece: por qué@importy no@use. - Módulo E3: Tokens de color. El truco de Portify de guardar el color como tripleta RGB, para qué sirve y por qué los colores de marca todavía no son tokens.
- Módulo E4: Fuentes y reglas base.
Dónde quedaron los
@font-facede la Parte 1, qué parte del reset de Portify se convirtió en variables de Bootstrap y qué reglas globales quedan. - Módulo E5: Alias de
importación.
@shared,@home,@generatede@interfacesentsconfig.json, quién los resuelve y por qué el script de contenido los escribe también. - Módulo E6:
El esqueleto de página.
Appdueña del<main>, el encabezado con el menú móvil gobernado por una señal, las secciones de la portada en una constante y los enlaces por fragmento que funcionan desde cualquier página. - Módulo E7: Los estilos del menú. El SCSS de Portify traducido a un componente encapsulado: panel deslizante, overlay por combinador de hermanos, línea animable y el error de la barra de scroll.
Cada módulo sigue el mismo orden: el problema que resuelve, la decisión tomada en este sitio, el procedimiento o el código completo, cómo funciona por dentro, errores comunes y preguntas de entrevista con su respuesta.
Esta página es una parte de la guía Cómo se construye este sitio; allí están el mapa y la ruta recomendada. Conviene haber leído antes Estilos y animaciones, que describe los tres archivos SCSS de Portify que aquí se traducen, y la Parte 1, de donde vienen las fuentes que esta parte carga.
Módulo E1: Bootstrap por partes y la carpeta src/styles¶
Fuente: package.json, angular.json, src/styles.scss y
src/styles/_bootstrap.scss del repositorio.
El problema que resuelve¶
El HTML de Portify está escrito con Bootstrap: la rejilla (row, col-xl-9),
los utilitarios (d-flex, gap-4, mb-4, d-xl-none) y los botones
(btn, btn-secondary). Para reconstruir sus pantallas en Angular hace falta
ese mismo CSS. Pero la plantilla importa Bootstrap entero y le suma la
fuente de iconos Phosphor en base64; su index.css compilado pesa 4 MB sin
minificar. El sitio no usa el modal, el carrusel, los tooltips ni el
JavaScript de Bootstrap, y Angular tiene un presupuesto (budgets en
angular.json) que avisa cuando el paquete inicial pasa de 600 kB.
La decisión en este sitio¶
- Bootstrap 5.3 se instala por npm y se importa sólo por partes:
root,reboot,images,containers,grid,buttons,utilitiesyutilities/api. Nada de componentes (modal, nav, dropdown) y nada de JavaScript, así que tampoco hace falta Popper. - Los estilos globales viven en una carpeta
src/styles/con cinco archivos parciales, uno por responsabilidad, ysrc/styles.scsssólo los importa en orden. - Las versiones de Bootstrap en el
package.jsonllevan acento circunflejo (^5.3.9), como el resto de dependencias: acepta parches y versiones menores, no una 6.
El procedimiento¶
Instalar Bootstrap desde la raíz del repositorio:
npm install [email protected]
Crear la carpeta y los archivos. Los nombres que empiezan por guion bajo son parciales de Sass: no se compilan por su cuenta, sólo cuando otro archivo los importa.
src/styles/_bootstrap.scss:
src/styles.scss, el archivo que angular.json declara en "styles":
Y en angular.json, dentro de architect.build.options, debajo de
"styles":
"stylePreprocessorOptions": {
"includePaths": ["src/styles"],
"sass": { "silenceDeprecations": ["import"] }
}
Comprobar con npm run build. La tabla que imprime Angular muestra el peso
del CSS global:
106 kB sin comprimir y unos 10 a 15 kB comprimidos, frente a los 4 MB de la plantilla. El presupuesto de 600 kB queda lejos.
Cómo funciona por dentro¶
- Bootstrap son muchos archivos pequeños.
node_modules/bootstrap/scss/tiene un parcial por pieza:_grid.scss,_buttons.scss, etc. El archivobootstrap.scssque importa la plantilla no es más que una lista que los importa todos. Escribir la lista uno mismo es la forma oficial de usar sólo una parte; Bootstrap lo documenta como «importar por partes». - El orden importa. Las partes que emiten CSS necesitan que antes se
hayan cargado las funciones, las variables, los mapas y los mixins; eso lo
hace
_tools.scss(Módulo E2), y por esostyles.scsslo importa primero. Dentro de_bootstrap.scss,utilitiestiene que ir antes deutilities/api: el primero define el mapa$utilities(qué clases existen) y el segundo lo recorre y genera las clases. rootyreboot.rootescribe las variables CSS--bs-*en:root;rebootes el reset de Bootstrap (márgenes,box-sizing, tipografía base delbody, enlaces). Las reglas delbodyque Portify escribía a mano salen de aquí a partir de variables (Módulo E4).- Angular resuelve
bootstrap/scss/...buscando ennode_modules, igual que haría webpack. No hace falta ruta relativa ni el prefijo~de otros proyectos. includePathsañadesrc/styles/a las carpetas donde Sass busca lo que se importa sin ruta. Así un componente ensrc/app/shared/components/header/escribe@import 'tools';en vez de@import '../../../../styles/tools';.silenceDeprecations: ["import"]calla el aviso de Sass por usar@import. El Módulo E2 explica por qué se usa igual.
Errores comunes¶
- Importar
bootstrap/scss/bootstrap«para ir rápido». Trae los 30 y pico componentes y multiplica el CSS; después cuesta saber qué se usa. Mejor empezar por lo mínimo y añadir un parcial cuando una pantalla lo pida. utilities/apisinutilities. Falla con «undefined variable$utilities»: el mapa que recorre la API no existe.- Usar clases que necesitan el JavaScript de Bootstrap.
data-bs-toggle,data-bs-spyocollapseno hacen nada sin el bundle de JS, que aquí no se incluye a propósito. El menú móvil y el resaltado de la sección activa se hacen con Angular. - Olvidar
includePathsy mover la carpeta. Sisrc/styles/cambia de sitio (por ejemplo asrc/app/styles/), hay que actualizarincludePathsy las rutas destyles.scss; los dos apuntan a la carpeta por su ruta.
Preguntas de entrevista (senior)¶
1. ¿Por qué importar Bootstrap por partes en lugar de importarlo entero y quitar lo que sobra con PurgeCSS?¶
Respuesta:
PurgeCSS borra las clases que no encuentra en el HTML, pero trabaja a
ciegas: una clase que Angular añade en tiempo de ejecución ([class.open])
o que viene de una variable no aparece en el HTML y se borra igual, y hay que
mantener una lista de excepciones. Importar por partes es explícito: se sabe
exactamente qué hay en el CSS, no depende de un escaneo y no tiene falsos
positivos. Las dos cosas se pueden combinar; aquí la primera alcanza, el CSS
queda en unos 15 kB comprimidos.
2. ¿Qué hace reboot y en qué se diferencia de un reset como normalize.css?¶
Respuesta:
Los dos parten de la misma idea: igualar los estilos por defecto de los
navegadores. normalize.css corrige diferencias entre navegadores y conserva
los valores útiles (por ejemplo, el tamaño de los títulos). reboot es
normalize más las opiniones de Bootstrap: box-sizing: border-box en
todo, márgenes sólo hacia abajo, la tipografía base del body y los enlaces
tomados de variables de Sass, y los <h1> a <h6> con los tamaños de
$h1-font-size y compañía. Como todo sale de variables, cambiar la fuente
del sitio es cambiar una variable antes de importar reboot, no escribir una
regla que lo pise.
3. ¿Cómo sabes cuánto pesa el CSS que publica Angular y si entra en el presupuesto?¶
Respuesta:
La tabla que imprime ng build da el tamaño en crudo y el «estimated
transfer size», una estimación comprimida. Los presupuestos están en
angular.json, en budgets: el de tipo initial suma JavaScript y CSS de la
primera carga (aquí avisa a 600 kB y falla a 1 MB) y el de
anyComponentStyle limita el CSS de cada componente (4 kB y 8 kB). Si un
componente de estilos grandes pasa el límite, se sube el presupuesto a
conciencia o se mueve parte del estilo a los globales; la decisión queda
escrita en el angular.json.
Módulo E2: Variables sin CSS y por qué import y no use¶
Fuente: src/styles/_tools.scss del repositorio.
El problema que resuelve¶
Los componentes de Angular tienen sus propios archivos de estilo, y van a
necesitar las mismas herramientas que los globales: el mixin de breakpoints
de Portify (min-width(xl)), los colores ($black) y los mapas de Bootstrap
($grid-breakpoints). Si un componente importara _bootstrap.scss para
tenerlas, Angular copiaría todo el CSS de Bootstrap dentro del estilo de ese
componente, una vez por componente. Hace falta un archivo que dé las
variables y los mixins sin emitir una sola regla CSS.
La decisión en este sitio¶
_tools.scssimporta de Bootstrap sólofunctions,variables,variables-dark,mapsymixins: definiciones, no CSS. Cualquier archivo puede importarlo tantas veces como haga falta sin engordar el resultado.- Antes de las variables de Bootstrap van los valores de Portify (colores,
botones, el mapa de
guttershasta 10) y la tipografía de marca de la Parte 1 expresada como variables de Bootstrap. - El mixin
min-widthde Portify se copia con una corrección: usamap.getdel módulosass:mapen lugar de la función globalmap-get, que Sass ha desaprobado. - Se mantiene
@importpara cargar Bootstrap, con el aviso de Sass silenciado, y la razón queda escrita en un comentario al principio del archivo para que no se pierda. $header-height(69 px) es la altura de la barra del encabezado cuando es fija por debajo dexl. Vive aquí porque la usan_base.scssy, como valor inicial, el componente (el Módulo E7).
El código¶
src/styles/_tools.scss completo:
Desde un componente se usa así:
Cómo funciona por dentro¶
!defaultes la clave de los overrides. Cada variable de Bootstrap está declarada como$primary: $blue !default;, que significa «asigna este valor sólo si la variable no existe todavía». Por eso los valores propios van antes de@import 'bootstrap/scss/variables': cuando Bootstrap llega a$primary, ya vale$yellowy respeta ese valor. Puestos después, ya no cambian nada de lo que Bootstrap calculó con ellos (los colores de los botones, por ejemplo).@importcomparte un único ámbito global. Todo lo que define un archivo importado (variables, funciones, mixins) queda visible para los archivos siguientes. Bootstrap 5 cuenta con eso:_variables.scssllama a funciones de_functions.scsssin cargarlas, porque da por hecho que alguien las importó antes. Y_mixins.scssusa variables de_variables.scssde la misma forma.@useaísla cada archivo en un módulo. Lo que define un archivo cargado con@usesólo se ve con prefijo (tools.$black,@include tools.min-width(xl)), y las variables se configuran conwith (...). Es el diseño correcto para código nuevo, pero no sirve para Bootstrap 5:@use 'bootstrap/scss/variables' with ($primary: $yellow)falla porque, ya dentro de su módulo,_variables.scssno encuentra las funciones que necesita. Bootstrap migrará al sistema de módulos en la versión 6; hasta entonces su documentación sigue mostrando@import.- Por qué no mezclar. Los componentes podrían hacer
@use 'tools'y escribir todo con prefijo, pero_tools.scssseguiría cargando Bootstrap con@importpor dentro, así que el aviso de Sass aparecería igual y el proyecto tendría dos sintaxis. Mejor una sola, y el cambio completo cuando Bootstrap 6 lo permita:_tools.scsspasa a@use ... with (...), los componentes a@use 'tools', y se borrasilenceDeprecations. @use 'sass:map'sí. Los módulos integrados de Sass (sass:map,sass:math,sass:color) se cargan con@usesin ese problema, y las funciones globales equivalentes (map-get,map-keys) están desaprobadas y desaparecerán en Dart Sass 3. La regla@usetiene que ir al principio del archivo, antes de cualquier@import; sólo los comentarios pueden precederla.- Importar
toolsdos veces no cuesta nada.styles.scsslo importa una vez para los globales y cada componente otra vez para sí mismo. Como no emite CSS, el resultado no crece; Sass sólo vuelve a calcular variables.
Errores comunes¶
- Poner los valores propios después de importar
variables. No da error: Bootstrap simplemente ya decidió todo con sus valores por defecto y los tuyos no se usan donde importaba. - Importar
_bootstrap.scss(el que emite CSS) desde un componente. Funciona, pero cada componente que lo haga lleva una copia entera de la rejilla y los utilitarios, y el presupuestoanyComponentStyleavisa. - Usar
map-geten vez demap.get. Angular muestra el aviso «Global built-in functions are deprecated» en cada compilación. Se corrige con@use 'sass:map'al principio ymap.get/map.keysen el código. - Colocar
@usedespués de un@importo de una regla. Sass lo rechaza: «@use rules must be written before any other rules». - Pedir un breakpoint que no existe (
min-width(xxxl)). El mixin no falla, pero emite el@warncon la lista de nombres válidos:xs,sm,md,lg,xl,xxl.
Preguntas de entrevista (senior)¶
1. ¿Qué diferencia hay entre @import y @use en Sass, y por qué este proyecto usa @import si está desaprobado?¶
Respuesta:
@import vuelca todo lo que define el archivo importado en un ámbito global
compartido, se puede repetir y las variables se pisan por orden de carga.
@use carga el archivo una sola vez como módulo con espacio de nombres, sus
miembros se leen con prefijo y se configuran con with (...); evita
colisiones y hace explícito de dónde viene cada cosa. Es la sintaxis
recomendada, pero una dependencia escrita para el ámbito global, como
Bootstrap 5, no se puede cargar con @use sin romperse: sus archivos cuentan
con ver las funciones y variables de los anteriores. La decisión es seguir la
sintaxis que la dependencia soporta, silenciar ese único aviso y documentar
en el código el momento de migrar (Bootstrap 6).
2. ¿Cómo permite !default «tematizar» una librería sin tocar su código?¶
Respuesta:
!default asigna un valor sólo si la variable no estaba definida. La librería
declara todos sus ajustes así, y quien la usa define los suyos antes de
importarla: la librería respeta los que existen y rellena el resto. Es una
inversión del orden habitual (primero mis valores, después la librería) y
exige disciplina en el orden de los @import. El equivalente con módulos es
@use 'lib' with ($primary: ...), que hace lo mismo pero verificado: si pasas
una variable que la librería no declara, Sass da error en vez de ignorarla.
3. Un componente necesita un breakpoint de Bootstrap. ¿Cómo lo haces sin duplicar el CSS de Bootstrap en ese componente?¶
Respuesta:
Separando «definiciones» de «CSS»: un parcial que sólo importa functions,
variables, maps y mixins de Bootstrap no emite reglas, así que cada
componente puede importarlo sin coste. El componente escribe @import 'tools'
(con includePaths para no escribir la ruta) y usa @include
media-breakpoint-up(xl) de Bootstrap o el mixin propio min-width(xl). El
CSS que sí pesa, rejilla y utilitarios, se importa una sola vez en los
estilos globales.
Módulo E3: Tokens de color como tripletas RGB¶
Fuente: src/styles/_tokens.scss del repositorio y la sección
Cómo se define el color de la
referencia de Portify.
El problema que resuelve¶
El mismo color aparece decenas de veces en Portify con distintas opacidades:
el negro sólido en el texto, el negro al 30 % en la línea del menú, al 15 % en
el fondo del enlace activo, al 6 % en el pie. Con una variable de Sass
($black) eso se resuelve en tiempo de compilación, pero el color queda
«horneado» en el CSS y no se puede cambiar en el navegador. Con una variable
CSS (--black: #000) se puede cambiar en vivo, pero rgba(var(--black), 0.3)
no es válido: rgba() espera tres números, no un color.
La decisión en este sitio¶
- Se conserva el mecanismo de Portify: tres variables CSS en
:rootcuyo valor es la tripleta RGB sinrgb(). El color se usa siempre a través dergb(var(--x))orgba(var(--x), alpha). - Los valores son los de Portify: amarillo
#ffdb67, negro y blanco. La paleta de marca de Janio (morado#563d7c, violeta, amarillo, verde azulado y verde) está documentada endocs/site-structure.mdy no se convierte en tokens todavía; Janio decide cuándo, con los bocetos. - El amarillo existe en dos sitios y hay que cambiarlo en los dos: aquí como
--primarypara los estilos propios, y en_tools.scsscomo$primarypara lo que Bootstrap compila (los botones).
El código¶
src/styles/_tokens.scss:
Uso en cualquier regla, global o de componente:
Cómo funciona por dentro¶
var()sustituye texto. Una variable CSS puede contener cualquier cosa, no sólo un color.--black: 0, 0, 0guarda literalmente «0, 0, 0», yrgba(var(--black), 0.3)se convierte enrgba(0, 0, 0, 0.3)antes de que el navegador lo interprete. Por eso funciona aunquergba()no acepte un color como primer argumento.- Cambiar un token cambia todo en vivo. Portify lo aprovecha en su
selector de color de demostración:
document.documentElement.style.setProperty('--primary', '255, 0, 0')repinta la página entera. Aquí no hay selector, pero el mecanismo queda disponible para un modo oscuro o para aplicar la marca más adelante. - Dos mundos: Sass y CSS.
$primary(Sass) se evalúa al compilar y ya no existe en el navegador; Bootstrap lo usa para generar.btn-secondaryy sus estados.--primary(CSS) vive en el navegador y lo leen las reglas propias. Portify mezcla los dos y por eso un cambio de paleta exige tocar_tools.scssy_tokens.scss. - La alternativa moderna. CSS tiene hoy
color-mix(in srgb, var(--black) 30%, transparent)y la sintaxis de color relativorgb(from var(--black) r g b / 0.3), que permiten guardar el color completo (--black: #000) y derivar opacidades. Funcionan en los navegadores actuales; se conserva la tripleta porque es lo que usa todo el SCSS de Portify que se va a traducir, y cambiarlo sería reescribir cada regla.
Errores comunes¶
- Escribir
color: var(--black). El resultado escolor: 0, 0, 0, que no es un color válido, y la regla se ignora sin aviso. Siempre dentro dergb()orgba(). - Guardar la tripleta con
rgb()incluido (--black: rgb(0, 0, 0)). Entoncesrgb(var(--black))se convierte enrgb(rgb(0, 0, 0))y falla. - Cambiar sólo
--primaryy esperar que cambien los botones. Los botones salen de$primaryy$secondarycompilados; hay que cambiar también_tools.scss. - Convertir la paleta de marca en tokens «porque ya está documentada». En esta etapa los tokens mantienen los valores de la plantilla a propósito.
Preguntas de entrevista (senior)¶
1. ¿Cuándo usas una variable de Sass y cuándo una variable CSS?¶
Respuesta:
Variable de Sass para lo que se decide al compilar y no cambia después: breakpoints, espaciados que alimentan mapas y bucles, configurar una librería como Bootstrap. Variable CSS para lo que puede cambiar en el navegador o depende del contexto: colores de tema, modo oscuro, un valor que JavaScript o una clase en un contenedor ajustan, y todo lo que un componente quiere exponer para que el padre lo sobrescriba. Las dos conviven: la de Sass puede escribir el valor inicial de la de CSS.
2. ¿Por qué Portify guarda los colores como «255, 219, 103» y no como #ffdb67? ¿Lo harías igual hoy?¶
Respuesta:
Porque necesitaba el mismo color con varias opacidades y cambiarlo en vivo
desde JavaScript; rgba(var(--x), 0.3) sólo funciona si la variable guarda
los tres números. Hoy, en un proyecto nuevo, guardaría el color completo y
derivaría las opacidades con color-mix() o la sintaxis de color relativo,
que además permiten mezclar colores y trabajar en oklch. En este sitio se
mantiene la tripleta porque la base de estilos que se traduce ya está escrita
así y la coherencia pesa más que la novedad.
3. Tienes la paleta de marca definida. ¿Por qué no la aplicas ya como tokens?¶
Respuesta:
Porque un token es una decisión de diseño con nombre (--primary es «el color
principal de la interfaz»), y asignar un color de marca a ese papel sin
bocetos es adivinar: el morado puede ser fondo, acento o sólo el color del
logo. Mientras no esté decidido, los tokens llevan los valores de la plantilla,
que ya funcionan con contraste suficiente, y la paleta vive en la
documentación. Cuando la decisión exista, el cambio es local: dos archivos.
Módulo E4: Fuentes y reglas base¶
Fuente: src/styles/_fonts.scss y src/styles/_base.scss del repositorio.
El problema que resuelve¶
La Parte 1 dejó los @font-face y la tipografía base en src/styles.scss.
Ahora ese archivo es sólo el orquestador, así que las fuentes necesitan su
propio parcial. Y el reset de Portify (body amarillo, enlaces sin
subrayado, títulos y párrafos sin margen) hay que repartirlo: parte se expresa
mejor como variables de Bootstrap, antes de que reboot genere su CSS, y
parte sigue siendo reglas globales que Bootstrap no cubre.
La decisión en este sitio¶
_fonts.scsscontiene las cuatro reglas@font-facedel Módulo M5, sin cambios.- Lo que Portify escribía como reglas y Bootstrap ya genera desde variables
pasa a
_tools.scss: la familia y el peso delbody, la familia, el estilo y el peso de los títulos, los márgenes a cero de títulos y párrafos, y los enlaces negros sin subrayado. _base.scssguarda lo que no tiene variable:font-synthesis, el fondo amarillo con el token,overflow-x: hidden, el tracking de los títulos, los botones más grandes en pantallasxxl, el ancho máximo del contenedor en pantallas de 1750 px y, desde la Parte 4, la regla del interruptor de animaciones (:root[data-motion='off']), que sustituyó a una de movimiento reducido que Portify no traía. Y, por debajo dexl, elscroll-padding-topque deja las secciones justo bajo el encabezado fijo (el Módulo E7).
El código¶
src/styles/_base.scss:
Las variables que sustituyen al reset de Portify, ya vistas en _tools.scss:
| Regla de Portify | Variable de Bootstrap en _tools.scss |
|---|---|
body { font-family: "Poppins" } |
$font-family-sans-serif: 'Mozilla Text', system-ui, sans-serif |
html { font-weight: 300 } (Parte 1) |
$font-weight-base: 300 |
h1…h6 { font-family; font-style; font-weight } (Parte 1) |
$headings-font-family, $headings-font-style: italic, $headings-font-weight: 600 |
h1…h6, p { margin-bottom: 0 } |
$headings-margin-bottom: 0, $paragraph-margin-bottom: 0 |
a { color: black; text-decoration: none } |
$link-color, $link-hover-color, $link-decoration: none |
Cómo funciona por dentro¶
rebootescribe elbodyy los títulos a partir de las variables.$font-family-basetoma por defecto$font-family-sans-serif, así que cambiar esta última cambia la fuente de todo el sitio;$headings-font-styleexiste en Bootstrap 5.3 justamente para casos como el nuestro, en que los títulos van en cursiva. El resultado compilado es el mismo que escribir las reglas a mano, pero coherente con el resto de Bootstrap (los.btn, por ejemplo, heredan$font-weight-basedonde corresponde).font-synthesis: nonesigue enhtml. Bootstrap no tiene variable para ello. Sólo hay cargado un peso de Mozilla Text (Light, 300); si alguna regla pide 500 o 700, el navegador no inventa una negrita y usa el 300. Es visible y se corrige cargando el peso que falte (Parte 1, Módulo M5).- El tracking no va en variable. Bootstrap no tiene
letter-spacingpara títulos; queda como regla, con el valor de Illustrator convertido aem. min-width(xxl)funciona aquí porquestyles.scssimportótoolsantes quebase: el mixin y$grid-breakpointsya existen en el ámbito global cuando Sass llega a este archivo.- Movimiento: de la preferencia del sistema al interruptor. Esta etapa
nació con una regla bajo
@media (prefers-reduced-motion: reduce)que acortaba animaciones y transiciones a 0,01 ms. Se retiró cuando se construyó el interruptor de animaciones (Parte 4, Módulo A4): el sitio anima por defecto y no consulta la preferencia del sistema (decisión del 13 de noviembre de 2026), y la regla pasó a depender de un atributo,:root[data-motion='off'], que pone el servicio del interruptor. La nueva regla acorta las animaciones y quita las transiciones (transition: none), porque una transición acortada conserva su retraso (el del menú móvil dejaba sus enlaces en el orden de tabulación). GSAP y el lienzo de puntos dependen del mismo servicio. - 1750 px y 1740 px. Portify limita el ancho del
container-fluiden pantallas muy anchas para que las líneas de texto no se alarguen de más; es el mismo valor que usa después para colocar la navegación vertical.
Errores comunes¶
- Dejar los
@font-facey las variables en archivos que se importan en el orden equivocado. Las fuentes pueden declararse en cualquier punto, pero las variables de tipografía tienen que estar antes debootstrap/scss/variables(Módulo E2). Sirebootsale con la fuente por defecto de Bootstrap, el orden es la causa. - Repetir en
_base.scsslo que ya hace una variable (por ejemplo, volver a escribira { text-decoration: none }). No rompe nada, pero duplica reglas y la próxima persona no sabe cuál manda. - Quitar el movimiento con
animation: none !important. Deja esperando al código que escucha el final de la animación. Acortar la duración es más seguro. - Esperar una negrita en un
<strong>. Confont-synthesis: noney sólo el peso 300 cargado, se verá igual que el texto normal hasta que se cargue un peso más.
Preguntas de entrevista (senior)¶
1. ¿Cómo respetas la preferencia de movimiento reducido en un sitio con animaciones de CSS y de JavaScript?¶
Respuesta:
En CSS, con una regla global bajo @media (prefers-reduced-motion: reduce)
que acorte animaciones y transiciones a casi cero, sin quitarlas, para no
romper los eventos de fin. En JavaScript, leyendo la misma preferencia con
matchMedia('(prefers-reduced-motion: reduce)') y, si es cierta, saltando a
los estados finales en vez de animar (GSAP tiene gsap.matchMedia() para
registrar animaciones sólo cuando la preferencia lo permite). Y, en los dos
casos, comprobar que el contenido es legible y usable sin ninguna animación:
las animaciones son un adorno sobre un estado final que tiene que funcionar
solo.
En este sitio se tomó otra decisión de producto: no consultar la preferencia del sistema y ofrecer, en su lugar, un interruptor propio que gobierna CSS, GSAP y el lienzo a la vez (Parte 4, Módulo A4). Lo anterior sigue siendo la respuesta general; lo que cambia es de dónde viene el estado.
2. ¿Por qué expresar el reset de Portify como variables de Bootstrap en vez de copiar sus reglas tal cual?¶
Respuesta:
Porque Bootstrap ya va a emitir reglas para body, los títulos y los
enlaces desde reboot; copiar las de Portify debajo las pisaría y el CSS
tendría dos versiones de cada regla, con la segunda ganando por orden. Al
expresarlas como variables, reboot escribe directamente el valor deseado,
una sola vez, y el resto de Bootstrap que depende de esas variables (botones,
formularios si llegan) es coherente con él. Lo que Bootstrap no cubre
(font-synthesis, el tracking, el ancho a 1750 px) sí se escribe como regla,
en un archivo separado y pequeño.
3. Un estilo nuevo: ¿va en _base.scss o en el componente?¶
Respuesta:
Depende de a quién afecta. Si describe el documento entero o un elemento
HTML sin clase (body, a, h2, un @media global), va en los globales.
Si pertenece a una pieza con nombre propio (.navigation, .hero), va en el
archivo de estilos de ese componente, que Angular encapsula para que no se
filtre. La prueba práctica: si al borrar el componente la regla deja de tener
sentido, es del componente. Los componentes importan tools para compartir
variables y mixins sin duplicar CSS.
Módulo E5: Alias de importación en tsconfig¶
Fuente: tsconfig.json y scripts/prepare-content.mjs del repositorio.
El problema que resuelve¶
Con las carpetas home/ y shared/ y sus subcarpetas, los imports relativos
se vuelven escaleras: '../../../shared/constants/locales.constants'. Son
difíciles de leer, se rompen al mover un archivo de carpeta y no dicen a
simple vista si lo importado es de shared, de home o un módulo generado.
El esqueleto de página (Módulo E6) importa desde las tres zonas a la vez, así
que es el momento de fijar la convención.
La decisión en este sitio¶
| Alias | Carpeta | Para qué |
|---|---|---|
@app/* |
src/app/* |
Lo que no encaja en los otros (hoy no se usa) |
@shared/* |
src/app/shared/* |
Componentes, constantes, interfaces y utilidades compartidas |
@home/* |
src/app/home/* |
Componentes y páginas de la portada |
@generated/* |
src/app/home/generated/* |
Los módulos que genera el script de contenido |
@interfaces/* |
src/app/home/interfaces/*, y si no está ahí, src/app/shared/interfaces/* |
Interfaces de datos |
- Un import que cruza carpetas usa alias; uno de la misma carpeta sigue
relativo (
'./app.routes'). - El script de contenido escribe los módulos generados con los mismos alias, así que un archivo generado y uno escrito a mano se leen igual.
@shared/*sigue la convención de la skillng-setup, que crea el mismo alias en los proyectos deangular-ufh.
El código¶
En tsconfig.json, dentro de compilerOptions:
"paths": {
"@app/*": ["./src/app/*"],
"@shared/*": ["./src/app/shared/*"],
"@home/*": ["./src/app/home/*"],
"@generated/*": ["./src/app/home/generated/*"],
"@interfaces/*": ["./src/app/home/interfaces/*", "./src/app/shared/interfaces/*"]
}
Antes y después, en src/app/home/pages/project-page/project-page.component.ts:
// Antes
import { Project } from '../../interfaces/project.interface'
import { PROJECT_BODIES } from '../../generated/project-bodies'
import { Locale } from '../../../shared/constants/locales.constants'
// Después
import { Project } from '@interfaces/project.interface'
import { PROJECT_BODIES } from '@generated/project-bodies'
import { Locale } from '@shared/interfaces/shared.interface'
Y en scripts/prepare-content.mjs, la plantilla de los módulos generados:
const imports = ["import type { Locale } from '@shared/interfaces/shared.interface'"]
if (interfaceName) {
const symbol = type.replace('[]', '')
imports.push(`import type { ${symbol} } from '@interfaces/${interfaceName}.interface'`)
}
Cómo funciona por dentro¶
pathses de TypeScript, pero alguien tiene que resolverlo al empaquetar. TypeScript sólo lo usa para comprobar tipos; no reescribe los imports. Angular leepathsdeltsconfigy se lo pasa a su empaquetador (esbuild), que resuelve cada alias a un archivo real al compilar. El ejecutor de pruebas (@angular/build:unit-test, con Vitest) construye con la misma cadena, así que las pruebas ven los alias sin configurar nada más. También funcionan en unimport()dinámico, como el de la página de proyecto enapp.routes.ts.- Sin
baseUrl. Desde TypeScript 4.1 las rutas depathspueden ser relativas al propiotsconfig.json(por eso empiezan por./src), ybaseUrlya no hace falta.tsconfig.app.jsonytsconfig.spec.jsonextiendentsconfig.json, así que los alias se declaran una sola vez. - La lista de
@interfaces/*es un orden de búsqueda. TypeScript y esbuild prueban cada carpeta en orden y se quedan con el primer archivo que existe. Vale porque los nombres no se repiten entrehome/interfaces/yshared/interfaces/; si se repitieran, ganaríahomeen silencio. - Los módulos generados no están en Git (
src/app/home/generated/está en.gitignore), pero sí se compilan con Angular; por eso pueden usar los alias. El propio script corre en Node sin empaquetador, así que sus imports siguen siendo relativos:pathsno existe para Node.
Errores comunes¶
- Cambiar un nombre de archivo y olvidar el script. Al renombrar
locales.tsalocales.constants.ts, los módulos generados siguieron apuntando al nombre viejo hasta que se actualizó la plantilla del script y se volvió a ejecutarnpm run content:prepare. Lo generado es código: si cambia la fuente, se regenera. - Dos alias para la misma carpeta.
@app/shared/...y@shared/...llevan al mismo sitio; mezclarlos hace que buscar usos de un archivo devuelva la mitad. Uno por carpeta. - Un alias que parece un paquete.
shared/*sin@se confundiría con un paquete de npm llamadoshared; el@al inicio evita la colisión. - El editor no se entera. Tras editar
paths, VS Code a veces sigue marcando los imports en rojo hasta reiniciar el servidor de TypeScript (TypeScript: Restart TS Server).
Preguntas de entrevista (senior)¶
1. ¿Qué hace paths en tsconfig.json y por qué a veces compila pero falla al ejecutar?¶
Respuesta:
paths le dice al comprobador de tipos dónde buscar un import que no es
relativo ni un paquete. No transforma el código: el JavaScript emitido sigue
diciendo from '@shared/...'. Si quien ejecuta ese código no conoce los alias
(Node a secas, por ejemplo), falla con «módulo no encontrado» aunque tsc
haya pasado. Funciona cuando el empaquetador los resuelve (esbuild, webpack,
Vite, el CLI de Angular) o cuando se añade un paso que reescribe las rutas.
Por eso en este sitio los alias viven en lo que Angular compila y el script
de Node usa rutas relativas.
2. ¿Qué riesgo tiene un alias con varias carpetas de respaldo, como @interfaces/*?¶
Respuesta:
Que la resolución depende del orden y de qué archivos existan: si aparece un
profile.interface.ts en las dos carpetas, el import resuelve al primero sin
avisar, y un cambio en el otro no se ve. Es cómodo mientras los nombres sean
únicos; la alternativa segura es un alias por carpeta (@home/interfaces/...
y @shared/interfaces/...), que es más largo pero no tiene ambigüedad.
Conviene revisarlo si las interfaces crecen.
3. ¿Cómo evitas que vuelvan a aparecer imports relativos profundos con el tiempo?¶
Respuesta:
Con una regla de ESLint, no-restricted-imports con un patrón como
../* (o ../../* si se tolera un nivel), que marca el import en el editor
y falla en el lint del CI. El alias por sí solo es una convención; la regla
la hace exigible. En este sitio el lint se ejecuta en la integración
continua, así que la regla también se aplica al código nuevo.
Módulo E6: El esqueleto de página: encabezado, navegación y columna de contenido¶
Fuente: src/app/app.html, src/app/shared/components/header/,
src/app/shared/constants/sections.constants.ts,
src/app/shared/interfaces/shared.interface.ts y
src/app/shared/utils/current-locale.utils.ts del repositorio.
El problema que resuelve¶
Portify organiza la página en tres piezas fijas: un encabezado con el logo y
el botón de menú, una navegación vertical numerada que en escritorio queda
fija a la derecha y en móvil entra desde la izquierda sobre un fondo oscuro, y
un <main class="container-fluid"> cuya columna col-xl-9 deja sitio a la
navegación. Todo el comportamiento del menú lo hace app.js a mano:
classList.toggle('open') en el icono, classList.toggle('opened') en el
<nav>, y el enlace activo lo marca el ScrollSpy de Bootstrap. En Angular hay
que decidir dónde vive ese estado, cómo se escriben los enlaces en dos
idiomas sin repetir plantilla y cómo se llega a una sección desde la página
de un proyecto, no sólo desde la portada.
La decisión en este sitio¶
Appes dueña del<main>: el esqueleto se escribe una vez enapp.htmly las páginas (home-page,project-page,not-found-page) ya no llevan<main>propio. Un documento con dos<main>anidados es HTML inválido.- Un solo componente,
shared-header, renderiza la barra, el<nav>y el overlay, porque los tres comparten un estado:menuOpen, una señal. - Las secciones de la portada viven en una constante
SECTIONSconidy etiqueta por idioma. Hoy son ocho: las seis de Portify más la Galería y la guía DIY, que llegan en las Partes 5 y 7, arriba de Contacto (el snippet de abajo ya las incluye). Elides a la vez el atributo del<section>y el fragmento del enlace. El número (01a08) lo escribe elSerialPipeen la plantilla desde la posición en el@for(Parte 3, Módulo S6). - Cada enlace es un
routerLinka/${locale}confragment, no unhref="#about": así funciona desde/en/projects/angular-guide, que navega a/en#about. - El idioma sale de la URL con dos funciones compartidas con el selector de
idioma:
injectCurrentUrlylocaleFromUrl. - El selector de idioma va al pie del panel de navegación, donde Portify muestra el correo y el teléfono; este sitio no publica correo. Al principio estuvo en la barra del encabezado y se movió al panel para cambiar de idioma sin volver arriba de la página; el contenedor cierra el menú móvil al elegir uno.
- Accesibilidad desde el primer día: el botón declara
aria-controls,aria-expandedyaria-label; el<nav>tienearia-label; el menú se cierra con Escape, con el overlay y al elegir un enlace. - En esta adaptación, Angular construye los enlaces; Bootstrap aporta los estilos del menú. El enlace activo según el scroll no forma parte del ejemplo.
El código¶
src/app/app.html:
Después: el
app.htmlactual añade<shared-background />como primera línea, el campo de puntos de fondo que se construye en la Parte 4 (Módulo A3). El resto es igual.
src/app/shared/constants/locales.constants.ts e
src/app/shared/interfaces/shared.interface.ts:
export const LOCALES = ['en', 'es'] as const
import { LOCALES } from '@shared/constants/locales.constants'
export type Locale = (typeof LOCALES)[number]
export interface Section {
id: string
label: Record<Locale, string>
}
src/app/shared/constants/sections.constants.ts:
import { Section } from '@shared/interfaces/shared.interface'
// Homepage sections in reading order. The id is the `id` attribute of each
// <section> and the fragment of its navigation link.
export const SECTIONS: readonly Section[] = [
{ id: 'home', label: { en: 'Home', es: 'Inicio' } },
{ id: 'about', label: { en: 'About', es: 'Sobre mí' } },
{ id: 'skills', label: { en: 'Skills', es: 'Habilidades' } },
{ id: 'experience', label: { en: 'Experience', es: 'Experiencia' } },
{ id: 'projects', label: { en: 'Projects', es: 'Proyectos' } },
{ id: 'gallery', label: { en: 'Gallery', es: 'Galería' } },
{ id: 'diy', label: { en: 'DIY guide', es: 'Guía DIY' } },
{ id: 'contact', label: { en: 'Contact', es: 'Contacto' } },
]
src/app/shared/utils/current-locale.utils.ts:
import { inject, Signal } from '@angular/core'
import { toSignal } from '@angular/core/rxjs-interop'
import { NavigationEnd, Router } from '@angular/router'
import { filter, map } from 'rxjs'
import { Locale } from '@shared/interfaces/shared.interface'
import { LOCALES } from '@shared/constants/locales.constants'
// The URL is the source of truth for the language: /en/... or /es/...
export function injectCurrentUrl(): Signal<string> {
const router = inject(Router)
return toSignal(
router.events.pipe(
filter((event) => event instanceof NavigationEnd),
map((event) => event.urlAfterRedirects),
),
{ initialValue: router.url },
)
}
export function localeFromUrl(url: string): Locale | null {
return LOCALES.find((locale) => new RegExp(`^/${locale}(?=[/?#]|$)`).test(url)) ?? null
}
src/app/shared/components/header/header.component.ts (así quedó en este
módulo; la nota de después está al final de la plantilla):
import { Component, computed, signal } from '@angular/core'
import { LanguageSwitcherComponent } from '@shared/components/language-switcher/language-switcher.component'
import { SECTIONS } from '@shared/constants/sections.constants'
import { injectCurrentUrl, localeFromUrl } from '@shared/utils/current-locale.utils'
import { SerialPipe } from '@shared/pipes/serial.pipe'
import { RouterLink } from '@angular/router'
@Component({
selector: 'shared-header',
imports: [LanguageSwitcherComponent, RouterLink, SerialPipe],
templateUrl: './header.component.html',
styleUrl: './header.component.scss',
// host is a way to bind host element events to component methods
// In this case, pressing the Escape key will trigger the closeMenu() method
host: { '(document:keydown.escape)': 'closeMenu()' },
})
export class HeaderComponent {
private readonly url = injectCurrentUrl()
protected readonly locale = computed(() => localeFromUrl(this.url()) ?? 'en')
protected readonly menuOpen = signal(false)
protected readonly links = computed(() =>
SECTIONS.map((section) => ({
id: section.id,
label: section.label[this.locale()],
})),
)
protected readonly labels = computed(() =>
this.locale() === 'es'
? { home: 'Ir al inicio', menu: 'Menú', sections: 'Secciones' }
: { home: 'Go to the homepage', menu: 'Menu', sections: 'Sections' },
)
protected toggleMenu() {
this.menuOpen.update((open) => !open)
}
protected closeMenu() {
this.menuOpen.set(false)
}
}
src/app/shared/components/header/header.component.html:
Después: el interruptor de animaciones de la Parte 4 (Módulo A4) toca estos dos archivos. En
header.component.tsse importaMotionToggleComponent(desde@shared/components/motion-toggle/motion-toggle.component) y se añade aimports, que queda[LanguageSwitcherComponent, MotionToggleComponent, RouterLink, SerialPipe]. Enheader.component.htmlse pone<shared-motion-toggle />justo antes del<button>del menú, dentro deldivde la barra. Nada más cambia.Después (encabezado fijo en móvil): el Módulo E7 explica por qué por debajo de
xlel encabezado se queda arriba al hacer scroll. Esto cambia también estos dos archivos. Enheader.component.htmlla barra lleva la referencia#bary los huecos pasan degap-4agap-3 gap-sm-4:<header #bar class="header"> <div class="container-fluid d-flex flex-wrap align-items-center justify-content-between gap-3 gap-sm-4" > <div class="d-flex align-items-center gap-3 gap-sm-4 ms-auto">En
header.component.tsel componente mide la barra y publica su altura real como--header-height(el código del constructor, y los imports nuevos de@angular/core:afterNextRender,DestroyRef,DOCUMENT,ElementRef,injectyviewChild):private readonly bar = viewChild.required<ElementRef<HTMLElement>>('bar') constructor() { const root = inject(DOCUMENT).documentElement const destroyRef = inject(DestroyRef) // Below `xl` the bar is sticky and the anchors stop under it (`scroll-padding-top`, see // `_base.scss`). Its height is not a constant: the bar wraps onto a second row on a very // narrow screen or with larger text, so the real height is published as `--header-height`. afterNextRender(() => { if (typeof ResizeObserver === 'undefined') return const bar = this.bar().nativeElement const observer = new ResizeObserver(() => root.style.setProperty('--header-height', `${bar.getBoundingClientRect().height}px`), ) observer.observe(bar) destroyRef.onDestroy(() => { observer.disconnect() root.style.removeProperty('--header-height') }) }) }
Y cada componente de sección lleva su id, por ejemplo en
hero.component.html:
Cómo funciona por dentro¶
- Una señal en lugar de
classList.toggle.menuOpenes la única fuente de verdad; la plantilla la refleja en tres sitios ([class.open]en el icono,[class.opened]en el<nav>,[attr.aria-expanded]en el botón) y el CSS hace el resto, incluido el overlay, que se muestra con el selector.navigation.opened + .nav-overlay(Módulo E7). No hay código que busque elementos en el DOM. host: { '(document:keydown.escape)': 'closeMenu()' }declara un oyente sobredocumenten los metadatos del componente; es la forma actual de Angular, que sustituye al decorador@HostListener. Angular lo registra al crear el componente y lo quita al destruirlo.computedrecalcula cuando cambia el idioma.injectCurrentUrlconvierte los eventos del router en una señal con la URL tras cada navegación (NavigationEnd, conurlAfterRedirectspara que/ya se lea como/en);localeFromUrlsaca el idioma del primer segmento.linksylabelsdependen delocale, así que al pulsar «Español» se reescriben solos. ElinitialValue: router.urlhace que la señal tenga valor desde el primer render, también durante el prerenderizado.[fragment]y el scroll. UnrouterLinkconfragment="about"navega a/en#about. En esta etapaapp.config.tsactivabawithInMemoryScrolling({ anchorScrolling: 'enabled' }), con lo que Angular buscaba el elemento con eseidy hacía scroll hasta él; desde el Módulo S3 de la Parte 3 ese scroll lo hace un inicializador propio, para poder omitirlo al cambiar de idioma. Desde la portada sólo cambia el fragmento; desde una página de proyecto vuelve a la portada y después hace el scroll.d-xl-nonees un utilitario de Bootstrap (Módulo E1): oculta el botón, el isotipo y el overlay a partir de 1200 px, donde la navegación es fija y siempre visible. Una sola plantilla sirve para los dos tamaños.flex-wrapyms-autoen la barra. Cuando el selector de idioma estaba en la barra, a 320 px el logo, los dos idiomas y el botón no cabían en una fila; sinflex-wrapel botón quedaba fuera de la pantalla y, conoverflow-x: hiddenen elbody, no se podía alcanzar. Conflex-wraplos controles bajan a una segunda fila yms-autolos mantiene pegados a la derecha.aria-expandedcomo atributo, no como propiedad.[attr.aria-expanded]escribe"true"o"false"en el HTML, que es lo que leen los lectores de pantalla;[aria-expanded]sinattr.intentaría asignar una propiedad que el elemento no tiene.- El espacio entre
01yHOMEno existe. Angular elimina por defecto los nodos de texto que son sólo espacios entre elementos (preserveWhitespaces: false), así que el espacio escrito entre los dos<span>desaparece y se leía «01HOME». La separación se da con un margen en CSS (Módulo E7). alt="Janio Isacura"en el logo yalt=""en el isotipo. El primero es el enlace a la portada y necesita nombre; el segundo es decorativo dentro de un menú que ya tiene etiqueta.
Errores comunes¶
- Dos
<main>. Las páginas venían con<main>de la etapa anterior; dejarlas así al añadir el deAppproduce<main>dentro de<main>. Las pruebas no lo detectan; sólo se ve en el HTML. - Enlaces sin destino. Si se escribe el menú antes de poner los
iden las secciones, los enlaces navegan a/en#homey no pasa nada, sin error en consola. Es fácil creer que falla el scroll del router. [routerLink]="[]"con fragmento. Significa «la ruta actual»; desde la página de un proyecto daría/en/projects/angular-guide#about, que no tiene esa sección. Por eso el enlace lleva['/', locale()]explícito.- Confiar en los
data-bs-*de Portify.data-bs-spyodata-bs-toggleno hacen nada sin el JavaScript de Bootstrap, que aquí no se incluye. - Volver a pulsar el enlace de la sección en la que ya estás. El router
ignora una navegación a la misma URL (
onSameUrlNavigation: 'ignore'por defecto), así que si la persona hizo scroll y pulsa el mismo enlace, no vuelve a subir.
Preguntas de entrevista (senior)¶
1. ¿Por qué guardar el estado del menú en una señal y no alternar clases en el DOM como hace la plantilla?¶
Respuesta:
Porque con una señal el estado existe en un solo sitio y la vista es una
función de él: si el menú está abierto, el icono, el panel, el overlay y
aria-expanded lo reflejan sin que nadie tenga que acordarse de actualizar
cuatro cosas. Alternar clases a mano funciona hasta que un segundo camino
cambia el estado (Escape, el overlay, un enlace) y uno de los cuatro se
queda desincronizado. Además la señal es comprobable en una prueba sin
mirar el DOM, y Angular sólo vuelve a pintar lo que depende de ella.
2. ¿Cómo haces que un enlace a una sección funcione desde cualquier página de la aplicación, y qué falta para que sea perfecto?¶
Respuesta:
Navegando a la ruta de la portada con un fragmento (['/', locale] más
fragment), no con href="#id", y activando anchorScrolling en el router
para que, al terminar la navegación, Angular haga scroll al elemento con ese
id. Faltan dos cosas: el router ignora una navegación a la misma URL, así
que repetir el enlace no vuelve a subir (se cambia con onSameUrlNavigation:
'reload' o haciendo el scroll a mano), y el enlace activo según la posición
del scroll, que en la plantilla hacía el ScrollSpy de Bootstrap y aquí se
hará con IntersectionObserver.
3. ¿Qué hace accesible a este menú móvil y qué le falta todavía?¶
Respuesta:
Es un <button> real (teclado y lector de pantalla lo entienden sin más),
con aria-label porque no tiene texto, aria-controls apuntando al <nav>
y aria-expanded que cambia con el estado; el <nav> tiene su aria-label;
Escape, el overlay y los propios enlaces lo cierran. Le falta gestionar el
foco: al abrir, llevar el foco al primer enlace y, al cerrar, devolverlo al
botón; y mientras está abierto, impedir que el tabulador salga del panel.
Módulo E7: Los estilos del menú de Portify traducidos a un componente¶
Fuente: src/app/shared/components/header/header.component.scss,
src/app/shared/components/language-switcher/language-switcher.component.scss
y src/app/shared/components/footer/footer.component.scss del repositorio.
El problema que resuelve¶
Los bloques .header, .navigation y .nav-overlay de Portify ocupan unas
250 líneas de la hoja global, con reglas para escritura de derecha a
izquierda (:dir(rtl)), prefijos de navegador de hace diez años y una
consulta @media (max-width: 1200px) que se solapa con el breakpoint xl
de Bootstrap (que empieza justo en 1200 px). En Angular esos estilos
pertenecen al componente que pinta el menú, encapsulados, y con el
presupuesto anyComponentStyle de 4 kB vigilando.
La decisión en este sitio¶
- Los estilos van en
header.component.scss, que importatools(Módulo E2) para el mixinmin-widthy el de Bootstrapmedia-breakpoint-down. - Se eliminan las reglas RTL, los prefijos y el bloque
.contact(correo y teléfono) que no existe en este sitio. media-breakpoint-down(xl)sustituye amax-width: 1200px: compila amax-width: 1199.98pxy no se solapa conmin-width(xl).- La línea vertical sigue siendo una variable
--height, fijada al 100 % hasta que GSAP la anime, pero en móvil se acorta 100 px: tal como estaba desbordaba el panel y aparecía una barra de scroll. - El hueco entre el número y la etiqueta se da con
margin-left, porque el espacio de la plantilla no llega al DOM (Módulo E6). - El selector de idioma y el pie tienen hojas propias y pequeñas.
- El encabezado se queda arriba en móvil. Se añadió tras probar el sitio en un
teléfono: para cambiar de sección o de idioma había que volver al principio de
la página. Por debajo de
xlel elemento fijo (position: sticky) es el anfitrión del componente (:host), y el desenfoque del fondo (backdrop-filter) va en la barra. El menú lateral y su capa sonposition: fixed; si el anfitrión tuvieratransform,filterobackdrop-filter, esas dos piezas dejarían de medirse contra la ventana y se medirían contra él. - El menú lateral es
fixedabierto y cerrado. Cerrado eraabsolute; con un anfitrión fijo su caja de referencia pasaba a ser los 69 px del anfitrión y el panel se encogía mientras se deslizaba hacia fuera. - La barra cabe en una fila en cualquier teléfono, y su altura se mide. Se
probó a 320 y 360 px y la barra se partía en dos filas (120,7 px): el logo, la
etiqueta del interruptor de animaciones, el botón del menú y los huecos no
cabían. Ahora los huecos son de 16 px por debajo de
sm(gap-3 gap-sm-4) y la etiqueta se oculta por debajo de 370 px (el Módulo A4 de la Parte 4, que explica el interruptor). Aun así, la altura no se da por supuesta: el componente la publica como--header-heightcon unResizeObserver, yhtmlla usa comoscroll-padding-top($header-height, 69 px, sólo vale hasta que el encabezado se pinta).
El código¶
src/app/shared/components/header/header.component.scss:
language-switcher.component.scss y footer.component.scss:
Después: esta es la banda del pie tal como quedó en este módulo. El archivo actual,
footer.component.scss, usa la clase.footeren lugar del selectorfooter, le añadeposition: relative(para quedar por encima del lienzo de fondo fijo de la Parte 4) yfont-size: 14px, y anida las reglas dep,.stacky.top-linkque construye la Parte 3, Módulo S9. Elpadding: 32px 0y el fondorgba(var(--black), 0.06)siguen igual.
Cómo funciona por dentro¶
- Cerrado y abierto en móvil. Cerrado, el panel está fuera de la
pantalla por la izquierda (
translateX(-100%)); con.openedpasa aposition: fixed, vuelve atranslateX(0)y recibe el fondo amarillo. La transición es sobretransform, que el navegador anima en el compositor sin recalcular el diseño de la página; animarleftobligaría a recalcularlo en cada fotograma. - El overlay depende del hermano.
.navigation.opened + .nav-overlayusa el combinador de hermano adyacente: el overlay se muestra sólo si el elemento inmediatamente anterior es el<nav>abierto. Por eso en la plantilla el<div class="nav-overlay">va justo después del</nav>. - Escritorio. A partir de
xlel panel es fijo a 100 px del borde superior y pegado a la derecha, con la lista de 300 px, y limitado acalc(100vh - 100px)conoverflow-y: auto: en una ventana baja (1280 × 360 px) los últimos enlaces quedaban fuera de la pantalla y, al ser un panel fijo sin botón, no había forma de llegar a ellos. Desde 1750 px se calcula suleftpara alinearlo con el contenedor de 1740 px que fija_base.scss(Módulo E4): los dos números van juntos. - La línea vertical es una variable CSS para que GSAP pueda animarla
(
gsap.to(nav, { '--height': '100%' })) sin tocar el CSS. En móvil empieza 100 px más abajo y midecalc(var(--height) - 100px); conheight: var(--height)sobresalía 100 px por debajo del panel y, como el panel tieneoverflow-y: autopara pantallas bajas, aparecía la barra de scroll. - El relleno del enlace es el pseudoelemento
::after: una franja negra al 15 % que crece de 0 al 100 % de ancho con la animacióngrowal pasar el ratón o con la clase.active, que queda reservada para el enlace activo del scroll. - El icono hamburguesa son tres
<span>absolutos a 0, 12 y 24 px. Con.open, el primero y el tercero se juntan a 12 px y giran 135° y -135° formando la X; el segundo se desvanece hacia la izquierda. - Escalera de
z-index: encabezado 10, overlay 12, panel 100. El overlay tapa la página y el encabezado; el panel queda encima del overlay. - El bloque
.languageal pie del panel aloja el selector de idioma con el mismo sangrado de 34 px que los enlaces. El(click)del contenedor cierra el panel porque el evento burbujea desde el enlace de idioma; el selector no necesita saber que vive dentro de un menú. -
Encapsulación. Angular añade un atributo a cada elemento de la plantilla y a cada selector del componente (
.navigation[_ngcontent-xxx]), así que estas reglas no alcanzan a ningún otro.navigationni los estilos globales rompen las suyas;@keyframes growtambién queda dentro del componente. Las clases de Bootstrap (d-xl-none,container-fluid) son globales y se aplican igual. El CSS compilado del componente queda por debajo del aviso de 4 kB; si crece, el presupuesto se ajusta a conciencia. -
position: stickyy sus ancestros. Un elementostickyse pega a la ventana mientras ningún ancestro entre él y la ventana tenga unoverflowdistinto devisible. Aquí eloverflow-x: hiddendelbodyse propaga a la ventana (no crea un contenedor propio) y eloverflow-x: clipestá enmain, que es un hermano del encabezado, no un ancestro. - El contexto de apilamiento del anfitrión. Con
z-index: 10, el anfitrión forma un contexto: dentro, la barra (10), la capa oscura (12) y el panel (100) conservan su orden de siempre; fuera, nada se interpone entre 10 y 100. El visor de la galería (100, en la raíz) queda por encima de todo. scroll-padding-topfrente ascrollToAnchor. La propiedad CSS hace que los saltos nativos a un#fragmentoy el foco de un elemento se detengan debajo de la barra. PeroViewportScroller.scrollToAnchorde Angular no la usa: desplaza la ventana a la posición del elemento menos su propiooffset. Por eso el inicializador de scroll registra eseoffsetleyendo la misma propiedad (el Módulo S3 de la Parte 3, que explica el scroll por fragmento).--header-height.ResizeObserveravisa cuando la barra cambia de tamaño (se parte en dos filas con un texto del sistema más grande, por ejemplo) y el componente escribe la altura real en<html>.scroll-padding-topla lee convar(--header-height, 69px), así que los enlaces siguen cayendo justo bajo la barra aunque cambie.
Errores comunes¶
@media (max-width: 1200px)junto amin-width: 1200px. A 1200 px exactos se cumplen las dos y el panel recibe reglas de móvil y de escritorio a la vez.media-breakpoint-down(xl)resta 0,02 px y lo evita.- La línea que desborda.
top: 100pxyheight: 100%suman más que el panel. Conoverflow-y: auto, el síntoma es una barra de scroll en el menú abierto aunque sobre espacio. - Mover el overlay de sitio en la plantilla: el selector
+deja de coincidir y el overlay nunca aparece, sin error. font-weight: 500en los enlaces, como en Portify. Confont-synthesis: noney sólo el peso 300 de Mozilla Text cargado, no cambia nada; se quitó para no dejar una regla que no hace lo que dice.- Olvidar
@import 'tools'al principio: Sass falla con «Undefined mixin» en la primera@include. - Poner el desenfoque en el anfitrión
sticky. El panel y la capa deposition: fixedpasan a medirse contra el anfitrión (69 px de alto) y no contra la ventana: el menú se abre mal o no se ve. Una prueba de contenido falla si el anfitrión recibetransform,filterobackdrop-filter. - Dar la altura de la barra por supuesta. Con 69 px en una constante, a 320 y 360 px los enlaces dejaban 52 px de la sección bajo la barra. Se encontró midiendo, y no con las pruebas: ninguna mide la altura en un navegador.
- Dejar el panel cerrado como
absolute. Su caja de referencia pasa a ser el anfitrión y el panel se encoge al cerrarse.
Preguntas de entrevista (senior)¶
1. ¿Por qué animar transform y no left para deslizar un panel?¶
Respuesta:
Porque transform (y opacity) se animan en el compositor: el navegador ya
tiene el panel pintado en una capa y sólo lo desplaza, sin recalcular diseño
ni volver a pintar el resto de la página en cada fotograma. left cambia la
geometría, obliga a recalcular el diseño y repintar, y en móvil se nota como
tirones. La regla del interruptor de animaciones de _base.scss quita igualmente
la transición para quien apaga el movimiento (Parte 4, Módulo A4).
2. ¿Cómo afecta la encapsulación de vistas de Angular a un selector como .navigation.opened + .nav-overlay y a una clase global como d-xl-none?¶
Respuesta:
Angular reescribe cada selector del componente añadiendo un atributo único
([_ngcontent-xxx]) a cada parte, y pone ese atributo en los elementos de
la plantilla. .navigation.opened + .nav-overlay sigue funcionando porque
los dos elementos están en la misma plantilla y reciben el atributo. Una
clase global como d-xl-none viene de la hoja global, que no se reescribe,
así que se aplica a cualquier elemento que la lleve. La encapsulación
protege en las dos direcciones: los estilos del componente no se escapan, y
una regla global sólo entra si el componente usa esa clase a propósito.
3. ¿Para qué sirve que la altura de la línea sea una variable CSS si hoy vale siempre 100 %?¶
Respuesta:
Para separar el «qué» del «cuánto»: el CSS describe que la línea mide
var(--height) y cómo se coloca; quien anime sólo tiene que cambiar un
número, desde JavaScript (GSAP) o desde otra regla, sin saber nada del
diseño. Es el mismo patrón de los tokens de color (Módulo E3). Si la
transición se hiciera en CSS puro, habría que declarar la propiedad con
@property para que el navegador sepa interpolarla; con GSAP no hace falta,
porque GSAP calcula cada valor intermedio y lo escribe.
4. Un encabezado position: sticky con un menú lateral position: fixed dentro. ¿Dónde pones el desenfoque de fondo y por qué?¶
Respuesta:
En la barra, no en el elemento que es sticky. transform, filter,
backdrop-filter, perspective y contain crean un bloque contenedor para
los descendientes position: fixed: si el elemento con esos estilos es el
anfitrión, el panel y la capa oscura dejan de medirse contra la ventana y se
miden contra él, que sólo mide lo que la barra (69 px). El menú se ve
recortado o desplazado. Con el desenfoque en la barra, que no contiene al
panel, el panel sigue siendo relativo a la ventana. Es un fallo silencioso: no
hay error, sólo un menú que se comporta distinto, y por eso conviene una
prueba que vigile esa regla.
5. Tienes un encabezado fijo y los enlaces a secciones dejan el título tapado. ¿Basta con scroll-padding-top?¶
Respuesta:
Con los saltos nativos a un #fragmento y con el foco, sí: el navegador se
detiene a esa distancia. Pero Angular, cuando hace el salto él mismo con
ViewportScroller.scrollToAnchor, no consulta esa propiedad: desplaza la
ventana a la posición del elemento menos un offset propio (por defecto, cero).
En este sitio, como el inicializador de scroll es quien salta, hay que
registrar un offset con ViewportScroller.setOffset. Para no repetir el
número, la función lee scroll-padding-top de <html> en el momento de
saltar: una sola fuente de verdad, cero donde el encabezado no es fijo, y
siempre al día si la altura cambia (--header-height).
Qué sigue¶
Con los estilos y el esqueleto listos, sigue con las secciones de Portify. El lienzo de puntos y las animaciones de entrada con GSAP se explican en Animaciones y fondo.