Blade Components

Use and components to display formatted monetary values and currency information in your Blade templates

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

Basic Amount

<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

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

Show Cart Total

<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>

Database Minor Units

{{-- 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>

Multiple Currencies

<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

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

Currency Selection

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

Transaction Details

<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.

Related

• 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