LoopOS UI v1.1.59.0-release.taskforce.dynamic.form.in.UI.rc2

Previews

No matching results.

x
1
2
3
4
5
6
7
8
9
10
11
12
<div class="lui-date_picker-wrapper">
  <div class="lui-date_picker h-[32px]!">
    <div class="lui-date_picker__field" data-controller="date-picker" data-date-picker-locale-value="pt" data-date-picker-submit-on-select-value="false" data-date-picker-show-today-button-value="true" data-date-picker-today-label-value="Hoje" data-date-picker-show-clear-button-value="true" data-date-picker-clear-label-value="Limpar" data-date-picker-granularity-value="date" data-date-picker-range-separator-value="~" data-date-picker-date-format-value="dd/MM/yyyy">
      <input name="date" class="air-datepicker-input" readonly="readonly" data-date-picker-target="input" placeholder="Selecionar data...">
      <div class="lui-date_picker__icon">
        <div class="lui-icon h-[16px] w-[16px]">
          <i class="fa-regular fa-calendar lui-icon__icon" style="font-size: 16px; color: currentColor;"></i>
        </div>
      </div>
    </div>
  </div>
</div>

DatePicker

Description

Used Components Components where is Used
Label

Usage rules

  • ✅ Do
  • ❌ Don't
1
2
3
4
5
6
7
8
9
10
11
12
<%= render LooposUi::DatePicker.new(
  inline: preview_params[:inline],
  range: preview_params[:range],
  presets: preview_params[:presets],
  granularity: (preview_params[:granularity].presence || 'date'),
  initial_date: preview_params[:initial_date] ? Date.parse(preview_params[:initial_date]) : nil,
  min_date: preview_params[:min_date] ? Date.parse(preview_params[:min_date]) : nil,
  max_date: preview_params[:max_date] ? Date.parse(preview_params[:max_date]) : nil,
  locale: "pt",
  help: preview_params[:help].presence,
  error: preview_params[:error].presence
) %>

No notes provided.

Param Description Input

Display as inline picker

Enable date range selection

Show preset date options

month_year", "year", "date_time", "time"] } "Selection precision

Initial date (YYYY-MM-DD)

Minimum selectable date (YYYY-MM-DD)

Maximum selectable date (YYYY-MM-DD)

Locale

Help text below the input

Error message below the input

Description

Date Picker component for selecting a single date, a date range, or month/year values. It integrates with a Stimulus controller and Air Datepicker, supports configurable granularity, an inline mode, and optional presets.

Arguments

Property Default Required Description
inline false Renders an inline calendar (always visible).
id nil Optional DOM id seed. When omitted, a random datepicker-* id is generated.
name nil Input name attribute. Defaults to date, month, year, time, or date_range.
submit_on_select false When true, submits the surrounding form after selecting.
range false Enables date range selection.
presets false Shows preset quick ranges in a popover with an inline calendar.
granularity 'date' Selection precision: date, month_year, year, date_time, time.
locale I18n.locale.to_s Locale used for Air Datepicker labels and component translations.
initial_date nil Pre-selected date (Date). Does not restrict selectable dates.
min_date nil Minimum selectable date. Dates before this are disabled in all modes.
max_date nil Maximum selectable date. Dates after this are disabled in all modes.
help nil Help text shown below the input. Hidden when error is present.
error nil Error message shown below the input. Adds an error border to the input.

Value formats by granularity

granularity Input value format
date dd/MM/yyyy
month_year MM/yyyy
year yyyy
date_time Display: dd/MM/yyyy HH:mm — submit: dd/MM/yyyy HH:mm:ss (:00)
time Display: HH:mm — submit: HH:mm:ss (:00)
range + any {start}~{end} using the format above

Notes:

  • For month_year and year, the picker opens in months or years view.
  • When presets: true, range selection is enabled and a left-side presets column is shown.
  • Unknown granularity values fall back to date.
  • LoopOS protocol forms use the same granularity values; map min_date, max_date, and range from the surrounding element when integrating.

Slots

None.

JS Events

Emits on the input element:

  • change: Fired whenever the input value changes due to selection or clearing.

Listens to:

  • No custom events. Uses internal Stimulus behaviors.

Accessibility

  • The input is readonly and opens a calendar UI; ensure labels and context are provided by the surrounding form.

Examples

  • Single date:
<%= render LooposUi::DatePicker.new %>
  • Month/year:
<%= render LooposUi::DatePicker.new(granularity: 'month_year') %>
  • Year-only:
<%= render LooposUi::DatePicker.new(granularity: 'year') %>
  • Date range:
<%= render LooposUi::DatePicker.new(range: true) %>
  • With date constraints:
<%= render LooposUi::DatePicker.new(
  min_date: Date.new(2024, 1, 1),
  max_date: Date.new(2025, 12, 31)
) %>
  • With presets and inline calendar:
<%= render LooposUi::DatePicker.new(presets: true, initial_date: Date.current) %>