Conditional rendering

In this article, we will explain how to use the advanced Conditional Rendering setting available in the Settings tab of elements:

Conditional rendering setting

Difference with display:none

The Conditional Rendering setting can greatly improve the performances of your web app because, when you hide an element using this advanced setting, that element will not be built on page load by default. It will only be rendered in the DOM if / when the condition to display it is met. As a result, your pages will load faster.

By comparison, when you use the standard display CSS propertyopen in new window to hide an element on a page, the browser still needs to build that element on page load. If you have a lot of hidden elements on the page, it can significantly slow down your browser.

You may wonder why ever use the standard CSS display property anymore? Well, if you need to access input variables of an element that is hidden by the Conditional Rendering setting, you won't be able to because the element won't be in the DOM. In that use case, the standard display property will continue to be very useful.

Using Conditional Rendering

The Conditional Rendering setting needs you to define a condition. When that condition is met, the element will be made available in the DOM and displayed on the page (provided you haven't used the standard CSS display property to hide it!).

In the example below, we are saying that, if the user types in more than 225 characters (from index 0 to 224 in the string of characters that is user_description text), we will display a message warning them they are close to reaching the 280 character limit:

Conditional rendering example

Like the standard CSS display property, the element will not appear on the page when the condition is not met:

Conditional rendering in action

The crucial difference with the standard CSS display property is that the element will not appear in the DOM either, the browser will only build it when the condition is met. In the WeWeb Navigator, you will see the little crossed-out eye icon that warns you an element is not displayed.

In the example below, you can see that, when we remove some text and fall below the 225 characters limit, the warning text element disappears completely from the DOM in the browser:

Conditional rendering in the browser

If we were using the display CSS property, the element would still be visible in the DOM in the browser.

Responsive design

Conditional rendering can be an effective tool to optimize your web-app's speed and performance on different types of devices because it allows you to fine-tune which elements you want the browser to spend time and energy rendering or not.

This, as a result, can greatly improve your page speed scores.

Note, however, that if you define a conditional rendering value that is not the same on all you breakpoints, the section or the element associated:

  • will be published, but
  • will not be be pre-rendered (even if you've enabled pre-rendering when you published your project).

As a result, when search engine bots visit the page for the first time, they will not see it.

Impact on SEO

Historically, pre-rendered content was consistently ranked higher than pages without pre-rendering as search engines crawlers that were built to look at static content dismissed what appeared to be blank pages at first glance.

However, in the past few years, search engines have largely evolved to better handle JavaScript content as more and more websites are built with JS frameworks like React or Vue.

Pre-rendered content may still beat pages without pre-rendering in the sense that a page could rank faster (on first bot visit), but best-in-class search engine bots now know to come back quickly (in a matter of days) for a second visit to parse the JS content that was not rendered on the initial visit.

Here are Google’s thoughts on the topicopen in new window:

Google on dynamic content

Last Updated:
Contributors: Joyce Kettering