formfeed-uk/nova-theming-classes

一个用于为组件添加主题类的 Laravel Nova 包。

1.1.0 2022-11-09 20:07 UTC

This package is auto-updated.

Last update: 2024-09-14 01:44:52 UTC


README

Laravel Nova 包将主题类功能重新添加回 Nova 4,这在 Nova 3 中之前是由 Nova::enableThemingClasses() 提供的。

要求

  • php: >=8.0
  • laravel/nova: ^4.0

特性

此包恢复了 Nova 3 中缺失的主题类,并将其添加回 Nova 4。

它应该适用于所有 Nova 组件以及任何第三方包的组件。

通过全局混合器在组件挂载和组件更新(对于 dependsOn 兼容性)时应用类。

添加了组件名称、字段名称、资源名称、面板名称和 Nova 可变内容布局组名称,以短横线命名,并可选添加前缀。

如果您有其他带有自定义属性且在默认配置下无法正常工作的包(如 Nova 可变内容布局组名称),请提交拉取请求或问题。 (拉取请求将被更快处理)

安装

使用 composer 在使用 Nova 的 Laravel 应用中安装此包

composer require formfeed-uk/nova-theming-classes

用法

通用

不需要额外的配置,包安装后默认启动,所有选项默认启用。

主题类默认以下列前缀为前缀

  • 组件:component-
  • 字段:field-
  • 资源:resource-
  • Nova 可变内容布局组:flex-group-
  • 面板:panel-

这可以在配置选项中更改(见下文)

配置选项

默认情况下,所有主题选项都启用,并使用上述默认前缀。

要配置显示哪些主题类及其前缀,请将以下内容添加到您的 config/nova.php

注意,如果需要,前缀中的最后一个分隔符必须手动应用(以允许空字符串前缀或替代前缀分隔符)

// config/nova.php

return [

...

    'theming' => [
         'component' => true|false, // Enable/Disable the component classes
         'field' => true|false, // Enable/Disable the field name classes
         'resource' => true|false, // Enable/Disable the resource name classes
         'flex_group' => true|false, // Enable/Disable the Nova Flexible Content Layout Groups classes
         'panel' => true|false, // Enable/Disable the panel name classes
         'prefix'=> [
            'component' => 'alternative-component-', // Component prefix
            'field' => 'alternative-field-', // Field prefix
            'resource' => 'alternative-resource-', // Resource prefix
            'flex_group' => 'alternative-flex-group-', // Nova Flexible Content Layout Group prefix
            'panel' => 'alternative-panel-', // Component prefix
         ]
    ]

...

]

许可证

Nova Theming Classes 是开源软件,根据 MIT 许可证 许可。