README.md

Nova Html Card

A Laravel Nova card that displays any html content, e.g. lists, notifications, small custom reports.

Requirements

• PHP 7.4 - 8.3
• Laravel 8.x - 11.x
• Nova 4

Installation

You can install the package via composer:

composer require abordage/nova-html-card

Usage

To create a cards use the artisan command:

php artisan nova-html-card MyHtmlCard

By default, all new cards will be placed in the app/Nova/Cards directory. Once your html card class has been generated, you're ready to customize it:

<?php

namespace App\Nova\Cards;

use Abordage\HtmlCard\HtmlCard;

class MyHtmlCard extends HtmlCard
{
    /**
     * Name of the card (optional)
     */
    public string $title = '';

    /**
     * The width of the card (1/2, 1/3, 1/4 or full).
     */
    public $width = '1/3';

    /**
     * The height strategy of the card (fixed or dynamic).
     */
    public $height = 'fixed';

    /**
     * Align content to the center of the card.
     */
    public bool $center = true;

    /**
     * Html content
     */
    public function content(): string
     {
        return '<h1 class="text-4xl">Some content</h1>';
     }
}

If set $height = 'fixed' content will scroll:

If set $height = 'dynamic' content is shown in full:

Once you have defined a card, you are ready to attach it to a dashboard or resource. You should simply add it to the array of metrics / cards.

Feedback

If you have any feedback, comments or suggestions, please feel free to open an issue within this repository.

Credits

• Pavel Bychko
• All Contributors

License

The MIT License (MIT). Please see License File for more information.