Skip to content

chore(docs): add clarification to order and order-{breakpoint} section #3888

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Aug 14, 2019
Merged

chore(docs): add clarification to order and order-{breakpoint} section #3888

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
03bc42f
chore(docs): add clarification to `order` and `order-{breakpoint}` se…
tmorehouse Aug 14, 2019
f8423d3
Merge branch 'dev' into tmorehouse/layout-docs
jacobmllr95 Aug 14, 2019
e5979bf
Update README.md
jacobmllr95 Aug 14, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 13 additions & 5 deletions src/components/layout/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -454,20 +454,28 @@ Use flexbox alignment utilities to vertically and horizontally align columns.

Use `order-*` props for controlling the visual order of your content. These props are responsive, so
you can set the order by breakpoint (e.g., `order="1" order-md="2"`). Includes support for 1 through
12 across all five grid tiers.
12 across all five grid tiers. `<b-col>` defaults to an order value of `0`.

```html
<b-container fluid class="bv-example-row">
<b-row>
<b-col>First, but unordered</b-col>
<b-col order="12">Second, but last</b-col>
<b-col order="1">Third, but first</b-col>
<b-row class="mb-3">
<b-col>First in DOM, no order applied</b-col>
<b-col order="5">Second in DOM, with a larger order</b-col>
<b-col order="1">Third in DOM, with an order of 1</b-col>
</b-row>

<b-row class="mb-3">
<b-col order="6">First in DOM, with order of 6</b-col>
<b-col order="1">Second in DOM, with an order of 1</b-col>
<b-col>Third in DOM, no order applied</b-col>
</b-row>
</b-container>

<!-- b-grid-order.vue -->
```

Ordering is controlled by flexbox's CSS style `order`.

### Offsetting columns

You can offset grid columns in two ways: our responsive `offset-*` props or the
Expand Down