Temporal-picker NPM

temporal-picker

Temporal Picker is a date picker base on ISO date format

The supported frameworks are:

Screenshots

Screenshot1 Screenshot2 Screenshot3 Screenshot4

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;
}