# `MishkaGervaz.Form.Web.Events.RelationHandler`
[🔗](https://github.com/mishka-group/mishka_gervaz/blob/v0.0.1-alpha.3/lib/mishka_gervaz/form/web/events/relation_handler.ex#L1)

Handles relation field events for search, multi-select, and dropdown state.

Follows the same pattern as `MishkaGervaz.Table.Web.Events.RelationFilterHandler`.

## Events Handled

- `search` - Search options by term (debounced)
- `focus` - Open dropdown and load initial options
- `close_dropdown` - Close dropdown on click-away
- `select` - Single select (for :search mode)
- `toggle` - Toggle selection (for :search_multi mode)
- `clear` - Clear all selections
- `load_more` - Load next page of options

## Customization

    defmodule MyApp.Form.RelationHandler do
      use MishkaGervaz.Form.Web.Events.RelationHandler

      def handle("toggle", params, state, socket) do
        super("toggle", params, state, socket)
      end
    end

Top-level helpers (`get_field/2`, `get_search_term/2`,
`validate_min_chars/2`, `resolve_selected_options/3`, `revalidate_form/3`,
`update_relation_state/5`, `reload_dependent_fields/3`, etc.) are public
so user overrides can reuse them — they live outside the `__using__`
macro to avoid per-consumer compile cost.

See `MishkaGervaz.Form.Web.Events`,
`MishkaGervaz.Form.Web.DataLoader.RelationLoader`, and the sibling
sub-handlers.

# `params`

```elixir
@type params() :: map()
```

# `socket`

```elixir
@type socket() :: Phoenix.LiveView.Socket.t()
```

# `state`

```elixir
@type state() :: MishkaGervaz.Form.Web.State.t()
```

# `handle`

```elixir
@callback handle(
  action :: String.t(),
  params :: params(),
  state :: state(),
  socket :: socket()
) ::
  {:noreply, socket()}
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*