Spinner

An indicator that can be used to show a loading state.

<twig:Spinner class="size-10" />

Installation

bin/console ux:install spinner --kit flowbite-4

That's it!

Install the following Composer dependencies:

composer require tales-from-a-dev/twig-tailwind-extra:^1.0.0

Copy the following file(s) into your Symfony app:

templates/components/Spinner.html.twig

<svg role="status" aria-hidden="true" class="{{ ('animate-spin fill-neutral-tertiary size-4 ' ~ attributes.render('class'))|tailwind_merge }}" viewBox="0 0 100 101" fill="none" xmlns="http://www.w3.org/2000/svg"
{{ attributes }}>
    <path d="M100 50.5908C100 78.2051 77.6142 100.591 50 100.591C22.3858 100.591 0 78.2051 0 50.5908C0 22.9766 22.3858 0.59082 50 0.59082C77.6142 0.59082 100 22.9766 100 50.5908ZM9.08144 50.5908C9.08144 73.1895 27.4013 91.5094 50 91.5094C72.5987 91.5094 90.9186 73.1895 90.9186 50.5908C90.9186 27.9921 72.5987 9.67226 50 9.67226C27.4013 9.67226 9.08144 27.9921 9.08144 50.5908Z" fill="currentFill"/>
    <path d="M93.9676 39.0409C96.393 38.4038 97.8624 35.9116 97.0079 33.5539C95.2932 28.8227 92.871 24.3692 89.8167 20.348C85.8452 15.1192 80.8826 10.7238 75.2124 7.41289C69.5422 4.10194 63.2754 1.94025 56.7698 1.05124C51.7666 0.367541 46.6976 0.446843 41.7345 1.27873C39.2613 1.69328 37.813 4.19778 38.4501 6.62326C39.0873 9.04874 41.5694 10.4717 44.0505 10.1071C47.8511 9.54855 51.7191 9.52689 55.5402 10.0491C60.8642 10.7766 65.9928 12.5457 70.6331 15.2552C75.2735 17.9648 79.3347 21.5619 82.5849 25.841C84.9175 28.9121 86.7997 32.2913 88.1811 35.8758C89.083 38.2158 91.5421 39.6781 93.9676 39.0409Z" fill="currentColor"/>
</svg>

Happy coding!

Usage

<twig:Button disabled>
    <twig:Spinner /> Please wait
</twig:Button>

Examples

Size

Change the size of the spinner component using the h-{*} and w-{*} or size-{*} utility classes from Tailwind CSS:

<div class="flex items-center gap-6">
    <twig:Spinner />
    <twig:Spinner class="size-6" />
    <twig:Spinner class="size-8" />
</div>

Color

You can change the colors of the spinner element using the fill and color utility classes from Tailwind CSS:
use text-{*} to change the main colors

<div class="flex items-center gap-6">
    <twig:Spinner class="text-brand size-8" />
    <twig:Spinner class="text-danger size-8" />
    <twig:Spinner class="text-success size-8" />
    <twig:Spinner class="text-warning size-8" />
</div>

Alignment

Because the spinner component is an inline HTML element it can easily be aligned on the left, center, or right side using the text-{left|center|right} utility classes:

<div class="w-full">
    <div class="text-left rtl:text-right">
        <div role="status">
            <twig:Spinner class="size-8 inline" />
            <span class="sr-only">Loading...</span>
        </div>
    </div>

    <div class="text-center">
        <div role="status">
            <twig:Spinner class="size-8 inline" />
            <span class="sr-only">Loading...</span>
        </div>
    </div>

    <div class="text-right rtl:text-left">
        <div role="status">
            <twig:Spinner class="size-8 inline" />
            <span class="sr-only">Loading...</span>
        </div>
    </div>
</div>

Spinner with card

Use this animated loading indicator when content inside of a card is still loading.

<twig:Card class="max-w-sm relative">
    <twig:Card:Header class="opacity-20">
        <twig:Card:Title as="h5">Noteworthy technology acquisitions 2021</twig:Card:Title>
    </twig:Card:Header>

    <twig:Card:Content class="opacity-20">
        <p>Here are the biggest technology acquisitions of 2025 so far, in reverse chronological order.</p>
    </twig:Card:Content>

    <div role="status" class="absolute -translate-x-1/2 -translate-y-1/2 top-2/4 left-1/2">
        <twig:Spinner class="size-8 text-brand"/>
        <span class="sr-only">Loading...</span>
    </div>
</twig:Card>

Progress spinner

Use this animated spinner component inside a list of steppers elements.

<div>
    <h2 class="mb-4 text-lg font-medium text-heading">Converting your image:</h2>
    <ul class="max-w-md space-y-3 text-body list-inside">
        <li class="flex items-center">
            <twig:ux:icon name="flowbite:check-circle-outline" class="size-5 text-fg-success shrink-0 me-2" />
            Upload your file to our website
        </li>
        <li class="flex items-center">
            <twig:ux:icon name="flowbite:check-circle-outline" class="size-5 text-fg-success shrink-0 me-2" />
            Choose your file format
        </li>
        <li class="flex items-center">
            <div role="status">
                <twig:Spinner class="size-4 text-brand me-2"/>
                <span class="sr-only">Loading...</span>
            </div>
            Preparing your file
        </li>
    </ul>
</div>

Buttons

The spinner component can also be used inside elements such as buttons when submitting form data:

<div>
    <twig:Button variant="tertiary">
        <twig:Spinner class="me-2 text-brand" />
        Loading...
    </twig:Button>
</div>