rapidez/blade-components

Rapidez使用的优秀Blade组件集合

dev-master 2024-09-25 10:57 UTC

This package is auto-updated.

Last update: 2024-09-25 10:57:27 UTC


README

此包包含一些Tailwind CSS样式的Blade组件,这些组件不需要Rapidez。默认情况下,此包仅用于Rapidez,但也可以在任何Laravel项目中使用

这些组件的想法是提供一个好的起点和集中化的样式。大多数组件使用匿名索引,这样你就有了一个默认值,旁边可以添加变体。

我们不提供输入 + 标签的组合组件,因为这会导致属性合并问题。我们无法猜测属性应该放在哪里;输入或标签。我们可以提供一个99%的使用案例,但最终你会在组件中遇到例外和复杂性。但是;我们为复选框和单选按钮提供了它,如你在那些组件中看到的那样。如果你不需要标签,你可以使用如示例中找到的base组件。

安装

composer require rapidez/blade-components

并确保这些颜色出现在你的Tailwind配置中

colors: {
    neutral: '#334155',
    inactive: '#64748b',
    border: '#e7ebef',
    disabled: '#ebe8de',
}

视图

如果你想更改组件,可以使用以下方式发布视图

php artisan vendor:publish --tag=rapidez-blade-components-views

使用方法

就像任何其他Blade组件一样,请参阅Laravel Blade文档以及上面链接的组件代码中的示例。所有组件都以前缀x-rapidez::开头,以避免与项目中的现有Blade组件发生冲突。

基本示例

带有标签的输入

<label>
    <x-rapidez::label>Something</x-rapidez::label>
    <x-rapidez::input name="something" class="extra-styling" />
</label>

复选框

<x-rapidez::input.checkbox name="something">
    @lang('Translatable label')
</x-rapidez::input.checkbox>

预览

所有组件都包含一个预览Blade文件,要在此项目中查看,你可以在routes/web.php中注册一个路由,并从浏览器访问/components路由。

Route::view('components', 'rapidez::components-preview');

许可证

GNU通用公共许可证v3。请参阅许可证文件以获取更多信息。