Skip to content

zk-field ​

Wraps form controls in a .field div. Adds an error class automatically when $errors->has($name). Used internally by zk-input, zk-select, and zk-textarea.

Props ​

PropTypeDefaultDescription
namestring|nullnullField name — used to detect validation errors
classstring|nullnullAdditional CSS class(es) on the wrapper div
fieldbooltrueRender the wrapper — set false to render slot content directly

Examples ​

Wrap a custom control ​

blade
<x-form.field name="avatar">
    <input type="file" name="avatar">
</x-form.field>
{{-- Renders: <div class="field error">...</div> when validation fails --}}

Opt out ​

blade
<x-form.field :field="false">
    <input type="hidden" name="_token" value="{{ csrf_token() }}">
</x-form.field>
{{-- Renders slot content directly, no wrapping div --}}

Notes ​

  • This component has no public x-zk-* alias — it is used internally by other form components.
  • The .error CSS class is appended automatically when the $errors bag contains an entry for name.

Documentation of 3.2.0 , built from c93e21f on 3.2.0 by pipeline #2919741884 on 2026-10-06.