Components
Sections or areas of your app that are reactive to user input.
Components are sections or areas of your site that you want to be reactive to user input. They can be as big or small as you like. For example, you may have a Signup form component that covers multiple steps or a button component that you reuse throughout your app.
Components are generally made up of Data Properties, Computed Properties, Actions, and an HTML template.
<cfscript>
// Data properties
data = {
"property1": "defaultValue",
"property2": "defaultValue"
};
// Computed properties
computed = {
"computedProperty" : function() {
// return something
}
};
// Actions
function action1() {
data.property1 = "another value";
}
</cfscript>
<!-- HTML Template -->
<cfoutput>
<div>
<h1>My Component</h1>
</div>
</cfoutput>Separating Component Definition and Template
You can place the above code in separate files to separate your component and template definitions. CFC components must extend 'cbwire.models.Component'.
./wires/MyComponent.cfc
./wires/MyComponent.cfm
Rendering Components
You can render a CBWIRE component using the wire() method.
External Components
You can render wires from folders and subfolders outside of the default ./wires folder.
You can also reference components within another ColdBox module by using the @module syntax.
Passing Parameters
You can pass data into a component as an additional argument using wire().
Using Parameters
Parameters are passed into your component's onMount() method. This is an optional method you can add.
Auto Population of Data Properties
As of CBWIRE 3.2, properties that you pass into your component will be automatically populated if onMount() IS NOT defined and a matching data property is found.
Last updated