Working with pre-built components in the Design Section

Blocks in the Budibase are pre-built components comprised of multiple Components themselves. They perform a common functionality and take away the complexity of having to repeat yourself.

Blocks especially shine if, on a single page, you only add one way of displaying data from a Data Provider.

As of this moment, there are 3 types of blocks available to be used immediately.

Adding a Block

To add a block to your application, head over to the design section, then press the Blocks tab to pick a block of choice.

Once you choose one of the blocks you want to have, it will appear in the design straight away. The only thing you have to do now is position the block in the place on your page where you want it to be.

Configuring Blocks

Configuration of blocks is done by clicking the block you just added. Immediately a settings panel will appear on the right.

In this panel, all configuration options are displayed in a structured manner. The most important selection you will have to make first is picking which data table you want to be displayed. This will automatically give you all options of all the available Data Sources.

All other options available to you in the settings panel are comprised of the different Components that were merged within the block you just selected. To learn about which components are used for each block, look at the respective section below.

Types of blocks

Table block

The Table block is the easiest way to quickly display and action table data.

Cards block

The Cards Block is a useful block that merges three different components into one. In order, it uses Data Provider, Repeater and Card components.

All the configuration options relevant to all three components are available in the sidebar.

Repeater block

The Repeater Block is a quick way to have both the Data Provider and the Repeater component into one. This way you can still configure what exactly is repeated within the repeater, but don't have to worry about having both the repeater component and the datasource component.

Form block

The Form Block is a comprehensive component that makes building different types of forms much more convenient.

Chart block

The Chart Block combines a Data Provider with a nested Chart that matches the type chosen from the Chart Type dropdown menu.

Row explorer block

Allows you to view data in an alternative way. It combines a searchable and scrollable list of cards on the left hand side, whilst displaying a detail form on the right for the selected card.

Ejecting blocks

As mentioned, blocks combine various components for convenience. Whilst there are many settings, sometimes blocks wont provide the full flexibility you are after. In this case, you can eject the block.

An ejected block will split a single block component into its constituent components. To eject a block, you can press the Eject block button in the settings panel, or select the option from the component tree.

Eject block button in the settings panel

Eject block button in the settings panel

Eject block from component tree

Eject block from component tree

Ejected content

Ejected content

What’s Next

Learn more about the individual components mentioned in this guide