Query String

Set your data properties with incoming query string values.

It can sometimes be helpful to update the browser's query string when your component's state changes.

Let's say we are building a component to search articles.

<!--- ./wires/SearchArticles.cfm --->
<cfscript>
    data = {
        "search": ""
    };
</cfscript>

<cfoutput>
    <div>
        <input wire:model="search" type="search" placeholder="Search articles...">
    </div>
</cfoutput>

We can automatically populate the search property above from the URL query string by adding a queryString array to our component.

queryString = [ "search" ];
<!-- ./wires/SearchArticles.cfm -->
<cfscript>
    queryString = [ "search" ];

    data = {
        "search": ""
    };
</cfscript>

<cfoutput>
    <div>
        <input wire:model="search" type="search" placeholder="Search articles...">
    </div>
</cfoutput>

Now when we access the page with 'search' included in the query string (/search-articles?search=some+string), the search property will have a default value of "some string".

In addition to this, when the user starts typing into our search field, the URL displayed in the browser will be instantly updated.

Last updated