temporal-picker

Temporal Picker is a date picker base on ISO date format

The supported frameworks are:

• react
• react-router

Screenshots

How to Use

Step 1.

npm i temporal-picker

Step 2.

import { define } from "temporal-picker";

define();

Step 3.

<style>
  :root {
    --t-input-color-fg-invalid: red;
  }
  temporal-picker::part(separator) {
    color: blue;
  }
</style>

<temporal-picker id="picker"></temporal-picker>

<temporal-picker id="range-picker" type="range" extra-select="true" reset-button="true">
  <temporal-preset label="Preset 1" start="2023-01-01" end="2023-02-15"></temporal-preset>
  <temporal-preset label="Preset 2" start="2023-04-01" end="2023-06-01"></temporal-preset>
</temporal-picker>

<script>
  const picker = document.getElementById("picker");
  picker.addEventListener("t-value-change", (e) => console.log(e));

  const rangePicker = document.getElementById("range-picker");
  rangePicker.addEventListener("t-range-change", (e) => console.log(e));
</script>

Properties

| Property | Attribute | Description | Type | Default | | ---------------- | ----------------- | ----------------------------- | ---------------------------------------------------- | ----------- | | autoApply | auto-apply | | boolean | undefined | | customLayout | custom-layout | | boolean | undefined | | disabled | disabled | | boolean | undefined | | end | end | The end value of date range | string | undefined | | extraSelect | extra-select | | boolean | undefined | | firstDay | first-day | | number | undefined | | locale | locale | | string | undefined | | localeApply | locale-apply | | string | undefined | | localeCancel | locale-cancel | | string | undefined | | localeClear | locale-clear | | string | undefined | | max | max | The max value | string | undefined | | min | min | The min value | string | undefined | | native | native | The native value | boolean | undefined | | picker | picker | The type of picker | "button" \| "input" | 'input' | | placement | placement | | "bottom" \| "bottom-end" \| "bottom-start" | 'bottom' | | plain | plain | The type of picker | "date" \| "datetime" \| "day" \| "month" \| "time" | 'date' | | presetPosition | preset-position | | "bottom" \| "left" \| "right" \| "top" | undefined | | readonly | readonly | | boolean | undefined | | reselect | reselect | | boolean | undefined | | resetButton | reset-button | | boolean | undefined | | rowHeader | row-header | | boolean | undefined | | pickLabel | pick-label | | boolean | undefined | | start | start | The start value of date range | string | undefined | | strict | strict | | boolean | undefined | | tooltip | tooltip | | boolean | undefined | | type | type | The type of picker | "plain" \| "range" | 'plain' | | value | value | The value of date | string | undefined |

Events

| Event | Description | Type | | ---------------- | ---------------------- | ---------------------------------------------- | | t-range-change | The range change event | CustomEvent<{ start: string; end: string; }> | | t-value-change | The value change event | CustomEvent<{ value: string; }> | | t-layout | | | | t-render | | | | t-mount | | | | t-update | | |

Shadow Parts

| Part | Description | | ----------------- | ----------- | | "button" | | | "input" | | | "start-input" | | | "end-input" | | | "separator" | | | "range-wrapper" | |

Customize

:root {
  --t-popup-color-bg-default: #fff;
  --t-popup-color-bg-secondary: #f2f5f8;
  --t-popup-color-fg-default: #1e293b;
  --t-popup-color-fg-primary: #2e6fda;
  --t-popup-color-fg-secondary: #64748b;
  --t-popup-color-fg-selected: #fff;
  --t-popup-color-fg-muted: #64748b;
  --t-popup-color-fg-accent: #e63757;
  --t-popup-color-fg-locked: #9e9e9e;
  --t-popup-color-bg-locked: #ffab91;
  --t-popup-color-bg-unavailable: #f9f9f9;
  --t-popup-color-bg-inrange: #e6effe;
  --t-popup-color-bg-inrange-inf: #f2f6fe;
  --t-popup-color-bg-tooltip: #fff;
  --t-popup-color-fg-tooltip: #1e293b;
  --t-popup-color-btn-primary-bg: #2e6fda;
  --t-popup-color-btn-primary-fg: #fff;
  --t-popup-color-btn-primary-border: #2e6fda;
  --t-popup-color-btn-primary-hover-bg: #2c67cd;
  --t-popup-color-btn-primary-hover-fg: #fff;
  --t-popup-color-btn-primary-hover-border: #2c67cd;
  --t-popup-color-btn-primary-disabled-bg: #80aff8;
  --t-popup-color-btn-primary-disabled-fg: #fff;
  --t-popup-color-btn-primary-disabled-border: #80aff8;
  --t-popup-color-btn-secondary-bg: #fff;
  --t-popup-color-btn-secondary-fg: #475569;
  --t-popup-color-btn-secondary-border: #cbd5e1;
  --t-popup-color-btn-secondary-hover-bg: #f8fafc;
  --t-popup-color-btn-secondary-hover-fg: #475569;
  --t-popup-color-btn-secondary-hover-border: #cbd5e1;
  --t-popup-color-btn-secondary-disabled-bg: #cbd5e1;
  --t-popup-color-btn-secondary-disabled-fg: #fff;
  --t-popup-color-btn-secondary-disabled-border: #cbd5e1;
  --t-popup-color-border-default: #cbd5e1;
  --t-popup-color-border-locked: #f9f9f9;
  --t-popup-day-width: 43px;
  --t-popup-day-height: 37px;
  --t-popup-month-width: 75px;
  --t-popup-month-height: 37px;
  --t-popup-z-index: 40;
  --t-popup-border-radius: 2px;
  --t-popup-primary-color: #2e6fda;
  --t-popup-secondary-color: #64748b;
  --t-popup-font-family: inherit;
  --t-popup-box-shadow: 0 4px 28px 0 rgb(0 0 0 / 12%);
  --t-popup-month-name-font-weight: 700;
  --t-popup-focus-color: #94a3b8;
  --t-popup-select-outline-color: #e5e7eb;

  --t-input-border: 1px solid #e5e7eb;
  --t-input-color: inherit;
  --t-input-font: inherit;
  --t-input-px: 0.375em;
  --t-input-py: 0.25em;
  --t-input-invalid-color: #be123c;

  --t-input-button-icon-size: 1.25em;

  --t-input-range-wrapper-gap: 1em;
  --t-input-separator-icon-size: 1em;
}