Data-binding Form INPUTs & SELECTs ❺

Data-binding is the original feature that SA was built around. It developed out of a need to populate Form SELECTs with dynamic data from Webflow Collection Lists.

In this latest version, support for form INPUTs ( textboxes ) has been added, using HTML5’s autocomplete features.

View Demonstration in Webflow

How it Works

In SA, data-binding involves two steps;

1. Creating a JSON datasource using a Webflow Collection List.

2. Processing that JSON into HTML and linking it to the INPUTs and SELECTs you designate.

Setup is relatively simple, and you can use the Collection List’s built-in sorting and filtering options to precisely control the data you want in your Form controls.

Getting Started

Use the demo examples as a current reference for using each feature.

NOTE: Here is a outdated video overview of setting up databinding in WFU v2.0. I’ll re-record soon. For now I’m leaving it as it will show you some of the internals on how the setup works.

STEP 1 - Add the Library

Paste this code, exactly, into the Before </body> tag script area of your Page settings. If you are using data-binding on multiple pages, you might choose to do this in your site-wide settings.

<script type="module">
    import { dataBindAll } from 'https://cdn.jsdelivr.net/gh/sygnaltech/[email protected]/src/locode/webflow-forms-helper.min.js';
    $(function () {
        dataBindAll();
    });
</script>

STEP 2 - Create a Collection List Data Source

First you need to setup your Collection List Data Source.

Follow the instructions here, and return to this document when you’ve completed.

This needs to be accessible on any page(s) that you’ll be doing data-binding, so if you’re

STEP 3 - Setup your Form

1. Now scroll to your form, and select the INPUT Textbox or SELECT List that you’re wanting to data-bind.

2. Add a custom attribute directly to that form control, with the name wfu-bind. This tells WFU that you want to bind this control to a datasource.

3. For the value, enter the data source name that you chose above.

NOTE: If you are binding a SELECT you may wish to remove the default values that Webflow has created. WFU will not delete them.

You’re done.

To see data-binding in action, you’ll need to publish your site, and view the published results. Scripts won’t run in the Webflow designer.

Troubleshooting

It’s not binding at all

If you’re not seeing anything in your dropdown when you open your SELECT, or when you click on your INPUT field, here are some things you can check;

• Double-check that you have the custom attribute wfu-data = (your data source name) on the outermost part of the Collection List.

• Double-check that you have the custom attribute wfu-bind = (your data source name) on the INPUT or SELECT that you’re wanting to data-bind.

• Double-check that your datasource name is exactly the same on both.

• Double-check that you have the script inserted in the right place in your page or site configuration.

• Make sure that your filter, sort, and item limit settings on your Collection List actually retrieve the data you want. If you need you can put a temporary text field and bind to that to double-check what items you’re pulling from your Collection. I recommend removing that test data before you publish to production.

• Run through the instructions above again and re-verify everything.

Something’s weird in the data on Form Posts

For INPUT elements, the value posted is whatever the user types in that textbox. Pretty simple.

For SELECTS, the value posted is the id you specified in your script block. Make sure you chose the right field for that, and that you have no extraneous spaces.

Getting Started ( NOCODE )

STEP 1 - Add the Library

First, add the library as detailed in Quick Start.

STEP 2 - Setup your attributes

See above for details.