Flex
Utilisation
Le composant Flex est un composant technique qui facilite l'utilisation du style CSS Flex. Pour des recommandations d'utilisation, reportez-vous à la documentation officielle Flexbox.
Code
<Flex>
<FlexItem>
<strong>First item</strong>
</FlexItem>
<FlexItem>
<strong>Second item</strong>
</FlexItem>
<FlexItem>
<strong>Third item</strong>
</FlexItem>
</Flex>
Instruction d'importation
import { Flex, FlexItem } from '@jutro/layout';
Cahier des charges du composant
Assurez-vous de comprendre la surface de l'API des composants du système de conception, ainsi que les implications et les compromis. Pour en savoir plus, reportez-vous à notre introduction à l'API des composants.
Propriétés
Propriétés de Flex
alignContent- Type
'center' | 'baseline' | 'stretch' | 'start' | 'end'DescriptionAligns the flex within its container in the axis opposite to its direction.
alignItems- Type
'center' | 'baseline' | 'stretch' | 'start' | 'end'DescriptionAligns all items within the grid in the axis opposite to its direction.
direction- Type
'row' | 'rowReverse' | 'column' | 'columnReverse'DescriptionSets the flex direction.
Valeur par défaut'row' gap- Type
'none' | 'small' | 'medium' | 'large'DescriptionThe size of the gaps between rows and columns.
justifyContent- Type
'center' | 'baseline' | 'stretch' | 'start' | 'end'DescriptionJustifies the content in the flex direction: horizontally if direction is 'row' (default) or vertically if direction is 'column'.
tag- Type
stringDescriptionOptional DOM tag to render.
Valeur par défaut'div' wrap- Type
boolean | 'true' | 'false' | 'reverse'DescriptionWrap (true), don't wrap (false), reverse wrap (reverse) flex items in the container.
phoneobsolète- Type
stringDescriptionFlex properties that are used at the
phonebreakpoint. phoneWideobsolète- Type
stringDescriptionFlex properties that are used at the
phoneWidebreakpoint. tabletobsolète- Type
FlexDescriptionFlex properties that are used at the
tabletbreakpoint. themeobsolète- Type
anyDescriptionProp 'theme' is unused in the component and has no effect.
Propriétés de FlexItem
alignSelf- Type
'center' | 'baseline' | 'stretch' | 'start' | 'end'DescriptionAligns the flex item according to the cross axis of the flex direction.
basis- Type
number | stringDescriptionSpecifies the initial length of a flex item.
grow- Type
number | stringDescriptionThe standard flex grow property.
shrink- Type
number | stringDescriptionThe standard flex shrink property.
tag- Type
stringDescriptionOptional DOM tag to render.
Valeur par défaut'div' textAlignobsolète- Type
'left' | 'center' | 'right'DescriptionAligns the contents of the column horizontally.
visibleobsolète- Type
booleanDescriptionIf set to
false, theFlexItemis hidden. In any other case, theFlexItemis displayed.
Crochets
Aucun crochet n'est disponible pour Flex.
Clés de traduction
Il n'existe aucune traduction pour Flex.
Pour en savoir plus sur la gestion des traductions, reportez-vous à notre section sur l'internationalisation.
Portes de sortie
Pour en savoir plus, reportez-vous à notre documentation sur les portes de sortie.
Exemples
Exemple de conteneur flexible de base
Un conteneur Jutro Flex de base contient un composant Flex avec plusieurs composants enfants. Si ces enfants sont des composants FlexItem, vous pouvez utiliser les propriétés FlexItem supplémentaires pour avoir plus de contrôle sur l'élément au niveau de la mise en page.
Par défaut, le composant Flex de Jutro contient la propriété wrap définie sur true. Cela signifie que vos éléments tentent de tenir dans l'espace horizontal disponible, mais s'ils ne le peuvent pas, ils apparaissent dans les lignes suivantes.
<Flex>
<FlexItem>
<strong>First item</strong>
</FlexItem>
<FlexItem>
<strong>Second item</strong>
</FlexItem>
<FlexItem>
<strong>Third item</strong>
</FlexItem>
</Flex>
Exemple gap
La propriété gap est utilisée pour définir la distance entre les colonnes d'un conteneur Flex.
<h3>Small</h3>
<Flex gap="small">
<FlexItem>
<strong>First item</strong>
</FlexItem>
<FlexItem>
<strong>Second item</strong>
</FlexItem>
<FlexItem>
<strong>Third item</strong>
</FlexItem>
</Flex>
<h3>Medium</h3>
<Flex gap="medium">
<FlexItem>
<strong>First item</strong>
</FlexItem>
<FlexItem>
<strong>Second item</strong>
</FlexItem>
<FlexItem>
<strong>Third item</strong>
</FlexItem>
</Flex>
<h3>Large</h3>
<Flex gap="large">
<FlexItem>
<strong>First item</strong>
</FlexItem>
<FlexItem>
<strong>Second item</strong>
</FlexItem>
<FlexItem>
<strong>Third item</strong>
</FlexItem>
</Flex>
<h3>None</h3>
<Flex gap="none">
<FlexItem>
<strong>First item</strong>
</FlexItem>
<FlexItem>
<strong>Second item</strong>
</FlexItem>
<FlexItem>
<strong>Third item</strong>
</FlexItem>
</Flex>
Exemple direction
La propriété direction définit la disposition initiale des éléments dans un conteneur Flex. Sa valeur par défaut est row, ce qui signifie que les éléments sont placés sur la même ligne s'il y a de la place, en commençant par le côté gauche de l'écran, comme on le voit dans les exemples précédents.
Si vous définissez direction sur rowReverse, les éléments seront placés sur la même ligne en partant du côté droit de l'écran.
<Flex direction="rowReverse">
<FlexItem>
<strong>First item</strong>
</FlexItem>
<FlexItem>
<strong>Second item</strong>
</FlexItem>
<FlexItem>
<strong>Third item</strong>
</FlexItem>
</Flex>
Si vous définissez direction sur column ou columnReverse, les éléments seront disposés verticalement de haut en bas ou de bas en haut respectivement.
<Flex direction='column'>
<FlexItem>
<strong>First item</strong>
</FlexItem>
<FlexItem>
<strong>Second item</strong>
</FlexItem>
<FlexItem>
<strong>Third item</strong>
</FlexItem>
</Flex>
<Flex direction='columnReverse'>
<FlexItem>
<strong>Fourth item</strong>
</FlexItem>
<FlexItem>
<strong>Fifth item</strong>
</FlexItem>
<FlexItem>
<strong>Sixth item</strong>
</FlexItem>
</Flex>
Journal des modifications
10.9.0
Modifications Flex effectuées dans la version 10.9.0
Les propriétés Flex suivantes sont désormais obsolètes :
tabletphoneWidephone
Les options suivantes pour les propriétés Flex sont désormais obsolètes :
alignItems-'top','middle','bottom','right'et'left'alignContent-'top','middle','bottom','right'et'left'justifyContent-'top','middle','bottom','right'et'left'
Modifications FlexItem effectuées dans la version 10.9.0
Les propriétés FlexItem suivantes sont désormais obsolètes :
tabletphoneWidephonevisibletextAlign
Les options suivantes pour les propriétés FlexItem sont désormais obsolètes :
alignSelf-'top','middle','bottom','right'et'left'