adamthehutt / laravel-dismissible-tips
用户可关闭和永久忽略的上下文帮助框
v0.7.1
2024-08-06 23:07 UTC
Requires
- php: >=7.0
- illuminate/support: ^5.8 | ^6.0 | ^7.0 | ^8.0 | ^9 | ^10 | ^11
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目录中。您可以安全地尽可能多地自定义提示的外观和感觉。