react-meter-chart
React component to render an element very much like an HTML <meter>. Basically a reason to improve the answer from a stackoverflow question.
See the demo.
Getting Started
First install react-meter-chart:
npm install react-meter-chartNext include it in your React app:
import React from 'react'
import { createRoot } from 'react-dom/client'
import { MeterChart } from 'react-meter-chart'
const root = createRoot(document.getElementById('root'))
root.render(
<main>
<MeterChart value={50} low={35} high={65} />
</main>
)Example
Check out the demo at https://morganney.github.io/react-meter-chart.
CDN with Import Map
You can skip a build step completely by placing this inside of your Vite project's dist directory to quickly preview with vite preview.
index.html
<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<script type="importmap">
{
"imports": {
"react": "https://esm.sh/react",
"react-dom/": "https://esm.sh/react-dom/",
"styled-components": "https://esm.sh/styled-components",
"react-meter-chart": "https://esm.sh/react-meter-chart",
"htm/": "https://esm.sh/htm/"
}
}
</script>
<title>CDN with Import Map: react-meter-chart</title>
</head>
<body>
<div id="root"></div>
<script type="module">
import { createRoot } from 'react-dom/client'
import { MeterChart } from 'react-meter-chart'
import { html } from 'htm/react'
createRoot(document.getElementById('root')).render(
html`
<${MeterChart} value=${50} low=${45} high=${65} />
`
)
</script>
</body>
</html>Now navigate to http://localhost:4173.
Build
To use it with a transpiler or bundler just import the component from this package. For instance, to use it with a new Vite project after scaffolding, change the file src/App.tsx:
src/App.tsx
import { MeterChart } from 'react-meter-chart'
function App() {
return (
<main>
<MeterChart value={50} low={35} high={65} />
</main>
)
}
export default AppAlso, remove the default styles from src/main.tsx:
import React from 'react'
import ReactDOM from 'react-dom/client'
import App from './App.tsx'
-import './index.css'
ReactDOM.createRoot(document.getElementById('root')!).render(
<React.StrictMode>
<App />
</React.StrictMode>,
)Now run vite build followed by vite preview.
Props
It accepts props very much like the HTML <meter> element attributes.
interface MeterChartProps {
value: number
min?: number
max?: number
low?: number
high?: number
size?: Size
scale?: number
colors?: Colors
showBoundsLabel?: boolean
}
interface Colors {
dot?: string
bounds?: string
range?: string
label?: string
}
type Size = 'small' | 'medium' | 'large'