@nappr/nappr-styles 0.3.2 → 0.3.3
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.
- package/README.md +33 -20
- package/dist/styles.css +7462 -1
- package/dist/styles.css.map +1 -1
- package/dist/styles.min.css +3 -0
- package/dist/styles.min.css.map +1 -0
- package/docs/_coverpage.md +2 -2
- package/docs/_sidebar.md +2 -2
- package/docs/docs.theme.css +2 -1
- package/docs/docs.theme.css.map +1 -1
- package/docs/index.html +1 -1
- package/docs/pages/displays.md +26 -8
- package/docs/pages/grid.md +365 -0
- package/docs/pages/helpers.md +30 -18
- package/docs/pages/quick-start.md +100 -14
- package/docs/temp.scss +122 -0
- package/index.d.ts +25 -0
- package/package.json +48 -14
- package/sass/_globals.module.scss +43 -0
- package/sass/_globals.scss +78 -0
- package/sass/components/_.scss +1 -0
- package/sass/components/_badge.scss +58 -0
- package/sass/components/_button.scss +212 -0
- package/sass/components/scrollbar/_.scss +102 -0
- package/sass/configs/_.scss +7 -0
- package/sass/configs/_breakpoints.scss +12 -0
- package/sass/configs/_defaults.scss +6 -0
- package/sass/configs/_grid.scss +8 -0
- package/sass/configs/_palettes.scss +72 -0
- package/sass/configs/_spacing.scss +36 -0
- package/sass/configs/_text.scss +41 -0
- package/sass/configs/_themes.scss +24 -0
- package/sass/core/funcs/_list.scss +43 -0
- package/sass/core/funcs/_map.scss +42 -0
- package/sass/core/funcs/_math.scss +35 -0
- package/sass/core/funcs/_string.scss +47 -0
- package/sass/core/mixins/_.scss +3 -0
- package/{lib → sass/core}/mixins/_links.scss +2 -2
- package/sass/core/mixins/_media-queries.scss +22 -0
- package/sass/core/mixins/_typography.scss +26 -0
- package/sass/core/placeholders/_.scss +4 -0
- package/sass/core/placeholders/_dimensions.scss +16 -0
- package/sass/core/placeholders/_flexbox.scss +11 -0
- package/sass/core/placeholders/_lists.scss +41 -0
- package/sass/core/placeholders/_positions.scss +19 -0
- package/sass/core/placeholders/_typography.scss +10 -0
- package/sass/elements/_.scss +6 -0
- package/sass/elements/_dialog.scss +13 -0
- package/{lib/htmls → sass/elements}/_form.scss +28 -6
- package/sass/elements/_links.scss +21 -0
- package/sass/elements/_lists.scss +11 -0
- package/{lib/htmls → sass/elements}/_table.scss +2 -6
- package/sass/elements/_typography.scss +13 -0
- package/sass/layout/grid/_.scss +4 -0
- package/sass/layout/grid/_columns.scss +32 -0
- package/sass/layout/grid/_gaps.scss +42 -0
- package/sass/layout/grid/_grid.scss +130 -0
- package/sass/layout/grid/_offsets.scss +35 -0
- package/sass/main.scss +59 -0
- package/sass/resets/_.scss +5 -0
- package/sass/resets/_base.scss +69 -0
- package/sass/resets/_nappr.scss +82 -0
- package/sass/themes/_dark.scss +17 -0
- package/sass/themes/_dracula.scss +17 -0
- package/sass/themes/_github-light.scss +17 -0
- package/sass/themes/_light.scss +17 -0
- package/sass/themes/_monokai-pro.scss +17 -0
- package/sass/themes/_night-owl.scss +17 -0
- package/sass/themes/_nord.scss +17 -0
- package/sass/themes/_tokyo-night.scss +17 -0
- package/sass/utilities/_.scss +21 -0
- package/sass/utilities/_dimensions.scss +11 -0
- package/sass/utilities/_displays.scss +111 -0
- package/sass/utilities/_flexbox.scss +81 -0
- package/{lib/helpers → sass/utilities}/_floats.scss +10 -13
- package/sass/utilities/_lists.scss +86 -0
- package/sass/utilities/_negates.scss +121 -0
- package/sass/utilities/_palette.scss +11 -0
- package/sass/utilities/_scrolls.scss +67 -0
- package/sass/utilities/_spacers.scss +120 -0
- package/sass/utilities/_square-grid.scss +33 -0
- package/sass/utilities/_typography.scss +106 -0
- package/sass/utilities/_visibility.scss +60 -0
- package/sass/utilities/_wrap.scss +12 -0
- package/styles.scss +5 -1
- package/lib/_globals.scss +0 -16
- package/lib/_reset.scss +0 -223
- package/lib/customs/scrollbar.scss +0 -40
- package/lib/funcs/_.scss +0 -5
- package/lib/funcs/_get-color.scss +0 -3
- package/lib/funcs/_math.scss +0 -5
- package/lib/funcs/_merge-palette.scss +0 -12
- package/lib/funcs/_rem.scss +0 -104
- package/lib/funcs/_strings.scss +0 -35
- package/lib/grid/_.scss +0 -4
- package/lib/grid/_col.scss +0 -117
- package/lib/grid/_row.scss +0 -117
- package/lib/grid/_square.scss +0 -34
- package/lib/grid/_wrap.scss +0 -39
- package/lib/helpers/_.scss +0 -9
- package/lib/helpers/_displays.scss +0 -151
- package/lib/helpers/_flexbox.scss +0 -105
- package/lib/helpers/_margins.scss +0 -13
- package/lib/helpers/_negates.scss +0 -171
- package/lib/helpers/_scrolls.scss +0 -55
- package/lib/helpers/_texts.scss +0 -101
- package/lib/helpers/_visibility.scss +0 -34
- package/lib/htmls/_.scss +0 -4
- package/lib/htmls/_headings.scss +0 -29
- package/lib/htmls/_links.scss +0 -11
- package/lib/mixins/_.scss +0 -9
- package/lib/mixins/_border-radius.scss +0 -61
- package/lib/mixins/_border.scss +0 -48
- package/lib/mixins/_dimensions.scss +0 -48
- package/lib/mixins/_font-size.scss +0 -22
- package/lib/mixins/_line-height.scss +0 -19
- package/lib/mixins/_margin-padding.scss +0 -66
- package/lib/mixins/_root-variables.scss +0 -11
- package/lib/mixins/_theme.scss +0 -25
- package/lib/styles.scss +0 -19
- package/lib/variables/_.scss +0 -4
- package/lib/variables/_breakpoints.scss +0 -5
- package/lib/variables/_colors.scss +0 -60
- package/lib/variables/_defaults.scss +0 -53
- /package/{lib/helpers → sass/utilities}/_pointers.scss +0 -0
package/docs/_sidebar.md
CHANGED
|
@@ -3,9 +3,9 @@
|
|
|
3
3
|
- [**Getting started**](pages/quick-start.md)
|
|
4
4
|
|
|
5
5
|
- Styles
|
|
6
|
-
|
|
7
6
|
- [Helpers](pages/helpers.md)
|
|
8
7
|
- [Typography](pages/typography.md)
|
|
8
|
+
- [Grid](pages/grid.md)
|
|
9
9
|
- [Responsive Grid](pages/responsive.md)
|
|
10
10
|
- [Scrollbox](pages/scrollbox.md)
|
|
11
11
|
- [Display](pages/displays.md)
|
|
@@ -15,4 +15,4 @@
|
|
|
15
15
|
|
|
16
16
|
- Mixins
|
|
17
17
|
|
|
18
|
-
- [Github](https://github.com/sixertoy/
|
|
18
|
+
- [Github](https://github.com/sixertoy/nappr-styles)
|
package/docs/docs.theme.css
CHANGED
|
@@ -1 +1,2 @@
|
|
|
1
|
-
.docs-palette{align-items:center;border:1px solid #ccc;display:flex;flex:1;height:70px;justify-content:center;text-align:center}
|
|
1
|
+
.docs-palette{align-items:center;border:1px solid #ccc;display:flex;flex:1;height:70px;justify-content:center;text-align:center}
|
|
2
|
+
/*# sourceMappingURL=docs.theme.css.map */
|
package/docs/docs.theme.css.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"
|
|
1
|
+
{"version":3,"sources":["../docs.theme.scss"],"names":[],"mappings":"AAOA,cACE,kBAAA,CACA,qBAAA,CACA,YAAA,CACA,MAAA,CACA,WAAA,CACA,sBAAA,CACA,iBAAA","file":"docs.theme.css"}
|
package/docs/index.html
CHANGED
package/docs/pages/displays.md
CHANGED
|
@@ -76,17 +76,35 @@
|
|
|
76
76
|
</div>
|
|
77
77
|
</pre>
|
|
78
78
|
|
|
79
|
-
#### .is-
|
|
79
|
+
#### .is-inset-0
|
|
80
80
|
|
|
81
|
-
|
|
82
|
-
bottom: 0;
|
|
83
|
-
}
|
|
81
|
+
> Place l'élément avec `inset: 0` (couvre tous les bords)
|
|
84
82
|
|
|
85
|
-
|
|
83
|
+
<pre class="docsify-example">
|
|
84
|
+
<div class="is-relative" style="min-height:144px;border:1px solid #CCC;min-width:100%;width:100%;height:140px;">
|
|
85
|
+
<div class="is-absolute is-inset-0" style="background-color:rgba(0,0,0,0.2);" />
|
|
86
|
+
</div>
|
|
87
|
+
</pre>
|
|
88
|
+
|
|
89
|
+
#### .is-stretch-y
|
|
86
90
|
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
91
|
+
> Étire l'élément verticalement de haut en bas (`top: 0; bottom: 0`)
|
|
92
|
+
|
|
93
|
+
<pre class="docsify-example">
|
|
94
|
+
<div class="is-relative" style="min-height:144px;border:1px solid #CCC;min-width:100%;width:100%;height:140px;">
|
|
95
|
+
<div class="is-absolute is-stretch-y" style="left:10px;right:10px;background-color:rgba(0,0,0,0.2);" />
|
|
96
|
+
</div>
|
|
97
|
+
</pre>
|
|
98
|
+
|
|
99
|
+
#### .is-stretch-x
|
|
100
|
+
|
|
101
|
+
> Étire l'élément horizontalement de gauche à droite (`left: 0; right: 0`)
|
|
102
|
+
|
|
103
|
+
<pre class="docsify-example">
|
|
104
|
+
<div class="is-relative" style="min-height:144px;border:1px solid #CCC;min-width:100%;width:100%;height:140px;">
|
|
105
|
+
<div class="is-absolute is-stretch-x" style="top:10px;bottom:10px;background-color:rgba(0,0,0,0.2);" />
|
|
106
|
+
</div>
|
|
107
|
+
</pre>
|
|
90
108
|
|
|
91
109
|
## Dimensions
|
|
92
110
|
|
|
@@ -0,0 +1,365 @@
|
|
|
1
|
+
# Grille CSS Grid
|
|
2
|
+
|
|
3
|
+
> Système de grille responsive basé sur CSS Grid avec 12 colonnes et des gouttières personnalisables
|
|
4
|
+
|
|
5
|
+
## Introduction
|
|
6
|
+
|
|
7
|
+
Le système de grille utilise CSS Grid pour créer des layouts flexibles et responsive. La grille est composée de 12 colonnes avec des gouttières (gaps) configurables.
|
|
8
|
+
|
|
9
|
+
## Container de base
|
|
10
|
+
|
|
11
|
+
Utilisez la classe `.grid` pour créer un container de grille :
|
|
12
|
+
|
|
13
|
+
```html
|
|
14
|
+
<div class="grid">
|
|
15
|
+
<!-- Vos colonnes ici -->
|
|
16
|
+
</div>
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## Colonnes
|
|
20
|
+
|
|
21
|
+
### Colonnes de base
|
|
22
|
+
|
|
23
|
+
Les colonnes sont définies de 1 à 12. Utilisez `.grid-col-{nombre}` pour définir la largeur d'une colonne :
|
|
24
|
+
|
|
25
|
+
```html
|
|
26
|
+
<div class="grid">
|
|
27
|
+
<div class="grid-col-12">12 colonnes (100%)</div>
|
|
28
|
+
<div class="grid-col-6">6 colonnes (50%)</div>
|
|
29
|
+
<div class="grid-col-4">4 colonnes (33.33%)</div>
|
|
30
|
+
<div class="grid-col-3">4 colonnes (25%)</div>
|
|
31
|
+
</div>
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
### Colonnes responsive
|
|
35
|
+
|
|
36
|
+
Le système est mobile-first. Utilisez les préfixes de breakpoint pour définir des colonnes différentes selon la taille d'écran :
|
|
37
|
+
|
|
38
|
+
- `.grid-col-sm-*` : ≥ 576px (Mobile)
|
|
39
|
+
- `.grid-col-md-*` : ≥ 768px (Tablet)
|
|
40
|
+
- `.grid-col-lg-*` : ≥ 1024px (Desktop)
|
|
41
|
+
- `.grid-col-xl-*` : ≥ 1248px (Desktop Large)
|
|
42
|
+
|
|
43
|
+
```html
|
|
44
|
+
<div class="grid">
|
|
45
|
+
<!-- Mobile: 1 colonne, Tablet: 2 colonnes, Desktop: 3 colonnes -->
|
|
46
|
+
<div class="grid-col-12 grid-col-md-6 grid-col-lg-4">
|
|
47
|
+
Colonne responsive
|
|
48
|
+
</div>
|
|
49
|
+
<div class="grid-col-12 grid-col-md-6 grid-col-lg-4">
|
|
50
|
+
Colonne responsive
|
|
51
|
+
</div>
|
|
52
|
+
<div class="grid-col-12 grid-col-md-12 grid-col-lg-4">
|
|
53
|
+
Colonne responsive
|
|
54
|
+
</div>
|
|
55
|
+
</div>
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## Décalage (Offset)
|
|
59
|
+
|
|
60
|
+
### Offset vers la droite
|
|
61
|
+
|
|
62
|
+
Utilisez `.grid-col-offset-{nombre}` pour décaler une colonne vers la droite :
|
|
63
|
+
|
|
64
|
+
```html
|
|
65
|
+
<div class="grid">
|
|
66
|
+
<!-- Colonne de 4 colonnes décalée de 2 colonnes vers la droite -->
|
|
67
|
+
<div class="grid-col-4 grid-col-offset-2">
|
|
68
|
+
Colonne décalée
|
|
69
|
+
</div>
|
|
70
|
+
</div>
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
### Offset vers la gauche
|
|
74
|
+
|
|
75
|
+
Utilisez `.grid-col-offset-{nombre}--right` pour définir où se termine une colonne :
|
|
76
|
+
|
|
77
|
+
```html
|
|
78
|
+
<div class="grid">
|
|
79
|
+
<!-- Colonne qui se termine à la position 9 -->
|
|
80
|
+
<div class="grid-col-4 grid-col-offset-8--right">
|
|
81
|
+
Colonne avec offset right
|
|
82
|
+
</div>
|
|
83
|
+
</div>
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
### Exemple : Centrer une colonne
|
|
87
|
+
|
|
88
|
+
```html
|
|
89
|
+
<div class="grid">
|
|
90
|
+
<!-- Colonne de 4 colonnes centrée (offset de 4) -->
|
|
91
|
+
<div class="grid-col-4 grid-col-offset-4">
|
|
92
|
+
Colonne centrée
|
|
93
|
+
</div>
|
|
94
|
+
</div>
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
## Gouttières (Gaps)
|
|
98
|
+
|
|
99
|
+
### Gouttières de base
|
|
100
|
+
|
|
101
|
+
Définissez l'espacement entre les colonnes avec les classes de gouttières :
|
|
102
|
+
|
|
103
|
+
- `.grid-gap-none` : Pas de gouttière (0px)
|
|
104
|
+
- `.grid-gap-small` : Petite gouttière (6px)
|
|
105
|
+
- `.grid-gap-medium` : Gouttière moyenne (12px) - **défaut**
|
|
106
|
+
- `.grid-gap-large` : Grande gouttière (24px)
|
|
107
|
+
- `.grid-gap-xlarge` : Très grande gouttière (48px)
|
|
108
|
+
|
|
109
|
+
```html
|
|
110
|
+
<div class="grid grid-gap-large">
|
|
111
|
+
<div class="grid-col-6">Colonne 1</div>
|
|
112
|
+
<div class="grid-col-6">Colonne 2</div>
|
|
113
|
+
</div>
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
### Gouttières responsive
|
|
117
|
+
|
|
118
|
+
Les gouttières peuvent être différentes selon les breakpoints :
|
|
119
|
+
|
|
120
|
+
```html
|
|
121
|
+
<div class="grid grid-gap-small grid-gap-md-medium grid-gap-lg-large">
|
|
122
|
+
<div class="grid-col-12 grid-col-md-6">Colonne 1</div>
|
|
123
|
+
<div class="grid-col-12 grid-col-md-6">Colonne 2</div>
|
|
124
|
+
</div>
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
## Nombre de colonnes du container
|
|
128
|
+
|
|
129
|
+
Par défaut, le container utilise 12 colonnes. Vous pouvez changer le nombre de colonnes avec `.grid-cols-{nombre}` :
|
|
130
|
+
|
|
131
|
+
```html
|
|
132
|
+
<!-- Grille avec 6 colonnes -->
|
|
133
|
+
<div class="grid grid-cols-6">
|
|
134
|
+
<div class="grid-col-2">2/6</div>
|
|
135
|
+
<div class="grid-col-2">2/6</div>
|
|
136
|
+
<div class="grid-col-2">2/6</div>
|
|
137
|
+
</div>
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
### Responsive
|
|
141
|
+
|
|
142
|
+
```html
|
|
143
|
+
<div class="grid grid-cols-1 grid-cols-md-2 grid-cols-lg-3 grid-cols-xl-4">
|
|
144
|
+
<div>Item 1</div>
|
|
145
|
+
<div>Item 2</div>
|
|
146
|
+
<div>Item 3</div>
|
|
147
|
+
<div>Item 4</div>
|
|
148
|
+
</div>
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
## Alignement des items
|
|
152
|
+
|
|
153
|
+
### Alignement vertical (align-items)
|
|
154
|
+
|
|
155
|
+
- `.grid-items-top` : Aligne les items en haut
|
|
156
|
+
- `.grid-items-middle` : Centre les items verticalement
|
|
157
|
+
- `.grid-items-bottom` : Aligne les items en bas
|
|
158
|
+
- `.grid-items-stretch` : Étire les items pour remplir (défaut)
|
|
159
|
+
|
|
160
|
+
```html
|
|
161
|
+
<div class="grid grid-items-middle">
|
|
162
|
+
<div class="grid-col-4">Item centré verticalement</div>
|
|
163
|
+
<div class="grid-col-4">Item centré verticalement</div>
|
|
164
|
+
</div>
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
### Justification horizontale (justify-items)
|
|
168
|
+
|
|
169
|
+
- `.grid-justify-start` : Aligne les items à gauche
|
|
170
|
+
- `.grid-justify-center` : Centre les items horizontalement
|
|
171
|
+
- `.grid-justify-end` : Aligne les items à droite
|
|
172
|
+
- `.grid-justify-stretch` : Étire les items pour remplir (défaut)
|
|
173
|
+
|
|
174
|
+
```html
|
|
175
|
+
<div class="grid grid-justify-center">
|
|
176
|
+
<div class="grid-col-4">Item centré horizontalement</div>
|
|
177
|
+
</div>
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
### Alignement et justification combinés (place-items)
|
|
181
|
+
|
|
182
|
+
- `.grid-place-start` : Haut/Gauche
|
|
183
|
+
- `.grid-place-center` : Centre
|
|
184
|
+
- `.grid-place-end` : Bas/Droite
|
|
185
|
+
- `.grid-place-stretch` : Étire
|
|
186
|
+
|
|
187
|
+
```html
|
|
188
|
+
<div class="grid grid-place-center">
|
|
189
|
+
<div class="grid-col-4">Item centré</div>
|
|
190
|
+
</div>
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
## Alignement du contenu
|
|
194
|
+
|
|
195
|
+
### Alignement vertical du contenu (align-content)
|
|
196
|
+
|
|
197
|
+
- `.grid-content-top` : Aligne le contenu en haut
|
|
198
|
+
- `.grid-content-middle` : Centre le contenu verticalement
|
|
199
|
+
- `.grid-content-bottom` : Aligne le contenu en bas
|
|
200
|
+
- `.grid-content-between` : Espace entre les éléments
|
|
201
|
+
- `.grid-content-around` : Espace autour des éléments
|
|
202
|
+
- `.grid-content-evenly` : Espace égal autour des éléments
|
|
203
|
+
- `.grid-content-stretch` : Étire le contenu
|
|
204
|
+
|
|
205
|
+
```html
|
|
206
|
+
<div class="grid grid-content-middle" style="height: 400px;">
|
|
207
|
+
<div class="grid-col-4">Contenu centré</div>
|
|
208
|
+
</div>
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
### Justification horizontale du contenu (justify-content)
|
|
212
|
+
|
|
213
|
+
- `.grid-justify-content-start` : Aligne le contenu à gauche
|
|
214
|
+
- `.grid-justify-content-center` : Centre le contenu horizontalement
|
|
215
|
+
- `.grid-justify-content-end` : Aligne le contenu à droite
|
|
216
|
+
- `.grid-justify-content-between` : Espace entre les éléments
|
|
217
|
+
- `.grid-justify-content-around` : Espace autour des éléments
|
|
218
|
+
- `.grid-justify-content-evenly` : Espace égal autour des éléments
|
|
219
|
+
- `.grid-justify-content-stretch` : Étire le contenu
|
|
220
|
+
|
|
221
|
+
```html
|
|
222
|
+
<div class="grid grid-justify-content-center">
|
|
223
|
+
<div class="grid-col-4">Contenu centré</div>
|
|
224
|
+
</div>
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
## Alignement des items individuels
|
|
228
|
+
|
|
229
|
+
### Alignement vertical d'un item (align-self)
|
|
230
|
+
|
|
231
|
+
- `.grid-self-top` : Aligne cet item en haut
|
|
232
|
+
- `.grid-self-middle` : Centre cet item verticalement
|
|
233
|
+
- `.grid-self-bottom` : Aligne cet item en bas
|
|
234
|
+
- `.grid-self-stretch` : Étire cet item
|
|
235
|
+
|
|
236
|
+
```html
|
|
237
|
+
<div class="grid">
|
|
238
|
+
<div class="grid-col-4 grid-self-bottom">
|
|
239
|
+
Cet item est aligné en bas
|
|
240
|
+
</div>
|
|
241
|
+
<div class="grid-col-4 grid-self-middle">
|
|
242
|
+
Cet item est centré
|
|
243
|
+
</div>
|
|
244
|
+
</div>
|
|
245
|
+
```
|
|
246
|
+
|
|
247
|
+
### Justification horizontale d'un item (justify-self)
|
|
248
|
+
|
|
249
|
+
- `.grid-self-justify-start` : Aligne cet item à gauche
|
|
250
|
+
- `.grid-self-justify-center` : Centre cet item horizontalement
|
|
251
|
+
- `.grid-self-justify-end` : Aligne cet item à droite
|
|
252
|
+
- `.grid-self-justify-stretch` : Étire cet item
|
|
253
|
+
|
|
254
|
+
```html
|
|
255
|
+
<div class="grid">
|
|
256
|
+
<div class="grid-col-4 grid-self-justify-end">
|
|
257
|
+
Cet item est aligné à droite
|
|
258
|
+
</div>
|
|
259
|
+
</div>
|
|
260
|
+
```
|
|
261
|
+
|
|
262
|
+
### Alignement et justification combinés (place-self)
|
|
263
|
+
|
|
264
|
+
- `.grid-self-place-start` : Haut/Gauche
|
|
265
|
+
- `.grid-self-place-center` : Centre
|
|
266
|
+
- `.grid-self-place-end` : Bas/Droite
|
|
267
|
+
- `.grid-self-place-stretch` : Étire
|
|
268
|
+
|
|
269
|
+
```html
|
|
270
|
+
<div class="grid">
|
|
271
|
+
<div class="grid-col-4 grid-self-place-center">
|
|
272
|
+
Item centré individuellement
|
|
273
|
+
</div>
|
|
274
|
+
</div>
|
|
275
|
+
```
|
|
276
|
+
|
|
277
|
+
## Exemples complets
|
|
278
|
+
|
|
279
|
+
### Layout classique 3 colonnes
|
|
280
|
+
|
|
281
|
+
```html
|
|
282
|
+
<div class="grid grid-gap-medium">
|
|
283
|
+
<div class="grid-col-12 grid-col-md-4">
|
|
284
|
+
<h2>Colonne 1</h2>
|
|
285
|
+
<p>Contenu de la première colonne</p>
|
|
286
|
+
</div>
|
|
287
|
+
<div class="grid-col-12 grid-col-md-4">
|
|
288
|
+
<h2>Colonne 2</h2>
|
|
289
|
+
<p>Contenu de la deuxième colonne</p>
|
|
290
|
+
</div>
|
|
291
|
+
<div class="grid-col-12 grid-col-md-4">
|
|
292
|
+
<h2>Colonne 3</h2>
|
|
293
|
+
<p>Contenu de la troisième colonne</p>
|
|
294
|
+
</div>
|
|
295
|
+
</div>
|
|
296
|
+
```
|
|
297
|
+
|
|
298
|
+
### Layout avec sidebar
|
|
299
|
+
|
|
300
|
+
```html
|
|
301
|
+
<div class="grid grid-gap-large">
|
|
302
|
+
<!-- Sidebar -->
|
|
303
|
+
<aside class="grid-col-12 grid-col-md-3">
|
|
304
|
+
<nav>Menu de navigation</nav>
|
|
305
|
+
</aside>
|
|
306
|
+
|
|
307
|
+
<!-- Contenu principal -->
|
|
308
|
+
<main class="grid-col-12 grid-col-md-9">
|
|
309
|
+
<article>
|
|
310
|
+
<h1>Titre de l'article</h1>
|
|
311
|
+
<p>Contenu principal...</p>
|
|
312
|
+
</article>
|
|
313
|
+
</main>
|
|
314
|
+
</div>
|
|
315
|
+
```
|
|
316
|
+
|
|
317
|
+
### Grille de cartes responsive
|
|
318
|
+
|
|
319
|
+
```html
|
|
320
|
+
<div class="grid grid-cols-1 grid-cols-sm-2 grid-cols-md-3 grid-cols-lg-4 grid-gap-medium">
|
|
321
|
+
<div class="card">Carte 1</div>
|
|
322
|
+
<div class="card">Carte 2</div>
|
|
323
|
+
<div class="card">Carte 3</div>
|
|
324
|
+
<div class="card">Carte 4</div>
|
|
325
|
+
<div class="card">Carte 5</div>
|
|
326
|
+
<div class="card">Carte 6</div>
|
|
327
|
+
</div>
|
|
328
|
+
```
|
|
329
|
+
|
|
330
|
+
### Centrer un contenu
|
|
331
|
+
|
|
332
|
+
```html
|
|
333
|
+
<div class="grid grid-items-middle grid-justify-center" style="min-height: 100vh;">
|
|
334
|
+
<div class="grid-col-12 grid-col-md-8 grid-col-lg-6">
|
|
335
|
+
<h1>Contenu centré</h1>
|
|
336
|
+
<p>Ce contenu est centré verticalement et horizontalement</p>
|
|
337
|
+
</div>
|
|
338
|
+
</div>
|
|
339
|
+
```
|
|
340
|
+
|
|
341
|
+
## Breakpoints
|
|
342
|
+
|
|
343
|
+
Les breakpoints utilisés sont :
|
|
344
|
+
|
|
345
|
+
- **xs** : 320px (Mobile Small)
|
|
346
|
+
- **sm** : 576px (Mobile)
|
|
347
|
+
- **md** : 768px (Tablet)
|
|
348
|
+
- **lg** : 1024px (Desktop)
|
|
349
|
+
- **xl** : 1248px (Desktop Extra Large)
|
|
350
|
+
|
|
351
|
+
## Variables personnalisables
|
|
352
|
+
|
|
353
|
+
Vous pouvez personnaliser la grille en surchargeant les variables dans votre fichier `variables.scss` :
|
|
354
|
+
|
|
355
|
+
```scss
|
|
356
|
+
// Nombre de colonnes (défaut: 12)
|
|
357
|
+
$NAPPR_GRID_COLUMNS: 12 !default;
|
|
358
|
+
|
|
359
|
+
// Gouttières
|
|
360
|
+
$NAPPR_GRID_GAP_DEFAULT: 12px !default;
|
|
361
|
+
$NAPPR_GRID_GAP_SMALL: 6px !default;
|
|
362
|
+
$NAPPR_GRID_GAP_MEDIUM: 12px !default;
|
|
363
|
+
$NAPPR_GRID_GAP_LARGE: 24px !default;
|
|
364
|
+
$NAPPR_GRID_GAP_XLARGE: 48px !default;
|
|
365
|
+
```
|
package/docs/pages/helpers.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
## Font Size
|
|
2
2
|
|
|
3
|
-
> Les tailles des fonts sont à définir par la variable sass `$
|
|
3
|
+
> Les tailles des fonts sont à définir par la variable sass `$NAPPR_FONT_SIZES_MAP`
|
|
4
4
|
|
|
5
|
-
```
|
|
6
|
-
$
|
|
5
|
+
```scss
|
|
6
|
+
$NAPPR_FONT_SIZES_MAP: (6, 8, 9, 12, 24, 26) !default;
|
|
7
7
|
```
|
|
8
8
|
|
|
9
|
-
**
|
|
9
|
+
**Exemple en utilisant la classe `.fs24`**
|
|
10
10
|
|
|
11
11
|
```html
|
|
12
12
|
<span class="fs24">Font size: 24px</span>
|
|
@@ -14,10 +14,10 @@ $FontSizes: (6, 8, 9, 12, 26, 24);
|
|
|
14
14
|
|
|
15
15
|
## Margin / Padding
|
|
16
16
|
|
|
17
|
-
> Les tailles des margin/padding sont à définir par la variable sass `$
|
|
17
|
+
> Les tailles des margin/padding sont à définir par la variable sass `$NAPPR_SPACINGS_MAP`
|
|
18
18
|
|
|
19
|
-
```
|
|
20
|
-
$
|
|
19
|
+
```scss
|
|
20
|
+
$NAPPR_SPACINGS_MAP: (3, 6, 9, 12, 18, 24, 48) !default;
|
|
21
21
|
```
|
|
22
22
|
|
|
23
23
|
> Il est alors possible d'ajouter du margin/padding sur :
|
|
@@ -26,7 +26,7 @@ $MarginPadding: (6, 8, 9, 12, 26, 24);
|
|
|
26
26
|
> - les 2 axes `.my(n) .mx(n)`
|
|
27
27
|
> - les 4 directions `.mt(n), .mr(n), .mb(n), .ml(n)`
|
|
28
28
|
|
|
29
|
-
**L'
|
|
29
|
+
**L'exemple ci-dessous ajoute un padding de 24px sur la position top d'un bloc**
|
|
30
30
|
|
|
31
31
|
```html
|
|
32
32
|
<div class="pt24">padding-top: 24px;</div>
|
|
@@ -34,12 +34,12 @@ $MarginPadding: (6, 8, 9, 12, 26, 24);
|
|
|
34
34
|
|
|
35
35
|
## Borders
|
|
36
36
|
|
|
37
|
-
> Le type de bordure est à définir par la variable `$
|
|
38
|
-
> Les tailles des bordures sont à définir par la variable sass `$
|
|
37
|
+
> Le type de bordure est à définir par la variable `$NAPPR_BORDER_STYLE`
|
|
38
|
+
> Les tailles des bordures sont à définir par la variable sass `$NAPPR_BORDER_SIZE_MAP`
|
|
39
39
|
|
|
40
|
-
```
|
|
41
|
-
$
|
|
42
|
-
$
|
|
40
|
+
```scss
|
|
41
|
+
$NAPPR_BORDER_STYLE: solid !default;
|
|
42
|
+
$NAPPR_BORDER_SIZE_MAP: (1, 2, 3) !default;
|
|
43
43
|
```
|
|
44
44
|
|
|
45
45
|
> Il est alors possible d'ajouter des bordures sur :
|
|
@@ -48,7 +48,7 @@ $BorderSizes: (1, 2, 3);
|
|
|
48
48
|
> - les 2 axes `.bx(n) .by(n)`
|
|
49
49
|
> - les 4 directions `.bt(n), .br(n), .bb(n), .bl(n)`
|
|
50
50
|
|
|
51
|
-
**L'
|
|
51
|
+
**L'exemple ci-dessous ajoute une bordure de 2px sur les positions top et bottom d'un bloc**
|
|
52
52
|
|
|
53
53
|
```html
|
|
54
54
|
<div class="by2" style="border-color: #CCCCCCCC;">
|
|
@@ -58,10 +58,10 @@ $BorderSizes: (1, 2, 3);
|
|
|
58
58
|
|
|
59
59
|
## Border Radius
|
|
60
60
|
|
|
61
|
-
> Les arrondis de bordures sont à définir par la variable sass `$
|
|
61
|
+
> Les arrondis de bordures sont à définir par la variable sass `$NAPPR_BORDER_RADIUS_MAP`.
|
|
62
62
|
|
|
63
|
-
```
|
|
64
|
-
$
|
|
63
|
+
```scss
|
|
64
|
+
$NAPPR_BORDER_RADIUS_MAP: (2, 3, 4, 8, 10, 12) !default;
|
|
65
65
|
```
|
|
66
66
|
|
|
67
67
|
> Il est alors possible d'ajouter des angles arrondis à un bloc sur :
|
|
@@ -69,10 +69,22 @@ $BorderRadiusSizes: (2, 3, 4, 8, 10, 12);
|
|
|
69
69
|
> - la totalité d'un bloc `.brad(n)`
|
|
70
70
|
> - les 4 directions `.bradt(n), .bradr(n), .bradb(n), .bradl(n)`
|
|
71
71
|
|
|
72
|
-
**L'
|
|
72
|
+
**L'exemple ci-dessous ajoute un angle arrondi de 2px sur le haut d'un bloc**
|
|
73
73
|
|
|
74
74
|
```html
|
|
75
75
|
<div class="bradt2" style="border-color: #CCCCCC;">
|
|
76
76
|
<span>Lorem ipsum</span>
|
|
77
77
|
</div>
|
|
78
78
|
```
|
|
79
|
+
|
|
80
|
+
## Deprecated
|
|
81
|
+
|
|
82
|
+
> ⚠️ **Version 1.0.0** : Les variables suivantes ont été renommées.
|
|
83
|
+
|
|
84
|
+
| Ancienne variable | Nouvelle variable |
|
|
85
|
+
|-------------------|-------------------|
|
|
86
|
+
| `$FontSizes` | `$NAPPR_FONT_SIZES_MAP` |
|
|
87
|
+
| `$MarginPaddingSizes` | `$NAPPR_SPACINGS_MAP` |
|
|
88
|
+
| `$BorderStyle` | `$NAPPR_BORDER_STYLE` |
|
|
89
|
+
| `$BorderSizes` | `$NAPPR_BORDER_SIZE_MAP` |
|
|
90
|
+
| `$BorderRadiusSizes` | `$NAPPR_BORDER_RADIUS_MAP` |
|
|
@@ -1,26 +1,112 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Quick Start
|
|
2
2
|
|
|
3
|
-
>
|
|
3
|
+
> Guide de démarrage rapide pour utiliser @nappr/nappr-styles
|
|
4
4
|
|
|
5
5
|
## Installation
|
|
6
6
|
|
|
7
7
|
```bash
|
|
8
|
-
|
|
8
|
+
yarn add https://github.com/sixertoy/nappr-styles.git#latest
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## Configuration
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
$body-width: 100% !default;
|
|
15
|
-
$body-font-size: 16px !default;
|
|
16
|
-
$default-padding: 12px !default;
|
|
13
|
+
Créez un fichier `variables.scss` pour personnaliser les variables :
|
|
17
14
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
$
|
|
15
|
+
```scss
|
|
16
|
+
// Configuration principale
|
|
17
|
+
$NAPPR_BODY_FONT_SIZE: 16px !default;
|
|
18
|
+
$NAPPR_BODY_WIDTH: 100vw !default;
|
|
19
|
+
$NAPPR_DEFAULT_SPACING: 12px !default;
|
|
21
20
|
|
|
22
|
-
|
|
21
|
+
// Tailles de police
|
|
22
|
+
$NAPPR_FONT_SIZES_MAP: (11, 12, 14, 16) !default;
|
|
23
23
|
|
|
24
|
-
|
|
25
|
-
$
|
|
24
|
+
// Espacements
|
|
25
|
+
$NAPPR_SPACINGS_MAP: (3, 6, 9, 12, 18, 24, 48) !default;
|
|
26
|
+
|
|
27
|
+
// Dimensions
|
|
28
|
+
$NAPPR_DIMENSIONS_MAP: (25, 50, 75, 100) !default;
|
|
29
|
+
|
|
30
|
+
// Bordures
|
|
31
|
+
$NAPPR_BORDER_STYLE: solid !default;
|
|
32
|
+
$NAPPR_BORDER_SIZE_MAP: (1, 2, 3) !default;
|
|
33
|
+
$NAPPR_BORDER_RADIUS_MAP: (4, 8, 12) !default;
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## Utilisation
|
|
37
|
+
|
|
38
|
+
Importez les styles dans votre fichier principal :
|
|
39
|
+
|
|
40
|
+
```scss
|
|
41
|
+
@use './variables.scss' as *;
|
|
42
|
+
@use '@nappr/nappr-styles/styles.scss' as *;
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## Exemple complet
|
|
46
|
+
|
|
47
|
+
```scss
|
|
48
|
+
// variables.scss
|
|
49
|
+
$NAPPR_BODY_FONT_SIZE: 16px !default;
|
|
50
|
+
$NAPPR_FONT_SIZES_MAP: (12, 14, 16, 24) !default;
|
|
51
|
+
$NAPPR_SPACINGS_MAP: (6, 12, 18, 24) !default;
|
|
52
|
+
|
|
53
|
+
// main.scss
|
|
54
|
+
@use './variables.scss' as *;
|
|
55
|
+
@use '@nappr/nappr-styles/styles.scss' as *;
|
|
56
|
+
|
|
57
|
+
.my-component {
|
|
58
|
+
@extend .fs16;
|
|
59
|
+
@extend .m12;
|
|
60
|
+
@extend .p6;
|
|
61
|
+
}
|
|
26
62
|
```
|
|
63
|
+
|
|
64
|
+
## Deprecated
|
|
65
|
+
|
|
66
|
+
> ⚠️ **Version 1.0.0** : Les éléments suivants ont été supprimés.
|
|
67
|
+
|
|
68
|
+
### Variables deprecated
|
|
69
|
+
|
|
70
|
+
| Ancienne variable | Nouvelle variable |
|
|
71
|
+
|-------------------|-------------------|
|
|
72
|
+
| `$body-width` | `$NAPPR_BODY_WIDTH` |
|
|
73
|
+
| `$body-font-size` | `$NAPPR_BODY_FONT_SIZE` |
|
|
74
|
+
| `$default-spacing` | `$NAPPR_DEFAULT_SPACING` |
|
|
75
|
+
| `$font-sizes-map` | `$NAPPR_FONT_SIZES_MAP` |
|
|
76
|
+
| `$spacings-map` | `$NAPPR_SPACINGS_MAP` |
|
|
77
|
+
| `$border-style` | `$NAPPR_BORDER_STYLE` |
|
|
78
|
+
| `$border-size-map` | `$NAPPR_BORDER_SIZE_MAP` |
|
|
79
|
+
| `$border-radius-map` | `$NAPPR_BORDER_RADIUS_MAP` |
|
|
80
|
+
|
|
81
|
+
### Syntaxe deprecated
|
|
82
|
+
|
|
83
|
+
```scss
|
|
84
|
+
// ❌ Ancienne syntaxe (deprecated)
|
|
85
|
+
@import './_variables.scss';
|
|
86
|
+
@import '~@nappr/nappr-styles/styles.scss';
|
|
87
|
+
|
|
88
|
+
// ✅ Nouvelle syntaxe
|
|
89
|
+
@use './variables.scss' as *;
|
|
90
|
+
@use '@nappr/nappr-styles/styles.scss' as *;
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
### Grille deprecated
|
|
94
|
+
|
|
95
|
+
Les anciennes classes `.columns` et `.rows` (basées sur flexbox) ont été supprimées. Utilisez le nouveau système de grille CSS Grid :
|
|
96
|
+
|
|
97
|
+
```scss
|
|
98
|
+
// ❌ Deprecated
|
|
99
|
+
.columns .col-50 { ... }
|
|
100
|
+
|
|
101
|
+
// ✅ Nouvelle syntaxe
|
|
102
|
+
.nappr-grid .nappr-grid-col-6 { ... }
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
## Migration
|
|
106
|
+
|
|
107
|
+
Pour migrer votre code vers la version 1.0.0+ :
|
|
108
|
+
|
|
109
|
+
1. **Remplacez toutes les variables** : Utilisez les variables en MAJUSCULES préfixées avec `NAPPR_`
|
|
110
|
+
2. **Remplacez `@import` par `@use`** : Utilisez la syntaxe moderne des modules Sass
|
|
111
|
+
3. **Configuration rem** : Si vous utilisiez `$rem-baseline`, `$rem-fallback` ou `$rem-px-only`, configurez directement `sass-rem` dans votre projet
|
|
112
|
+
4. **Migrez vers la nouvelle grille** : Remplacez `.columns`/`.rows` par `.nappr-grid` et `.nappr-grid-col-*`
|