Documentation 03-grilles.md
This commit is contained in:
raphaelgoettter
parent
ec671ed5e6
commit
d95cac1545
2 changed files with 156 additions and 43 deletions
156
doc/03-grilles.md
Normal file
156
doc/03-grilles.md
Normal file
|
|
@ -0,0 +1,156 @@
|
||||||
|
# les grilles de mise en page
|
||||||
|
Il existe deux types principaux de systèmes de grilles dans KNACSS :
|
||||||
|
|
||||||
|
- Les grilles à colonnes égales
|
||||||
|
- Les grilles à colonnes inégales
|
||||||
|
|
||||||
|
Dans les deux cas, la technique associée depuis KNACSS v4 pour concevoir les grilles est **CSS3 Flexbox**, ce qui signifie que la compatibilité de **cette fonctionnalité sera réservée aux [navigateurs modernes](http://caniuse.com/#search=flexbox)** (IE10 et tous les autres, soit environ 95% du marché en France en 2015).
|
||||||
|
|
||||||
|
**NOTE pour les utilisateurs de LESS / Sass :** par défaut, les grilles sont activées dans KNACSS. Si vous avez le moindre souci, vérifiez que `@import "_03-grids";` est présent et non commenté dans votre fichier `less/knacss.less` ou `sass/knacss.scss`).
|
||||||
|
|
||||||
|
## Précautions à prendre
|
||||||
|
|
||||||
|
Qui dit CSS3 dit précautions à prendre.
|
||||||
|
La bonne nouvelle est que Flexbox est plutôt bien reconnu par l'ensemble des navigateurs de la planète; la mauvaise est que certains anciens navigateurs (Android par exemple) ne reconnaissent que certaines versions précédentes des spécifications. Il est donc encore nécessaire d'employer toute une panoplie de préfixes CSS (`-webkit-`, `-moz-`, `-ms-`, ...) pour être certain que vos grilles fonctionneront partout.
|
||||||
|
|
||||||
|
Au sein de la version CSS de KNACSS, l'ensemble des préfixes est présent, **vous n'avez donc pas à vous en soucier**.
|
||||||
|
|
||||||
|
**Par contre, dans les versions LESS et Sass de KNACSS, les préfixes n'apparaissent pas** pour ne pas polluer la lecture du fichier de travail. **Il vous sera donc nécessaire de les ajouter**, de préférence automatiquement grâce à un plugin ou aux excellents outils que sont [autoprefixer](https://github.com/postcss/autoprefixer) ou [pleeease](http://pleeease.io/).
|
||||||
|
|
||||||
|
## Exemple concret
|
||||||
|
|
||||||
|
Pour vous faire une idée, et jouer avec les valeurs possibles, vous trouverez [un exemple "bac à sable"](http://codepen.io/raphaelgoetter/full/zxBMLW/) sur CodePen.
|
||||||
|
|
||||||
|
|
||||||
|
## Mise en oeuvre
|
||||||
|
|
||||||
|
Il est très simple de construire une grille, il vous suffit :
|
||||||
|
|
||||||
|
- D'un **conteneur**
|
||||||
|
- D'autant **d'enfants** que vous souhaitez
|
||||||
|
|
||||||
|
Le **conteneur** sera l'élément HTML que vous voulez (`div`, `section`, `ul`, ...). Il vous suffit simplement de le munir d'une classe selon votre choix de grille :
|
||||||
|
|
||||||
|
- `.grid-2`, `.grid-3`, `.grid-4`, ... `.grid-12` pour les grilles de largeur égales
|
||||||
|
- `.grid-2-1`, `.grid-1-2`, `.grid-3-1`, ... `.grid-1-4` pour les grilles de largeur inégales (2/3 - 1/3 par exemple)
|
||||||
|
|
||||||
|
Par défaut, chaque colonne est séparée de sa voisine par une gouttière dont la largeur par défaut est `1em`. Pour modifier ce réglage, il sera nécessaire de passer par la version préprocesseur (LESS, Sass) de KNACSS (voir plus loin).
|
||||||
|
|
||||||
|
Les **enfants** directs d'un conteneur, quels qu'ils soient, se répartissent automatiquement au sein de la grille formée par leur conteneur. Par exemple, 6 enfants contenus dans un parent de classe `.grid-3` se répartiront en 3 colonnes et 2 lignes.
|
||||||
|
|
||||||
|
## Offsets
|
||||||
|
|
||||||
|
Il vous est très facile de "pousser" un élément à droite ou à gauche de sa ligne dans la grille, et créer ainsi un espacement volontaire, ce que l'on appelle "offset".
|
||||||
|
|
||||||
|
Pour cela, appliquez simplement l'une ou l'autre de ces déclarations sur l'élément :
|
||||||
|
|
||||||
|
- `margin-left: auto` pour le pousser à droite sur sa ligne
|
||||||
|
- `margin-right: auto` pour le pousser à gauche sur sa ligne
|
||||||
|
|
||||||
|
## Mise en exergue
|
||||||
|
|
||||||
|
Il est possible de mettre un élément particulier en exergue, en doublant sa taille par rapport aux autres, tout en conservant un agencement parfait de la grille.
|
||||||
|
|
||||||
|
Pour ce faire, appliquez la classe `.flexitem-double` à cet élément.
|
||||||
|
|
||||||
|
## Pousser au début ou à la fin
|
||||||
|
|
||||||
|
Vous pouvez modifier l'ordre d'affichage des éléments au sein d'une grille à l'aide des classes :
|
||||||
|
|
||||||
|
- `.flexitem-first` (l'élément apparaîtra avant tous les autres)
|
||||||
|
- `.flexitem-last` (l'élément apparaîtra tout à la fin de la grille)
|
||||||
|
|
||||||
|
## Plus loin avec les préprocesseurs
|
||||||
|
|
||||||
|
KNACSS est pensé pour être utilisé à l'aide de preprocesseurs tels que LESS ou Sass. Il existe par conséquent un fichier de variables de configuration et des mixins prévus pour étendre les possibilités des grilles notamment.
|
||||||
|
|
||||||
|
### Modifier les variables globales
|
||||||
|
|
||||||
|
Les variables de configuration des grilles se trouvent dans le fichier `less/_00-config.less` (pour les utilisateurs de LESS) et `sass/_00-config.scss` (en version Sass) :
|
||||||
|
|
||||||
|
```css
|
||||||
|
@gutter: 1em;
|
||||||
|
@number: 4; // for equal columns
|
||||||
|
@left: 2; // left side of uneven columns
|
||||||
|
@right: 1; // right side of uneven columns
|
||||||
|
```
|
||||||
|
|
||||||
|
Il vous suffit de modifier les valeurs de ces variables de config pour répercuter vos préférences sur l'ensemble du projet dès que vos fichiers LESS/Sass seront compilés en CSS.
|
||||||
|
|
||||||
|
### Générer des grilles personnalisées
|
||||||
|
|
||||||
|
Indépendamment des variables de configuration, rien de vous empêche de créer une grille personnalisée en incluant directement l'un des deux mixins possibles dans vos éléments :
|
||||||
|
|
||||||
|
- `.grid(n,g)` pour personnaliser une grille de colonnes **égales**. Les arguments sont "n" = nombre de colonnes et "g" = largeur de gouttière (exemple ci-dessous)
|
||||||
|
- `.uneven-grid(l,r,g)` pour personnaliser une grille de colonnes **inégales**. Les arguments sont "l" = pour le ratio de la colonne de gauche, "r" = pour le ratio de la colonne de droite et "g" = largeur de gouttière (exemple ci-dessous)
|
||||||
|
|
||||||
|
#### Grille de colonnes égales en LESS
|
||||||
|
|
||||||
|
**Objectif : je souhaite que mon élément `.grid-container` crée une grille de 6 colonnes égales, séparées par une gouttière de 10px.**
|
||||||
|
|
||||||
|
LESS (fichier de développement) :
|
||||||
|
```css
|
||||||
|
.grid-container {
|
||||||
|
.grid(6, 10px);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
CSS compilé (sans Autoprefixer) :
|
||||||
|
|
||||||
|
```css
|
||||||
|
.grid-container {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: row;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
margin-left: -10px;
|
||||||
|
}
|
||||||
|
.grid-container > * {
|
||||||
|
flex: 0 0 auto;
|
||||||
|
width: 16.66666667%;
|
||||||
|
display: block; /* IE fix */
|
||||||
|
padding: 1em;
|
||||||
|
border-left: 10px solid transparent;
|
||||||
|
background-clip: padding-box !important; /* no background on border */
|
||||||
|
}
|
||||||
|
...
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Grille de colonnes inégales en LESS
|
||||||
|
|
||||||
|
**Objectif : je souhaite que mon élément `<section>` crée une grille de 2 colonnes réparties en 2/3 et 1/3, séparées par une gouttière de 15px.**
|
||||||
|
|
||||||
|
LESS (fichier de développement) :
|
||||||
|
|
||||||
|
```css
|
||||||
|
section {
|
||||||
|
.uneven-grid(2, 1, 15px);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
CSS compilé (sans Autoprefixer) :
|
||||||
|
|
||||||
|
```css
|
||||||
|
section {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: row;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
margin-left: -15px;
|
||||||
|
}
|
||||||
|
section > * {
|
||||||
|
display: block; /* IE fix */
|
||||||
|
padding: 1em;
|
||||||
|
border-left: 15px solid transparent;
|
||||||
|
background-clip: padding-box !important; /* no background on border */
|
||||||
|
}
|
||||||
|
section > *:nth-child(odd) {
|
||||||
|
width: 66.66666667%;
|
||||||
|
}
|
||||||
|
section > *:nth-child(even) {
|
||||||
|
width: 33.33333333%;
|
||||||
|
}
|
||||||
|
...
|
||||||
|
```
|
||||||
|
|
||||||
|
## Article associé
|
||||||
|
|
||||||
|
Si vous voulez comprendre dans le détail le fonctionnement des grilles Flexbox de KNACSS, je vous invite à suivre l'article d'Alsacréations ["Une grille responsive avec CSS3 Flexbox et LESS (ou Sass)"](http://www.alsacreations.com/tuto/lire/1659-une-grille-responsive-avec-flexbox-et-LESS.html).
|
||||||
|
|
@ -1,43 +0,0 @@
|
||||||
# les grilles de mise en page
|
|
||||||
Il existe deux types principaux de systèmes de grilles dans KNACSS :
|
|
||||||
|
|
||||||
- Les grilles à colonnes égales
|
|
||||||
- Les grilles à colonnes inégales
|
|
||||||
|
|
||||||
Dans les deux cas, la technique associée depuis KNACSS v4 pour concevoir les grilles est **CSS3 Flexbox**, ce qui signifie que la compatibilité de **cette fonctionnalité sera réservée aux [navigateurs modernes](http://caniuse.com/#search=flexbox)** (IE10 et tous les autres, soit environ 95% du marché en France en 2015).
|
|
||||||
|
|
||||||
## Précautions
|
|
||||||
|
|
||||||
préfixes (autoprefixer, pleeease)
|
|
||||||
|
|
||||||
## Mise en oeuvre
|
|
||||||
|
|
||||||
Il est très simple de construire une grille, il vous suffit :
|
|
||||||
|
|
||||||
- D'un **conteneur**
|
|
||||||
- D'autant **d'enfants** que vous souhaitez
|
|
||||||
|
|
||||||
Le **conteneur** sera l'élément HTML que vous voulez (`div`, `section`, `ul`, ...). Il vous suffit simplement de le munir d'une classe selon votre choix de grille :
|
|
||||||
|
|
||||||
- `.grid-2`, `.grid-3`, `.grid-4`, ... `.grid-12` pour les grilles de largeur égales
|
|
||||||
- `.grid-2-1`, `.grid-1-2`, `.grid-3-1`, ... `.grid-1-4` pour les grilles de largeur inégales (2/3 - 1/3 par exemple)
|
|
||||||
|
|
||||||
Par défaut, chaque colonne est séparée de sa voisine par une gouttière dont la largeur par défaut est `1em`. Pour modifier ce réglage, il sera nécessaire de passer par la version préprocesseur (LESS, Sass) de KNACSS (voir plus loin).
|
|
||||||
|
|
||||||
Les **enfants** directs d'un conteneur, quels qu'ils soient, se répartissent automatiquement au sein de la grille formée par leur conteneur. Par exemple, 6 enfants contenus dans un parent de classe `.grid-3` se répartiront en 3 colonnes et 2 lignes.
|
|
||||||
|
|
||||||
## Offsets
|
|
||||||
|
|
||||||
margin-left ou margin-right
|
|
||||||
|
|
||||||
## À la une
|
|
||||||
|
|
||||||
".flexitem-double"
|
|
||||||
|
|
||||||
## Pousser au début ou à la fin
|
|
||||||
|
|
||||||
".flexitem-first" and ".flexitem-last"
|
|
||||||
|
|
||||||
## Pour aller plus loin
|
|
||||||
|
|
||||||
Si vous voulez comprendre dans le détail le fonctionnement des grilles Flexbox de KNACSS, je vous invite à suivre l'article d'Alsacréations ["Une grille responsive avec CSS3 Flexbox et LESS (ou Sass)"](http://www.alsacreations.com/tuto/lire/1659-une-grille-responsive-avec-flexbox-et-LESS.html).
|
|
||||||
Loading…
Reference in a new issue