What's New With 2.1

11/26/2022

New Features

Direct HTML Rendering

CBWIRE 2.1 introduces the ability to return HTML directly from the onRender() method, eliminating the need for separate template files for simple components.

// wires/SimpleAlert.cfc
component extends="cbwire.models.Component" {
    data = {
        "message" = "",
        "type" = "info",
        "visible" = true
    };
    
    function mount(params = {}) {
        data.message = params.message ?: "Default message";
        data.type = params.type ?: "info";
    }
    
    function onRender() {
        // Return HTML directly without needing a .cfm file
        if (!data.visible) {
            return "";
        }
        
        var alertClass = "alert alert-" & data.type;
        var html = '
        <div class="#alertClass#">
            <button wire:click="dismiss" class="close">&times;</button>
            #data.message#
        </div>';
        
        return html;
    }
    
    function dismiss() {
        data.visible = false;
    }
}

This feature is particularly useful for:

• Simple notification components

• Dynamic content that doesn't warrant a separate template file

• Components with conditional rendering logic

• Programmatically generated markup

// wires/DynamicCard.cfc
component extends="cbwire.models.Component" {
    data = {
        "items" = [],
        "cardType" = "default"
    };
    
    function onRender() {
        var html = '<div class="card card-#data.cardType#">';
        
        for (var item in data.items) {
            html &= '<div class="card-item">';
            html &= '<h4>#item.title#</h4>';
            html &= '<p>#item.description#</p>';
            html &= '</div>';
        }
        
        html &= '</div>';
        return html;
    }
    
    function addItem(title, description) {
        arrayAppend(data.items, {
            "title" = title,
            "description" = description
        });
    }
}

Bug Fixes

Computed Properties

• Fixed empty return values: Computed properties that return no value no longer cause errors

• Better error handling: Improved error messages when computed properties fail

// This now works correctly in 2.1
component extends="cbwire.models.Component" {
    function getDisplayName() {
        // This won't error if it returns nothing
        if (structKeyExists(data, "name")) {
            return data.name;
        }
        // Implicit return of empty value handled gracefully
    }
}

Nested Component Rendering

• Fixed template rendering: Nested components now properly render their individual templates instead of only the last one

• Fixed component isolation: Nested components no longer interfere with each other's rendering

• Improved nesting support: Components can now be deeply nested without rendering issues

<!-- This now works correctly -->
<cfoutput>
<div class="parent-component">
    #wire("ChildComponent1")#
    #wire("ChildComponent2")# 
    #wire("NestedContainer")#
</div>
</cfoutput>

Template Data Handling

• Fixed struct value preservation: Struct values in templates are no longer replaced with empty strings

• Better data type handling: Improved handling of complex data types in template rendering

• Preserved variable scope: Template variables maintain their proper types and values

ColdBox Integration

• Subdirectory support: CBWIRE now works correctly with ColdBox applications installed in subdirectories

• Version compatibility: Fixed rendering errors that occurred with the latest ColdBox versions

• Improved path resolution: Better handling of application paths and module locations

Component Lifecycle

• Rendering reliability: Fixed various scenarios where components would fail to render

• State management: Improved component state handling during complex rendering scenarios

• Error recovery: Better error handling and recovery during component initialization

Enhancements

Performance Improvements

• Faster rendering for components using onRender() method

• Reduced overhead for simple components that don't need template files

• Better memory management for nested component hierarchies

Developer Experience

• Clearer error messages for rendering issues

• Better debugging information for failed component initialization

• Improved development workflow for simple components

Template System

• More reliable template resolution

• Better handling of edge cases in component nesting

• Improved variable scope management

Breaking Changes

This release maintains full backward compatibility with existing CBWIRE 2.0 applications. No breaking changes were introduced in version 2.1.