README

基于 encima-io/novachecklists

此包旨在让您轻松在 Laravel Nova 中创建检查清单。您只需要在模型中有一个文本/json列来存储项目。

安装

您可以通过 composer 安装此包

composer require ahmedkandel/nova-checklist

使用方法

use Ahmedkandel\NovaChecklist\Checklist;

Checklist::make('Tasks')
    ->placeholder('Add another task')   // Defaults to "Add item"
    ->placeholderCounter()              // Not active by default
    ->storeUserName()                   // Not active by default, accepts user-model column. Uses "name" when column isn't provided.
    ->showDetails()                     // Not active by default
    ->showItemStatusOnIndex()           // Not active by default
    ->showCompletionOnIndex(),          // Not active by default

要使用此包，您需要在模型中有一个文本或 JSON 列来保存项目，因为它们作为 JSON 保存在您的模型中。

表单页面

->placeholder() 方法允许您指定“添加新项目字段”的占位符文本。

->placeholderCounter() 方法允许您在添加新项目时显示项目编号。如果有 5 个项目，则它将说“添加项目 6”。

->storeUserName() 方法允许您保存创建或完成项目的用户。您指定要保存到项目中的用户模型的哪个列，默认使用“名称”列。

->canEdit() 方法可用于允许/禁止添加/编辑/删除项目。通过将布尔值或闭包传递给此方法，如果为 true，则用户可以添加/编辑/删除项目，如果为 false，则用户只能检查/取消选中项目。

->canEdit(function ($request) {
    return $request->isCreateOrAttachRequest() || $request->user()->isAdmin();
})

除非通过 ->canEdit() 方法禁止，否则您可以点击现有项目来编辑它。

详情页面

->showDetails() 方法允许您显示谁完成了项目以及完成项目的时间。

索引页面

默认情况下，此包将在索引页面上只显示项目数量。

->showItemStatusOnIndex() 将将索引更改以显示完成的项目数量与项目总数。

->showCompletionOnIndex() 方法将允许您显示完成的项目百分比。

当您点击标签时，将显示包含所有详细信息的工具提示。

许可证

MIT 许可证 (MIT)。