rapidez / blade-components
Rapidez使用的优秀Blade组件集合
dev-master
2024-09-25 10:57 UTC
Requires
- php: ^8.1|^8.2
- blade-ui-kit/blade-heroicons: ^2.4
- gehrisandro/tailwind-merge-laravel: ^1.2
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。请参阅许可证文件以获取更多信息。