use-viewport-width/README.md

React hook that returns pixel values for viewport width percentages, updating on resize.

## Install with NPM

```
npm i use-viewport-width
```
## Parameter

| Name        | Type     | Description |
|------------|---------|---------|
| `percentage` | `number` | The percentage of the viewport width to calculate. The hook returns this percentage of the current viewport width in **pixels**. For example, `50` will return 50% of the viewport width. |

## Usage

```typescript
import useVW from 'use-viewport-width'

const w = useVW(100) // 100% of the viewport width in pixels
```

## Example

```typescript
import useVW from "use-viewport-width"

function Box() {
  const w = useVW(50) // 50% of viewport width

  return (
    <div style={{ width: `${w}px`, background: "blue", height: "100px" }}>
      responsive box - width: {w}px
    </div>
  )
}
```