Laravel Nova 的一个卡片,用于显示任意 HTML 内容

3.3.0 2024-03-12 13:56 UTC

README

Nova HTML Card

Latest Stable Version Total Downloads Type coverage

向 Laravel Nova 控制台添加任意 HTML 内容的卡片。

image

安装

您可以通过 composer 在使用 Nova 的 Laravel 应用中安装此包

composer require interaction-design-foundation/nova-html-card

使用方法

注册您的卡片.

use InteractionDesignFoundation\HtmlCard\HtmlCard;

public function cards()
{
    return [
        (new HtmlCard())->width('1/3')->html('<h1>Hello World!</h1>'),
        (new HtmlCard())->width('1/3')->markdown('# Hello World!'),
        (new HtmlCard())->width('1/3')->view('cards.hello', ['name' => 'World']),
     ];
}

选项

  • 设置内容
    • ->html('<h1>Hello!</h1>'): 设置 HTML 或纯文本内容。
    • ->markdown('# Hello!'): 设置 Markdown 内容,它将被转换为 HTML。
    • ->view('path.to.view', []): 指定 blade 视图文件,并可选地传递一个数组作为视图数据。
  • 样式
    • ->center(false): 使卡片内容居中。默认为 false
    • ->withoutCardStyles(true): 是否使用标准的 Nova 卡片样式(背景、填充等)。默认为 false
    • ->withBasicStyles(): 向卡片中的 HTML 元素添加一些基本样式。当渲染 Markdown 时很有用。

为什么选择这个包?

有几个包具有类似的功能。我们的包提供了一个 API,涵盖了这些包的所有用例,并额外提供了一些独特功能,如

  • Markdown 支持
  • 轻松在 Nova-card 样式和原始 HTML 样式之间切换
  • 简单、类似 Laravel 的 API

变更日志

请参阅 Releases 以了解最近更改的详细信息。

贡献

请参阅 CONTRIBUTING 以获取详细信息。

许可证

MIT 许可证(MIT)。请参阅 许可证文件 以获取更多信息。