Author: | dan-lee |
---|---|
Views Total: | 27 views |
Official Page: | Go to website |
Last Update: | September 6, 2023 |
License: | MIT |
Preview:

Description:
Timescape is an accessible, headless, touch-enable, user-friendly date & time selector component designed specifically to enhance and replace the native date and time inputs in your applications. Compatible with popular frameworks like React, Vue, Solid, Preact, and Svelte.
With its flexible API, you can use hooks to get seamless component integration. Plus, you have the freedom to render inputs in any order, ensuring the date/time format fits your application’s needs.
How to use it:
1. Install the Timescape via package managers.
# Yarn $ yarn add timescape # NPM $ npm i timescape
2. Integrate Timescape into your Vue project.
// App.vue <template> <div class="timescape-root" :ref="registerRoot()"> <input :ref="registerElement('days')" class="timescape-input" /> <span class="separator">/</span> <input :ref="registerElement('months')" class="timescape-input" /> <span class="separator">/</span> <input :ref="registerElement('years')" class="timescape-input" /> <span class="separator"> </span> <input :ref="registerElement('hours')" class="timescape-input" /> <span class="separator">:</span> <input :ref="registerElement('minutes')" class="timescape-input" /> <span class="separator">:</span> <input :ref="registerElement('seconds')" class="timescape-input" /> </div> </template> <script lang="ts" setup> import { useTimescape, $NOW, type UseTimescapeOptions } from 'timescape/vue' import { ref, computed, watchEffect, reactive } from 'vue' const date = ref(new Date()) const dateString = computed(() => date.value.toLocaleString('en-UK')) watchEffect(() => { console.log('Date changed to', date.value) }) const options = reactive({ date, } as UseTimescapeOptions) const { registerElement, registerRoot } = useTimescape(options) </script>
3. Integrate Timescape into your React project.
// App.tsx import { useTimescape } from 'timescape/react' function App() { const { getRootProps, getInputProps } = useTimescape({ date: new Date(), onChangeDate: (nextDate) => { console.log('Date changed to', nextDate) }, }) return ( <div className="timescape-root" {...getRootProps()}> <input className="timescape-input" {...getInputProps('days')} /> <span className="separator">/</span> <input className="timescape-input" {...getInputProps('months')} /> <span className="separator">/</span> <input className="timescape-input" {...getInputProps('years')} /> <span className="separator"> </span> <input className="timescape-input" {...getInputProps('hours')} /> <span className="separator">:</span> <input className="timescape-input" {...getInputProps('minutes')} /> <span className="separator">:</span> <input className="timescape-input" {...getInputProps('seconds')} /> </div> ) } export default App