Rythm.js
v2.2.5 - A lot of new dances !
العرض التوضيحي في: https://okazari.github.io/rythm.js/
مكتبة JavaScript التي تصنع رقص صفحتك.
التثبيت مع NPM:
npm install rythm.jsأو الحصول على CDN:
https://unpkg.com/rythm.js/
https://cdnjs.cloudflare.com/ajax/libs/rythm.js/2.2.6/rythm.min.js
استيراد Rythm في صفحتك:
< script type =" text/javascript " src =" /path/to/rythm.min.js " > </ script >أضف إحدى فصول Rythm CSS للإشارة إلى العنصر الذي سيرقص:
< div class =" rythm-bass " > </ div >قم بإنشاء كائن Rythm واعطه عنوان URL الخاص بك ، ثم استخدم وظيفة START:
var rythm = new Rythm ( )
rythm . setMusic ( 'path/to/sample.mp3' )
rythm . start ( ) import Rythm from 'rythm.js'
const rythm = new Rythm ( )
rythm . setMusic ( 'path/to/sample.mp3' )
rythm . start ( ) const rythm = new Rythm ( )
/* The starting scale is the minimum scale your element will take (Scale ratio is startingScale + (pulseRatio * currentPulse)).
* Value in percentage between 0 and 1
* Default: 0.75
*/
rythm . startingScale = value
/* The pulse ratio is be the maximum additional scale your element will take (Scale ratio is startingScale + (pulseRatio * currentPulse)).
* Value in percentage between 0 and 1
* Default: 0.30
*/
rythm . pulseRatio = value
/* The max value history represent the number of passed value that will be stored to evaluate the current pulse.
* Int value, minimum 1
* Default: 100
*/
rythm . maxValueHistory = value
/* Set the music the page will dance to
* @audioUrl: '../example/mysong.mp3'
*/
rythm . setMusic ( audioUrl )
/* Used to collaborate with other players library.
* You can connect Rythm to an audioElement, and then control the audio with your other player
*/
rythm . connectExternalAudioElement ( audioElement )
/* Adjust audio gain
* @value: Number
*/
rythm . setGain ( value )
/* Add your own rythm-class
* @elementClass: Class that you want to link your rythm to
* @danceType: Use any of the built-in effect or give your own function
* @startValue: The starting frequency of your rythm
* @nbValue: The number of frequency of your rythm
* 1024 Frequencies, your rythm will react to the average of your selected frequencies.
* Examples: bass 0-10 ; medium 150-40 ; high 500-100
*/
rythm . addRythm ( elementClass , danceType , startValue , nbValue )
/* Plug your computer microphone to rythm.js.
* This function returns a Promise object that is resolved when the microphone is up.
* Require your website to be run in HTTPS
*/
rythm . plugMicrophone ( ) . then ( function ( ) { ... } )
// Let's dance
rythm . start ( )
/* Stop the party
* @freeze: Set this to true if you want to prevent the elements to reset to their initial position
*/
rythm . stop ( freeze ) يمكنك استخدام وظيفة addRythm لجعل الفصول الخاصة بك تستمع إلى ترددات محددة. إليك كيفية إنشاء فصول الأساسيات:
addRythm('rythm-bass', 'pulse', 0, 10)addRythm('rythm-medium', 'pulse', 150, 40)addRythm('rythm-high', 'pulse', 500, 100) لمزيد من التحكم في أنواع الرقص ، يمكنك إعطاء كائن تكوين كوسيطة أخيرة لـ addRythm :
addRythm ( 'rythm-high' , 'shake' , 500 , 100 , { direction : 'left' , min : 20 , max : 300 } )فيما يلي الرقصات المدمجة وخياراتها:
transform: scale() . الافتراضي: 0.75transform: scale() . الافتراضي: 1.25transform: translateY() . الافتراضي: 0transform: translateY() . الافتراضي: 30transform: translateX() . الافتراضي: -15transform: translateX() . الافتراضي: 15left للحركة اليمنى إلى اليسار ، right للحركة اليمنى إلى اليمين. الافتراضي: righttransform: rotate() . الافتراضي: -20transform: rotate() . الافتراضي: 20left للحركة اليمنى إلى اليسار ، right للحركة اليمنى إلى اليمين. الافتراضي: rightopacity . الافتراضي: 0opacity . الافتراضي: 1false (أعلى النبض ، كلما كان الأمر أكثر وضوحًا)[0,0,0][255,255,255][0,0,0][255,255,255]border-radius . الافتراضي: 0border-radius . الافتراضي: 25falsefilter: blur() . الافتراضي: 0filter: blur() . الافتراضي: 8falseup أو down . الافتراضي: downright أو left . الافتراضي: right20letter-spacing . الافتراضي: 0letter-spacing . الافتراضي: 25false[0,0,0][255,255,255]border-width . الافتراضي: 0border-width . الافتراضي: 5font-width . الافتراضي: 0.8font-width . الافتراضي: 1.2tilt . الافتراضي: 20tilt . الافتراضي: 25false[0,0,0][255,255,255]لرؤية كل تأثير مرئي ، يمكنك الذهاب إلى العرض التوضيحي.
إذا كنت ترغب في استخدام نوع الرقص الخاص بك ، فأنت بحاجة إلى إعطاء كائن كوسيلة ثاني لـ addRythm بدلاً من مفتاح الرقص المدمج.
يجب أن يكون لهذا الكائن خصائصان:
/* The custom function signature is
* @elem: The HTML element target you want to apply your effect to
* @value: The current pulse ratio (percentage between 0 and 1)
* @options: The option object user can give as last argument of addRythm function
*/
const pulse = ( elem , value , options = { } ) => {
const max = options . max || 1.25
const min = options . min || 0.75
const scale = ( max - min ) * value
elem . style . transform = `scale( ${ min + scale } )`
}
/* The reset function signature is
* @elem: The element to reset
*/
const resetPulse = elem => {
elem . style . transform = ''
}
addRythm ( 'my-css-class' , { dance : pulse , reset : resetPulse } , 150 , 40 )سيتم تقدير أي طلب سحب. يمكنك البدء في الترميز في هذا المشروع باتباع هذه الخطوات:
npm installnpm start في المجلد الرئيسي لبدء تشغيل خادم ويب تطويرفي v2.2.x إضافة نوع رقص جديد أمر سهل للغاية:
srcdances على سبيل المثال ، إليك محتوى ملف jump.js :
/* The function signature is
* @elem: The HTML element target you want to apply your effect to
* @value: The current pulse ratio (percentage between 0 and 1)
* @options: The option object user can give as last argument of addRythm function
*/
export default ( elem , value , options = { } ) => {
const max = options . max || 30
const min = options . min || 0
const jump = ( max - min ) * value
elem . style . transform = `translateY( ${ - jump } px)`
}
/* The reset function signature is
* @elem: The element to reset
*/
export const reset = elem => {
elem . style . transform = ''
}Dancer.js : import jump , { reset as resetJump } from './dances/jump.js'
class Dancer {
constructor ( ) {
this . registerDance ( 'jump' , jump , resetJump )
}
}الترخيص: GNU GPL
المؤلف: @أوكازاريبز
