2.0.0 • Published 3 years ago

react-piano-keyboard v2.0.0

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

react-piano-keyboard

概要

クリックで演奏できる ピアノ鍵盤の React コンポーネントです。

スタイルは全くあたっていないので、ご自身でスタイリングしてください。

使い方

インストール

yarn add react-piano-keyboard

鍵盤を表示する

import Keyboard from 'react-piano-keyboard';

function App() {
  return (
    <Keyboard
      keyboardWidth={400}
      classKeyboard={'classKeyboard'}
      classWhiteKeys={'classWhiteKeys'}
      classWhiteKey={'classWhiteKey'}
      classBlackKeys={'classBlackKeys'}
      classBlackKey={'classBlackKey'}
      noteSounds={soudObjects}
    />
  );
}

キーを強調する

<Keyboard
  keyboardWidth={400}
  classKeyboard={'classKeyboard'}
  classWhiteKeys={'classWhiteKeys'}
  classWhiteKey={'classWhiteKey'}
  classBlackKeys={'classBlackKeys'}
  classBlackKey={'classBlackKey'}
  noteSounds={soudObjects}
  classActiveKey={'classActiveKey'}
  activeKeys={['C0', 'E0', 'G0']}
/>

Props

props 名説明
keyboardWidth必須 number鍵盤全体の幅を指定してください。
classKeyboard必須 string鍵盤全体のclassNameを指定してください。
classWhiteKeys必須 string白鍵全体のclassNameを指定してください。
classWhiteKey必須 string白鍵一つ一つのclassNameを指定してください。
classBlackKeys必須 string黒鍵全体のclassNameを指定してください。
classBlackKey必須 string黒鍵一つ一つのclassNameを指定してください。
noteSounds必須 { [keyName: string]: HTMLAudioElement }キーのクリック時に再生するHTMLAudioElementを指定してください。
classActiveKey任意 string強調したいキーがある場合、そのclassNameを指定してください。
activeKeys任意 string[]強調したいキーがある場合、keyNameを指定してください。(C3, A6, Eb2, etc...)
keyScale任意 number鍵盤のスケールを指定してください。初期値は0です。

keyName

#(シャープ)は使えません。代わりにb(フラット)を使ってください。

C# == Db
D# == Eb
F# == Gb
G# == Ab
A# == Bb

音源について

GitHub リポジトリ./src/public/audioにてピアノの音源を配布しています。

ピアノ以外の音源で演奏することも可能です。