Enclose is a peculiar type of element provided by Larastrap: similar to a Form, it acts as a logical container for other elements without providing any actual HTML markup.
@php
$obj = App\Models\User::inRandomOrder()->first();
@endphp
<x-larastrap::enclose :obj="$obj">
<x-larastrap::text name="name" readonly squeeze />
<x-larastrap::email name="email" squeeze />
</x-larastrap::enclose>
<input id="input-1407f0f9" type="text" class="form-control-plaintext" name="name" value="Edwina Hettinger" readonly> <input id="input-9e727afa" type="email" class="form-control" name="email" value="hermina.streich@example.net">His may purpose is to isolate different models within the same logical block. The common use case is: a form with a table involving multiple models at once, each with his own attributes (and his own input fields).
<x-larastrap::form>
<table class="table">
@foreach(App\Models\User::inRandomOrder()->take(3)->get() as $user)
<x-larastrap::enclose :obj="$user">
<tr>
<td><x-larastrap::text name="name" readonly squeeze="true" /></td>
<td><x-larastrap::email name="email" npostfix="[]" squeeze="true" /></td>
</tr>
</x-larastrap::enclose>
@endforeach
</table>
</x-larastrap::form>
<form id="form-1a2cc12c" class="" method="post" name="form-1a2cc12c">
<input type="hidden" name="_token" value="95L8hreM6ITQIgvTozCEoVumoXxNBKs1IFB9p2Uu" autocomplete="off">
<table class="table">
<tr>
<td>
<input id="input-4afc6582" type="text" class="form-control-plaintext" name="name" value="Geraldine Abshire IV" readonly>
</td>
<td>
<input id="input-14733afd" type="email" class="form-control" name="email[]" value="lschultz@example.com">
</td>
</tr>
<tr>
<td>
<input id="input-062eb0dc" type="text" class="form-control-plaintext" name="name" value="Jessyca Goyette" readonly>
</td>
<td>
<input id="input-9d001767" type="email" class="form-control" name="email[]" value="casper.lorine@example.net">
</td>
</tr>
<tr>
<td>
<input id="input-97c7c6dd" type="text" class="form-control-plaintext" name="name" value="Ebba Olson I" readonly>
</td>
<td>
<input id="input-53ece1c7" type="email" class="form-control" name="email[]" value="ebert.jeremy@example.net">
</td>
</tr>
</table>
<div class="col-12 text-end">
<button id="button-f960d277" class="btn btn-primary" type="submit">Save</button>
</div>
</form>In the example above, it is important to note the use of npostfix parameter: when the form is submitted, all email addresses have to be serialized into an array and sent to the specified endpoint (the form's action ).
For convenience, it is possible to set both nprefix and npostfix parameters once on the Enclose, to be inherited by all the child Inputs.
<x-larastrap::form>
@foreach(App\Models\User::inRandomOrder()->take(3)->get() as $user)
<x-larastrap::enclose :obj="$user" nprefix="user_" npostfix="[]">
<div class="row mb-2">
<div class="col">
<x-larastrap::hidden name="id" squeeze />
<x-larastrap::email name="email" squeeze />
</div>
</div>
</x-larastrap::enclose>
@endforeach
</x-larastrap::form>
<form id="form-4740077a" class="" method="post" name="form-4740077a">
<input type="hidden" name="_token" value="95L8hreM6ITQIgvTozCEoVumoXxNBKs1IFB9p2Uu" autocomplete="off">
<div class="row mb-2">
<div class="col">
<input id="hidden-19b6ad2d" type="hidden" class="" name="user_id[]" value="9"> <input id="input-172d57c2" type="email" class="form-control" name="user_email[]" value="genevieve.reinger@example.com">
</div>
</div>
<div class="row mb-2">
<div class="col">
<input id="hidden-8e6200fc" type="hidden" class="" name="user_id[]" value="1"> <input id="input-80f9fa13" type="email" class="form-control" name="user_email[]" value="daniel.arlie@example.net">
</div>
</div>
<div class="row mb-2">
<div class="col">
<input id="hidden-29435b7f" type="hidden" class="" name="user_id[]" value="8"> <input id="input-365740ed" type="email" class="form-control" name="user_email[]" value="xwelch@example.org">
</div>
</div>
<div class="col-12 text-end">
<button id="button-733f4462" class="btn btn-primary" type="submit">Save</button>
</div>
</form>