digitlimit/alert

在Laravel应用程序中显示消息的简单方法

v2.2.0 2024-09-30 22:44 UTC

README

版本 2.0

Alert是一个用于在Laravel应用程序视图中显示不同类型消息的Laravel包。它旨在使Laravel应用程序中的消息提示变得简单易行,提供许多易于使用且流畅的方法。

Alert的使用非常简单、可定制和可扩展。它提供了6种内置的提示类型,包括

消息提示
粘性提示
字段提示
字段包提示
模态提示
通知提示

幸运的是,您可以轻松创建自定义类型。该包可以通过宏轻松扩展。

快速开始

1. 使用composer安装Alert

composer require digitlimit/alert

2. 在blade模板的某个位置

<x-alert-message />

示例

@extends('layouts.default')

@section('content')
  <div class="container-xxl flex-grow-1 container-p-y">
    <div class="row">
      <div class="col-md-12">
        <x-alert-message />
      </div>
    </div>

    <div class="row">
      @include('form.profile')
    </div>        
  </div>

  @include('partials.footer')
@endsection

注意:目前alert组件使用Twitter Bootstrap 5构建,并可以自定义使用其他CSS类。需要确保页面上包含了bootstrap。

3. 在应用的某个位置

<?php

namespace App\Http\Controllers;

use Alert;

class DashboardController extends Controller
{
    public function index()
    {
        Alert::message('Welcome! Please complete your profile')
            ->info()
            ->flash();

        return view('home');
    }
}

4. 结果

image

文档

学习如何开始使用Alert,然后深入了解其他高级主题

完整文档

变更日志

即将推出

行为准则

如果你表现得很好,我们也会表现得很好。有关详细信息,请参阅我们的CODE_OF_CONDUCT.md

贡献

请阅读我们的贡献指南。其中包括如何提交问题的说明。

维护者

Alert包目前由Emeka Mbah维护。如果您有任何问题,请毫不犹豫地在此存储库中创建一个问题。

版本控制

尽可能在语义版本控制指南下维护Alert。发布将按照以下格式编号

<主版本>.<次版本>.<修订版本>

有关SemVer的更多信息,请访问https://semver.org

  • 任何发布都可能更新现有图标的样式、外观或品牌
  • 我们永远不会有意发布破坏向后兼容性的修订版更新
  • 次要版本发布可能包括向后不兼容的更改,但我们将会在UPGRADING.md中编写清晰的升级说明
  • 次要版本修订版本发布永远不会删除图标
  • 错误修复将通过修订版本发布解决,除非它们包括向后不兼容性,那么它们将是次要版本发布

许可证

Alert Free是免费的、开源的,并且与GPL兼容。您可以将其用于商业项目、开源项目或几乎任何您想要的项目。

  • 代码 — MIT许可证
    • 在Alert Free下载中,MIT许可证适用于所有PHP文件。

我们已经使归属注释简短,所以我们要求您不要积极工作以从文件中删除它们,特别是代码。这是人们了解Alert的绝佳方式。