1.1.1 • Published 2 years ago

react-frequency v1.1.1

Weekly downloads
-
License
MIT
Repository
github
Last release
2 years ago

react-frequency

A simple React component and hook which emits a frequency generated thanks to the AudioContext API of JavaScript !

Live Demo

img

Installation

npm

npm install react-frequency

yarn

yarn add react-frequency

Usage

Hook

import React from 'react';
import { useFrequency } from 'react-frequency';

const App = () => {
  const { toggle, start, stop, playing } = useFrequency({
    hz: 174,
    type: "center",
    gain: 1,
    oscillator: "sine"
  })

  return (
    <div>
      <h1>playing: { playing ? 'true' : 'false' }</h1>
    
      <button onClick={toggle}>toggle</button>
      
      <button onClick={start}>start</button>
      <button onClick={stop}>stop</button>
    </div>
  )
};

The useFrequency hook return 3 functions and 1 boolean :

functions
  • toggle: start and stop the frequency
  • start: start the frequency
  • stop: stop the frequency
boolean
  • playing: reading state of the frequency

Component

import React from 'react';
import { Frequency } from 'react-frequency';

const App = () => (
  <Frequency
    hz={174}
    type="center"
    gain={1}
    oscillator="sine"
  />
);

The component does not return any elements and emits automatically the frequency.

Props

The only props required is hz.

NameDefaultDescription
hzrequirednumberThe frequency corresponds to the number of vibrations per second.The human ear hears values ranging from 20Hz to 20,000Hz
typenot required"center"The type defines from which side the sound will come out.Values can be "left", "center" or "right"
gainnot required1The gain defines the ability to increase the strength of a signal.Value is float between 0 and 1
oscillatornot required"sine"It specifies what shape of waveform the oscillator will output.Values can be "sine", "square", "sawtooth" or "triangle"

A complete exemple is available in the Live Demo

1.1.1

2 years ago

1.1.0

2 years ago

1.0.19

2 years ago

1.0.17

2 years ago

1.0.16

2 years ago

1.0.15

2 years ago

1.0.14

2 years ago

1.0.13

2 years ago

1.0.12

2 years ago

1.0.11

2 years ago

1.0.10

2 years ago

1.0.9

2 years ago

1.0.8

2 years ago

1.0.7

2 years ago

1.0.6

2 years ago

1.0.5

2 years ago

1.0.4

2 years ago

1.0.3

2 years ago

1.0.2

2 years ago

1.0.1

2 years ago

1.0.0

2 years ago