# @nealrame/react-clock

> An analog clock for your React application.

Latest version **1.0.1** (published 2022-08-10) · MIT license · 0 weekly downloads

## Install

```sh
npm install @nealrame/react-clock
pnpm add @nealrame/react-clock
yarn add @nealrame/react-clock
bun add @nealrame/react-clock
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.1 |
| Published | 2022-08-10 |
| First published | 2022-08-07 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 14.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Julien Graziano |
| Maintainers | nealrame |
| Keywords | analog clock, clock, react, time |

## Links

- npm: https://www.npmjs.com/package/@nealrame/react-clock
- Repository: https://github.com/NealRame/react-clock
- Homepage: https://github.com/NealRame/react-clock#readme
- Issues: https://github.com/NealRame/react-clock/issues
- npm.io page: https://npm.io/package/@nealrame/react-clock

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 1.0.1 (latest) — 2022-08-10
- 1.0.0 — 2022-08-09
- 0.1.3 — 2022-08-09
- 0.1.2 — 2022-08-09
- 0.1.1 — 2022-08-08
- 0.1.0 — 2022-08-07

## README

# React Clock

An analog clock for your [_React_](https://reactjs.org) application.

## Installation

```sh
> npm install @nealrame/react-clock
```

## Usage

```jsx
import * as React from "react"

import Clock from "@neal-rame/react-clock"

const app = () => {
    const [date, setDate] = React.useState(new Date())

    React.useEffect(() => {
        const interval = setInterval(() => {
            setDate(new Date())
        }, 1000)
        return () => clearInterval(interval)
    })

    return <Clock date={ date } />
}
```

## Customization

### size
Use this property to change the size of the clock.

#### example
```jsx
const app = () => {
    return <Clock date={ new Date() } size={ 200 } />
}
```

### backgroundColor
Use this property to change the background color of the clock. Accept a string
parsed as CSS <[color](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value)> value.

#### example
```jsx
const app = () => {
    return <Clock
        date={ new Date() }
        backgroundColor={ "#fddd9c" }
    />
}
```

<p align="center"><img src="./docs/images/background_color.png"/></p>

### borderColor
Use this property to change the border color of the clock. Accept a string
parsed as CSS <[color](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value)> value.

#### example
```jsx
const app = () => {
    return <Clock
        date={ new Date() }
        borderColor={ "#a56ef9" }
    />
}
```

<p align="center"><img src="./docs/images/border_color.png"/></p>

### borderThickness
Use this property to change the border thickness of the clock. Accept a number.

#### example
```jsx
const app = () => {
    return <Clock
        date={ date }
        borderColor={ "#bbb" }
        borderThickness={ 18 }
    />
}
```

<p align="center"><img src="./docs/images/border_thickness.png"/></p>

### padding
Use this property to change the padding between border and marks of the clock.
Accept a number.

#### example
```jsx
const app = () => {
    return <Clock
        date={ date }
        padding={ 16 }
    />
}
```

<p align="center"><img src="./docs/images/padding.png"/></p>

### hourHandColor
### minuteHandColor
### secondHandColor
Use this properties to change the color of respectively hour, minute and
second hand. Accept a string parsed as CSS <[color](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value)> value.

#### example
```jsx
const app = () => {
    return <Clock
        date={ date }
        hourHandColor={ "#02b701" }
        minuteHandColor={ "#a56ef9" }
        secondHandColor={ "#37a1ff" }
    />
}
```

<p align="center"><img src="./docs/images/hand_color.png"/></p>

### hourHandRadius
### minuteHandRadius
### secondHandRadius
Use this properties to change the radius of respectively hour, minute and
second hand. Accept number.

#### example
```jsx
const app = () => {
    return <Clock
        date={ date }
        hourHandRadius={ 16 }
        minuteHandRadius={ 16 }
        secondHandRadius={ 16 }
    />
}
```

<p align="center"><img src="./docs/images/hand_radius.png"/></p>

### hourHandSize
### minuteHandSize
### secondHandSize
Use this property to change the size of the hour hand. Accept a number.

#### example
```jsx
const app = () => {
    return <Clock
        date={ date }
        hourHandSize={ 40 }
        minuteHandSize={ 64 }
        secondHandSize={ 72 }
    />
}
```

<p align="center"><img src="./docs/images/hand_size.png"/></p>

### hourHandTailSize
### minuteHandTailSize
### secondHandTailSize
Use this property to change the size of the tail of respectively hour, minute
and hand. Accept a number.

#### example
```jsx
const app = () => {
    return <Clock
        date={ date }
        hourHandTailSize={ 16 }
        minuteHandTailSize={ 16 }
        secondHandTailSize={ 16 }
    />
}
```

<p align="center"><img src="./docs/images/hand_tail_size.png"/></p>

### hourHandThickness
### minuteHandThickness
### secondHandThickness
Use this property to change the thickness of respectively hour, minute and
second hand. Accept a number.

#### example
```jsx
const app = () => {
    return <Clock
        date={ date }
        hourHandThickness={ 14 }
        minuteHandThickness={ 10 }
        secondHandThickness={ 2 }
    />
}
```

<p align="center"><img src="./docs/images/hand_thickness.png"/></p>

### hourMarkerColor
### minuteMarkerColor
Use this property to change the color of respectively hour and minute markers.
Accept a string parsed as CSS <[color](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value)> value.

#### example
```jsx
const app = () => {
    return <Clock
        date={ date }
        hourMarkerColor={ "#a56ef9" }
        minuteMarkerColor={ "#01aaba" }
    />
}
```

<p align="center"><img src="./docs/images/markers_color.png"/></p>

### hourMarkerSize
### minuteMarkerSize
Use this property to change the size of respectively hour and minute markers.
Accept number.

#### example
```jsx
const app = () => {
    return <Clock
        date={ date }
        hourMarkerSize={ 16 }
        minuteMarkerSize={ 10 }
    />
}
```

<p align="center"><img src="./docs/images/markers_size.png"/></p>

### hourMarkerThickness
### minuteMarkerThickness
Use this property to change the thickness of respectively hour and minute
markers. Accept number.

#### example
```jsx
const app = () => {
    return <Clock
        date={ date }
        hourMarkerThickness={ 2 }
        minuteMarkerThickness={ 1 }
    />
}
```

<p align="center"><img src="./docs/images/markers_thickness.png"/></p>

---
_Source: https://npm.io/package/@nealrame/react-clock · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
