MishkaGervaz.Table.Web.DataLoader.RelationLoader behaviour (MishkaGervaz v0.0.1-alpha.3)

Copy Markdown View Source

Handles paginated loading of relation filter options.

Provides support for different loading modes:

  • :static - Load all options at once
  • :load_more - Initial page with load more capability
  • :search - Search with pagination (single select)
  • :search_multi - Search with pagination (multi select)

Usage

# Load initial options
{:ok, result} = RelationLoader.load_options(filter, state, page: 1)

# Search options
{:ok, result} = RelationLoader.search_options(filter, state, "search term", page: 1)

Override

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

  def load_options(filter, state, opts) do
    # Custom loading logic
    super(filter, state, opts)
  end
end

See MishkaGervaz.Table.Web.DataLoader, MishkaGervaz.Table.Web.DataLoader.Helpers, MishkaGervaz.Table.Types.Filter.Relation, and the sibling sub-builders QueryBuilder, FilterParser, PaginationHandler, TenantResolver, HookRunner.

Summary

Types

filter()
load_result()
state()

Callbacks

load_more_options(filter, state, keyword)
load_options(filter, state, keyword)
load_with_selected(filter, state, list, keyword)
resolve_selected(filter, state, list)
search_options(filter, state, t, keyword)

Types

filter()

@type filter() :: map()

load_result()

@type load_result() :: %{
  options: [{String.t(), any()}],
  page: pos_integer(),
  has_more?: boolean(),
  total_count: pos_integer() | nil
}

state()

@type state() :: map()

Callbacks

load_more_options(filter, state, keyword)

@callback load_more_options(filter(), state(), keyword()) ::
  {:ok, load_result()} | {:error, term()}

load_options(filter, state, keyword)

@callback load_options(filter(), state(), keyword()) ::
  {:ok, load_result()} | {:error, term()}

load_with_selected(filter, state, list, keyword)

@callback load_with_selected(filter(), state(), list(), keyword()) ::
  {:ok, load_result()} | {:error, term()}

resolve_selected(filter, state, list)

@callback resolve_selected(filter(), state(), list()) ::
  {:ok, [{String.t(), any()}]} | {:error, term()}

search_options(filter, state, t, keyword)

@callback search_options(filter(), state(), String.t(), keyword()) ::
  {:ok, load_result()} | {:error, term()}