README

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

License

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

abordage / nova-html-card

Maintainers

Details