adamthehutt/laravel-dismissible-tips

用户可关闭和永久忽略的上下文帮助框

v0.7.1 2024-08-06 23:07 UTC

This package is auto-updated.

Last update: 2024-09-06 23:17:13 UTC


README

此包允许您向用户提供可关闭或永久忽略的上下文帮助提示。

安装

使用composer安装

composer require adamthehutt/laravel-dismissible-tips

然后发布资源和配置

php artisan vendor:publish

运行迁移

php artisan migrate

请确保包括相关的css和js文件。您可以将它们整合到现有的资源管道中,或者直接引用

<link rel="stylesheet" href="/vendor/dismissible-tips/tips.css"/>
<script src="/vendor/dismissible-tips/tips.js"></script>

图标库

默认情况下,可关闭提示假定可以访问Font Awesome (版本 5.9) 用于图标。如果您已经在您的应用程序中使用Font Awesome,那么就没有其他需要做的了。如果没有,那么您有两个选择

  • 在布局中安装Font Awesome(免费且快捷)
  • 使用不同的图标库,在这种情况下,您需要相应地自定义blade模板

配置

提示在lang文件中定义,例如

/resources/lang/en/vendor/dismissible-tips/en/tips.php

要添加新提示,创建新的条目,嵌套得尽可能深

return [
    'zappa' => [
        'wisdom' => [
            'snow' => "Don't eat the yellow snow!"
        ]
    ]
];

上面的代码将创建一个标识为 zappa.wisdom.snow 的新提示。

使用

在blade模板中使用上面的提示

@tip(['tip' => 'zappa.wisdom.snow'])

在提示后添加可选链接

@tip(['tip' => 'zappa.wisdom.snow', 'link' => 'https://example.com/foo/bar'])

定制

此包将其视图、css和javascript发布在传统的vendor目录中。您可以安全地尽可能多地自定义提示的外观和感觉。