# `MishkaGervaz.Form.Web.DataLoader.RelationLoader`
[🔗](https://github.com/mishka-group/mishka_gervaz/blob/v0.0.1-alpha.3/lib/mishka_gervaz/form/web/data_loader/relation_loader.ex#L1)

Loads options for relation/select fields in forms.

Follows the same pattern as `MishkaGervaz.Table.Web.DataLoader.RelationLoader`.

## Modes

- `:static` - Load all options at once (`page: false`)
- `:load_more` - Paginated with load more button
- `:search` - Search with pagination (single select)
- `:search_multi` - Search with pagination (multi select)

## Action Resolution

For master users, tries `:master_read` → `:read_any` → `:read`.
For tenant users, uses `:read` with the user's `site_id` as tenant.

## User Override

    defmodule MyApp.Form.RelationLoader do
      use MishkaGervaz.Form.Web.DataLoader.RelationLoader

      def load_options(field, state, opts) do
        super(field, state, opts)
      end
    end

Top-level helpers (`load_all_options/4`, `load_paginated_options/6`,
`build_options/4`, `prepend_nil_option/2`, `resolve_display_field/2`,
`resolve_load_action/3`, `get_tenant/1`, `maybe_apply_search/2`,
`maybe_apply_custom_load/3`, `resolve_selected_fallback/7`) are public
so user overrides can reuse them — they live outside the `__using__`
macro to avoid per-consumer compile cost.

See `MishkaGervaz.Form.Web.DataLoader`,
`MishkaGervaz.Form.Web.DataLoader.Helpers`,
`MishkaGervaz.Form.Web.State`, and the sibling sub-builders
`RecordLoader`, `TenantResolver`, `HookRunner`. The table-side
counterpart is `MishkaGervaz.Table.Web.DataLoader.RelationLoader`.

---

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