search
InstallSource CodeIssuesSupport

SPAs with Turbo

Create single-page-like applications (SPAs) with little-to-no JavaScript in record time.

CBWIRE has built-in support for Turboarrow-up-right. Turbo is an open-source library that accelerates links and form submissions by negating the need for full-page reloads. With Turbo, you get all the following included:

  • Links and form submissions are performed in the background using AJAX instead of performing full-page reloads

  • Browse history management, so clicking the back and forward buttons in the browser work as expected

  • Internal caching improves perceived performance by showing temporary previews during network requests and while the page is updated

  • Built-in progress bar

  • Pre-load Links

  • And much more!

CBWIRE and Turbo allow you to build single-page applications in record time quickly.

hashtag
Enabling Turbo

You can enable Turbo with the enableTurbo configuration setting, which automatically wires up everything needed to start using Turbo. Once enabled, links and form submissions will automatically be performed in the background via AJAX instead of performing full-page reloads.

You can alternatively perform a manual installation of Turbo instead.

// File: ./config/ColdBox.cfc
component{
    function configure() {
        moduleSettings = {
            "cbwire" = {
                "enableTurbo": true
            }
        };
     }
}

hashtag
Manual Installation

circle-info

Use the manual installation when you want more control over where Turbo is included within your HTML.

hashtag
npm

You can install Turbo by running the following npm command in the root of your project.

Then you can require or import Turbo.

hashtag
Skypack

To avoid manual installation, there is also a Skypackarrow-up-right available which you can add to the <head></head> of your layout.

hashtag
Turbo Plugin

To work correctly, include the Turbo plugin below your wireScripts() call in your layout.

circle-info

Note: You MUST have either the data-turbolinks-eval="false" or data-turbo-eval="false" attributes added to the script tag (having both won't hurt).

hashtag
Progress Bar

During Turbo navigation, the browser will not display its native progress indicator. Turbo installs a CSS-based progress bar to provide feedback while issuing a request.

The progress bar is enabled by default. It appears automatically for any page that takes longer than 500ms to load.

The progress bar is a <div> element with the class name turbo-progress-bar. Its default styles appear first in the document and can be overridden by rules that come later.

For example, the following CSS will result in a thick green progress bar:

In your layout file, you can include the progress bar like so:

hashtag
Preload Links

Preload links into Turbo Drive’s cache using data-turbo-preload.

This will make page transitions feel lightning fast by providing a preview of a page even before the first visit. Use it to preload the most important pages in your application.

circle-exclamation

Avoid over usage, as it will lead to loading content that is not needed.

PreviousContentBox CMSNextAlpineJS

Last updated