Layouts used for positioning content inside of pages, cards, or containers.
<%= pb_rails("layout", props: {position: "left", size: "sm", collapse: "md"}) do %> <%= pb_rails("layout/sidebar") do %> <%= pb_rails("body", props: { text: "Light" }) %> <% end %> <%= pb_rails("layout/body") do %> Body <% end %> <% end %> <br/><br/> <%= pb_rails("layout", props: {position: "left", size: "sm", collapse: "md", variant: "dark"}) do %> <%= pb_rails("layout/sidebar") do %> <%= pb_rails("body", props: { text: "Dark", dark: true }) %> <% end %> <%= pb_rails("layout/body") do %> Body <% end %> <% end %> <br/><br/> <%= pb_rails("layout", props: {position: "left", size: "sm", collapse: "md", variant: "gradient"}) do %> <%= pb_rails("layout/sidebar") do %> <%= pb_rails("body", props: { text: "Gradient", dark: true }) %> <% end %> <%= pb_rails("layout/body") do %> Body <% end %> <% end %>
<%= pb_rails("layout", props: {position: "left", size: "xs", collapse: "sm", transparent: true}) do %> <%= pb_rails("layout/sidebar") do %> <%= pb_rails("body", props: { text: "Side" }) %> <% end %> <%= pb_rails("layout/body") do %> <%= pb_rails("body", props: { text: "Body" }) %> <% end %> <% end %>
<%= pb_rails("layout", props: {position: "left", size: "xs", collapse: "xs"}) do %> <%= pb_rails("layout/sidebar") do %> Side <% end %> <%= pb_rails("layout/body") do %> Body <% end %> <% end %> <br/><br/> <%= pb_rails("layout", props: {position: "left", size: "sm", collapse: "sm"}) do %> <%= pb_rails("layout/sidebar") do %> Side <% end %> <%= pb_rails("layout/body") do %> Body <% end %> <% end %> <br/><br/> <%= pb_rails("layout", props: {position: "left", size: "md", collapse: "sm"}) do %> <%= pb_rails("layout/sidebar") do %> Side <% end %> <%= pb_rails("layout/body") do %> Body <% end %> <% end %> <br/><br/> <%= pb_rails("layout", props: {position: "left", size: "lg", collapse: "sm"}) do %> <%= pb_rails("layout/sidebar") do %> Side <% end %> <%= pb_rails("layout/body") do %> Body <% end %> <% end %> <br/><br/> <%= pb_rails("layout", props: {position: "left", size: "xl", collapse: "sm"}) do %> <%= pb_rails("layout/sidebar") do %> Side <% end %> <%= pb_rails("layout/body") do %> Body <% end %> <% end %>
Layout can leverage the max-width property. Learn more in our visual guidelines.
<%= pb_rails("layout", props: {layout: "collection"}) do %> <%= pb_rails("layout/body") do %> <%= pb_rails("card" ) do %> Card content <% end %> <%= pb_rails("card") do %> <%= pb_rails("title", props: { text: "Title 4", tag: "h4", size: 4 }) %> <%= pb_rails("title", props: { text: "Title 3", tag: "h3", size: 3 }) %> <% end %> <%= pb_rails("card" ) do %> <%= pb_rails("user", props: { name: "Anna Black", title: "Remodeling Consultant", orientation: "vertical", align: "center", size: "lg", avatar_url: "https://randomuser.me/api/portraits/women/44.jpg" }) %> <% end %> <%= pb_rails("card" ) do %> <%= pb_rails("title", props: { text: "Title 4", tag: "h4", size: 4 }) %> <%= pb_rails("title", props: { text: "Title 2", tag: "h2", size: 2 }) %> <%= pb_rails("title", props: { text: "Title 1", tag: "h1", size: 1 }) %> <% end %> <%= pb_rails("card" ) do %> Card content <% end %> <%= pb_rails("card") do %> Card content <% end %> <%= pb_rails("user", props: { name: "Anna Black", title: "Remodeling Consultant", orientation: "vertical", align: "center", size: "lg", avatar_url: "https://randomuser.me/api/portraits/women/44.jpg" }) %> <%= pb_rails("card" ) do %> Card content <% end %> <%= pb_rails("card" ) do %> <%= pb_rails("title", props: { text: "Title 4", tag: "h4", size: 4 }) %> <%= pb_rails("title", props: { text: "Title 3", tag: "h3", size: 3 }) %> <%= pb_rails("title", props: { text: "Title 2", tag: "h2", size: 2 }) %> <%= pb_rails("title", props: { text: "Title 1", tag: "h1", size: 1 }) %> <% end %> <% end %> <% end %>
The left element on Collection Detail can be used for things such as navigation or secondary content to the element on the right. The right content can be used the same way that you would use Collection. The element on the right should be the primary focus and can be used for repeating elements such as cards.
<%= pb_rails("layout", props: {position: "left", size: "sm", collapse: "md", layout: "collection_detail" }) do %> <%= pb_rails("layout/sidebar") do %> <%= pb_rails("card", props: { margin_right: "md", padding: "none" }) do %> <%= pb_rails("nav", props: {title: "Menu", link: "#", padding_top:"md" }) do %> <%= pb_rails("nav/item", props: { text: "Photos", link: "#" }) %> <%= pb_rails("nav/item", props: { text: "Music", link: "#" }) %> <%= pb_rails("nav/item", props: { text: "Video", link: "#", active: true }) %> <%= pb_rails("nav/item", props: { text: "Files", link: "#" }) %> <% end %> <% end %> <% end %> <%= pb_rails("layout/body") do %> <% 25.times do %> <%= pb_rails("card") do %> Card content <% end %> <% end %> <% end %> <% end %>
<%= pb_rails("layout", props: {layout: "kanban"}) do %> <%= pb_rails("layout/body") do %> <%= pb_rails("caption", props: {text: 'Queued'}) %> <%= pb_rails("card") do %> Kanban Item <% end %> <% end %> <%= pb_rails("layout/body") do %> <%= pb_rails("caption", props: {text: 'In Progress'}) %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <% end %> <%= pb_rails("layout/body") do %> <%= pb_rails("caption", props: {text: 'Validation'}) %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <% end %> <%= pb_rails("layout/body") do %> <%= pb_rails("caption", props: {text: 'Done'}) %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <% end %> <%= pb_rails("layout/body") do %> <%= pb_rails("caption", props: {text: 'OKRs'}) %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <% end %> <%= pb_rails("layout/body") do %> <%= pb_rails("caption", props: {text: 'Bugs'}) %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <% end %> <%= pb_rails("layout/body") do %> <%= pb_rails("caption", props: {text: 'Another Column'}) %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <% end %> <%= pb_rails("layout/body") do %> <%= pb_rails("caption", props: {text: 'Another Column'}) %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <% end %> <%= pb_rails("layout/body") do %> <%= pb_rails("caption", props: {text: 'A Final Column'}) %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <%= pb_rails("card") do %> Kanban Item <% end %> <% end %> <% end %>
<%= pb_rails("layout", props: {layout: "content" }) do %> <%= pb_rails("layout/header") do %> <%= pb_rails("card") do %> Header <% end %> <% end %> <%= pb_rails("layout/sidebar") do %> <%= pb_rails("card") do %> Sidebar <br><br> Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec iaculis, risus a fringilla luctus, sapien eros sodales ex, quis molestie est nulla non turpis. Vestibulum aliquet at ipsum eget posuere. Morbi sed laoreet erat. Sed commodo posuere lectus, at porta nulla ornare a. Suspendisse quam est, sollicitudin ut enim sit amet, commodo placerat enim. Donec laoreet metus ac mauris pellentesque mattis. <% end %> <% end %> <%= pb_rails("layout/body") do %> <%= pb_rails("card") do %> Body <br><br> Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec iaculis, risus a fringilla luctus, sapien eros sodales ex, quis molestie est nulla non turpis. Vestibulum aliquet at ipsum eget posuere. Morbi sed laoreet erat. Sed commodo posuere lectus, at porta nulla ornare a. Suspendisse quam est, sollicitudin ut enim sit amet, commodo placerat enim. Donec laoreet metus ac mauris pellentesque mattis. Pellentesque luctus vel mauris non aliquam. Mauris hendrerit mattis porttitor. Curabitur vehicula justo non ex consectetur commodo. Quisque posuere aliquet quam. Maecenas malesuada magna mauris, ac tempor metus euismod at. <br><br> Cras ornare fermentum magna mollis efficitur. Sed vitae nulla vel purus ultrices mollis. Maecenas id nulla id libero faucibus feugiat quis sit amet turpis. In commodo pellentesque risus at fringilla. Integer non interdum leo, non commodo ante. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ut mi augue, dignissim at orci vel, egestas aliquam mi. Proin finibus aliquet tempor. Integer cursus, ex quis gravida rhoncus, nisi elit viverra ipsum, non efficitur est ex ac tortor. Praesent vitae odio massa. <% end %> <% end %> <%= pb_rails("layout/footer") do %> <%= pb_rails("card") do %> Footer <% end %> <% end %> <% end %>
<%= pb_rails("layout", props: {layout: "masonry"}) do %> <%= pb_rails("layout/body") do %> <%= pb_rails("layout/item") do %> <%= pb_rails("image", props: { url: "https://unsplash.it/500/400/?image=634" }) %> <% end %> <%= pb_rails("layout/item") do %> <%= pb_rails("image", props: { url: "https://images.unsplash.com/photo-1611932084285-4fc50bfb7102?ixid=MXwxMjA3fDB8MHxlZGl0b3JpYWwtZmVlZHwxMnx8fGVufDB8fHw%3D&ixlib=rb-1.2.1&auto=format&fit=crop&w=800&q=60" }) %> <% end %> <%= pb_rails("layout/item", props: { size: "md" }) do %> <%= pb_rails("image", props: { url: "https://images.unsplash.com/photo-1611934529218-748707e1d066?ixid=MXwxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHw%3D&ixlib=rb-1.2.1&auto=format&fit=crop&w=2307&q=80" }) %> <% end %> <%= pb_rails("layout/item", props: { size: "md" }) do %> <%= pb_rails("image", props: { url: "https://images.unsplash.com/photo-1611927263897-c2f1156bc760?ixid=MXwxMjA3fDB8MHxlZGl0b3JpYWwtZmVlZHwyMHx8fGVufDB8fHw%3D&ixlib=rb-1.2.1&auto=format&fit=crop&w=800&q=60" }) %> <% end %> <%= pb_rails("layout/item", props: { size: "lg"}) do %> <%= pb_rails("image", props: { url: "https://images.unsplash.com/photo-1606851685679-2a35cfdd62d6?ixid=MXwxMjA3fDF8MHxlZGl0b3JpYWwtZmVlZHwxMXx8fGVufDB8fHw%3D&ixlib=rb-1.2.1&auto=format&fit=crop&w=800&q=60" }) %> <% end %> <%= pb_rails("layout/item", props: { size: "md" }) do %> <%= pb_rails("image", props: { url: "https://images.unsplash.com/photo-1612144349227-1555ef8f2467?ixid=MXwxMjA3fDB8MHxlZGl0b3JpYWwtZmVlZHwzM3x8fGVufDB8fHw%3D&ixlib=rb-1.2.1&auto=format&fit=crop&w=800&q=60" }) %> <% end %> <%= pb_rails("layout/item") do %> <%= pb_rails("image", props: { url: "https://unsplash.it/500/400/?image=634" }) %> <% end %> <%= pb_rails("layout/item") do %> <%= pb_rails("image", props: { url: "https://images.unsplash.com/photo-1611932084285-4fc50bfb7102?ixid=MXwxMjA3fDB8MHxlZGl0b3JpYWwtZmVlZHwxMnx8fGVufDB8fHw%3D&ixlib=rb-1.2.1&auto=format&fit=crop&w=800&q=60" }) %> <% end %> <%= pb_rails("layout/item", props: { size: "md" }) do %> <%= pb_rails("image", props: { url: "https://images.unsplash.com/photo-1611934529218-748707e1d066?ixid=MXwxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHw%3D&ixlib=rb-1.2.1&auto=format&fit=crop&w=2307&q=80" }) %> <% end %> <%= pb_rails("layout/item") do %> <%= pb_rails("image", props: { url: "https://unsplash.it/500/400/?image=634" }) %> <% end %> <%= pb_rails("layout/item", props: { size: "md" }) do %> <%= pb_rails("image", props: { url: "https://images.unsplash.com/photo-1606851685679-2a35cfdd62d6?ixid=MXwxMjA3fDF8MHxlZGl0b3JpYWwtZmVlZHwxMXx8fGVufDB8fHw%3D&ixlib=rb-1.2.1&auto=format&fit=crop&w=800&q=60" }) %> <% end %> <%= pb_rails("layout/item") do %> <%= pb_rails("image", props: { url: "https://images.unsplash.com/photo-1612123912968-5f6e964e8ea5?ixid=MXwxMjA3fDB8MHxlZGl0b3JpYWwtZmVlZHw0N3x8fGVufDB8fHw%3D&ixlib=rb-1.2.1&auto=format&fit=crop&w=800&q=60" }) %> <% end %> <%= pb_rails("layout/item") do %> <%= pb_rails("image", props: { url: "https://images.unsplash.com/photo-1612092172331-d788286028d5?ixid=MXwxMjA3fDB8MHxlZGl0b3JpYWwtZmVlZHw3Mnx8fGVufDB8fHw%3D&ixlib=rb-1.2.1&auto=format&fit=crop&w=800&q=60" }) %> <% end %> <%= pb_rails("layout/item") do %> <%= pb_rails("image", props: { url: "https://unsplash.it/500/400/?image=634" }) %> <% end %> <% end %> <% end %>
| Props | Type | Values |
|---|---|---|
align_content |
enum | responsive
|
start
end
center
spaceBetween
spaceAround
spaceEvenly
|
align_items |
enum | responsive
|
start
end
center
|
border_radius |
enum
|
none
xs
sm
md
lg
xl
rounded
|
cursor |
enum
|
auto
default
none
contextMenu
help
pointer
progress
wait
cell
|
dark |
boolean
|
true
false
|
flex |
enum | responsive
|
auto
initial
0
1
2
3
4
5
6
7
8
9
10
11
12
none
|
flex_direction |
enum | responsive
|
row
column
rowReverse
columnReverse
|
flex_wrap |
enum | responsive
|
wrap
nowrap
wrapReverse
|
justify_content |
enum | responsive
|
start
end
center
spaceBetween
spaceAround
spaceEvenly
|
line_height |
enum
|
loosest
looser
loose
normal
tight
tighter
tightest
|
margin_right |
array
|
none
xxs
xs
sm
md
lg
xl
|
margin_left |
array
|
none
xxs
xs
sm
md
lg
xl
|
margin_top |
array
|
none
xxs
xs
sm
md
lg
xl
|
margin_bottom |
array
|
none
xxs
xs
sm
md
lg
xl
|
margin_x |
array
|
none
xxs
xs
sm
md
lg
xl
|
margin_y |
array
|
none
xxs
xs
sm
md
lg
xl
|
margin |
array
|
none
xxs
xs
sm
md
lg
xl
|
width |
string
|
|
min_width |
string
|
|
max_width |
string
|
|
gap |
string | responsive
|
|
column_gap |
string | responsive
|
|
row_gap |
string | responsive
|
|
number_spacing |
enum
|
tabular
|
order |
enum | responsive
|
none
first
1
2
3
4
5
6
7
8
9
10
11
12
|
overflow_x |
enum
|
scroll
visible
hidden
auto
|
overflow_y |
enum
|
scroll
visible
hidden
auto
|
overflow |
enum
|
scroll
visible
hidden
auto
|
padding_right |
array
|
none
xxs
xs
sm
md
lg
xl
|
padding_left |
array
|
none
xxs
xs
sm
md
lg
xl
|
padding_top |
array
|
none
xxs
xs
sm
md
lg
xl
|
padding_bottom |
array
|
none
xxs
xs
sm
md
lg
xl
|
padding_x |
array
|
none
xxs
xs
sm
md
lg
xl
|
padding_y |
array
|
none
xxs
xs
sm
md
lg
xl
|
padding |
array
|
none
xxs
xs
sm
md
lg
xl
|
position |
enum
|
relative
absolute
fixed
sticky
static
|
shadow |
enum
|
none
deep
deeper
deepest
|
text_align |
enum | responsive
|
start
end
left
right
center
justify
justifyAll
matchParent
|
truncate |
enum
|
none
1
2
3
4
5
|
vertical_align |
enum | responsive
|
baseline
super
top
middle
bottom
sub
text-top
text-bottom
|
z_index |
enum | responsive
|
1
2
3
4
5
6
7
8
9
10
max
|
top |
enum | object
|
xxs
xs
sm
md
lg
xl
xxl
|
inset |
boolean
|
true
false
|
right |
enum | object
|
xxs
xs
sm
md
lg
xl
xxl
|
bottom |
enum | object
|
xxs
xs
sm
md
lg
xl
xxl
|
left |
enum | object
|
xxs
xs
sm
md
lg
xl
xxl
|
height |
string
|
|
max_height |
string
|
|
min_height |
string
|
|
hover |
object
|
|
group_hover |
boolean
|
true
false
|
| Props | Type | Values | Default |
|---|---|---|---|
collapse |
enum
|
xs
sm
md
lg
xl
|
xs
|
full |
boolean
|
true
false
|
false
|
responsive |
boolean
|
true
false
|
false
|
size |
enum
|
sm
md
lg
|
{"react"=>"sm", "rails"=>"md"}
|
variant |
enum
|
light
dark
gradient
|
light
|
transparent |
boolean
|
true
false
|
false
|
layout |
enum
|
sidebar
collection
collection_detail
kanban
content
masonry
bracket
|
sidebar
|