mypgs 2.0.0 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (104) hide show
  1. package/README.md +25 -25
  2. package/assets/scss/components/_accordion.scss +0 -2
  3. package/assets/scss/components/_button.scss +1 -1
  4. package/assets/scss/components/_form.scss +0 -16
  5. package/assets/scss/components/_formAddon.scss +18 -0
  6. package/assets/scss/components/_modals.scss +5 -3
  7. package/assets/scss/components/_search.scss +2 -2
  8. package/assets/scss/components/_slides.scss +0 -1
  9. package/assets/scss/components/_tooltip.scss +0 -1
  10. package/assets/scss/index.scss +1 -0
  11. package/assets/scss/layout/_footer.scss +0 -2
  12. package/assets/scss/layout/_header.scss +9 -1
  13. package/assets/scss/layout/_pageShell.scss +6 -2
  14. package/assets/scss/mixin/_mx-button.scss +30 -76
  15. package/assets/scss/mixin/_mx-card.scss +11 -9
  16. package/assets/scss/mixin/_mx-form.scss +3 -5
  17. package/assets/scss/mixin/{_mx-form-addon.scss → _mx-formAddon.scss} +23 -26
  18. package/assets/scss/mixin/_mx-hover.scss +75 -0
  19. package/assets/scss/mixin/_settings.scss +2 -1
  20. package/assets/scss/mixin/mixin.scss +2 -1
  21. package/demo/demo.js +4 -3
  22. package/dist/css/index.css +1166 -1517
  23. package/dist/css/index.css.map +1 -1
  24. package/dist/css/index.min.css +1 -1
  25. package/docs/componenti-e-markup.md +6 -5
  26. package/docs/components/accordion.md +22 -22
  27. package/docs/components/badges.md +19 -19
  28. package/docs/components/breadcumbs.md +8 -8
  29. package/docs/components/button.md +17 -17
  30. package/docs/components/card.md +19 -19
  31. package/docs/components/dropdown.md +29 -29
  32. package/docs/components/form.md +63 -40
  33. package/docs/components/formAddon.md +79 -0
  34. package/docs/components/logo.md +11 -11
  35. package/docs/components/menu.md +20 -20
  36. package/docs/components/modal.md +46 -46
  37. package/docs/components/notification.md +34 -34
  38. package/docs/components/search.md +51 -50
  39. package/docs/components/slides.md +39 -39
  40. package/docs/components/stepTabs.md +41 -41
  41. package/docs/components/steps.md +16 -16
  42. package/docs/components/summary.md +20 -20
  43. package/docs/components/table.md +7 -7
  44. package/docs/components/tooltip.md +22 -22
  45. package/docs/convenzioni.md +11 -11
  46. package/docs/export-e-sviluppo.md +3 -3
  47. package/docs/helper-javascript.md +7 -7
  48. package/docs/layout/body.md +11 -11
  49. package/docs/layout/flex.md +44 -44
  50. package/docs/layout/footer.md +23 -23
  51. package/docs/layout/grid.md +44 -44
  52. package/docs/layout/header.md +34 -34
  53. package/docs/layout/pageShell.md +11 -11
  54. package/docs/layout/section.md +26 -26
  55. package/docs/patterns/cookieConsent.md +38 -38
  56. package/docs/utilizzo-css-scss.md +8 -8
  57. package/package.json +1 -1
  58. package/scripts/generate-component-docs.js +5 -5
  59. package/templates/html/components/accordion.html +19 -19
  60. package/templates/html/components/badges.html +17 -17
  61. package/templates/html/components/breadcumbs.html +6 -6
  62. package/templates/html/components/button.html +15 -15
  63. package/templates/html/components/card.html +17 -17
  64. package/templates/html/components/dropdown.html +25 -25
  65. package/templates/html/components/form.html +58 -35
  66. package/templates/html/components/formAddon.html +72 -0
  67. package/templates/html/components/logo.html +9 -9
  68. package/templates/html/components/menu.html +16 -16
  69. package/templates/html/components/modal.html +42 -42
  70. package/templates/html/components/notification.html +30 -30
  71. package/templates/html/components/search.html +43 -42
  72. package/templates/html/components/slides.html +31 -31
  73. package/templates/html/components/stepTabs.html +37 -37
  74. package/templates/html/components/steps.html +13 -13
  75. package/templates/html/components/summary.html +17 -17
  76. package/templates/html/components/table.html +5 -5
  77. package/templates/html/components/tooltip.html +18 -18
  78. package/templates/html/layout/body.html +9 -10
  79. package/templates/html/layout/flex.html +42 -42
  80. package/templates/html/layout/footer.html +20 -20
  81. package/templates/html/layout/grid.html +42 -42
  82. package/templates/html/layout/header.html +32 -32
  83. package/templates/html/layout/pageShell.html +8 -8
  84. package/templates/html/layout/section.html +24 -24
  85. package/templates/html/patterns/cookieConsent.html +33 -33
  86. package/templates/react/components/accordion.jsx +4 -4
  87. package/templates/react/components/breadcumbs.jsx +1 -1
  88. package/templates/react/components/button.jsx +5 -5
  89. package/templates/react/components/card.jsx +4 -4
  90. package/templates/react/components/dropdown.jsx +8 -8
  91. package/templates/react/components/form.jsx +2 -2
  92. package/templates/react/components/modal.jsx +14 -14
  93. package/templates/react/components/notification.jsx +3 -3
  94. package/templates/react/components/search.jsx +5 -5
  95. package/templates/react/components/slides.jsx +3 -3
  96. package/templates/react/components/stepTabs.jsx +8 -8
  97. package/templates/react/components/summary.jsx +3 -3
  98. package/templates/react/components/table.jsx +2 -2
  99. package/templates/react/layout/flex.jsx +8 -8
  100. package/templates/react/layout/grid.jsx +8 -8
  101. package/templates/react/layout/section.jsx +12 -12
  102. package/templates/react/patterns/cookieConsent.jsx +8 -8
  103. package/templates/react/patterns/footer.jsx +3 -3
  104. package/templates/react/patterns/header.jsx +3 -3
@@ -1,43 +1,43 @@
1
1
  <!--
2
2
  /**
3
3
  * @title Slides
4
- * @description Carosello orizzontale che osserva gli elementi visibili e crea automaticamente controlli precedente, successivo e indicatori di posizione.
4
+ * @description Slides markup, configuration, behavior, and usage example.
5
5
  *
6
6
  * @pgs
7
- * - slides: identifica il root inizializzato dal modulo slides.
8
- * - slides-container: identifica la lista orizzontale degli elementi scorrevoli.
9
- * - slides-prec: identifica il pulsante precedente creato dinamicamente.
10
- * - slides-next: identifica il pulsante successivo creato dinamicamente.
11
- * - slides-dots: identifica il contenitore degli indicatori creato dinamicamente.
7
+ * - slides: identifies the slides element used by Slides.
8
+ * - slides-container: identifies the slides-container element used by Slides.
9
+ * - slides-prec: identifies the slides-prec element used by Slides.
10
+ * - slides-next: identifies the slides-next element used by Slides.
11
+ * - slides-dots: identifies the slides-dots element used by Slides.
12
12
  *
13
13
  * @pgs-option
14
- * - singleScroll: usa un solo elemento visibile come riferimento per la navigazione precedente e successiva.
15
- * - shadowDesktop: abilita l'ombreggiatura laterale del carosello sui layout desktop.
16
- * - notScrollAnimation: applicata a un elemento li disabilita l'animazione visiva basata sulla percentuale di visibilità.
17
- * - notScrollWithMouse: sul root disabilita la gestione dello scorrimento orizzontale tramite mouse.
14
+ * - singleScroll: identifies the singleScroll element used by Slides.
15
+ * - shadowDesktop: identifies the shadowDesktop element used by Slides.
16
+ * - notScrollAnimation: identifies the notScrollAnimation element used by Slides.
17
+ * - notScrollWithMouse: identifies the notScrollWithMouse element used by Slides.
18
18
  *
19
19
  * @api
20
- * - pgs.slides.init(root): inizializza il root stesso quando è un carosello e tutti i caroselli discendenti non ancora registrati; il valore predefinito è document.
21
- * - pgs.slides.api(element): restituisce l'istanza associata a un root slides inizializzato.
22
- * - instance.previous(): porta in vista la slide precedente.
23
- * - instance.next(): porta in vista la slide successiva.
24
- * - instance.goTo(index): porta in vista la slide con l'indice indicato.
25
- * - instance.getCurrentIndexes(): restituisce gli indici delle slide attualmente visibili.
26
- * - instance.getCurrentElements(): restituisce gli elementi slide attualmente visibili.
27
- * - instance.getTotal(): restituisce il numero totale di slide.
28
- * - instance.isAtStart(): restituisce true quando la prima slide è visibile.
29
- * - instance.isAtEnd(): restituisce true quando l'ultima slide è visibile.
30
- * - instance.refresh(): sincronizza controlli e dots, sostituisce listener e observer precedenti e restituisce la nuova API.
20
+ * - pgs.slides.init(root): initializes matching elements within the specified root.
21
+ * - pgs.slides.api(element): returns the instance associated with the specified initialized element.
22
+ * - instance.previous(): moves to the previous item.
23
+ * - instance.next(): moves to the next item.
24
+ * - instance.goTo(index): provides the documented operation through the component public API.
25
+ * - instance.getCurrentIndexes(): provides the documented operation through the component public API.
26
+ * - instance.getCurrentElements(): provides the documented operation through the component public API.
27
+ * - instance.getTotal(): returns the total number of items.
28
+ * - instance.isAtStart(): provides the documented operation through the component public API.
29
+ * - instance.isAtEnd(): provides the documented operation through the component public API.
30
+ * - instance.refresh(): refreshes the component and returns its updated instance.
31
31
  *
32
32
  * @related
33
- * - card: usa card come contenuto dimostrativo di ogni slide.
34
- * - card-img: identifica l'immagine delle card dimostrative.
35
- * - imgCover: adatta le immagini allo spazio disponibile.
36
- * - flexColumn: organizza verticalmente ogni card.
37
- * - flexColumnTexts: applica la spaziatura ai testi delle card.
38
- * - buttonIcon: viene applicato ai controlli precedente e successivo generati.
33
+ * - card: uses the related card component or utility in this example.
34
+ * - card-img: uses the related card-img component or utility in this example.
35
+ * - imgCover: uses the related imgCover component or utility in this example.
36
+ * - flexColumn: uses the related flexColumn component or utility in this example.
37
+ * - flexColumnTexts: uses the related flexColumnTexts component or utility in this example.
38
+ * - buttonIcon: uses the related buttonIcon component or utility in this example.
39
39
  *
40
- * @return Lista di slide basate su card, completata a runtime con pulsanti e indicatori.
40
+ * @return Complete HTML markup and usage example for Slides.
41
41
  */
42
42
  -->
43
43
 
@@ -48,7 +48,7 @@
48
48
  <img pgs="card-img imgCover" src="https://placehold.co/800x500?text=Slide+1" alt="Slide 1">
49
49
  <div pgs="flexColumnTexts">
50
50
  <h3>Slide uno</h3>
51
- <p>Contenuto della prima slide.</p>
51
+ <p>First slide content.</p>
52
52
  </div>
53
53
  </article>
54
54
  </li>
@@ -58,7 +58,7 @@
58
58
  <img pgs="card-img imgCover" src="https://placehold.co/800x500?text=Slide+2" alt="Slide 2">
59
59
  <div pgs="flexColumnTexts">
60
60
  <h3>Slide due</h3>
61
- <p>Contenuto della seconda slide.</p>
61
+ <p>Second slide content.</p>
62
62
  </div>
63
63
  </article>
64
64
  </li>
@@ -68,7 +68,7 @@
68
68
  <img pgs="card-img imgCover" src="https://placehold.co/800x500?text=Slide+3" alt="Slide 3">
69
69
  <div pgs="flexColumnTexts">
70
70
  <h3>Slide tre</h3>
71
- <p>Contenuto della terza slide.</p>
71
+ <p>Third slide content.</p>
72
72
  </div>
73
73
  </article>
74
74
  </li>
@@ -1,47 +1,47 @@
1
1
  <!--
2
2
  /**
3
3
  * @title Step Tabs
4
- * @description Procedura guidata a schede con avanzamento sequenziale, indicatori generati, controlli di navigazione e possibilità di bloccare uno step.
4
+ * @description Step Tabs markup, configuration, behavior, and usage example.
5
5
  *
6
6
  * @pgs
7
- * - stepTabs: identifica il root della procedura guidata.
8
- * - stepTabs-dots: identifica il contenitore degli indicatori di avanzamento.
9
- * - stepTabs-dots-dot: identifica ogni indicatore creato dinamicamente.
10
- * - stepTabs-container: contiene nell'ordine tutte le schede della procedura.
11
- * - tab: identifica una singola scheda navigabile.
12
- * - stepTabs-prev: identifica il controllo per tornare allo step precedente.
13
- * - stepTabs-restart: identifica il controllo che riavvia la procedura dal primo step.
14
- * - stepTabs-next: identifica il controllo per avanzare allo step successivo.
7
+ * - stepTabs: identifies the stepTabs element used by Step Tabs.
8
+ * - stepTabs-dots: identifies the stepTabs-dots element used by Step Tabs.
9
+ * - stepTabs-dots-dot: identifies the stepTabs-dots-dot element used by Step Tabs.
10
+ * - stepTabs-container: identifies the stepTabs-container element used by Step Tabs.
11
+ * - tab: identifies the tab element used by Step Tabs.
12
+ * - stepTabs-prev: identifies the stepTabs-prev element used by Step Tabs.
13
+ * - stepTabs-restart: identifies the stepTabs-restart element used by Step Tabs.
14
+ * - stepTabs-next: identifies the stepTabs-next element used by Step Tabs.
15
15
  *
16
16
  * @pgs-option
17
- * - tabIcon: su ogni tab usa tabIcon[classe] con una singola classe Font Awesome per l'indicatore corrispondente; il fallback è fa-circle.
18
- * - step: viene applicata a ogni indicatore generato con la sintassi step[indice] per conservarne l'indice zero-based.
19
- * - buttonReverse: inverte testo e icona sul pulsante successivo e appartiene al componente button.
17
+ * - tabIcon: identifies the tabIcon element used by Step Tabs.
18
+ * - step: identifies the step element used by Step Tabs.
19
+ * - buttonReverse: identifies the buttonReverse element used by Step Tabs.
20
20
  *
21
21
  * @pgs-state
22
- * - is-active: identifica la scheda corrente e il relativo indicatore.
23
- * - is-completed: identifica gli indicatori degli step già completati e nuovamente selezionabili.
24
- * - is-locked: applicato a un tab impedisce di avanzare finché lo step resta bloccato.
22
+ * - is-active: identifies the is-active element used by Step Tabs.
23
+ * - is-completed: identifies the is-completed element used by Step Tabs.
24
+ * - is-locked: identifies the is-locked element used by Step Tabs.
25
25
  *
26
26
  * @api
27
- * - pgs.stepTabs.init(root): inizializza le procedure non ancora registrate dentro Document o Element indicato.
28
- * - pgs.stepTabs.api(element): restituisce l'istanza associata a un root stepTabs inizializzato.
27
+ * - pgs.stepTabs.init(root): initializes matching elements within the specified root.
28
+ * - pgs.stepTabs.api(element): returns the instance associated with the specified initialized element.
29
29
  * - instance.restart(): torna al primo tab e ripristina i blocchi dichiarati inizialmente.
30
- * - instance.goTo(index, scroll): attiva il tab indicato, aggiorna controlli e indicatori e opzionalmente scorre al componente.
31
- * - instance.next(): attiva il tab successivo entro i limiti disponibili.
32
- * - instance.prev(): attiva il tab precedente entro i limiti disponibili.
33
- * - instance.toggleLock(index, lock): aggiunge o rimuove is-locked dal tab indicato e aggiorna i controlli.
34
- * - instance.refresh(): riesegue l'inizializzazione nel contenitore della procedura e restituisce l'istanza.
35
- * - instance.getCurrent(): restituisce l'indice del tab corrente.
36
- * - instance.getState(): restituisce un oggetto con indice corrente e numero totale di tab.
30
+ * - instance.goTo(index, scroll): provides the documented operation through the component public API.
31
+ * - instance.next(): moves to the next item.
32
+ * - instance.prev(): moves to the previous item.
33
+ * - instance.toggleLock(index, lock): provides the documented operation through the component public API.
34
+ * - instance.refresh(): refreshes the component and returns its updated instance.
35
+ * - instance.getCurrent(): provides the documented operation through the component public API.
36
+ * - instance.getState(): provides the documented operation through the component public API.
37
37
  *
38
38
  * @related
39
- * - flexColumnElements: organizza verticalmente le aree principali del componente.
40
- * - flexColumnTexts: organizza il contenuto testuale di ogni tab.
41
- * - flexRow: dispone sulla stessa riga i controlli di navigazione.
42
- * - button: applica lo stile standard ai controlli precedente, riavvio e successivo.
39
+ * - flexColumnElements: uses the related flexColumnElements component or utility in this example.
40
+ * - flexColumnTexts: uses the related flexColumnTexts component or utility in this example.
41
+ * - flexRow: uses the related flexRow component or utility in this example.
42
+ * - button: uses the related button component or utility in this example.
43
43
  *
44
- * @return Procedura HTML a tre schede con indicatori e controlli di navigazione.
44
+ * @return Complete HTML markup and usage example for Step Tabs.
45
45
  */
46
46
  -->
47
47
 
@@ -50,25 +50,25 @@
50
50
 
51
51
  <div pgs="stepTabs-container">
52
52
  <section pgs="tab flexColumnTexts" tabindex="-1" pgs-option="tabIcon[fa-user]">
53
- <h3>Dati personali</h3>
54
- <p>Contenuto del primo tab.</p>
53
+ <h3>Personal details</h3>
54
+ <p>First tab content.</p>
55
55
  </section>
56
56
 
57
57
  <section pgs="tab flexColumnTexts" tabindex="-1" pgs-option="tabIcon[fa-list-check]">
58
- <h3>Preferenze</h3>
59
- <p>Contenuto del secondo tab.</p>
58
+ <h3>Preferences</h3>
59
+ <p>Second tab content.</p>
60
60
  </section>
61
61
 
62
62
  <section pgs="tab flexColumnTexts" tabindex="-1" pgs-option="tabIcon[fa-check]">
63
- <h3>Conferma</h3>
64
- <p>Contenuto del terzo tab.</p>
63
+ <h3>Confirmation</h3>
64
+ <p>Third tab content.</p>
65
65
  </section>
66
66
  </div>
67
67
 
68
68
  <div pgs="flexRow">
69
69
  <button pgs="stepTabs-prev button" type="button">
70
70
  <i class="fa-solid fa-arrow-left" aria-hidden="true"></i>
71
- Indietro
71
+ Back
72
72
  </button>
73
73
 
74
74
  <button pgs="stepTabs-restart button" type="button">
@@ -76,7 +76,7 @@
76
76
  </button>
77
77
 
78
78
  <button pgs="stepTabs-next button" pgs-option="buttonReverse" type="button">
79
- Avanti
79
+ Next
80
80
  <i class="fa-solid fa-arrow-right" aria-hidden="true"></i>
81
81
  </button>
82
82
  </div>
@@ -1,24 +1,24 @@
1
1
  <!--
2
2
  /**
3
3
  * @title Steps
4
- * @description Elenco ordinato di passaggi che presenta numero, contenuto e linea di collegamento, aggiungendo a runtime gli elementi strutturali mancanti.
4
+ * @description Ordered list of steps showing a number, content, and connecting line, with missing structural elements added at runtime.
5
5
  *
6
6
  * @pgs
7
- * - steps: identifica la lista ordinata inizializzata dal modulo steps.
8
- * - steps-step: identifica ogni passaggio della sequenza.
9
- * - steps-step-circle: identifica l'indicatore numerico, creato automaticamente se assente.
10
- * - steps-step-content: identifica il contenuto testuale del passaggio.
11
- * - steps-step-line: identifica la linea di collegamento aggiunta dinamicamente a ogni passaggio.
7
+ * - steps: identifies the ordered list initialized by the steps module.
8
+ * - steps-step: identifies each step in the sequence.
9
+ * - steps-step-circle: identifies the numeric indicator, which is created automatically when missing.
10
+ * - steps-step-content: identifies the text content of the step.
11
+ * - steps-step-line: identifies the connecting line dynamically added to each step.
12
12
  *
13
13
  * @api
14
- * - pgs.steps.init(root): inizializza le liste steps non ancora registrate dentro Document o Element indicato.
15
- * - pgs.steps.api(element): restituisce l'istanza associata a un root steps inizializzato.
16
- * - instance.steps(): restituisce un array con tutti gli elementi steps-step.
17
- * - instance.getStep(index): restituisce lo step corrispondente all'indice indicato.
18
- * - instance.getTotal(): restituisce il numero totale di step.
19
- * - instance.refresh(): reinizializza la lista, ricrea gli elementi mancanti e restituisce la nuova istanza.
14
+ * - pgs.steps.init(root): initializes unregistered step lists within the specified Document or Element.
15
+ * - pgs.steps.api(element): returns the instance associated with an initialized steps root.
16
+ * - instance.steps(): returns an array containing every steps-step element.
17
+ * - instance.getStep(index): returns the step at the specified index.
18
+ * - instance.getTotal(): returns the total number of steps.
19
+ * - instance.refresh(): reinitializes the list, recreates missing elements, and returns the new instance.
20
20
  *
21
- * @return Lista ordinata HTML di passaggi numerati completata dal modulo JavaScript.
21
+ * @return Ordered HTML list of numbered steps completed by the JavaScript module.
22
22
  */
23
23
  -->
24
24
 
@@ -1,41 +1,41 @@
1
1
  <!--
2
2
  /**
3
3
  * @title Summary
4
- * @description Componente che limita inizialmente un testo lungo a tre righe e mostra il controllo di espansione solo quando il contenuto eccede tale altezza.
4
+ * @description Summary markup, configuration, behavior, and usage example.
5
5
  *
6
6
  * @pgs
7
- * - summary: identifica il root inizializzato dal modulo summary.
8
- * - summary-content: identifica il contenuto misurato e ridimensionato.
9
- * - summary-button: identifica il controllo per mostrare più o meno contenuto.
7
+ * - summary: identifies the summary element used by Summary.
8
+ * - summary-content: identifies the summary-content element used by Summary.
9
+ * - summary-button: identifies the summary-button element used by Summary.
10
10
  *
11
11
  * @pgs-state
12
- * - overflow: indica che il contenuto supera l'altezza contratta e richiede il controllo.
13
- * - open: indica che tutto il contenuto è espanso e visibile.
12
+ * - overflow: identifies the overflow element used by Summary.
13
+ * - open: identifies the open element used by Summary.
14
14
  *
15
15
  * @api
16
- * - pgs.summary.init(root): inizializza i summary non ancora registrati dentro Document o Element indicato.
17
- * - pgs.summary.api(element): restituisce l'istanza associata a un root summary inizializzato.
18
- * - instance.open(): espande il contenuto quando supera l'altezza contratta.
19
- * - instance.close(): richiude il contenuto alla dimensione prevista.
20
- * - instance.toggle(): inverte lo stato espanso o contratto.
21
- * - instance.refresh(): ricalcola overflow e altezza conservando lo stato corrente.
22
- * - instance.isOpen(): restituisce true quando il contenuto è espanso.
16
+ * - pgs.summary.init(root): initializes matching elements within the specified root.
17
+ * - pgs.summary.api(element): returns the instance associated with the specified initialized element.
18
+ * - instance.open(): opens the component.
19
+ * - instance.close(): closes the component.
20
+ * - instance.toggle(): toggles the component state.
21
+ * - instance.refresh(): refreshes the component and returns its updated instance.
22
+ * - instance.isOpen(): returns true when the component is open.
23
23
  *
24
- * @return Struttura HTML con contenuto espandibile e pulsante sincronizzato tramite ARIA.
24
+ * @return Complete HTML markup and usage example for Summary.
25
25
  */
26
26
  -->
27
27
 
28
28
  <div pgs="summary">
29
29
  <div pgs="summary-content">
30
30
  <p>
31
- Questo testo dimostrativo e' abbastanza lungo da occupare piu righe e mostrare il comportamento del componente summary. Il contenuto puo includere testo, link e altri elementi inline senza richiedere markup aggiuntivo.
31
+ This demonstration text is long enough to span multiple lines and show the summary component behavior. Content can include text, links, and other inline elements without requiring additional markup.
32
32
  </p>
33
33
  <p>
34
- Quando il contenuto supera tre righe viene mostrato un pulsante per espandere o richiudere l'area visibile.
34
+ When content exceeds three lines, a button is shown to expand or collapse the visible area.
35
35
  </p>
36
36
  </div>
37
37
 
38
38
  <button pgs="summary-button" type="button">
39
- Mostra di più
39
+ Show more
40
40
  </button>
41
41
  </div>
@@ -1,12 +1,12 @@
1
1
  <!--
2
2
  /**
3
3
  * @title Table
4
- * @description Contenitore responsive per una tabella semantica con intestazioni e righe di dati coerenti con gli stili del design system.
4
+ * @description Responsive container for a semantic table with headers and data rows consistent with the design system styles.
5
5
  *
6
6
  * @pgs
7
- * - table: identifica il wrapper che gestisce presentazione e scorrimento della tabella nativa.
7
+ * - table: identifies the wrapper that manages presentation and scrolling for the native table.
8
8
  *
9
- * @return Tabella HTML completa racchiusa nel contenitore PGS dedicato.
9
+ * @return Complete HTML table wrapped in the dedicated PGS container.
10
10
  */
11
11
  -->
12
12
 
@@ -14,7 +14,7 @@
14
14
  <table>
15
15
  <thead>
16
16
  <tr>
17
- <th>Nome</th>
17
+ <th>Name</th>
18
18
  <th>Stato</th>
19
19
  <th>Data</th>
20
20
  </tr>
@@ -23,7 +23,7 @@
23
23
  <tbody>
24
24
  <tr>
25
25
  <td>Elemento uno</td>
26
- <td>Attivo</td>
26
+ <td>Active</td>
27
27
  <td>2026-01-01</td>
28
28
  </tr>
29
29
  <tr>
@@ -1,35 +1,35 @@
1
1
  <!--
2
2
  /**
3
3
  * @title Tooltip
4
- * @description Variante compatta del dropdown che mostra un breve pannello informativo controllato da un pulsante a icona.
4
+ * @description Tooltip markup, configuration, behavior, and usage example.
5
5
  *
6
6
  * @pgs
7
- * - tooltip: identifica il root della variante tooltip.
8
- * - tooltip-button: identifica il controllo specifico del tooltip.
9
- * - tooltip-content: identifica il contenuto informativo del tooltip.
7
+ * - tooltip: identifies the tooltip element used by Tooltip.
8
+ * - tooltip-button: identifies the tooltip-button element used by Tooltip.
9
+ * - tooltip-content: identifies the tooltip-content element used by Tooltip.
10
10
  *
11
11
  * @pgs-option
12
- * - position: può essere applicata al root condiviso con sintassi position[lato allineamento] per modificare la posizione ereditata dal dropdown.
12
+ * - position: identifies the position element used by Tooltip.
13
13
  *
14
14
  * @pgs-state
15
- * - open: viene gestito dal modulo dropdown sul root per mostrare o nascondere il tooltip.
15
+ * - open: identifies the open element used by Tooltip.
16
16
  *
17
17
  * @api
18
- * - pgs.dropdown.init(root): inizializza il tooltip perché il suo root condivide il token dropdown.
19
- * - pgs.dropdown.api(element): restituisce l'istanza dropdown associata al root del tooltip.
20
- * - instance.open(): apre il contenuto informativo.
21
- * - instance.close(): chiude il contenuto informativo.
22
- * - instance.toggle(): inverte la visibilità del tooltip.
23
- * - instance.refresh(): reinizializza il contesto e ricalcola il posizionamento.
24
- * - instance.isOpen(): restituisce true quando il tooltip è aperto.
18
+ * - pgs.dropdown.init(root): initializes matching elements within the specified root.
19
+ * - pgs.dropdown.api(element): returns the instance associated with the specified initialized element.
20
+ * - instance.open(): opens the component.
21
+ * - instance.close(): closes the component.
22
+ * - instance.toggle(): toggles the component state.
23
+ * - instance.refresh(): refreshes the component and returns its updated instance.
24
+ * - instance.isOpen(): returns true when the component is open.
25
25
  *
26
26
  * @related
27
- * - dropdown: fornisce apertura, chiusura e posizionamento del tooltip.
28
- * - dropdown-button: collega il pulsante al comportamento dropdown.
29
- * - dropdown-content: collega il pannello al comportamento dropdown.
30
- * - buttonMini: presenta il controllo come pulsante a icona di dimensione minima.
27
+ * - dropdown: uses the related dropdown component or utility in this example.
28
+ * - dropdown-button: uses the related dropdown-button component or utility in this example.
29
+ * - dropdown-content: uses the related dropdown-content component or utility in this example.
30
+ * - buttonMini: uses the related buttonMini component or utility in this example.
31
31
  *
32
- * @return Tooltip HTML composto tramite i token condivisi del dropdown.
32
+ * @return Complete HTML markup and usage example for Tooltip.
33
33
  */
34
34
  -->
35
35
 
@@ -1,20 +1,20 @@
1
1
  <!--
2
2
  /**
3
3
  * @title Body
4
- * @description Documento HTML di base che abilita MyPGS, configura i metadati essenziali e applica al body le varianti condivise di sfondo, testo e titoli.
4
+ * @description Base HTML document that enables MyPGS, configures essential metadata, and applies shared background, text, and heading variants to the body.
5
5
  *
6
6
  * @pgs
7
- * - htmlBase: applica le regole fondamentali all'elemento html.
8
- * - initP: abilita gli stili di layout, componenti e pattern racchiusi nel namespace MyPGS.
9
- * - bodyBase: applica struttura e spaziatura di base al body.
10
- * - bodyImg: abilita le regole condivise per le immagini contenute nella pagina.
11
- * - bodyText: abilita tipografia e spaziatura del testo.
12
- * - bodyHeading: abilita la gerarchia tipografica dei titoli.
7
+ * - htmlBase: applies the fundamental rules to the html element.
8
+ * - initP: enables layout, component, and pattern styles scoped to the MyPGS namespace.
9
+ * - bodyBase: applies the base structure and spacing to the body.
10
+ * - bodyImg: enables shared rules for images contained in the page.
11
+ * - bodyText: enables text typography and spacing.
12
+ * - bodyHeading: enables the typographic heading hierarchy.
13
13
  *
14
14
  * @pgs-state
15
- * - darkmode: viene applicato dinamicamente a html e body per attivare il tema scuro.
15
+ * - darkmode: is applied dynamically to html and body to activate the dark theme.
16
16
  *
17
- * @return Scheletro HTML completo necessario per inizializzare la libreria MyPGS.
17
+ * @return Complete HTML skeleton required to initialize the MyPGS library.
18
18
  */
19
19
  -->
20
20
 
@@ -32,4 +32,3 @@
32
32
  </head>
33
33
 
34
34
  <body pgs="bodyBase bodyImg bodyText bodyHeading" >
35
-
@@ -1,109 +1,109 @@
1
1
  <!--
2
2
  /**
3
3
  * @title Flex
4
- * @description Esempi di layout flex responsive che distribuiscono da due a sei elementi per riga adattando automaticamente la disposizione allo spazio disponibile.
4
+ * @description Flex markup, configuration, behavior, and usage example.
5
5
  *
6
6
  * @pgs
7
- * - flex-2: crea una distribuzione responsive fino a due elementi per riga.
8
- * - flex-3: crea una distribuzione responsive fino a tre elementi per riga.
9
- * - flex-4: crea una distribuzione responsive fino a quattro elementi per riga.
10
- * - flex-6: crea una distribuzione responsive fino a sei elementi per riga.
7
+ * - flex-2: identifies the flex-2 element used by Flex.
8
+ * - flex-3: identifies the flex-3 element used by Flex.
9
+ * - flex-4: identifies the flex-4 element used by Flex.
10
+ * - flex-6: identifies the flex-6 element used by Flex.
11
11
  *
12
12
  * @related
13
- * - container: definisce il contesto contenitore dell'introduzione.
14
- * - flexColumnTexts: organizza verticalmente e distanzia testi e contenuti delle card.
15
- * - card: rende visibili le celle dimostrative del layout flex.
13
+ * - container: defines the container context for the introduction.
14
+ * - flexColumnTexts: vertically organizes and spaces card text and content.
15
+ * - card: makes the demonstration cells of the flex layout visible.
16
16
  *
17
- * @return Raccolta HTML dei layout flex responsive a due, tre, quattro e sei elementi.
17
+ * @return HTML collection of responsive flex layouts with two, three, four, and six items.
18
18
  */
19
19
  -->
20
20
 
21
21
  <div pgs="container flexColumnTexts">
22
- <strong>Sezione standard</strong>
23
- <p>Contenuto centrato dentro una sezione MyPGS.</p>
22
+ <strong>Standard section</strong>
23
+ <p>Centered content inside a MyPGS section.</p>
24
24
  </div>
25
25
 
26
26
 
27
27
  <div pgs="flex-2">
28
28
  <article pgs="card flexColumnTexts">
29
- <strong>Colonna uno</strong>
30
- <p>Contenuto della prima colonna.</p>
29
+ <strong>Column one</strong>
30
+ <p>First column content.</p>
31
31
  </article>
32
32
 
33
33
  <article pgs="card flexColumnTexts">
34
- <strong>Colonna due</strong>
35
- <p>Contenuto della seconda colonna.</p>
34
+ <strong>Column two</strong>
35
+ <p>Second column content.</p>
36
36
  </article>
37
37
  </div>
38
38
 
39
39
 
40
40
  <div pgs="flex-3">
41
41
  <article pgs="card flexColumnTexts">
42
- <strong>Colonna uno</strong>
43
- <p>Contenuto della prima colonna.</p>
42
+ <strong>Column one</strong>
43
+ <p>First column content.</p>
44
44
  </article>
45
45
 
46
46
  <article pgs="card flexColumnTexts">
47
- <strong>Colonna due</strong>
48
- <p>Contenuto della seconda colonna.</p>
47
+ <strong>Column two</strong>
48
+ <p>Second column content.</p>
49
49
  </article>
50
50
 
51
51
  <article pgs="card flexColumnTexts">
52
- <strong>Colonna tre</strong>
53
- <p>Contenuto della terza colonna.</p>
52
+ <strong>Column three</strong>
53
+ <p>Third column content.</p>
54
54
  </article>
55
55
  </div>
56
56
 
57
57
 
58
58
  <div pgs="flex-4">
59
59
  <article pgs="card flexColumnTexts">
60
- <strong>Colonna uno</strong>
61
- <p>Contenuto della prima colonna.</p>
60
+ <strong>Column one</strong>
61
+ <p>First column content.</p>
62
62
  </article>
63
63
 
64
64
  <article pgs="card flexColumnTexts">
65
- <strong>Colonna due</strong>
66
- <p>Contenuto della seconda colonna.</p>
65
+ <strong>Column two</strong>
66
+ <p>Second column content.</p>
67
67
  </article>
68
68
 
69
69
  <article pgs="card flexColumnTexts">
70
- <strong>Colonna tre</strong>
71
- <p>Contenuto della terza colonna.</p>
70
+ <strong>Column three</strong>
71
+ <p>Third column content.</p>
72
72
  </article>
73
73
  <article pgs="card flexColumnTexts">
74
- <strong>Colonna quattro</strong>
75
- <p>Contenuto della quarta colonna.</p>
74
+ <strong>Column four</strong>
75
+ <p>Fourth column content.</p>
76
76
  </article>
77
77
  </div>
78
78
 
79
79
  <div pgs="flex-6">
80
80
  <article pgs="card flexColumnTexts">
81
- <strong>Colonna uno</strong>
82
- <p>Contenuto della prima colonna.</p>
81
+ <strong>Column one</strong>
82
+ <p>First column content.</p>
83
83
  </article>
84
84
 
85
85
  <article pgs="card flexColumnTexts">
86
- <strong>Colonna due</strong>
87
- <p>Contenuto della seconda colonna.</p>
86
+ <strong>Column two</strong>
87
+ <p>Second column content.</p>
88
88
  </article>
89
89
 
90
90
  <article pgs="card flexColumnTexts">
91
- <strong>Colonna tre</strong>
92
- <p>Contenuto della terza colonna.</p>
91
+ <strong>Column three</strong>
92
+ <p>Third column content.</p>
93
93
  </article>
94
94
 
95
95
  <article pgs="card flexColumnTexts">
96
- <strong>Colonna quattro</strong>
97
- <p>Contenuto della quarta colonna.</p>
96
+ <strong>Column four</strong>
97
+ <p>Fourth column content.</p>
98
98
  </article>
99
99
 
100
100
  <article pgs="card flexColumnTexts">
101
- <strong>Colonna cinque</strong>
102
- <p>Contenuto della quinta colonna.</p>
101
+ <strong>Column five</strong>
102
+ <p>Fifth column content.</p>
103
103
  </article>
104
104
 
105
105
  <article pgs="card flexColumnTexts">
106
- <strong>Colonna sei</strong>
107
- <p>Contenuto della sesta colonna.</p>
106
+ <strong>Column six</strong>
107
+ <p>Sixth column content.</p>
108
108
  </article>
109
- </div
109
+ </div