1.0.0 • Published 1 year ago

web-clocks v1.0.0

Weekly downloads
5
License
MIT
Repository
github
Last release
1 year ago

Analogue and Digital Clocks as Web Components

Latest version Dependency status Published on webcomponents.org

Web components showing an analogue clock known from a Svelte example and a digital clock similar to another Svelte example.

Example

See the on-line demo or the storybook.

Usage

1: Place the ana-clock or digi-clock web component with or without attributes to a page. For example:

<ana-clock></ana-clock>
<ana-clock secondhand="false"></ana-clock>
<digi-clock></digi-clock>
<digi-clock seconds="false"></digi-clock>

2: Include the implementation of the web component on your page, typically at the bottom of the body element. Choose the way that fits your scenario the base.

<!-- Load both clocks from the NPM CDN -->
<script type="module" src="https://unpkg.com/web-clocks@1.0.0/dist/index.mjs"></script>
<!-- Load either analogue or digital clock from a local installation -->
<script type="module" src="node_modules/web-clocks/dist/ana-clock.mjs"></script>
<script type="module" src="node_modules/web-clocks/dist/digi-clock.mjs"></script>
<script type="module">
  // Load both clocks and use their classes
  import { AnaClock, DigiClock } from '../dist/index.mjs'
  ...
</script>
<script type="module">
  // Load either analogue or digital clock and use their classes
  import AnaClock from '../dist/ana-clock.mjs'
  import DigiClock from '../dist/digi-clock.mjs'
  ...
</script>
// Include either analogue or digital clock in your application bundle
import { AnaClock, DigiClock } from 'web-clocks'

Attributes

AttributeDescriptionValuesDefault
markerschooses the density of markers (analogue)sixty | twelve | four | nonesixty
secondhanddisables the second hand (analogue)booleantrue
secondsdisables the second part (digital)booleanfalse
offsetadds the offset in minutes to UTCnumber of minutes0

Methods

NameDescription
stop()stops the clock
restart()sets the clock to the current time and starts ticking again

Events

NameTriggeredDetails
tickwhen the second or the minute hand movescurrent Date

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Lint and test your code using npm test.

License

Copyright (c) 2021-2023 Ferdinand Prantl

Licensed under the MIT license.