defmodule Corex.AngleSlider do @moduledoc ~S''' Phoenix implementation of [Zag.js Angle Slider](https://zagjs.com/components/react/angle-slider). ## Examples ### Basic ```heex <.angle_slider id="angle" class="angle-slider"> <:label>Angle ``` ### With marks ```heex <.angle_slider id="angle" class="angle-slider" marker_values={[0, 90, 180, 270]}> <:label>Angle ``` ### Controlled In controlled mode, use `on_value_change` and `on_value_change_client` so the thumb moves during drag. Use `on_value_change_end` and `on_value_change_end_client` if you only need to react when the user releases. ```elixir defmodule MyAppWeb.AngleSliderLive do use MyAppWeb, :live_view def mount(_params, _session, socket) do {:ok, assign(socket, :angle, 0)} end def handle_event("angle_changed", %{"value" => value}, socket) do {:noreply, assign(socket, :angle, value)} end def render(assigns) do ~H""" <.angle_slider id="angle" controlled value={@angle} on_value_change="angle_changed" marker_values={[0, 90, 180, 270]} class="angle-slider"> <:label>Angle """ end end ``` ## API Control In order to use the API, you must use an id on the component. ***Client-side*** ```heex ``` ***Server-side*** ```elixir def handle_event("set_angle", %{"value" => value}, socket) do {:noreply, Corex.AngleSlider.set_value(socket, "my-angle-slider", String.to_float(value))} end ``` ## Machine API The slider API exposes the following methods: | Method | Type | Description | |--------|------|-------------| | value | number | The current value of the angle slider | | valueAsDegree | string | The current value as a degree string | | setValue | (value: number) => void | Sets the value of the angle slider | | dragging | boolean | Whether the slider is being dragged | ## Styling Use data attributes: `[data-scope="angle-slider"][data-part="root"]`, `control`, `thumb`, `value-text` (with `value` and `text` spans), `marker-group`, `marker`. ''' @doc type: :component use Phoenix.Component alias Corex.AngleSlider.Anatomy.{ Props, Root, Label, HiddenInput, Control, Thumb, ValueText, Value, Text, MarkerGroup, Marker } alias Corex.AngleSlider.Connect attr(:id, :string, required: false, doc: "The id of the angle slider") attr(:value, :float, default: 0.0, doc: "The value or controlled value in degrees") attr(:controlled, :boolean, default: false, doc: "Whether the value is controlled") attr(:step, :float, default: 1.0, doc: "Step value") attr(:disabled, :boolean, default: false, doc: "Whether the slider is disabled") attr(:read_only, :boolean, default: false, doc: "Whether the slider is read-only") attr(:invalid, :boolean, default: false, doc: "Whether the slider is invalid") attr(:name, :string, default: nil, doc: "Name for form submission") attr(:dir, :string, default: nil, values: [nil, "ltr", "rtl"], doc: "Direction") attr(:on_value_change, :string, default: nil, doc: "Server event when value changes (uncontrolled)" ) attr(:on_value_change_client, :string, default: nil, doc: "Client event when value changes (uncontrolled)" ) attr(:on_value_change_end, :string, default: nil, doc: "Server event when value change ends (controlled)" ) attr(:on_value_change_end_client, :string, default: nil, doc: "Client event when value change ends (controlled)" ) attr(:marker_values, :list, default: [], doc: "List of angle values to show as markers (e.g. [0, 90, 180, 270])" ) attr(:rest, :global) slot(:label, required: false) def angle_slider(assigns) do assigns = assigns |> assign_new(:id, fn -> "angle-slider-#{System.unique_integer([:positive])}" end) |> assign_new(:dir, fn -> "ltr" end) ~H"""