Blazorise Grid Utilities
A simple way to build responsive columns with Flex grid system.
Blazorise comes with a 12 point grid system built using flexbox. The grid is used to create specific layouts within an application’s content. It contains 5 types of media breakpoints that are used for targeting specific screen sizes or orientations, xs, sm, md, lg and xl.
Examples
Rows & Columns
As the grid can be divided into 12 columns, there are size classes for each division. These can be set usingColumnSize followed by .Is1 -> .Is12.
<Row> <Column ColumnSize="ColumnSize.Is12"> <Alert Color="Color.Primary" Visible> Is12 </Alert> </Column> </Row> <Row> <Column ColumnSize="ColumnSize.Is8"> <Alert Color="Color.Primary" Visible> Is8 </Alert> </Column> <Column ColumnSize="ColumnSize.Is4"> <Alert Color="Color.Secondary" Visible> Is4 </Alert> </Column> </Row>
Offset
Move columns to the right using.WithOffset attribute.
<Row> <Column ColumnSize="ColumnSize.Is4"> <Alert Color="Color.Primary" Visible> Is4 </Alert> </Column> <Column ColumnSize="ColumnSize.Is4.Is4.WithOffset"> <Alert Color="Color.Primary" Visible> Is4.Is4.WithOffset </Alert> </Column> </Row> <Row> <Column ColumnSize="ColumnSize.Is3.Is3.WithOffset"> <Alert Color="Color.Primary" Visible> Is3.Is3.WithOffset </Alert> </Column> <Column ColumnSize="ColumnSize.Is3.Is3.WithOffset"> <Alert Color="Color.Primary" Visible> Is3.Is3.WithOffset </Alert> </Column> </Row> <Row> <Column ColumnSize="ColumnSize.Is6.Is3.WithOffset"> <Alert Color="Color.Primary" Visible> Is6.Is3.WithOffset </Alert> </Column> </Row>
Gutter
Gutter can be used to set small spacing between Columns within a Row, without breaking the Grid wrapping rules (this is done by offsetting margins).
You can use it by setting the Gutter attribute on the Row. The Columns will automatically inherit this spacing and apply it.
Gutter is a tuple, which is (int Horizontal, int Vertical) based off pixel spacing.
In this example, each Column will get 16px of padding left and right, as well as 8px
of padding top and bottom. The Row will offset the margin accordingly.
<Row HorizontalGutter="32" VerticalGutter="16"> <Column ColumnSize="ColumnSize.Is8"> <Alert Color="Color.Primary" Visible> I have padding </Alert> </Column> <Column ColumnSize="ColumnSize.Is4"> <Alert Color="Color.Secondary" Visible> I also have padding </Alert> </Column> </Row>
Containers
Containers can be used as an easy and helpful way to display content with some default padding and margins for a clean UI.
Container
This container will be centered on desktop.<Container> <Alert Color="Color.Primary" Visible> Suspendisse vel quam malesuada, aliquet sem sit amet, fringilla elit. Morbi tempor tincidunt tempor. Etiam id turpis viverra, vulputate sapien nec, varius sem. Curabitur ullamcorper fringilla eleifend. In ut eros hendrerit est consequat posuere et at velit. </Alert> </Container>
Fluid Container
If you don’t want to have a maximum width but want to keep the some margin on the left and right sides, add theFluid modifier:
<Container Fluid> <Alert Color="Color.Primary" Visible> Suspendisse vel quam malesuada, aliquet sem sit amet, fringilla elit. Morbi tempor tincidunt tempor. Etiam id turpis viverra, vulputate sapien nec, varius sem. Curabitur ullamcorper fringilla eleifend. In ut eros hendrerit est consequat posuere et at velit. </Alert> </Container>
Responsive
Responsive containers allow you to specify a class that is 100% wide until the specified breakpoint is reached, after which we applymax-widths for each of the higher breakpoints. For example, Breakpoint.Tablet
is 100% wide to start until the Tablet breakpoint is reached, where it will scale up
with Desktop, Widescreen, and FullHD.
<Container Breakpoint="Breakpoint.Tablet"> <Alert Color="Color.Primary" Visible> 100% wide until tablet breakpoint </Alert> </Container> <Container Breakpoint="Breakpoint.Desktop"> <Alert Color="Color.Primary" Visible> 100% wide until desktop breakpoint </Alert> </Container> <Container Breakpoint="Breakpoint.Widescreen"> <Alert Color="Color.Primary" Visible> 100% wide until widescreen breakpoint </Alert> </Container> <Container Breakpoint="Breakpoint.FullHD"> <Alert Color="Color.Primary" Visible> 100% wide until full-hd breakpoint </Alert> </Container>
API
Attributes
Row
| Name | Description | Type | Default |
|---|---|---|---|
Gutter |
Row grid spacing - we recommend setting Horizontal and/or Vertical it to (16 + 8n). (n stands for natural number.) | (int, int) | null |
Column
| Name | Description | Type | Default |
|---|---|---|---|
Gutter |
Column grid spacing, we recommend setting it to (16 + 8n). (n stands for natural number.) | (int, int) | null |
Container
| Name | Description | Type | Default |
|---|---|---|---|
Breakpoint |
Makes a full width container that is 100% wide until the specified breakpoint is reached. | Breakpoint | None |
Fluid |
Makes a full width container, spanning the entire width of the viewport. | bool | false |