Slots

• inner_block (required)

Renders an input with label and error messages.

A Phoenix.HTML.FormField may be passed as argument, which is used to retrieve the input name, id, and values. Otherwise all attributes may be passed explicitly.

Examples

<.input field={@form[:email]} type="email" />
<.input name="my-input" errors={["oh no!"]} />

Attributes

• id (:any) - the id of the input. Defaults to nil.
• name (:any) - the name of the input.
• label (:string) - the label for the input. Defaults to nil.
• value (:any) - the value of the input.
• type (:string) - the type of the input. Defaults to "text". Must be one of "switch", "checkbox", "color", "date", "datetime-local", "email", "file", "month", "number", "password", "range", "search", "select", "tel", "text", "textarea", "time", "url", "week", "hidden", "radio-group", or "autocomplete".
• field (Phoenix.HTML.FormField) - a form field struct retrieved from the form, for example: @form[:email].
• errors (:list) - A list of strings to display as field errors. Defaults to [].
• checked (:boolean) - the checked flag for checkbox inputs.
• prompt (:string) - the prompt for select inputs. Defaults to nil.
• options (:list) - the options to pass to Phoenix.HTML.Form.options_for_select/2.
• target (:string) - the target of the call for remote options. Will default to the current live view. For a live component, pass remove_options_target={@myself} if the event is handled on the live component. Defaults to nil.
• event (:string) - The event name to trigger when searching for remote options. That event must return a li. Defaults to nil.
• multiple (:boolean) - the multiple flag for select inputs. Defaults to false.
• Global attributes are accepted. Supports all globals plus: ["accept", "autocomplete", "capture", "cols", "disabled", "form", "list", "max", "maxlength", "min", "minlength", "multiple", "pattern", "placeholder", "readonly", "required", "rows", "size", "step"].

Slots

• help - A slot used to display help text under the input.

Renders a label.

Attributes

• for (:string) - Defaults to nil.

Slots

• inner_block (required)

Renders a simple form.

Examples

<.simple_form for={@form} phx-change="validate" phx-submit="save">
  <.input field={@form[:email]} label="Email"/>
  <.input field={@form[:username]} label="Username" />
  <:actions>
    <.button>Save</.button>
  </:actions>
</.simple_form>

Attributes

• for (:any) (required) - the data structure for the form.
• as (:any) - the server side parameter to collect all input under. Defaults to nil.
• Global attributes are accepted. the arbitrary HTML attributes to apply to the form tag. Supports all globals plus: ["autocomplete", "name", "rel", "action", "enctype", "method", "novalidate", "target", "multipart"].

Slots

• inner_block (required)
• actions - the slot for form actions, such as a submit button.

Translates an error message using gettext.

Translates the errors for a field from a keyword list of errors.