Update README.md

Author: pascalbaljet

README.md

@@ -34,7 +34,7 @@ composer require protonemedia/laravel-form-components
 
 todo
 
-## Usage
+## Quick example
 
 ```blade
 <x-form>
@@ -60,6 +60,82 @@ todo
 </x-form>
 ```
 
+## Usage
+
+### Input and textarea elements
+
+The minimum requirement for an `input` or `textarea` is a `name` attribute.
+
+```blade
+<x-form-input name="company_name" />
+```
+
+Optionally you can add a `label` attribute, which can be computed as well.
+
+```blade
+<x-form-input name="company_name" label="Company name" />
+<x-form-input name="company_name" :label="trans('forms.company_name')" />
+```
+
+You can also choose to use a `placeholder` instead of a label, and of course you can change the `type` of the element.
+
+```blade
+<x-form-input type="email" name="current_email" placeholder="Current email address" />
+```
+
+By default every element shows validation errors but you can hide them if you want.
+
+```blade
+<x-form-textarea name="description" :show-errors="false" />
+```
+
+### Default value
+
+You can use the `default` attribute to specify the default value of the element.
+
+```blade
+<x-form-textarea name="motivation" default="I want to use this package because..." />
+```
+
+### Binding a target
+
+Instead of setting a default value, you can also pass in a target, like an Eloquent model. Now the component will get the value from the target by the `name`.
+
+```blade
+<x-form-textarea name="description" :bind="$video" />
+```
+
+In the example above, where `$video` is an Eloquent model, the default value will be `$video->description`.
+
+### Binding a target to multiple elements
+
+You can also bind a target by using the `@bind` directive. This will bind the target to all elements until the `@endbind` directive.
+
+```blade
+<x-form>
+    @bind($video)
+        <x-form-input name="title" label="Title" />
+        <x-form-textarea name="description" label="Description" />
+    @endbind
+</x-form>
+```
+
+You can even mix targets!
+
+```blade
+<x-form>
+    @bind($user)
+        <x-form-input name="full_name" label="Full name" />
+
+        @bind($userProfile)
+            <x-form-textarea name="biography" label="Biography" />
+        @endbind
+
+        <x-form-input name="email" label="Email address" />
+    @endbind
+</x-form>
+```
+
 ### Testing
 
 ``` bash