Skip to main content

Main

Introduction​

The Main module in Builderius is a crucial element designed to represent the main content of your web page. As a semantic container, the Main module should contain the primary content that is unique to each page. With the Main module, you can structure and organize the main content of your website or application, ensuring accessibility and search engine visibility. Main is not a sectioning element and should not have header, aside or footer elements as direct children.

When you insert the Main module into the canvas, it automatically generates a <main> HTML tag. Main module can only be used once per page and it should contain the content that is unique for that page, repeating elements such as sidebars with content that is the same across various pages, should not be inside the main element. This element represents a main landmark role, helping assistive technologies easily find the central portion of the page. You might also want to provide a skip link navigation to allow users of such technologies to quickly jump to the main content by skipping the repeating elements and jump straight to main content.

Standard Module Settings​

The Main module shares standard settings with other Builderius modules, making it easy to adapt and use across your designs. Once you learn how to use Main 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 Main 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 Main 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 Main 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 Main 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 Main 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 Main 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 Main module, refer to the following resources:

Conclusion

Congratulations! You've learned about the Main 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 Main module!