Blade Components

Overview

Laravel Brick Money provides two Blade components for rendering monetary values and currency information in your templates. These components offer a clean, declarative syntax for displaying formatted money and currency data.

Money Component

The <x-money /> component renders formatted monetary values with automatic currency formatting.

Basic Usage

<x-money amount="100"/>
<!-- Output: $100.00 -->

Component Attributes

amount

BigNumber|float|int|string

required

The monetary amount to display. Can be a number, string, or BigNumber instance.

currency

string

default:"config('brick-money.currency')"

The currency code (e.g., “USD”, “EUR”, “GBP”). Defaults to the configured currency in your brick-money.php config file.

minor

bool

default:"config('brick-money.minor')"

Whether the amount is in minor units (e.g., cents). When true, an amount of 100 represents

1.00 instead of

100.00. Defaults to the configured value in your brick-money.php config file.

context

Context

default:"null"

A Brick\Money\Context instance for custom precision handling. Advanced use cases only.

roundingMode

RoundingMode

default:"RoundingMode::UNNECESSARY"

The rounding mode to use from Brick\Math\RoundingMode. Options include UP, DOWN, CEILING, FLOOR, HALF_UP, HALF_DOWN, HALF_CEILING, HALF_FLOOR, HALF_EVEN, and UNNECESSARY.

Examples

Display Product Price
Show Cart Total
Database Minor Units
Multiple Currencies

<div class="product-card">
    <h3>{{ $product->name }}</h3>
    <p class="price">
        <x-money 
            :amount="$product->price" 
            :currency="$product->currency"
        />
    </p>
</div>

<div class="cart-summary">
    <span>Subtotal:</span>
    <span><x-money :amount="$cart->subtotal" currency="USD"/></span>
    
    <span>Tax:</span>
    <span><x-money :amount="$cart->tax" currency="USD"/></span>
    
    <strong>Total:</strong>
    <strong><x-money :amount="$cart->total" currency="USD"/></strong>
</div>

{{-- Amount stored as 1099 in database (minor units) --}}
<div class="transaction">
    <span>Amount:</span>
    <x-money 
        :amount="$transaction->amount_cents" 
        currency="USD"
        :minor="true"
    />
    {{-- Output: $10.99 --}}
</div>

<table class="pricing-table">
    @foreach($prices as $price)
    <tr>
        <td>{{ $price->region }}</td>
        <td>
            <x-money 
                :amount="$price->amount" 
                :currency="$price->currency_code"
            />
        </td>
    </tr>
    @endforeach
</table>

Implementation Details

The <x-money /> component is implemented in Devhammed\LaravelBrickMoney\View\Components\Money and renders using the money() helper function internally.

// Component class: src/View/Components/Money.php
public function __construct(
    public BigNumber|float|int|string $amount,
    public ?string $currency = null,
    public ?bool $minor = null,
    public ?Context $context = null,
    public RoundingMode $roundingMode = RoundingMode::UNNECESSARY
) {
    //
}

The component template simply calls the money() helper:

{{-- resources/views/components/money.blade.php --}}
{{ money($amount, $currency, $minor, $context, $roundingMode) }}

Currency Component

The <x-currency /> component renders formatted currency information.

Basic Usage

<x-currency currency="USD"/>
<!-- Output: USD -->

Component Attributes

currency

string

required

The currency code to display (e.g., “USD”, “EUR”, “GBP”).

Examples

Display Currency Code
Currency Selection
Transaction Details

<div class="account-info">
    <span>Account Currency:</span>
    <span><x-currency :currency="$account->currency_code"/></span>
</div>

<select name="currency">
    @foreach($currencies as $code)
    <option value="{{ $code }}">
        <x-currency :currency="$code"/> - {{ currency($code)->getName() }}
    </option>
    @endforeach
</select>

<div class="transaction-details">
    <dl>
        <dt>Amount:</dt>
        <dd><x-money :amount="$transaction->amount" :currency="$transaction->currency"/></dd>
        
        <dt>Currency:</dt>
        <dd><x-currency :currency="$transaction->currency"/></dd>
        
        <dt>Currency Name:</dt>
        <dd>{{ currency($transaction->currency)->getName() }}</dd>
    </dl>
</div>

Implementation Details

The <x-currency /> component is implemented in Devhammed\LaravelBrickMoney\View\Components\Currency and renders using the currency() helper function internally.

// Component class: src/View/Components/Currency.php
public function __construct(public string $currency)
{
    //
}

The component template simply calls the currency() helper:

{{-- resources/views/components/currency.blade.php --}}
{{ currency($currency) }}

Component Registration

Both components are automatically registered in the package service provider:

// src/Provider.php
Blade::component('money', View\Components\Money::class);
Blade::component('currency', View\Components\Currency::class);

The components are available as soon as you install the package. No additional configuration is required.

Blade Directives - Alternative syntax using @money and @currency directives
Helper Functions - Use money() and currency() helpers directly in PHP code
Configuration - Set default currency and minor unit behavior

Getting Started

Core Concepts

Eloquent Integration

HTTP Integration

Views

Advanced

API Reference

Overview

Money Component

Basic Usage

Component Attributes

Examples

Implementation Details

Currency Component

Basic Usage

Component Attributes

Examples

Implementation Details

Component Registration

Build docs developers (and LLMs) love

Getting Started

Core Concepts

Eloquent Integration

HTTP Integration

Views

Advanced

API Reference

​Overview

​Money Component

​Basic Usage

​Component Attributes

​Examples

​Implementation Details

​Currency Component

​Basic Usage

​Component Attributes

​Examples

​Implementation Details

​Component Registration

​Related

Build docs developers (and LLMs) love

Overview

Money Component

Basic Usage

Component Attributes

Examples

Implementation Details

Currency Component

Basic Usage

Component Attributes

Examples

Implementation Details

Component Registration

Related