You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Jan 2, 2024. It is now read-only.
Copy file name to clipboardExpand all lines: README.md
+25-6Lines changed: 25 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,21 +1,24 @@
1
-
# [WIP]Laravel Form Components
1
+
# Laravel Form Components
2
2
3
3
[](https://packagist.org/packages/protonemedia/laravel-form-components)
[](https://plant.treeware.earth/pascalbaljetmedia/laravel-form-components)
8
+
9
+
A set of Blade components to rapidly build forms with [Tailwind CSS Custom Forms](https://tailwindcss-custom-forms.netlify.app). It uses the default styling from the plugin and is still fully customizable!
7
10
8
11
## Features
9
12
10
13
* Components for input, textarea, select, multi-select, checkbox and radio elements
11
14
* Support for [Tailwind CSS Custom Forms](https://tailwindcss-custom-forms.netlify.app)
12
-
* Re-populate form with [old input](https://laravel.com/docs/master/requests#old-input)
13
-
* Validation errors
14
15
* Bind a target to a form (or a set of elements) to provide default values
15
16
* Support for Spatie's [laravel-translatable](https://github.com/spatie/laravel-translatable)
17
+
* Re-populate forms with [old input](https://laravel.com/docs/master/requests#old-input)
18
+
* Validation errors
16
19
* Components classes and Blade views fully customizable
17
20
* Support for prefixing the components
18
-
* Prepared for other CSS frameworks as well (future release)
21
+
* Prepared for other CSS frameworks as well (in a future release)
19
22
20
23
## Requirements
21
24
@@ -29,6 +32,8 @@ You can install the package via composer:
Make sure the [Tailwind plugin](https://github.com/tailwindcss/custom-forms#install) is installed and added to your `tailwind.config.js` file. If you're starting a new project, you can use the [Frontend preset for Tailwind CSS](https://github.com/laravel-frontend-presets/tailwindcss) which includes the Custom Forms plugin as well.
36
+
32
37
## Configuration
33
38
34
39
There is no configuration needed unless you want to [customize the Blade views and components](#customize-the-blade-views).
@@ -207,7 +212,7 @@ You can group checkbox and radio elements on the same horizontal row by adding a
207
212
208
213
### Old input data
209
214
210
-
When a validation errors occurs, and Laravel redirects you back, the form will be re-populated with the old input data. This old data will override any binding or default value.
215
+
When a validation errors occurs and Laravel redirects you back, the form will be re-populated with the old input data. This old data will override any binding or default value.
211
216
212
217
### Handling translations
213
218
@@ -237,7 +242,7 @@ You can find the Blade views in the `resources/views/vendor/form-components` fol
237
242
238
243
### Customize the components
239
244
240
-
You can bind your own component classes to any of the elements. In the `form-components.php` configuration file, you can change the class *per* component. As the logic for the components is quite complex, it is strongly recommended to duplicate the default component as a starting point, and start editing from there. You'll find the default component classes in the `vendor/protonemedia/laravel-form-components/src/Components` folder.
245
+
You can bind your own component classes to any of the elements. In the `form-components.php` configuration file, you can change the class *per* component. As the logic for the components is quite complex, it is strongly recommended to duplicate the default component as a starting point and start editing. You'll find the default component classes in the `vendor/protonemedia/laravel-form-components/src/Components` folder.
241
246
242
247
### Prefix the components
243
248
@@ -286,6 +291,16 @@ Please see [CHANGELOG](CHANGELOG.md) for more information about what has changed
286
291
287
292
Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
288
293
294
+
## Other Laravel packages
295
+
296
+
*[`Laravel Analytics Event Tracking`](https://github.com/pascalbaljetmedia/laravel-analytics-event-tracking): Laravel package to easily send events to Google Analytics.
297
+
*[`Laravel Blade On Demand`](https://github.com/pascalbaljetmedia/laravel-blade-on-demand): Laravel package to compile Blade templates in memory.
298
+
*[`Laravel Cross Eloquent Search`](https://github.com/pascalbaljetmedia/laravel-cross-eloquent-search): Laravel package to search through multiple Eloquent models.
299
+
*[`Laravel FFMpeg`](https://github.com/pascalbaljetmedia/laravel-ffmpeg): This package provides an integration with FFmpeg for Laravel. The storage of the files is handled by Laravel's Filesystem.
300
+
*[`Laravel Paddle`](https://github.com/pascalbaljetmedia/laravel-paddle): Paddle.com API integration for Laravel with support for webhooks/events.
301
+
*[`Laravel Verify New Email`](https://github.com/pascalbaljetmedia/laravel-verify-new-email): This package adds support for verifying new email addresses: when a user updates its email address, it won't replace the old one until the new one is verified.
302
+
*[`Laravel WebDAV`](https://github.com/pascalbaljetmedia/laravel-webdav): WebDAV driver for Laravel's Filesystem.
303
+
289
304
### Security
290
305
291
306
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
@@ -298,3 +313,7 @@ If you discover any security related issues, please email [email protected] i
298
313
## License
299
314
300
315
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.
316
+
317
+
## Treeware
318
+
319
+
This package is [Treeware](https://treeware.earth). If you use it in production, then we ask that you [**buy the world a tree**](https://plant.treeware.earth/pascalbaljetmedia/laravel-form-components) to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.
0 commit comments