defmodule Surface.Components.Form.Checkbox do @moduledoc """ Defines a checkbox. Provides a wrapper for Phoenix.HTML.Form's `checkbox/3` function. All options passed via `opts` will be sent to `checkbox/3`, `value` and `class` can be set directly and will override anything in `opts`. ## Examples ``` ``` """ use Surface.Components.Form.Input import Phoenix.HTML.Form, only: [checkbox: 3] import Surface.Components.Utils, only: [events_to_opts: 1] import Surface.Components.Form.Utils @doc "The value to be sent when the checkbox is checked. Defaults to \"true\"" prop checked_value, :any, default: true @doc "Controls if this function will generate a hidden input to submit the unchecked value or not, defaults to \"true\"." prop hidden_input, :boolean, default: true @doc "The value to be sent when the checkbox is unchecked, defaults to \"false\"." prop unchecked_value, :any, default: false def render(assigns) do helper_opts = props_to_opts(assigns, [:checked_value, :hidden_input, :unchecked_value, :value]) attr_opts = props_to_attr_opts(assigns, class: get_default_class()) event_opts = events_to_opts(assigns) opts = assigns.opts |> Keyword.merge(helper_opts) |> Keyword.merge(attr_opts) |> Keyword.merge(event_opts) assigns = assign(assigns, :opts, opts) ~F[{checkbox(@form, @field, @opts)}] end end