Actions

Overview

Actions are methods on your component that either change the component's data properties or perform some routine, such as updating your database or anything you can dream up in CFML.

Here is a basic example of how to use it:

// wires/Time.cfc
component extends="cbwire.models.Component" {
    data = {
        "currentTime" : now()
    };
    function updateTime() {
        data.currentTime = now();
    }
}
<!--- wires/time.cfm --->
<cfoutput>
    <div>
        <p>Current time: #currentTime#</p>
        <button wire:click="updateTime">Update</button>
    </div>
</cfoutput>

Actions do not need to return any value. Return values are ignored.

Executing Actions

Livewire listens for browser events and invokes actions on your component using directives. These directives are used in your HTML templates and follow the format: wire:[browser event]=[action].

Some examples of events you can listen for include:

<button wire:click="doSomething">Do Something</button>

<input wire:keydown.enter="doSomething">

<form wire:submit="save">
    <button type="submit">Save</button>
</form>

You can listen for any browser events on elements using the wire:[event] directive, where [event] is the event's name. For example, to listen for a "foo" event on a button element, you would use the following code:

<button wire:foo="someAction">

On some elements, such as forms or links, you need to add a .prevent modifier to prevent the browser's default behavior. Otherwise, the browser will cause the page to reload and you will get unintended results.

<a href="##" wire:click.prevent="doSomething">Do Something</a>

Passing Parameters

You can pass parameters to actions such as actionName( arg1, arg2, arg3 ).

<cfoutput>
    <div>
        <button wire:click="addTask('Some Task')">Add Task</button>
    </div>
</cfoutput>

The parameter is then passed through to your actions via function arguments.

component extends="cbwire.models.Component" {
    function addTask( taskName ){
        queryExecute( "
            insert into tasks (
                name
            ) values (
                :name
            )
        ", { name = arguments.taskName } ); // Adds 'Some Task'
    }
}

Magic Actions

There are a few magic actions already created on your components.

Consider the example below.

// wires/SayHello.cfc
component extends="cbwire.models.Component" {
    data = {
        "message": ""
    };
    function setMessageToHello() {
        data.message = "Hello";
    }
}
<!--- wires/sayhello.cfm --->
<div>
    #message#
    <button wire:click="$set( 'message', 'Hello' )">Say Hi</button>
</div>

Last updated