Skip to content

Latest commit

 

History

36 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

lddatetimepicker

Vanilla Date/Time picker.

Usage

install via npm, along with required libraries:

npm install --save lddatetimepicker @loadingio/debounce.js dayjs

include required js / css:

<link rel="stylesheet" type="text/css" href="dist/index.min.css">
<script type="text/javascript" src="path-to/debounce.js"></script>
<script type="text/javascript" src="path-to-day.js"></script>
<script type="text/javascript" src="dist/index.min.js"></script>

initialize:

lddtp = new lddatetimepicker({host: "input"})
lddtp.value("2021/01/23"); // set value
lddtp.value(); // get value

Constructor options:

  • host: host element ( should be an input element, if provided )
  • time: default true. hide and disable time picker if false.
  • viewMode: default false. if true, a prettified, read-only overlay is rendered right on top of the host input, showing the picked value as 2011/01/01 13:05 UTC+8 ( date only if time is false ). the host input still carries the raw ISO value, so form submission is unaffected. the overlay steps aside whenever host is focused, so the raw value stays editable by typing, and comes back on blur. requires host.
  • suppress: default false. suppress popup when clicking host if true.
  • fixed: (deprecated) default false. true to enabled fixed mode.
  • mode: either in-place, out-place or fixed.
    • fixed:
      • when toggled, the datetime widget pops up in screen center, and covers the whole screen.
      • will be forced to true if host and container are not provided.
    • out-place: widget is inserted under body.
    • in-place: widget is inserted after host.
  • container: optional. if provided, lddatetimepicker are rendered barely in this container.
    • this should be an object with following fields:
      • node: required. container element.
      • toggle(v): required. function for toggling container on / off.
      • isOn(): required. return true if a container is toggled on, otherwise false.
      • position({x,y,ix,iy}): optional. use this function to correctly position container.
        • x: suggested x position
        • y: suggested y position
        • ix: suggested x position if mode is in-place.
        • iy: suggested y position if mode is in-place.
    • by default, mode will be out-place with container option set.
      • Set mode to fixed if the container is a fixed element (such as dialog)
  • zmgr: optional. if provided, widget will be auto z-indexing based on this zmgr.

API

  • isOn(): return true if lddatetimepicker dialog is on, otherwise return false
  • fire(n, ...args)
  • on(n, cb)
  • update()
  • value()
  • config(opt): update configuration.
    • following options are supported:
      • suppress: see constructor option for this option.
      • time: see constructor option for time
      • viewMode: see constructor option for viewMode
    • return current config ( suppress, viewMode and time ) when calling without option.

License

MIT

About

Vanilla Date/Time Picker

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages