Columns

Learn how to modify columns with a handful of options for alignment, ordering, and offsetting thanks to our flexbox grid system.

On this page

How they work#

Columns build on the grid's flexbox architecture. Flexbox means we have options for changing individual columns andmodifying groups of columns at the row level. You choose how columns grow, shrink, or otherwise change.
When building grid layouts, all content goes in columns. The hierarchy of CoreUI's grid goes fromcontainer to row to column to your content. On rare occasions, you may combine content and column, but be aware there can be unintended consequences.
CoreUI for React.js includes predefined components for creating fast, responsive layouts. Withsix breakpoints and a dozen columns at each grid tier, we have dozens of components already built for you to create your desired layouts. This can be disabled via Sass if you wish.

Alignment#

Use flexbox alignment utilities to vertically and horizontally align columns.

Vertical alignment#

One of three columns

<CContainer>
<CRowclassName="align-items-start">
<CCol>One of three columns</CCol>
<CCol>One of three columns</CCol>
<CCol>One of three columns</CCol>
</CRow>
<CRowclassName="align-items-center">
<CCol>One of three columns</CCol>
<CCol>One of three columns</CCol>
<CCol>One of three columns</CCol>
</CRow>
<CRowclassName="align-items-end">
<CCol>One of three columns</CCol>
<CCol>One of three columns</CCol>
<CCol>One of three columns</CCol>
</CRow>
</CContainer>

One of three columns

<CContainer>
<CRow>
<CColclassName="align-self-start">One of three columns</CCol>
<CColclassName="align-self-center">One of three columns</CCol>
<CColclassName="align-self-end">One of three columns</CCol>
</CRow>
</CContainer>

Horizontal alignment#

One of two columns

<CContainer>
<CRowclassName="justify-content-start">
<CColxs={4}>One of two columns</CCol>
<CColxs={4}>One of two columns</CCol>
</CRow>
<CRowclassName="justify-content-center">
<CColxs={4}>One of two columns</CCol>
<CColxs={4}>One of two columns</CCol>
</CRow>
<CRowclassName="justify-content-end">
<CColxs={4}>One of two columns</CCol>
<CColxs={4}>One of two columns</CCol>
</CRow>
<CRowclassName="justify-content-around">
<CColxs={4}>One of two columns</CCol>
<CColxs={4}>One of two columns</CCol>
</CRow>
<CRowclassName="justify-content-between">
<CColxs={4}>One of two columns</CCol>
<CColxs={4}>One of two columns</CCol>
</CRow>
<CRowclassName="justify-content-evenly">
<CColxs={4}>One of two columns</CCol>
<CColxs={4}>One of two columns</CCol>
</CRow>
</CContainer>

Column wrapping#

If more than 12 columns are placed within a single row, each group of extra columns will, as one unit, wrap onto a new line.

.col-9

.col-4
Since 9 + 4 = 13 > 12, this 4-column-wide div gets wrapped onto a new line as one contiguous unit.

.col-6
Subsequent columns continue along the new line.

<CContainer>
<CRow>
<CColxs={9}>.col-9</CCol>
<CColxs={4}>
      .col-4
<br/>
      Since 9 + 4 = 13 &gt; 12, this 4-column-wide div gets wrapped onto a new line as one
      contiguous unit.
</CCol>
<CColxs={6}>
      .col-6
<br/>
      Subsequent columns continue along the new line.
</CCol>
</CRow>
</CContainer>

Column breaks#

Breaking columns to a new line in flexbox requires a small hack: add an element withwidth: 100% wherever you want to wrap your columns to a new line. Normally this is accomplished with multiple<CRow>s, but not every implementation method can account for this.

.col-6 .col-sm-3

<CContainer>
<CRow>
<CColxs={6}sm={3}>
      .col-6 .col-sm-3
</CCol>
<CColxs={6}sm={3}>
      .col-6 .col-sm-3
</CCol>
<divclassName="w-100"></div>
<CColxs={6}sm={3}>
      .col-6 .col-sm-3
</CCol>
<CColxs={6}sm={3}>
      .col-6 .col-sm-3
</CCol>
</CRow>
</CContainer>

You may also apply this break at specific breakpoints with ourresponsive display utilities.

.col-6 .col-sm-4

<CContainer>
<CRow>
<CColxs={6}sm={4}>
      .col-6 .col-sm-4
</CCol>
<CColxs={6}sm={4}>
      .col-6 .col-sm-4
</CCol>
<divclassName="w-100 d-none d-md-block"></div>
<CColxs={6}sm={4}>
      .col-6 .col-sm-4
</CCol>
<CColxs={6}sm={4}>
      .col-6 .col-sm-4
</CCol>
</CRow>
</CContainer>

Reordering#

Order props#

Usexs|sm|md|lg|xl|xxl={{ order: 1-5 }} props for controlling thevisual order of your content. These props are responsive, so you can set theorder by breakpoint (e.g.,xs={{ order: 1}} md={{ order: 2}}). Includes support for1 through5 across all six grid tiers.

First in DOM, no order applied

Second in DOM, with a larger order

Third in DOM, with an order of 1

<CContainer>
<CRow>
<CCol>First in DOM, no order applied</CCol>
<CColxs={{span:true,order:5}}>Second in DOM, with a larger order</CCol>
<CColxs={{span:true,order:1}}>Third in DOM, with an order of 1</CCol>
</CRow>
</CContainer>

There are also responsivexs|sm|md|lg|xl|xxl={{ order: 'first' }} andxs|sm|md|lg|xl|xxl={{ order: 'last' }} props that change theorder of an element by applyingorder: -1 andorder: 6, respectively. These values can also be intermixed with the numberedxs|sm|md|lg|xl|xxl={{ order: 1-5 }} values as needed.

First in DOM, ordered last

Second in DOM, unordered

Third in DOM, ordered first

<CContainer>
<CRow>
<CColxs={{span:true,order:'last'}}>First in DOM, ordered last</CCol>
<CCol>Second in DOM, unordered</CCol>
<CColxs={{span:true,order:'first'}}>Third in DOM, ordered first</CCol>
</CRow>
</CContainer>

Offsetting columns#

You can offset grid columns in two ways: our responsivexs|sm|md|lg|xl|xxl={{ offset: 0-12 }} grid props and ourmargin utilities. Grid props are sized to match columns while margins are more useful for quick layouts where the width of the offset is variable.

Offset prop#

Move columns to the right usingmd={{ offset: * }} props. These props increase the left margin of a column by* columns. For example,md={{ offset: 4 }} moves.col-md-4 over four columns.

.col-md-4

.col-md-4 .offset-md-4

.col-md-3 .offset-md-3

.col-md-6 .offset-md-3

<CContainer>
<CRow>
<CColmd={4}>.col-md-4</CCol>
<CColmd={{span:4,offset:4}}>.col-md-4 .offset-md-4</CCol>
</CRow>
<CRow>
<CColmd={{span:3,offset:3}}>.col-md-3 .offset-md-3</CCol>
<CColmd={{span:3,offset:3}}>.col-md-3 .offset-md-3</CCol>
</CRow>
<CRow>
<CColmd={{span:6,offset:3}}>.col-md-6 .offset-md-3</CCol>
</CRow>
</CContainer>

.col-sm-5 .col-md-6

.col-sm-5 .offset-sm-2 .col-md-6 .offset-md-0

.col-sm-6 .col-md-5 .col-lg-6

.col-sm-6 .col-md-5 .offset-md-2 .col-lg-6 .offset-lg-0

<CContainer>
<CRow>
<CColsm={5}md={6}>
      .col-sm-5 .col-md-6
</CCol>
<CColsm={{span:5,offset:2}}md={{span:6,offset:0}}>
      .col-sm-5 .offset-sm-2 .col-md-6 .offset-md-0
</CCol>
</CRow>
<CRow>
<CColsm={6}md={5}lg={6}>
      .col-sm-6 .col-md-5 .col-lg-6
</CCol>
<CColsm={6}md={{span:5,offset:2}}lg={{span:6,offset:0}}>
      .col-sm-6 .col-md-5 .offset-md-2 .col-lg-6 .offset-lg-0
</CCol>
</CRow>
</CContainer>

Margin utilities#

You can use margin utilities like.me-auto to force sibling columns away from one another.

.col-md-4

.col-md-4 .ms-auto

.col-md-3 .ms-md-auto

.col-auto .me-auto

.col-auto

<CContainer>
<CRow>
<CColmd={4}>.col-md-4</CCol>
<CColmd={4}className="ms-auto">
      .col-md-4 .ms-auto
</CCol>
</CRow>
<CRow>
<CColmd={3}className="ms-md-auto">
      .col-md-3 .ms-md-auto
</CCol>
<CColmd={3}className="ms-md-auto">
      .col-md-3 .ms-md-auto
</CCol>
</CRow>
<CRow>
<CColxs="auto"className="me-auto">
      .col-auto .me-auto
</CCol>
<CColxs="auto">.col-auto</CCol>
</CRow>
</CContainer>

Standalone column component#

The<CCol> component can also be used outside a<CRow> to give an element a specific width. Whenever column component are used as non direct children of a row, the paddings are omitted.

.col-3: width of 25%

.col-sm-9: width of 75% above sm breakpoint

<CColxs={3}className="bg-light p-3 border">
  .col-3: width of 25%
</CCol>
<CColsm={9}className="bg-light p-3 border">
  .col-sm-9: width of 75% above sm breakpoint
</CCol>

API#

CCol#

import{CCol}from'@coreui/react'
// or
importCColfrom'@coreui/react/src/components/grid/CCol'

Property	Default	Type
className#	-	`string`
A string of all className you want applied to the base component.
lg#	-	`{ 'auto' \| number \| string \| boolean \| { span: 'auto' \| number \| string \| boolean } \| { offset: number \| string } \| { order: 'first' \| 'last' \| number \| string }}`
The number of columns/offset/order on large devices (<1200px).
md#	-	`{ 'auto' \| number \| string \| boolean \| { span: 'auto' \| number \| string \| boolean } \| { offset: number \| string } \| { order: 'first' \| 'last' \| number \| string }}`
The number of columns/offset/order on medium devices (<992px).
sm#	-	`{ 'auto' \| number \| string \| boolean \| { span: 'auto' \| number \| string \| boolean } \| { offset: number \| string } \| { order: 'first' \| 'last' \| number \| string }}`
The number of columns/offset/order on small devices (<768px).
xl#	-	`{ 'auto' \| number \| string \| boolean \| { span: 'auto' \| number \| string \| boolean } \| { offset: number \| string } \| { order: 'first' \| 'last' \| number \| string }}`
The number of columns/offset/order on X-Large devices (<1400px).
xs#	-	`{ 'auto' \| number \| string \| boolean \| { span: 'auto' \| number \| string \| boolean } \| { offset: number \| string } \| { order: 'first' \| 'last' \| number \| string }}`
The number of columns/offset/order on extra small devices (<576px).
xxl#	-	`{ 'auto' \| number \| string \| boolean \| { span: 'auto' \| number \| string \| boolean } \| { offset: number \| string } \| { order: 'first' \| 'last' \| number \| string }}`
The number of columns/offset/order on XX-Large devices (≥1400px).

Movatterモバイル変換