Skip to main content

List

Introduction

The List module in Builderius is a fundamental element used to create unordered and ordered lists on your website or application. As a semantic container, the List module represents a group of related items presented in a sequence. With the List module, you can easily structure and display lists of items, such as bullet-point lists, or numbered lists to convey information in an organized and easy-to-read manner.

When you insert the List module into the canvas, it automatically generates a <ul> HTML tag, with several <li> items inside of it. This tag represents an unordered list, where the order of the items does not matter. You can change the HTML Tag of the module to <ol> to create an ordered list. The List module provides a semantic way to structure information into a list format. <ul> and <ol> have required <li> elements inside them, which in turn can have <ul> or <ol> children inside of them.

Standard Module Settings

The List module shares standard settings with other Builderius modules, making it easy to adapt and use across your designs. Once you learn how to use List you know how to use other modules as well. These settings are divided into two main sections: Data Settings and CSS Settings. Let's explore each in detail.

Data Settings

Module data settings

Content

The Content section allows you to define the textual content to be displayed inside the List module. You can enter simple static text, utilize HTML markup (with autocomplete), and use dynamic data template tags to display information from the WordPress database, JSON, or other data source. Remember, you can nest child modules within this module to create complex content structures.

HTML Tag

The HTML Tag setting empowers you to select an HTML tag from the provided drop-down list or create a custom HTML element by entering any string of letters (follow the syntax rules).

This toggle allows you to convert the module into a link element. When enabled, you can manually specify a URL or use dynamic data to generate the link. Please note that activating this option will replace the previously selected HTML tag with the appropriate anchor or link element.

HTML Attributes

In this section, you can add various attributes to the module's HTML code. These attributes enable you to label or modify the behavior of the module. There are three types of attributes you can work with:

Module html attributes

Classes

Add multiple classes to apply styles (e.g., color, size, spacing) to multiple modules simultaneously.

ID

Assign a unique ID name to identify this module distinctively. IDs are commonly used for in-page linking or establishing relationships between different modules on the page.

Custom Attributes

Create custom attributes, such as aria- type attributes for screen reader accessibility or data- type attributes to extend module functionality. You can define both the attribute name and its value.

Conditions

The Conditions section allows you to set server-side conditions for displaying the List module. These conditions are processed before the page is generated, meaning that if the conditions are not met, the module will not appear on the page. Conditions are a powerful way to customize what content appears based on various factors. For more information on conditions, refer to our documentation on conditions.

Module conditions

CSS Settings

Module CSS settings

Creating media queries

Module creating new media query

Creating pseudo CSS selectors

Module pseudo selectors

Creating custom CSS selectors

Module adding CSS selector

The CSS Settings area provides extensive control over the design and styling of the List module. You can craft the appearance of the module using various CSS methods. The CSS Settings are organized under several subsections:

CSS Variables

Create CSS variables to ensure consistent styles across the List module and its submodules. Various types of CSS variables are supported, including integer, number, color, image, percentage, length, angle, time, and any value.

Creating CSS Variables

Module CSS variables

Using CSS Variables

Module using CSS variables

Layout

Control the module's layout using CSS methods such as flexbox and grid, among others.

Positioning

Adjust the positioning of the module using position methods like fixed, absolute, relative, and more.

Size

Manage the size and spacing of the List module to achieve the desired visual effect.

Typography

Control the presentation of text within the module using typographic CSS properties like font-size, line-height, letter-spacing and more.

Border

Design borders and outlines to enhance the module's appearance.

Background

Apply color, gradients, or images to the module's background as per design needs.

Extra

Additional settings can be found here, offering more customization options.

Examples and Use Cases

To better understand the potential of the List module, let's explore some practical examples and use cases. These examples will showcase how you can utilize this module to create various elements for your website or application.

Video coming soon

Additional Resources

For more in-depth information the List module, refer to the following resources:

Conclusion

Congratulations! You've learned about the List module and its essential settings in Builderius. Armed with this knowledge, you can now create any kind of html element to enhance your website or application. Experiment, explore, and unleash your creativity with the List module!