gitpitch/docs/grid-layouts/flow.md
2020-10-20 09:37:12 +01:00

3.6 KiB

Grid Layouts Flow

Grid layouts drag-and-drop both sizes and positions content on your slides. This is achieved using a simple concept called a block. The grid flow property on a block is used to control the layout and spacing of content within the block.

?> When discussing grid layouts content-within-blocks are referred to as block items.

Basic Syntax

The following basic syntax is used to activate a custom flow for any block:

[drag=width height, drop=x y, flow=col | row | stack]

Using a value of col, row, or stack on the flow= property defines the layout behavior for the block. If the flow= property is not specified for a block then the block automatically inherits the default col flow behavior.

Column Flow

When flow=col is activated the following layout and spacing behaviors occur within the block:

  1. Block items are rendered vertically within the block.
  2. An equal amount of space is injected between each block item
  3. And an equal amount of space is injected at the start and end of the block.

The following sample slide screenshot helps to clarify this concept. Note, the sample block height here is 100% of the slide height:

Sample slide demonstrating grid layouts column flow

?> Flow is activated for a block with zero changes to the markdown of individual block items.

Column Flow with Push

When flow=col true is activated the following layout and spacing behaviors occur within the block:

  1. Block items are rendered vertically within the block.
  2. An equal amount of space is injected between each block item.
  3. However no space is injected at the start and end of the block.

This pushes your block items to the extreme ends of the block. The following sample slide screenshot helps to clarify this concept. Note, the sample block height here is 100% of the slide height:

Sample slide demonstrating grid layouts column flow with push

?> Flow is activated for a block with zero changes to the markdown of individual block items.

Row Flow

When flow=row is activated the following layout and spacing behaviors occur within the block:

  1. Block items are rendered horizontally within the block.
  2. An equal amount of space is injected between each block item
  3. And an equal amount of space is injected at the start and end of the block.

The following sample slide screenshot helps to clarify this concept. Note, the sample block width here is 100% of the slide width:

Sample slide demonstrating grid layouts row flow

?> Flow is activated for a block with zero changes to the markdown of individual block items.

Row Flow with Push

When flow=row true is activated the following layout and spacing behaviors occur within the block:

  1. Block items are rendered horizontally within the block.
  2. An equal amount of space is injected between each block item
  3. However no space is injected at the start or end of the block.

This pushes your block items to the extreme ends of the block. The following sample slide screenshot helps to clarify this concept. Note, the sample block width here is 100% of the slide width:

Sample slide demonstrating grid layouts row flow with push

?> Flow is activated for a block with zero changes to the markdown of individual block items.

Stack Flow

The use of flow=stack is a unique case and is covered in detail within the Grid Stacks Guide.