Skip to content

Laravel IBAN Field Component

Free · MIT

A bank account number, grouped as a bank prints it and checked before it can leave.

A IBAN Field built for the TALL stack — Blade, Livewire 3 & 4, Alpine.js and Tailwind CSS 4. Server-rendered by default and dark-mode ready. Aura's solid-background and border colours are contrast-tested against WCAG 2.1 AA/UI in CI, in both themes — see what's covered. Drop it in with a single Blade tag: <x-aura::iban-field>

Installation

composer require bluestarsystem/aura-ui

Usage

<x-aura::iban-field label="IBAN" />

See the full API, props and live examples in the IBAN Field documentation.

Overview

<x-aura::iban-field> groups the number in fours as you type, checks it with the ISO 13616 checksum, and posts the plain number without the spaces.

The grouping is not decoration. It is how the number appears on a statement, and reading a 27-character string back without it is exactly where the typos come from. The checksum catches every single-character mistake and almost every transposition — which matters here more than anywhere, because a wrong IBAN is a payment that leaves and does not arrive.

Props

Prop Type Default Description
label string|null null Tied to the field with for.
name string 'iban' The hidden field's name — what posts is the number without spaces.
value string|null null Formatted for display on first render.
hint string|null null Replaced by the error text when the checksum fails.
error string|null null A server-side error, announced with role="alert".
size string 'md' sm, md, lg.

See more examples and every variant in the IBAN Field documentation.

Laravel-native
No JavaScript framework. Pure Blade, Livewire & Alpine.
Dark mode & themeable
Tailwind 4 CSS variables and a visual Theme Studio.
Accessible
Colour contrast tested against WCAG 2.1 AA/UI in CI; ARIA attributes on select components.