1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743574457455746574757485749575057515752575357545755575657575758575957605761576257635764576557665767576857695770577157725773577457755776577757785779578057815782578357845785578657875788578957905791579257935794579557965797579857995800580158025803580458055806580758085809581058115812581358145815581658175818581958205821582258235824582558265827582858295830583158325833583458355836583758385839584058415842584358445845584658475848584958505851585258535854585558565857585858595860586158625863586458655866586758685869587058715872587358745875587658775878587958805881588258835884588558865887588858895890589158925893589458955896589758985899590059015902590359045905590659075908590959105911591259135914591559165917591859195920592159225923592459255926592759285929593059315932593359345935593659375938593959405941594259435944594559465947594859495950595159525953595459555956595759585959596059615962596359645965596659675968596959705971597259735974597559765977597859795980598159825983598459855986598759885989599059915992599359945995599659975998599960006001 |
- /**
- * @license Highcharts JS v7.0.2 (2019-01-17)
- * Annotations module
- *
- * (c) 2009-2019 Torstein Honsi
- *
- * License: www.highcharts.com/license
- */
- 'use strict';
- (function (factory) {
- if (typeof module === 'object' && module.exports) {
- factory['default'] = factory;
- module.exports = factory;
- } else if (typeof define === 'function' && define.amd) {
- define(function () {
- return factory;
- });
- } else {
- factory(typeof Highcharts !== 'undefined' ? Highcharts : undefined);
- }
- }(function (Highcharts) {
- var eventEmitterMixin = (function (H) {
- /**
- * It provides methods for:
- * - adding and handling DOM events and a drag event,
- * - mapping a mouse move event to the distance between two following events.
- * The units of the distance are specific to a transformation,
- * e.g. for rotation they are radians, for scaling they are scale factors.
- *
- * @mixin
- * @memberOf Annotation
- */
- var eventEmitterMixin = {
- /**
- * Add emitter events.
- */
- addEvents: function () {
- var emitter = this;
- H.addEvent(
- emitter.graphic.element,
- 'mousedown',
- function (e) {
- emitter.onMouseDown(e);
- }
- );
- H.objectEach(emitter.options.events, function (event, type) {
- var eventHandler = function (e) {
- if (type !== 'click' || !emitter.cancelClick) {
- event.call(
- emitter,
- emitter.chart.pointer.normalize(e),
- emitter.target
- );
- }
- };
- if (type !== 'drag') {
- emitter.graphic.on(type, eventHandler);
- } else {
- H.addEvent(emitter, 'drag', eventHandler);
- }
- });
- if (emitter.options.draggable) {
- H.addEvent(emitter, 'drag', emitter.onDrag);
- if (!emitter.graphic.renderer.styledMode) {
- emitter.graphic.css({
- cursor: {
- x: 'ew-resize',
- y: 'ns-resize',
- xy: 'move'
- }[emitter.options.draggable]
- });
- }
- }
- },
- /**
- * Remove emitter document events.
- */
- removeDocEvents: function () {
- if (this.removeDrag) {
- this.removeDrag = this.removeDrag();
- }
- if (this.removeMouseUp) {
- this.removeMouseUp = this.removeMouseUp();
- }
- },
- /**
- * Mouse down handler.
- *
- * @param {Object} e event
- */
- onMouseDown: function (e) {
- var emitter = this,
- pointer = emitter.chart.pointer,
- prevChartX,
- prevChartY;
- // On right click, do nothing:
- if (e.button === 2) {
- return;
- }
- e.stopPropagation();
- e = pointer.normalize(e);
- prevChartX = e.chartX;
- prevChartY = e.chartY;
- emitter.cancelClick = false;
- emitter.removeDrag = H.addEvent(
- H.doc,
- 'mousemove',
- function (e) {
- emitter.hasDragged = true;
- e = pointer.normalize(e);
- e.prevChartX = prevChartX;
- e.prevChartY = prevChartY;
- H.fireEvent(emitter, 'drag', e);
- prevChartX = e.chartX;
- prevChartY = e.chartY;
- }
- );
- emitter.removeMouseUp = H.addEvent(
- H.doc,
- 'mouseup',
- function (e) {
- emitter.cancelClick = emitter.hasDragged;
- emitter.hasDragged = false;
- emitter.onMouseUp(e);
- }
- );
- },
- /**
- * Mouse up handler.
- *
- * @param {Object} e event
- */
- onMouseUp: function () {
- var chart = this.chart,
- annotation = this.target || this,
- annotationsOptions = chart.options.annotations,
- index = chart.annotations.indexOf(annotation);
- this.removeDocEvents();
- annotationsOptions[index] = annotation.options;
- },
- /**
- * Drag and drop event. All basic annotations should share this
- * capability as well as the extended ones.
- *
- * @param {Object} e event
- */
- onDrag: function (e) {
- if (
- this.chart.isInsidePlot(
- e.chartX - this.chart.plotLeft,
- e.chartY - this.chart.plotTop
- )
- ) {
- var translation = this.mouseMoveToTranslation(e);
- if (this.options.draggable === 'x') {
- translation.y = 0;
- }
- if (this.options.draggable === 'y') {
- translation.x = 0;
- }
- if (this.points.length) {
- this.translate(translation.x, translation.y);
- } else {
- this.shapes.forEach(function (shape) {
- shape.translate(translation.x, translation.y);
- });
- this.labels.forEach(function (label) {
- label.translate(translation.x, translation.y);
- });
- }
- this.redraw(false);
- }
- },
- /**
- * Map mouse move event to the radians.
- *
- * @param {Object} e event
- * @param {number} cx center x
- * @param {number} cy center y
- */
- mouseMoveToRadians: function (e, cx, cy) {
- var prevDy = e.prevChartY - cy,
- prevDx = e.prevChartX - cx,
- dy = e.chartY - cy,
- dx = e.chartX - cx,
- temp;
- if (this.chart.inverted) {
- temp = prevDx;
- prevDx = prevDy;
- prevDy = temp;
- temp = dx;
- dx = dy;
- dy = temp;
- }
- return Math.atan2(dy, dx) - Math.atan2(prevDy, prevDx);
- },
- /**
- * Map mouse move event to the distance between two following events.
- *
- * @param {Object} e event
- */
- mouseMoveToTranslation: function (e) {
- var dx = e.chartX - e.prevChartX,
- dy = e.chartY - e.prevChartY,
- temp;
- if (this.chart.inverted) {
- temp = dy;
- dy = dx;
- dx = temp;
- }
- return {
- x: dx,
- y: dy
- };
- },
- /**
- * Map mouse move to the scale factors.
- *
- * @param {Object} e event
- * @param {number} cx center x
- * @param {number} cy center y
- **/
- mouseMoveToScale: function (e, cx, cy) {
- var prevDx = e.prevChartX - cx,
- prevDy = e.prevChartY - cy,
- dx = e.chartX - cx,
- dy = e.chartY - cy,
- sx = (dx || 1) / (prevDx || 1),
- sy = (dy || 1) / (prevDy || 1),
- temp;
- if (this.chart.inverted) {
- temp = sy;
- sy = sx;
- sx = temp;
- }
- return {
- x: sx,
- y: sy
- };
- },
- /**
- * Destroy the event emitter.
- */
- destroy: function () {
- this.removeDocEvents();
- H.removeEvent(this);
- this.hcEvents = null;
- }
- };
- return eventEmitterMixin;
- }(Highcharts));
- var ControlPoint = (function (H, eventEmitterMixin) {
- /**
- * A control point class which is a connection between controllable
- * transform methods and a user actions.
- *
- * @constructor
- * @mixes eventEmitterMixin
- * @memberOf Annotation
- *
- * @param {Highcharts.Chart} chart a chart instance
- * @param {Object} target a controllable instance which is a target for
- * a control point
- * @param {Annotation.ControlPoint.Options} options an options object
- * @param {number} [index]
- **/
- function ControlPoint(chart, target, options, index) {
- this.chart = chart;
- this.target = target;
- this.options = options;
- this.index = H.pick(options.index, index);
- }
- /**
- * @typedef {Object} Annotation.ControlPoint.Position
- * @property {number} x
- * @property {number} y
- */
- /**
- * @callback Annotation.ControlPoint.Positioner
- * @param {Object} e event
- * @param {Controllable} target
- * @return {Annotation.ControlPoint.Position} position
- */
- /**
- * @typedef {Object} Annotation.ControlPoint.Options
- * @property {string} symbol
- * @property {number} width
- * @property {number} height
- * @property {Object} style
- * @property {boolean} visible
- * @property {Annotation.ControlPoint.Positioner} positioner
- * @property {Object} events
- */
- H.extend(
- ControlPoint.prototype,
- eventEmitterMixin
- );
- /**
- * Set the visibility.
- *
- * @param {boolean} [visible]
- **/
- ControlPoint.prototype.setVisibility = function (visible) {
- this.graphic.attr('visibility', visible ? 'visible' : 'hidden');
- this.options.visible = visible;
- };
- /**
- * Render the control point.
- */
- ControlPoint.prototype.render = function () {
- var chart = this.chart,
- options = this.options;
- this.graphic = chart.renderer
- .symbol(
- options.symbol,
- 0,
- 0,
- options.width,
- options.height
- )
- .add(chart.controlPointsGroup)
- .css(options.style);
- this.setVisibility(options.visible);
- this.addEvents();
- };
- /**
- * Redraw the control point.
- *
- * @param {boolean} [animation]
- */
- ControlPoint.prototype.redraw = function (animation) {
- this.graphic[animation ? 'animate' : 'attr'](
- this.options.positioner.call(this, this.target)
- );
- };
- /**
- * Destroy the control point.
- */
- ControlPoint.prototype.destroy = function () {
- eventEmitterMixin.destroy.call(this);
- if (this.graphic) {
- this.graphic = this.graphic.destroy();
- }
- this.chart = null;
- this.target = null;
- this.options = null;
- };
- /**
- * Update the control point.
- */
- ControlPoint.prototype.update = function (userOptions) {
- var chart = this.chart,
- target = this.target,
- index = this.index,
- options = H.merge(true, this.options, userOptions);
- this.destroy();
- this.constructor(chart, target, options, index);
- this.render(chart.controlPointsGroup);
- this.redraw();
- };
- return ControlPoint;
- }(Highcharts, eventEmitterMixin));
- var MockPoint = (function (H) {
- /**
- * A point-like object, a mock point or a point uses in series.
- *
- * @typedef {Highcharts.Point | Annotation.MockPoint} Annotation.PointLike
- */
- /**
- * A mock point configuration.
- *
- * @typedef {Object} Annotation.MockPoint.Options
- * @property {number} x x value for the point in xAxis scale or pixels
- * @property {number} y y value for the point in yAxis scale or pixels
- * @property {string|number|Highcharts.Axis} [xAxis] xAxis instance, index or id
- * @property {string|number|Highcharts.Axis} [yAxis] yAxis instance, index or id
- */
- /**
- * A trimmed point object which imitates {@link Highchart.Point} class.
- * It is created when there is a need of pointing to some chart's position
- * using axis values or pixel values
- *
- * @class
- * @memberOf Annotation
- *
- * @param {Chart} chart a chart instance
- * @param {Controllable} [target] a controllable instance
- * @param {Annotation.MockPoint.Options} options an options object
- */
- function MockPoint(chart, target, options) {
- /**
- * A mock series instance imitating a real series from a real point.
- *
- * @type {Object}
- * @property {boolean} series.visible=true - whether a series is visible
- * @property {Chart} series.chart - a chart instance
- * @property {function} series.getPlotBox
- */
- this.series = {
- visible: true,
- chart: chart,
- getPlotBox: H.Series.prototype.getPlotBox
- };
- /**
- * @type {?Controllable}
- */
- this.target = target || null;
- /**
- * Options for the mock point.
- *
- * @type {Annotation.MockPoint.Options}
- */
- this.options = options;
- /**
- * If an xAxis is set it represents the point's value in terms of the xAxis.
- *
- * @name Annotation.MockPoint#x
- * @type {?number}
- */
- /**
- * If an yAxis is set it represents the point's value in terms of the yAxis.
- *
- * @name Annotation.MockPoint#y
- * @type {?number}
- */
- /**
- * It represents the point's pixel x coordinate relative to its plot box.
- *
- * @name Annotation.MockPoint#plotX
- * @type {?number}
- */
- /**
- * It represents the point's pixel y position relative to its plot box.
- *
- * @name Annotation.MockPoint#plotY
- * @type {?number}
- */
- /**
- * Whether the point is inside the plot box.
- *
- * @name Annotation.MockPoint#isInside
- * @type {boolean}
- */
- this.applyOptions(this.getOptions());
- }
- /**
- * Create a mock point from a real Highcharts point.
- *
- * @param {Point} point
- *
- * @return {Annotation.MockPoint} a mock point instance.
- */
- MockPoint.fromPoint = function (point) {
- return new MockPoint(point.series.chart, null, {
- x: point.x,
- y: point.y,
- xAxis: point.series.xAxis,
- yAxis: point.series.yAxis
- });
- };
- /**
- * @typedef Annotation.MockPoint.Position
- * @property {number} x
- * @property {number} y
- */
- /**
- * Get the pixel position from the point like object.
- *
- * @param {Annotation.PointLike} point
- * @param {boolean} [paneCoordinates]
- * whether the pixel position should be relative
- *
- * @return {Annotation.MockPoint.Position} pixel position
- */
- MockPoint.pointToPixels = function (point, paneCoordinates) {
- var series = point.series,
- chart = series.chart,
- x = point.plotX,
- y = point.plotY,
- plotBox;
- if (chart.inverted) {
- if (point.mock) {
- x = point.plotY;
- y = point.plotX;
- } else {
- x = chart.plotWidth - point.plotY;
- y = chart.plotHeight - point.plotX;
- }
- }
- if (series && !paneCoordinates) {
- plotBox = series.getPlotBox();
- x += plotBox.translateX;
- y += plotBox.translateY;
- }
- return {
- x: x,
- y: y
- };
- };
- /**
- * Get fresh mock point options from the point like object.
- *
- * @param {Annotation.PointLike} point
- *
- * @return {Annotation.MockPoint.Options} mock point's options
- */
- MockPoint.pointToOptions = function (point) {
- return {
- x: point.x,
- y: point.y,
- xAxis: point.series.xAxis,
- yAxis: point.series.yAxis
- };
- };
- H.extend(MockPoint.prototype, /** @lends Annotation.MockPoint# */ {
- /**
- * A flag indicating that a point is not the real one.
- *
- * @type {boolean}
- * @default true
- */
- mock: true,
- /**
- * Check if the point has dynamic options.
- *
- * @return {boolean} A positive flag if the point has dynamic options.
- */
- hasDynamicOptions: function () {
- return typeof this.options === 'function';
- },
- /**
- * Get the point's options.
- *
- * @return {Annotation.MockPoint.Options} the mock point's options.
- */
- getOptions: function () {
- return this.hasDynamicOptions() ?
- this.options(this.target) :
- this.options;
- },
- /**
- * Apply options for the point.
- *
- * @param {Annotation.MockPoint.Options} options
- */
- applyOptions: function (options) {
- this.command = options.command;
- this.setAxis(options, 'x');
- this.setAxis(options, 'y');
- this.refresh();
- },
- /**
- * Set x or y axis.
- *
- * @param {Annotation.MockPoint.Options} options
- * @param {string} xOrY 'x' or 'y' string literal
- */
- setAxis: function (options, xOrY) {
- var axisName = xOrY + 'Axis',
- axisOptions = options[axisName],
- chart = this.series.chart;
- this.series[axisName] =
- axisOptions instanceof H.Axis ?
- axisOptions :
- H.defined(axisOptions) ?
- chart[axisName][axisOptions] || chart.get(axisOptions) :
- null;
- },
- /**
- * Transform the mock point to an anchor
- * (relative position on the chart).
- *
- * @return {Array<number>} A quadruple of numbers which denotes x, y,
- * width and height of the box
- **/
- toAnchor: function () {
- var anchor = [this.plotX, this.plotY, 0, 0];
- if (this.series.chart.inverted) {
- anchor[0] = this.plotY;
- anchor[1] = this.plotX;
- }
- return anchor;
- },
- /**
- * @typedef {Object} Annotation.MockPoint.LabelConfig
- * @property {number|undefined} x x value translated to x axis scale
- * @property {number|undefined} y y value translated to y axis scale
- * @property {Annotation.MockPoint} point instance of the point
- */
- /**
- * Returns a label config object -
- * the same as Highcharts.Point.prototype.getLabelConfig
- *
- * @return {Annotation.MockPoint.LabelConfig} the point's label config
- */
- getLabelConfig: function () {
- return {
- x: this.x,
- y: this.y,
- point: this
- };
- },
- /**
- * Check if the point is inside its pane.
- *
- * @return {boolean} A flag indicating whether the point is inside the pane.
- */
- isInsidePane: function () {
- var plotX = this.plotX,
- plotY = this.plotY,
- xAxis = this.series.xAxis,
- yAxis = this.series.yAxis,
- isInside = true;
- if (xAxis) {
- isInside = H.defined(plotX) && plotX >= 0 && plotX <= xAxis.len;
- }
- if (yAxis) {
- isInside =
- isInside &&
- H.defined(plotY) &&
- plotY >= 0 && plotY <= yAxis.len;
- }
- return isInside;
- },
- /**
- * Refresh point values and coordinates based on its options.
- */
- refresh: function () {
- var series = this.series,
- xAxis = series.xAxis,
- yAxis = series.yAxis,
- options = this.getOptions();
- if (xAxis) {
- this.x = options.x;
- this.plotX = xAxis.toPixels(options.x, true);
- } else {
- this.x = null;
- this.plotX = options.x;
- }
- if (yAxis) {
- this.y = options.y;
- this.plotY = yAxis.toPixels(options.y, true);
- } else {
- this.y = null;
- this.plotY = options.y;
- }
- this.isInside = this.isInsidePane();
- },
- /**
- * Translate the point.
- *
- * @param {number} [cx] origin x transformation
- * @param {number} [cy] origin y transformation
- * @param {number} dx translation for x coordinate
- * @param {number} dy translation for y coordinate
- **/
- translate: function (cx, cy, dx, dy) {
- if (!this.hasDynamicOptions()) {
- this.plotX += dx;
- this.plotY += dy;
- this.refreshOptions();
- }
- },
- /**
- * Scale the point.
- *
- * @param {number} cx origin x transformation
- * @param {number} cy origin y transformation
- * @param {number} sx scale factor x
- * @param {number} sy scale factor y
- */
- scale: function (cx, cy, sx, sy) {
- if (!this.hasDynamicOptions()) {
- var x = this.plotX * sx,
- y = this.plotY * sy,
- tx = (1 - sx) * cx,
- ty = (1 - sy) * cy;
- this.plotX = tx + x;
- this.plotY = ty + y;
- this.refreshOptions();
- }
- },
- /**
- * Rotate the point.
- *
- * @param {number} cx origin x rotation
- * @param {number} cy origin y rotation
- * @param {number} radians
- */
- rotate: function (cx, cy, radians) {
- if (!this.hasDynamicOptions()) {
- var cos = Math.cos(radians),
- sin = Math.sin(radians),
- x = this.plotX,
- y = this.plotY,
- tx,
- ty;
- x -= cx;
- y -= cy;
- tx = x * cos - y * sin;
- ty = x * sin + y * cos;
- this.plotX = tx + cx;
- this.plotY = ty + cy;
- this.refreshOptions();
- }
- },
- /**
- * Refresh point options based on its plot coordinates.
- */
- refreshOptions: function () {
- var series = this.series,
- xAxis = series.xAxis,
- yAxis = series.yAxis;
- this.x = this.options.x = xAxis ?
- this.options.x = xAxis.toValue(this.plotX, true) :
- this.plotX;
- this.y = this.options.y = yAxis ?
- yAxis.toValue(this.plotY, true) :
- this.plotY;
- }
- });
- return MockPoint;
- }(Highcharts));
- var controllableMixin = (function (H, ControlPoint, MockPoint) {
- /**
- * It provides methods for handling points, control points
- * and points transformations.
- *
- * @mixin
- * @memberOf Annotation
- */
- var controllableMixin = {
- /**
- * Init the controllable
- *
- * @param {Annotation} annotation - an annotation instance
- * @param {Object} options - options specific for controllable
- * @param {number} index - index of the controllable element
- **/
- init: function (annotation, options, index) {
- this.annotation = annotation;
- this.chart = annotation.chart;
- this.options = options;
- this.points = [];
- this.controlPoints = [];
- this.index = index;
- this.linkPoints();
- this.addControlPoints();
- },
- /**
- * Redirect attr usage on the controllable graphic element.
- **/
- attr: function () {
- this.graphic.attr.apply(this.graphic, arguments);
- },
- /**
- * Get the controllable's points options.
- *
- * @return {Array<PointLikeOptions>} - an array of points' options.
- *
- */
- getPointsOptions: function () {
- var options = this.options;
- return options.points || (options.point && H.splat(options.point));
- },
- /**
- * Utility function for mapping item's options
- * to element's attribute
- *
- * @param {Object} options
- * @return {Object} mapped options
- **/
- attrsFromOptions: function (options) {
- var map = this.constructor.attrsMap,
- attrs = {},
- key,
- mappedKey,
- styledMode = this.chart.styledMode;
- for (key in options) {
- mappedKey = map[key];
- if (
- mappedKey &&
- (
- !styledMode ||
- ['fill', 'stroke', 'stroke-width']
- .indexOf(mappedKey) === -1
- )
- ) {
- attrs[mappedKey] = options[key];
- }
- }
- return attrs;
- },
- /**
- * @typedef {Object} Annotation.controllableMixin.Position
- * @property {number} x
- * @property {number} y
- */
- /**
- * An object which denotes an anchor position
- *
- * @typedef Annotation.controllableMixin.AnchorPosition
- * Annotation.controllableMixin.Position
- * @property {number} height
- * @property {number} width
- */
- /**
- * An object which denots a controllable's anchor positions
- * - relative and absolute.
- *
- * @typedef {Object} Annotation.controllableMixin.Anchor
- * @property {Annotation.controllableMixin.AnchorPosition} relativePosition
- * @property {Annotation.controllableMixin.AnchorPosition} absolutePosition
- */
- /**
- * Returns object which denotes anchor position - relative and absolute.
- *
- * @param {Annotation.PointLike} point a point like object
- * @return {Annotation.controllableMixin.Anchor} a controllable anchor
- */
- anchor: function (point) {
- var plotBox = point.series.getPlotBox(),
- box = point.mock ?
- point.toAnchor() :
- H.Tooltip.prototype.getAnchor.call({
- chart: point.series.chart
- }, point),
- anchor = {
- x: box[0] + (this.options.x || 0),
- y: box[1] + (this.options.y || 0),
- height: box[2] || 0,
- width: box[3] || 0
- };
- return {
- relativePosition: anchor,
- absolutePosition: H.merge(anchor, {
- x: anchor.x + plotBox.translateX,
- y: anchor.y + plotBox.translateY
- })
- };
- },
- /**
- * Map point's options to a point-like object.
- *
- * @param {Annotation.MockPoint.Options} pointOptions point's options
- * @param {Annotation.PointLike} point a point like instance
- * @return {Annotation.PointLike|null} if the point is
- * found/set returns this point, otherwise null
- */
- point: function (pointOptions, point) {
- if (pointOptions && pointOptions.series) {
- return pointOptions;
- }
- if (!point || point.series === null) {
- if (H.isObject(pointOptions)) {
- point = new MockPoint(
- this.chart,
- this,
- pointOptions
- );
- } else if (H.isString(pointOptions)) {
- point = this.chart.get(pointOptions) || null;
- } else if (typeof pointOptions === 'function') {
- var pointConfig = pointOptions.call(point, this);
- point = pointConfig.series ?
- pointConfig :
- new MockPoint(
- this.chart,
- this,
- pointOptions
- );
- }
- }
- return point;
- },
- /**
- * Find point-like objects based on points options.
- *
- * @return {Array<Annotation.PointLike>} an array of point-like objects
- */
- linkPoints: function () {
- var pointsOptions = this.getPointsOptions(),
- points = this.points,
- len = (pointsOptions && pointsOptions.length) || 0,
- i,
- point;
- for (i = 0; i < len; i++) {
- point = this.point(pointsOptions[i], points[i]);
- if (!point) {
- points.length = 0;
- return;
- }
- if (point.mock) {
- point.refresh();
- }
- points[i] = point;
- }
- return points;
- },
- /**
- * Add control points to a controllable.
- */
- addControlPoints: function () {
- var controlPointsOptions = this.options.controlPoints;
- (controlPointsOptions || []).forEach(
- function (controlPointOptions, i) {
- var options = H.merge(
- this.options.controlPointOptions,
- controlPointOptions
- );
- if (!options.index) {
- options.index = i;
- }
- controlPointsOptions[i] = options;
- this.controlPoints.push(
- new ControlPoint(this.chart, this, options)
- );
- },
- this
- );
- },
- /**
- * Check if a controllable should be rendered/redrawn.
- *
- * @return {boolean} whether a controllable should be drawn.
- */
- shouldBeDrawn: function () {
- return Boolean(this.points.length);
- },
- /**
- * Render a controllable.
- **/
- render: function () {
- this.controlPoints.forEach(function (controlPoint) {
- controlPoint.render();
- });
- },
- /**
- * Redraw a controllable.
- *
- * @param {boolean} animation
- **/
- redraw: function (animation) {
- this.controlPoints.forEach(function (controlPoint) {
- controlPoint.redraw(animation);
- });
- },
- /**
- * Transform a controllable with a specific transformation.
- *
- * @param {string} transformation a transformation name
- * @param {number} cx origin x transformation
- * @param {number} cy origin y transformation
- * @param {number} p1 param for the transformation
- * @param {number} p2 param for the transformation
- **/
- transform: function (transformation, cx, cy, p1, p2) {
- if (this.chart.inverted) {
- var temp = cx;
- cx = cy;
- cy = temp;
- }
- this.points.forEach(function (point, i) {
- this.transformPoint(transformation, cx, cy, p1, p2, i);
- }, this);
- },
- /**
- * Transform a point with a specific transformation
- * If a transformed point is a real point it is replaced with
- * the mock point.
- *
- * @param {string} transformation a transformation name
- * @param {number} cx origin x transformation
- * @param {number} cy origin y transformation
- * @param {number} p1 param for the transformation
- * @param {number} p2 param for the transformation
- * @param {number} i index of the point
- *
- **/
- transformPoint: function (transformation, cx, cy, p1, p2, i) {
- var point = this.points[i];
- if (!point.mock) {
- point = this.points[i] = MockPoint.fromPoint(point);
- }
- point[transformation](cx, cy, p1, p2);
- },
- /**
- * Translate a controllable.
- *
- * @param {number} dx translation for x coordinate
- * @param {number} dy translation for y coordinate
- **/
- translate: function (dx, dy) {
- this.transform('translate', null, null, dx, dy);
- },
- /**
- * Translate a specific point within a controllable.
- *
- * @param {number} dx translation for x coordinate
- * @param {number} dy translation for y coordinate
- * @param {number} i index of the point
- **/
- translatePoint: function (dx, dy, i) {
- this.transformPoint('translate', null, null, dx, dy, i);
- },
- /**
- * Rotate a controllable.
- *
- * @param {number} cx origin x rotation
- * @param {number} cy origin y rotation
- * @param {number} radians
- **/
- rotate: function (cx, cy, radians) {
- this.transform('rotate', cx, cy, radians);
- },
- /**
- * Scale a controllable.
- *
- * @param {number} cx origin x rotation
- * @param {number} cy origin y rotation
- * @param {number} sx scale factor x
- * @param {number} sy scale factor y
- */
- scale: function (cx, cy, sx, sy) {
- this.transform('scale', cx, cy, sx, sy);
- },
- /**
- * Set control points' visibility.
- *
- * @param {boolean} [visible]
- */
- setControlPointsVisibility: function (visible) {
- this.controlPoints.forEach(function (controlPoint) {
- controlPoint.setVisibility(visible);
- });
- },
- /**
- * Destroy a controllable.
- */
- destroy: function () {
- if (this.graphic) {
- this.graphic = this.graphic.destroy();
- }
- if (this.tracker) {
- this.tracker = this.tracker.destroy();
- }
- this.controlPoints.forEach(function (controlPoint) {
- controlPoint.destroy();
- });
- this.chart = null;
- this.points = null;
- this.controlPoints = null;
- this.options = null;
- if (this.annotation) {
- this.annotation = null;
- }
- },
- /**
- * Update a controllable.
- *
- * @param {Object} newOptions
- */
- update: function (newOptions) {
- var annotation = this.annotation,
- options = H.merge(true, this.options, newOptions),
- parentGroup = this.graphic.parentGroup;
- this.destroy();
- this.constructor(annotation, options);
- this.render(parentGroup);
- this.redraw();
- }
- };
- return controllableMixin;
- }(Highcharts, ControlPoint, MockPoint));
- var markerMixin = (function (H) {
- /**
- * Options for configuring markers for annotations.
- *
- * An example of the arrow marker:
- * <pre>
- * {
- * arrow: {
- * id: 'arrow',
- * tagName: 'marker',
- * refY: 5,
- * refX: 5,
- * markerWidth: 10,
- * markerHeight: 10,
- * children: [{
- * tagName: 'path',
- * attrs: {
- * d: 'M 0 0 L 10 5 L 0 10 Z',
- * strokeWidth: 0
- * }
- * }]
- * }
- * }
- * </pre>
- * @type {Object}
- * @sample highcharts/annotations/custom-markers/
- * Define a custom marker for annotations
- * @sample highcharts/css/annotations-markers/
- * Define markers in a styled mode
- * @since 6.0.0
- * @apioption defs
- */
- var defaultMarkers = {
- arrow: {
- tagName: 'marker',
- render: false,
- id: 'arrow',
- refY: 5,
- refX: 9,
- markerWidth: 10,
- markerHeight: 10,
- children: [{
- tagName: 'path',
- d: 'M 0 0 L 10 5 L 0 10 Z', // triangle (used as an arrow)
- strokeWidth: 0
- }]
- },
- 'reverse-arrow': {
- tagName: 'marker',
- render: false,
- id: 'reverse-arrow',
- refY: 5,
- refX: 1,
- markerWidth: 10,
- markerHeight: 10,
- children: [{
- tagName: 'path',
- // reverse triangle (used as an arrow)
- d: 'M 0 5 L 10 0 L 10 10 Z',
- strokeWidth: 0
- }]
- }
- };
- H.SVGRenderer.prototype.addMarker = function (id, markerOptions) {
- var options = { id: id };
- var attrs = {
- stroke: markerOptions.color || 'none',
- fill: markerOptions.color || 'rgba(0, 0, 0, 0.75)'
- };
- options.children = markerOptions.children.map(function (child) {
- return H.merge(attrs, child);
- });
- var marker = this.definition(H.merge(true, {
- markerWidth: 20,
- markerHeight: 20,
- refX: 0,
- refY: 0,
- orient: 'auto'
- }, markerOptions, options));
- marker.id = id;
- return marker;
- };
- var createMarkerSetter = function (markerType) {
- return function (value) {
- this.attr(markerType, 'url(#' + value + ')');
- };
- };
- /**
- * @mixin
- */
- var markerMixin = {
- markerEndSetter: createMarkerSetter('marker-end'),
- markerStartSetter: createMarkerSetter('marker-start'),
- /*
- * Set markers.
- *
- * @param {Controllable} item
- */
- setItemMarkers: function (item) {
- var itemOptions = item.options,
- chart = item.chart,
- defs = chart.options.defs,
- fill = itemOptions.fill,
- color = H.defined(fill) && fill !== 'none' ?
- fill :
- itemOptions.stroke,
- setMarker = function (markerType) {
- var markerId = itemOptions[markerType],
- def,
- predefinedMarker,
- key,
- marker;
- if (markerId) {
- for (key in defs) {
- def = defs[key];
- if (
- markerId === def.id && def.tagName === 'marker'
- ) {
- predefinedMarker = def;
- break;
- }
- }
- if (predefinedMarker) {
- marker = item[markerType] = chart.renderer
- .addMarker(
- (itemOptions.id || H.uniqueKey()) + '-' +
- predefinedMarker.id,
- H.merge(predefinedMarker, { color: color })
- );
- item.attr(markerType, marker.attr('id'));
- }
- }
- };
- ['markerStart', 'markerEnd'].forEach(setMarker);
- }
- };
- // In a styled mode definition is implemented
- H.SVGRenderer.prototype.definition = function (def) {
- var ren = this;
- function recurse(config, parent) {
- var ret;
- H.splat(config).forEach(function (item) {
- var node = ren.createElement(item.tagName),
- attr = {};
- // Set attributes
- H.objectEach(item, function (val, key) {
- if (
- key !== 'tagName' &&
- key !== 'children' &&
- key !== 'textContent'
- ) {
- attr[key] = val;
- }
- });
- node.attr(attr);
- // Add to the tree
- node.add(parent || ren.defs);
- // Add text content
- if (item.textContent) {
- node.element.appendChild(
- H.doc.createTextNode(item.textContent)
- );
- }
- // Recurse
- recurse(item.children || [], node);
- ret = node;
- });
- // Return last node added (on top level it's the only one)
- return ret;
- }
- return recurse(def);
- };
- H.addEvent(H.Chart, 'afterGetContainer', function () {
- this.options.defs = H.merge(defaultMarkers, this.options.defs || {});
- H.objectEach(this.options.defs, function (def) {
- if (def.tagName === 'marker' && def.render !== false) {
- this.renderer.addMarker(def.id, def);
- }
- }, this);
- });
- return markerMixin;
- }(Highcharts));
- var ControllablePath = (function (H, controllableMixin, markerMixin) {
- // See TRACKER_FILL in highcharts.src.js
- var TRACKER_FILL = 'rgba(192,192,192,' + (H.svg ? 0.0001 : 0.002) + ')';
- /**
- * A controllable path class.
- *
- * @class
- * @mixes Annotation.controllableMixin
- * @mixes Annotation.markerMixin
- * @memberOf Annotation
- *
- * @param {Highcharts.Annotation}
- * @param {Object} options a path's options object
- * @param {number} index of the path
- **/
- function ControllablePath(annotation, options, index) {
- this.init(annotation, options, index);
- this.collection = 'shapes';
- }
- /**
- * @typedef {Object} Annotation.ControllablePath.AttrsMap
- * @property {string} dashStyle=dashstyle
- * @property {string} strokeWidth=stroke-width
- * @property {string} stroke=stroke
- * @property {string} fill=fill
- * @property {string} zIndex=zIndex
- */
- /**
- * A map object which allows to map options attributes to element attributes
- *
- * @type {Annotation.ControllablePath.AttrsMap}
- */
- ControllablePath.attrsMap = {
- dashStyle: 'dashstyle',
- strokeWidth: 'stroke-width',
- stroke: 'stroke',
- fill: 'fill',
- zIndex: 'zIndex'
- };
- H.merge(
- true,
- ControllablePath.prototype,
- controllableMixin, /** @lends Annotation.ControllablePath# */ {
- /**
- * @type 'path'
- */
- type: 'path',
- setMarkers: markerMixin.setItemMarkers,
- /**
- * Map the controllable path to 'd' path attribute
- *
- * @return {Array<(string|number)>} a path's d attribute
- */
- toD: function () {
- var d = this.options.d;
- if (d) {
- return typeof d === 'function' ?
- d.call(this) :
- d;
- }
- var points = this.points,
- len = points.length,
- showPath = len,
- point = points[0],
- position = showPath && this.anchor(point).absolutePosition,
- pointIndex = 0,
- dIndex = 2,
- command;
- d = position && ['M', position.x, position.y];
- while (++pointIndex < len && showPath) {
- point = points[pointIndex];
- command = point.command || 'L';
- position = this.anchor(point).absolutePosition;
- if (command === 'Z') {
- d[++dIndex] = command;
- } else {
- if (command !== points[pointIndex - 1].command) {
- d[++dIndex] = command;
- }
- d[++dIndex] = position.x;
- d[++dIndex] = position.y;
- }
- showPath = point.series.visible;
- }
- return showPath ?
- this.chart.renderer.crispLine(d, this.graphic.strokeWidth()) :
- null;
- },
- shouldBeDrawn: function () {
- return controllableMixin.shouldBeDrawn.call(this) ||
- Boolean(this.options.d);
- },
- render: function (parent) {
- var options = this.options,
- attrs = this.attrsFromOptions(options);
- this.graphic = this.annotation.chart.renderer
- .path(['M', 0, 0])
- .attr(attrs)
- .add(parent);
- if (options.className) {
- this.graphic.addClass(options.className);
- }
- this.tracker = this.annotation.chart.renderer
- .path(['M', 0, 0])
- .addClass('highcharts-tracker-line')
- .attr({
- zIndex: 2
- })
- .add(parent);
- if (!this.annotation.chart.styledMode) {
- this.tracker.attr({
- 'stroke-linejoin': 'round', // #1225
- stroke: TRACKER_FILL,
- fill: TRACKER_FILL,
- 'stroke-width': this.graphic.strokeWidth() +
- options.snap * 2
- });
- }
- controllableMixin.render.call(this);
- H.extend(this.graphic, {
- markerStartSetter: markerMixin.markerStartSetter,
- markerEndSetter: markerMixin.markerEndSetter
- });
- this.setMarkers(this);
- },
- redraw: function (animation) {
- var d = this.toD(),
- action = animation ? 'animate' : 'attr';
- if (d) {
- this.graphic[action]({ d: d });
- this.tracker[action]({ d: d });
- } else {
- this.graphic.attr({ d: 'M 0 ' + -9e9 });
- this.tracker.attr({ d: 'M 0 ' + -9e9 });
- }
- this.graphic.placed = this.tracker.placed = Boolean(d);
- controllableMixin.redraw.call(this, animation);
- }
- }
- );
- return ControllablePath;
- }(Highcharts, controllableMixin, markerMixin));
- var ControllableRect = (function (H, controllableMixin, ControllablePath) {
- /**
- * A controllable rect class.
- *
- * @class
- * @mixes Annotation.controllableMixin
- * @memberOf Annotation
- *
- * @param {Highcharts.Annotation} annotation an annotation instance
- * @param {Object} options a rect's options
- * @param {number} index of the rectangle
- **/
- function ControllableRect(annotation, options, index) {
- this.init(annotation, options, index);
- this.collection = 'shapes';
- }
- /**
- * @typedef {Annotation.ControllablePath.AttrsMap}
- * Annotation.ControllableRect.AttrsMap
- * @property {string} width=width
- * @property {string} height=height
- */
- /**
- * A map object which allows to map options attributes to element attributes
- *
- * @type {Annotation.ControllableRect.AttrsMap}
- */
- ControllableRect.attrsMap = H.merge(ControllablePath.attrsMap, {
- width: 'width',
- height: 'height'
- });
- H.merge(
- true,
- ControllableRect.prototype,
- controllableMixin, /** @lends Annotation.ControllableRect# */ {
- /**
- * @type 'rect'
- */
- type: 'rect',
- render: function (parent) {
- var attrs = this.attrsFromOptions(this.options);
- this.graphic = this.annotation.chart.renderer
- .rect(0, -9e9, 0, 0)
- .attr(attrs)
- .add(parent);
- controllableMixin.render.call(this);
- },
- redraw: function (animation) {
- var position = this.anchor(this.points[0]).absolutePosition;
- if (position) {
- this.graphic[animation ? 'animate' : 'attr']({
- x: position.x,
- y: position.y,
- width: this.options.width,
- height: this.options.height
- });
- } else {
- this.attr({
- x: 0,
- y: -9e9
- });
- }
- this.graphic.placed = Boolean(position);
- controllableMixin.redraw.call(this, animation);
- },
- translate: function (dx, dy) {
- var annotationOptions = this.annotation.userOptions,
- shapeOptions = annotationOptions[this.collection][this.index];
- this.translatePoint(dx, dy, 0);
- // Options stored in chart:
- shapeOptions.point = this.options.point;
- }
- }
- );
- return ControllableRect;
- }(Highcharts, controllableMixin, ControllablePath));
- var ControllableCircle = (function (H, controllableMixin, ControllablePath) {
- /**
- * A controllable circle class.
- *
- * @constructor
- * @mixes Annotation.controllableMixin
- * @memberOf Annotation
- *
- * @param {Highcharts.Annotation} annotation an annotation instance
- * @param {Object} options a shape's options
- * @param {number} index of the circle
- **/
- function ControllableCircle(annotation, options, index) {
- this.init(annotation, options, index);
- this.collection = 'shapes';
- }
- /**
- * A map object which allows to map options attributes to element attributes.
- */
- ControllableCircle.attrsMap = H.merge(ControllablePath.attrsMap, {
- r: 'r'
- });
- H.merge(
- true,
- ControllableCircle.prototype,
- controllableMixin, /** @lends Annotation.ControllableCircle# */ {
- /**
- * @type 'circle'
- */
- type: 'circle',
- render: function (parent) {
- var attrs = this.attrsFromOptions(this.options);
- this.graphic = this.annotation.chart.renderer
- .circle(0, -9e9, 0)
- .attr(attrs)
- .add(parent);
- controllableMixin.render.call(this);
- },
- redraw: function (animation) {
- var position = this.anchor(this.points[0]).absolutePosition;
- if (position) {
- this.graphic[animation ? 'animate' : 'attr']({
- x: position.x,
- y: position.y,
- r: this.options.r
- });
- } else {
- this.graphic.attr({
- x: 0,
- y: -9e9
- });
- }
- this.graphic.placed = Boolean(position);
- controllableMixin.redraw.call(this, animation);
- },
- translate: function (dx, dy) {
- var annotationOptions = this.annotation.userOptions,
- shapeOptions = annotationOptions[this.collection][this.index];
- this.translatePoint(dx, dy, 0);
- // Options stored in chart:
- shapeOptions.point = this.options.point;
- },
- /**
- * Set the radius.
- *
- * @param {number} r a radius to be set
- */
- setRadius: function (r) {
- this.options.r = r;
- }
- }
- );
- return ControllableCircle;
- }(Highcharts, controllableMixin, ControllablePath));
- var ControllableLabel = (function (H, controllableMixin, MockPoint) {
- /**
- * A controllable label class.
- *
- * @class
- * @mixes Annotation.controllableMixin
- * @memberOf Annotation
- *
- * @param {Highcharts.Annotation} annotation an annotation instance
- * @param {Object} options a label's options
- * @param {number} index of the label
- **/
- function ControllableLabel(annotation, options, index) {
- this.init(annotation, options, index);
- this.collection = 'labels';
- }
- /**
- * Shapes which do not have background - the object is used for proper
- * setting of the contrast color.
- *
- * @type {Array<String>}
- */
- ControllableLabel.shapesWithoutBackground = ['connector'];
- /**
- * Returns new aligned position based alignment options and box to align to.
- * It is almost a one-to-one copy from SVGElement.prototype.align
- * except it does not use and mutate an element
- *
- * @param {Object} alignOptions
- * @param {Object} box
- * @return {Annotation.controllableMixin.Position} aligned position
- */
- ControllableLabel.alignedPosition = function (alignOptions, box) {
- var align = alignOptions.align,
- vAlign = alignOptions.verticalAlign,
- x = (box.x || 0) + (alignOptions.x || 0),
- y = (box.y || 0) + (alignOptions.y || 0),
- alignFactor,
- vAlignFactor;
- if (align === 'right') {
- alignFactor = 1;
- } else if (align === 'center') {
- alignFactor = 2;
- }
- if (alignFactor) {
- x += (box.width - (alignOptions.width || 0)) / alignFactor;
- }
- if (vAlign === 'bottom') {
- vAlignFactor = 1;
- } else if (vAlign === 'middle') {
- vAlignFactor = 2;
- }
- if (vAlignFactor) {
- y += (box.height - (alignOptions.height || 0)) / vAlignFactor;
- }
- return {
- x: Math.round(x),
- y: Math.round(y)
- };
- };
- /**
- * Returns new alignment options for a label if the label is outside the
- * plot area. It is almost a one-to-one copy from
- * Series.prototype.justifyDataLabel except it does not mutate the label and
- * it works with absolute instead of relative position.
- *
- * @param {Object} label
- * @param {Object} alignOptions
- * @param {Object} alignAttr
- * @return {Object} justified options
- **/
- ControllableLabel.justifiedOptions = function (
- chart,
- label,
- alignOptions,
- alignAttr
- ) {
- var align = alignOptions.align,
- verticalAlign = alignOptions.verticalAlign,
- padding = label.box ? 0 : (label.padding || 0),
- bBox = label.getBBox(),
- off,
- options = {
- align: align,
- verticalAlign: verticalAlign,
- x: alignOptions.x,
- y: alignOptions.y,
- width: label.width,
- height: label.height
- },
- x = alignAttr.x - chart.plotLeft,
- y = alignAttr.y - chart.plotTop;
- // Off left
- off = x + padding;
- if (off < 0) {
- if (align === 'right') {
- options.align = 'left';
- } else {
- options.x = -off;
- }
- }
- // Off right
- off = x + bBox.width - padding;
- if (off > chart.plotWidth) {
- if (align === 'left') {
- options.align = 'right';
- } else {
- options.x = chart.plotWidth - off;
- }
- }
- // Off top
- off = y + padding;
- if (off < 0) {
- if (verticalAlign === 'bottom') {
- options.verticalAlign = 'top';
- } else {
- options.y = -off;
- }
- }
- // Off bottom
- off = y + bBox.height - padding;
- if (off > chart.plotHeight) {
- if (verticalAlign === 'top') {
- options.verticalAlign = 'bottom';
- } else {
- options.y = chart.plotHeight - off;
- }
- }
- return options;
- };
- /**
- * @typedef {Object} Annotation.ControllableLabel.AttrsMap
- * @property {string} backgroundColor=fill
- * @property {string} borderColor=stroke
- * @property {string} borderWidth=stroke-width
- * @property {string} zIndex=zIndex
- * @property {string} borderRadius=r
- * @property {string} padding=padding
- */
- /**
- * A map object which allows to map options attributes to element attributes
- *
- * @type {Annotation.ControllableLabel.AttrsMap}
- */
- ControllableLabel.attrsMap = {
- backgroundColor: 'fill',
- borderColor: 'stroke',
- borderWidth: 'stroke-width',
- zIndex: 'zIndex',
- borderRadius: 'r',
- padding: 'padding'
- };
- H.merge(
- true,
- ControllableLabel.prototype,
- controllableMixin, /** @lends Annotation.ControllableLabel# */ {
- /**
- * Translate the point of the label by deltaX and deltaY translations.
- * The point is the label's anchor.
- *
- * @param {number} dx translation for x coordinate
- * @param {number} dy translation for y coordinate
- **/
- translatePoint: function (dx, dy) {
- controllableMixin.translatePoint.call(this, dx, dy, 0);
- },
- /**
- * Translate x and y position relative to the label's anchor.
- *
- * @param {number} dx translation for x coordinate
- * @param {number} dy translation for y coordinate
- **/
- translate: function (dx, dy) {
- var annotationOptions = this.annotation.userOptions,
- labelOptions = annotationOptions[this.collection][this.index];
- // Local options:
- this.options.x += dx;
- this.options.y += dy;
- // Options stored in chart:
- labelOptions.x = this.options.x;
- labelOptions.y = this.options.y;
- },
- render: function (parent) {
- var options = this.options,
- attrs = this.attrsFromOptions(options),
- style = options.style;
- this.graphic = this.annotation.chart.renderer
- .label(
- '',
- 0,
- -9e9,
- options.shape,
- null,
- null,
- options.useHTML,
- null,
- 'annotation-label'
- )
- .attr(attrs)
- .add(parent);
- if (!this.annotation.chart.styledMode) {
- if (style.color === 'contrast') {
- style.color = this.annotation.chart.renderer.getContrast(
- ControllableLabel.shapesWithoutBackground.indexOf(
- options.shape
- ) > -1 ? '#FFFFFF' : options.backgroundColor
- );
- }
- this.graphic
- .css(options.style)
- .shadow(options.shadow);
- }
- if (options.className) {
- this.graphic.addClass(options.className);
- }
- this.graphic.labelrank = options.labelrank;
- controllableMixin.render.call(this);
- },
- redraw: function (animation) {
- var options = this.options,
- text = this.text || options.format || options.text,
- label = this.graphic,
- point = this.points[0],
- show = false,
- anchor,
- attrs;
- label.attr({
- text: text ?
- H.format(
- text,
- point.getLabelConfig(),
- this.annotation.chart.time
- ) :
- options.formatter.call(point, this)
- });
- anchor = this.anchor(point);
- attrs = this.position(anchor);
- show = attrs;
- if (show) {
- label.alignAttr = attrs;
- attrs.anchorX = anchor.absolutePosition.x;
- attrs.anchorY = anchor.absolutePosition.y;
- label[animation ? 'animate' : 'attr'](attrs);
- } else {
- label.attr({
- x: 0,
- y: -9e9
- });
- }
- label.placed = Boolean(show);
- controllableMixin.redraw.call(this, animation);
- },
- /**
- * All basic shapes don't support alignTo() method except label.
- * For a controllable label, we need to subtract translation from
- * options.
- */
- anchor: function () {
- var anchor = controllableMixin.anchor.apply(this, arguments),
- x = this.options.x || 0,
- y = this.options.y || 0;
- anchor.absolutePosition.x -= x;
- anchor.absolutePosition.y -= y;
- anchor.relativePosition.x -= x;
- anchor.relativePosition.y -= y;
- return anchor;
- },
- /**
- * Returns the label position relative to its anchor.
- *
- * @param {Annotation.controllableMixin.Anchor} anchor
- * @return {Annotation.controllableMixin.Position|null} position
- */
- position: function (anchor) {
- var item = this.graphic,
- chart = this.annotation.chart,
- point = this.points[0],
- itemOptions = this.options,
- anchorAbsolutePosition = anchor.absolutePosition,
- anchorRelativePosition = anchor.relativePosition,
- itemPosition,
- alignTo,
- itemPosRelativeX,
- itemPosRelativeY,
- showItem =
- point.series.visible &&
- MockPoint.prototype.isInsidePane.call(point);
- if (showItem) {
- if (itemOptions.distance) {
- itemPosition = H.Tooltip.prototype.getPosition.call(
- {
- chart: chart,
- distance: H.pick(itemOptions.distance, 16)
- },
- item.width,
- item.height,
- {
- plotX: anchorRelativePosition.x,
- plotY: anchorRelativePosition.y,
- negative: point.negative,
- ttBelow: point.ttBelow,
- h: anchorRelativePosition.height ||
- anchorRelativePosition.width
- }
- );
- } else if (itemOptions.positioner) {
- itemPosition = itemOptions.positioner.call(this);
- } else {
- alignTo = {
- x: anchorAbsolutePosition.x,
- y: anchorAbsolutePosition.y,
- width: 0,
- height: 0
- };
- itemPosition = ControllableLabel.alignedPosition(
- H.extend(itemOptions, {
- width: item.width,
- height: item.height
- }),
- alignTo
- );
- if (this.options.overflow === 'justify') {
- itemPosition = ControllableLabel.alignedPosition(
- ControllableLabel.justifiedOptions(
- chart,
- item,
- itemOptions,
- itemPosition
- ),
- alignTo
- );
- }
- }
- if (itemOptions.crop) {
- itemPosRelativeX = itemPosition.x - chart.plotLeft;
- itemPosRelativeY = itemPosition.y - chart.plotTop;
- showItem =
- chart.isInsidePlot(
- itemPosRelativeX,
- itemPosRelativeY
- ) &&
- chart.isInsidePlot(
- itemPosRelativeX + item.width,
- itemPosRelativeY + item.height
- );
- }
- }
- return showItem ? itemPosition : null;
- }
- }
- );
- /* ********************************************************************** */
- /**
- * General symbol definition for labels with connector
- */
- H.SVGRenderer.prototype.symbols.connector = function (x, y, w, h, options) {
- var anchorX = options && options.anchorX,
- anchorY = options && options.anchorY,
- path,
- yOffset,
- lateral = w / 2;
- if (H.isNumber(anchorX) && H.isNumber(anchorY)) {
- path = ['M', anchorX, anchorY];
- // Prefer 45 deg connectors
- yOffset = y - anchorY;
- if (yOffset < 0) {
- yOffset = -h - yOffset;
- }
- if (yOffset < w) {
- lateral = anchorX < x + (w / 2) ? yOffset : w - yOffset;
- }
- // Anchor below label
- if (anchorY > y + h) {
- path.push('L', x + lateral, y + h);
- // Anchor above label
- } else if (anchorY < y) {
- path.push('L', x + lateral, y);
- // Anchor left of label
- } else if (anchorX < x) {
- path.push('L', x, y + h / 2);
- // Anchor right of label
- } else if (anchorX > x + w) {
- path.push('L', x + w, y + h / 2);
- }
- }
- return path || [];
- };
- return ControllableLabel;
- }(Highcharts, controllableMixin, MockPoint));
- var ControllableImage = (function (H, controllableMixin, ControllableLabel) {
- /**
- * A controllable image class.
- *
- * @class
- * @mixes Annotation.controllableMixin
- * @memberOf Annotation
- *
- * @param {Highcharts.Annotation} annotation - an annotation instance
- * @param {Object} options a controllable's options
- * @param {number} index of the image
- **/
- function ControllableImage(annotation, options, index) {
- this.init(annotation, options, index);
- this.collection = 'shapes';
- }
- /**
- * @typedef {Object} Annotation.ControllableImage.AttrsMap
- * @property {string} width=width
- * @property {string} height=height
- * @property {string} zIndex=zIndex
- */
- /**
- * A map object which allows to map options attributes to element attributes
- *
- * @type {Annotation.ControllableImage.AttrsMap}
- */
- ControllableImage.attrsMap = {
- width: 'width',
- height: 'height',
- zIndex: 'zIndex'
- };
- H.merge(
- true,
- ControllableImage.prototype,
- controllableMixin, /** @lends Annotation.ControllableImage# */ {
- /**
- * @type 'image'
- */
- type: 'image',
- render: function (parent) {
- var attrs = this.attrsFromOptions(this.options),
- options = this.options;
- this.graphic = this.annotation.chart.renderer
- .image(options.src, 0, -9e9, options.width, options.height)
- .attr(attrs)
- .add(parent);
- this.graphic.width = options.width;
- this.graphic.height = options.height;
- controllableMixin.render.call(this);
- },
- redraw: function (animation) {
- var anchor = this.anchor(this.points[0]),
- position = ControllableLabel.prototype.position.call(
- this,
- anchor
- );
- if (position) {
- this.graphic[animation ? 'animate' : 'attr']({
- x: position.x,
- y: position.y
- });
- } else {
- this.graphic.attr({
- x: 0,
- y: -9e9
- });
- }
- this.graphic.placed = Boolean(position);
- controllableMixin.redraw.call(this, animation);
- },
- translate: function (dx, dy) {
- var annotationOptions = this.annotation.userOptions,
- shapeOptions = annotationOptions[this.collection][this.index];
- this.translatePoint(dx, dy, 0);
- // Options stored in chart:
- shapeOptions.point = this.options.point;
- }
- }
- );
- return ControllableImage;
- }(Highcharts, controllableMixin, ControllableLabel));
- (function (H, controllableMixin, ControllableRect, ControllableCircle, ControllablePath, ControllableImage, ControllableLabel, eventEmitterMixin, MockPoint, ControlPoint) {
- /**
- * (c) 2009-2017 Highsoft, Black Label
- *
- * License: www.highcharts.com/license
- */
- var merge = H.merge,
- addEvent = H.addEvent,
- defined = H.defined,
- erase = H.erase,
- find = H.find,
- isString = H.isString,
- pick = H.pick,
- reduce = H.reduce,
- splat = H.splat,
- destroyObjectProperties = H.destroyObjectProperties;
- /* *********************************************************************
- *
- * ANNOTATION
- *
- ******************************************************************** */
- /**
- * @typedef {
- * Annotation.ControllableCircle|
- * Annotation.ControllableImage|
- * Annotation.ControllablePath|
- * Annotation.ControllableRect
- * }
- * Annotation.Shape
- */
- /**
- * @typedef {Annotation.ControllableLabel} Annotation.Label
- */
- /**
- * An annotation class which serves as a container for items like labels or
- * shapes. Created items are positioned on the chart either by linking them to
- * existing points or created mock points
- *
- * @class
- * @mixes Annotation.controllableMixin
- * @mixes Annotation.eventEmitterMixin
- *
- * @param {Highcharts.Chart} chart a chart instance
- * @param {AnnotationOptions} options the options object
- */
- var Annotation = H.Annotation = function (chart, options) {
- var labelsAndShapes;
- /**
- * The chart that the annotation belongs to.
- *
- * @type {Highcharts.Chart}
- */
- this.chart = chart;
- /**
- * The array of points which defines the annotation.
- *
- * @type {Array<Annotation.PointLike>}
- */
- this.points = [];
- /**
- * The array of control points.
- *
- * @type {Array<Annotation.ControlPoint>}
- */
- this.controlPoints = [];
- this.coll = 'annotations';
- /**
- * The array of labels which belong to the annotation.
- *
- * @type {Array<Annotation.Label>}
- */
- this.labels = [];
- /**
- * The array of shapes which belong to the annotation.
- *
- * @type {Array<Annotation.Shape>}
- */
- this.shapes = [];
- /**
- * The options for the annotations.
- *
- * @type {AnnotationOptions}
- */
- // this.options = merge(this.defaultOptions, userOptions);
- this.options = options;
- /**
- * The user options for the annotations.
- *
- * @type {AnnotationOptions}
- */
- this.userOptions = merge(true, {}, options);
- // Handle labels and shapes - those are arrays
- // Merging does not work with arrays (stores reference)
- labelsAndShapes = this.getLabelsAndShapesOptions(
- this.userOptions,
- options
- );
- this.userOptions.labels = labelsAndShapes.labels;
- this.userOptions.shapes = labelsAndShapes.shapes;
- /**
- * The callback that reports to the overlapping-labels module which
- * labels it should account for.
- *
- * @name labelCollector
- * @memberOf Annotation#
- * @type {Function}
- */
- /**
- * The group svg element.
- *
- * @name group
- * @memberOf Annotation#
- * @type {Highcharts.SVGElement}
- */
- /**
- * The group svg element of the annotation's shapes.
- *
- * @name shapesGroup
- * @memberOf Annotation#
- * @type {Highcharts.SVGElement}
- */
- /**
- * The group svg element of the annotation's labels.
- *
- * @name labelsGroup
- * @memberOf Annotation#
- * @type {Highcharts.SVGElement}
- */
- this.init(chart, options);
- };
- merge(
- true,
- Annotation.prototype,
- controllableMixin,
- eventEmitterMixin, /** @lends Annotation# */ {
- /**
- * A basic type of an annotation. It allows to add custom labels
- * or shapes. The items can be tied to points, axis coordinates
- * or chart pixel coordinates.
- *
- * @private
- * @type {Object}
- * @ignore-options base, annotations.crookedLine
- * @sample highcharts/annotations/basic/
- * Basic annotations
- * @sample highcharts/demo/annotations/
- * Advanced annotations
- * @sample highcharts/css/annotations
- * Styled mode
- * @sample highcharts/annotations-advanced/controllable
- * Controllable items
- * @sample {highstock} stock/annotations/fibonacci-retracements
- * Custom annotation, Fibonacci retracement
- * @since 6.0.0
- * @optionparent annotations.crookedLine
- */
- defaultOptions: {
- /**
- * Whether the annotation is visible.
- *
- * @sample highcharts/annotations/visible/
- * Set annotation visibility
- */
- visible: true,
- /**
- * Allow an annotation to be draggable by a user. Possible
- * values are `"x"`, `"xy"`, `"y"` and `""` (disabled).
- *
- * @type {string}
- * @validvalue ["x", "xy", "y", ""]
- */
- draggable: 'xy',
- /**
- * Options for annotation's labels. Each label inherits options
- * from the labelOptions object. An option from the labelOptions
- * can be overwritten by config for a specific label.
- */
- labelOptions: {
- /**
- * The alignment of the annotation's label. If right,
- * the right side of the label should be touching the point.
- *
- * @validvalue ["left", "center", "right"]
- * @sample highcharts/annotations/label-position/
- * Set labels position
- */
- align: 'center',
- /**
- * Whether to allow the annotation's labels to overlap.
- * To make the labels less sensitive for overlapping,
- * the can be set to 0.
- *
- * @sample highcharts/annotations/tooltip-like/
- * Hide overlapping labels
- */
- allowOverlap: false,
- /**
- * The background color or gradient for the annotation's label.
- *
- * @type {Color}
- * @sample highcharts/annotations/label-presentation/
- * Set labels graphic options
- */
- backgroundColor: 'rgba(0, 0, 0, 0.75)',
- /**
- * The border color for the annotation's label.
- *
- * @type {Color}
- * @sample highcharts/annotations/label-presentation/
- * Set labels graphic options
- */
- borderColor: 'black',
- /**
- * The border radius in pixels for the annotaiton's label.
- *
- * @sample highcharts/annotations/label-presentation/
- * Set labels graphic options
- */
- borderRadius: 3,
- /**
- * The border width in pixels for the annotation's label
- *
- * @sample highcharts/annotations/label-presentation/
- * Set labels graphic options
- */
- borderWidth: 1,
- /**
- * A class name for styling by CSS.
- *
- * @sample highcharts/css/annotations
- * Styled mode annotations
- * @since 6.0.5
- */
- className: '',
- /**
- * Whether to hide the annotation's label
- * that is outside the plot area.
- *
- * @sample highcharts/annotations/label-crop-overflow/
- * Crop or justify labels
- */
- crop: false,
- /**
- * The label's pixel distance from the point.
- *
- * @type {number}
- * @sample highcharts/annotations/label-position/
- * Set labels position
- * @default undefined
- * @apioption annotations.crookedLine.labelOptions.distance
- */
- /**
- * A [format](https://www.highcharts.com/docs/chart-concepts/labels-and-string-formatting) string for the data label.
- *
- * @type {string}
- * @see [plotOptions.series.dataLabels.format](
- * plotOptions.series.dataLabels.format.html)
- * @sample highcharts/annotations/label-text/
- * Set labels text
- * @default undefined
- * @apioption annotations.crookedLine.labelOptions.format
- */
- /**
- * Alias for the format option.
- *
- * @type {string}
- * @see [format](annotations.labelOptions.format.html)
- * @sample highcharts/annotations/label-text/
- * Set labels text
- * @default undefined
- * @apioption annotations.crookedLine.labelOptions.text
- */
- /**
- * Callback JavaScript function to format
- * the annotation's label. Note that if a `format` or `text`
- * are defined, the format or text take precedence and
- * the formatter is ignored. `This` refers to a * point object.
- *
- * @type {function}
- * @sample highcharts/annotations/label-text/
- * Set labels text
- * @default function () {
- * return defined(this.y) ? this.y : 'Annotation label';
- * }
- */
- formatter: function () {
- return defined(this.y) ? this.y : 'Annotation label';
- },
- /**
- * How to handle the annotation's label that flow
- * outside the plot area. The justify option aligns the label
- * inside the plot area.
- *
- * @validvalue ["none", "justify"]
- * @sample highcharts/annotations/label-crop-overflow/
- * Crop or justify labels
- **/
- overflow: 'justify',
- /**
- * When either the borderWidth or the backgroundColor is set,
- * this is the padding within the box.
- *
- * @sample highcharts/annotations/label-presentation/
- * Set labels graphic options
- */
- padding: 5,
- /**
- * The shadow of the box. The shadow can be
- * an object configuration containing
- * `color`, `offsetX`, `offsetY`, `opacity` and `width`.
- *
- * @type {Boolean|Object}
- * @sample highcharts/annotations/label-presentation/
- * Set labels graphic options
- */
- shadow: false,
- /**
- * The name of a symbol to use for the border around the label.
- * Symbols are predefined functions on the Renderer object.
- *
- * @type {string}
- * @sample highcharts/annotations/shapes/
- * Available shapes for labels
- */
- shape: 'callout',
- /**
- * Styles for the annotation's label.
- *
- * @type {CSSObject}
- * @sample highcharts/annotations/label-presentation/
- * Set labels graphic options
- * @see [plotOptions.series.dataLabels.style](
- * plotOptions.series.dataLabels.style.html)
- */
- style: {
- fontSize: '11px',
- fontWeight: 'normal',
- color: 'contrast'
- },
- /**
- * Whether to [use HTML](http://www.highcharts.com/docs/chart-concepts/labels-and-string-formatting#html)
- * to render the annotation's label.
- *
- * @type {boolean}
- * @default false
- */
- useHTML: false,
- /**
- * The vertical alignment of the annotation's label.
- *
- * @type {string}
- * @validvalue ["top", "middle", "bottom"]
- * @sample highcharts/annotations/label-position/
- * Set labels position
- */
- verticalAlign: 'bottom',
- /**
- * The x position offset of the label relative to the point.
- * Note that if a `distance` is defined, the distance takes
- * precedence over `x` and `y` options.
- *
- * @sample highcharts/annotations/label-position/
- * Set labels position
- */
- x: 0,
- /**
- * The y position offset of the label relative to the point.
- * Note that if a `distance` is defined, the distance takes
- * precedence over `x` and `y` options.
- *
- * @sample highcharts/annotations/label-position/
- * Set labels position
- */
- y: -16
- },
- /**
- * An array of labels for the annotation. For options that apply to
- * multiple labels, they can be added to the
- * [labelOptions](annotations.labelOptions.html).
- *
- * @type {Array<Object>}
- * @extends annotations.crookedLine.labelOptions
- * @apioption annotations.crookedLine.labels
- */
- /**
- * This option defines the point to which the label
- * will be connected.
- * It can be either the point which exists in the series - it is
- * referenced by the point's id - or a new point with defined x, y
- * properies and optionally axes.
- *
- * @type {string|MockPointOptions}
- * @sample highcharts/annotations/mock-point/
- * Attach annotation to a mock point
- * @apioption annotations.crookedLine.labels.point
- */
- /**
- * The x position of the point. Units can be either in axis
- * or chart pixel coordinates.
- *
- * @type {number}
- * @apioption annotations.crookedLine.labels.point.x
- */
- /**
- * The y position of the point. Units can be either in axis
- * or chart pixel coordinates.
- *
- * @type {number}
- * @apioption annotations.crookedLine.labels.point.y
- */
- /**
- * This number defines which xAxis the point is connected to.
- * It refers to either the axis id or the index of the axis
- * in the xAxis array. If the option is not configured or
- * the axis is not found the point's
- * x coordinate refers to the chart pixels.
- *
- * @type {number|string}
- * @apioption annotations.crookedLine.labels.point.xAxis
- */
- /**
- * This number defines which yAxis the point is connected to.
- * It refers to either the axis id or the index of the axis
- * in the yAxis array. If the option is not configured or
- * the axis is not found the point's
- * y coordinate refers to the chart pixels.
- *
- * @type {number|string}
- * @apioption annotations.crookedLine.labels.point.yAxis
- */
- /**
- * An array of shapes for the annotation. For options that apply to
- * multiple shapes, then can be added to the
- * [shapeOptions](annotations.shapeOptions.html).
- *
- * @type {Array<Object>}
- * @extends annotations.crookedLine.shapeOptions
- * @apioption annotations.crookedLine.shapes
- */
- /**
- * This option defines the point to which the shape will be
- * connected.
- * It can be either the point which exists in the series - it is
- * referenced by the point's id - or a new point with defined x, y
- * properties and optionally axes.
- *
- * @type {string|MockPointOptions}
- * @extends annotations.crookedLine.labels.point
- * @apioption annotations.crookedLine.shapes.point
- */
- /**
- * An array of points for the shape. This option is available
- * for shapes which can use multiple points such as path.
- * A point can be either a point object or a point's id.
- *
- * @type {Array<string|Highcharts.MockPoint.Options>}
- * @see [annotations.shapes.point](annotations.shapes.point.html)
- * @apioption annotations.crookedLine.shapes.points
- */
- /**
- * Id of the marker which will be drawn at the final
- * vertex of the path.
- * Custom markers can be defined in defs property.
- *
- * @type {string}
- * @see [defs.markers](defs.markers.html)
- * @sample highcharts/annotations/custom-markers/
- * Define a custom marker for annotations
- * @apioption annotations.crookedLine.shapes.markerEnd
- */
- /**
- * Id of the marker which will be drawn at the first
- * vertex of the path.
- * Custom markers can be defined in defs property.
- *
- * @type {string}
- * @see [defs.markers](defs.markers.html)
- * @sample {highcharts} highcharts/annotations/custom-markers/
- * Define a custom marker for annotations
- * @apioption annotations.crookedLine.shapes.markerStart
- */
- /**
- * Options for annotation's shapes. Each shape inherits options
- * from the shapeOptions object. An option from the shapeOptions
- * can be overwritten by config for a specific shape.
- *
- * @type {Object}
- */
- shapeOptions: {
- /**
- * The width of the shape.
- *
- * @type {number}
- * @sample highcharts/annotations/shape/
- * Basic shape annotation
- * @apioption annotations.crookedLine.shapeOptions.width
- **/
- /**
- * The height of the shape.
- *
- * @type {number}
- * @sample highcharts/annotations/shape/
- * Basic shape annotation
- * @apioption annotations.crookedLine.shapeOptions.height
- */
- /**
- * The color of the shape's stroke.
- *
- * @type {Color}
- * @sample highcharts/annotations/shape/
- * Basic shape annotation
- */
- stroke: 'rgba(0, 0, 0, 0.75)',
- /**
- * The pixel stroke width of the shape.
- *
- * @sample highcharts/annotations/shape/
- * Basic shape annotation
- */
- strokeWidth: 1,
- /**
- * The color of the shape's fill.
- *
- * @type {Color}
- * @sample highcharts/annotations/shape/
- * Basic shape annotation
- */
- fill: 'rgba(0, 0, 0, 0.75)',
- /**
- * The type of the shape, e.g. circle or rectangle.
- *
- * @type {string}
- * @sample highcharts/annotations/shape/
- * Basic shape annotation
- * @default 'rect'
- * @apioption annotations.crookedLine.shapeOptions.type
- */
- /**
- * The radius of the shape.
- *
- * @sample highcharts/annotations/shape/
- * Basic shape annotation
- */
- r: 0,
- /**
- * Defines additional snapping area around an annotation
- * making this annotation to focus. Defined in pixels.
- */
- snap: 2
- },
- /**
- * Options for annotation's control points. Each control point
- * inherits options from controlPointOptions object.
- * Options from the controlPointOptions can be overwritten
- * by options in a specific control point.
- *
- * @type {Annotation.ControlPoint.Options}
- * @apioption annotations.crookedLine.controlPointOptions
- */
- controlPointOptions: {
- symbol: 'circle',
- width: 10,
- height: 10,
- style: {
- stroke: 'black',
- 'stroke-width': 2,
- fill: 'white'
- },
- visible: false,
- /**
- * @function {Annotation.ControlPoint.Positioner}
- * @apioption annotations.crookedLine.controlPointOptions.positioner
- */
- events: {}
- },
- /**
- * @type {Object}
- */
- events: {},
- /**
- * The Z index of the annotation.
- *
- * @type {number}
- * @default 6
- */
- zIndex: 6
- },
- /**
- * Initialize the annotation.
- *
- * @param {Highcharts.Chart} - the chart
- * @param {AnnotationOptions} - the user options for the annotation
- */
- init: function () {
- this.linkPoints();
- this.addControlPoints();
- this.addShapes();
- this.addLabels();
- this.addClipPaths();
- this.setLabelCollector();
- },
- getLabelsAndShapesOptions: function (baseOptions, newOptions) {
- var mergedOptions = {};
- ['labels', 'shapes'].forEach(function (name) {
- if (baseOptions[name]) {
- mergedOptions[name] = splat(newOptions[name]).map(
- function (basicOptions, i) {
- return merge(baseOptions[name][i], basicOptions);
- }
- );
- }
- });
- return mergedOptions;
- },
- addShapes: function () {
- (this.options.shapes || []).forEach(function (shapeOptions, i) {
- var shape = this.initShape(shapeOptions, i);
- this.options.shapes[i] = shape.options;
- }, this);
- },
- addLabels: function () {
- (this.options.labels || []).forEach(function (labelOptions, i) {
- var label = this.initLabel(labelOptions, i);
- this.options.labels[i] = label.options;
- }, this);
- },
- addClipPaths: function () {
- this.setClipAxes();
- if (this.clipXAxis && this.clipYAxis) {
- this.clipRect = this.chart.renderer.clipRect(
- this.getClipBox()
- );
- }
- },
- setClipAxes: function () {
- var xAxes = this.chart.xAxis,
- yAxes = this.chart.yAxis,
- linkedAxes = reduce(
- (this.options.labels || [])
- .concat(this.options.shapes || []),
- function (axes, labelOrShape) {
- return [
- xAxes[
- labelOrShape &&
- labelOrShape.point &&
- labelOrShape.point.xAxis
- ] || axes[0],
- yAxes[
- labelOrShape &&
- labelOrShape.point &&
- labelOrShape.point.yAxis
- ] || axes[1]
- ];
- },
- []
- );
- this.clipXAxis = linkedAxes[0];
- this.clipYAxis = linkedAxes[1];
- },
- getClipBox: function () {
- return {
- x: this.clipXAxis.left,
- y: this.clipYAxis.top,
- width: this.clipXAxis.width,
- height: this.clipYAxis.height
- };
- },
- setLabelCollector: function () {
- var annotation = this;
- annotation.labelCollector = function () {
- return annotation.labels.reduce(
- function (labels, label) {
- if (!label.options.allowOverlap) {
- labels.push(label.graphic);
- }
- return labels;
- },
- []
- );
- };
- annotation.chart.labelCollectors.push(
- annotation.labelCollector
- );
- },
- /**
- * Set an annotation options.
- *
- * @param {AnnotationOptions} - user options for an annotation
- */
- setOptions: function (userOptions) {
- this.options = merge(this.defaultOptions, userOptions);
- },
- redraw: function (animation) {
- this.linkPoints();
- if (!this.graphic) {
- this.render();
- }
- if (this.clipRect) {
- this.clipRect.animate(this.getClipBox());
- }
- this.redrawItems(this.shapes, animation);
- this.redrawItems(this.labels, animation);
- controllableMixin.redraw.call(this, animation);
- },
- /**
- * @param {Array<(Annotation.Label|Annotation.Shape)>} items
- * @param {boolean} [animation]
- */
- redrawItems: function (items, animation) {
- var i = items.length;
- // needs a backward loop
- // labels/shapes array might be modified
- // due to destruction of the item
- while (i--) {
- this.redrawItem(items[i], animation);
- }
- },
- render: function () {
- var renderer = this.chart.renderer;
- this.graphic = renderer
- .g('annotation')
- .attr({
- zIndex: this.options.zIndex,
- visibility: this.options.visible ?
- 'visible' :
- 'hidden'
- })
- .add();
- this.shapesGroup = renderer
- .g('annotation-shapes')
- .add(this.graphic)
- .clip(this.chart.plotBoxClip);
- this.labelsGroup = renderer
- .g('annotation-labels')
- .attr({
- // hideOverlappingLabels requires translation
- translateX: 0,
- translateY: 0
- })
- .add(this.graphic);
- if (this.clipRect) {
- this.graphic.clip(this.clipRect);
- }
- this.addEvents();
- controllableMixin.render.call(this);
- },
- /**
- * Set the annotation's visibility.
- *
- * @param {Boolean} [visible] - Whether to show or hide an annotation.
- * If the param is omitted, the annotation's visibility is toggled.
- */
- setVisibility: function (visibility) {
- var options = this.options,
- visible = pick(visibility, !options.visible);
- this.graphic.attr(
- 'visibility',
- visible ? 'visible' : 'hidden'
- );
- if (!visible) {
- this.setControlPointsVisibility(false);
- }
- options.visible = visible;
- },
- setControlPointsVisibility: function (visible) {
- var setItemControlPointsVisibility = function (item) {
- item.setControlPointsVisibility(visible);
- };
- controllableMixin.setControlPointsVisibility.call(
- this,
- visible
- );
- this.shapes.forEach(setItemControlPointsVisibility);
- this.labels.forEach(setItemControlPointsVisibility);
- },
- /**
- * Destroy the annotation. This function does not touch the chart
- * that the annotation belongs to (all annotations are kept in
- * the chart.annotations array) - it is recommended to use
- * {@link Highcharts.Chart#removeAnnotation} instead.
- */
- destroy: function () {
- var chart = this.chart,
- destroyItem = function (item) {
- item.destroy();
- };
- this.labels.forEach(destroyItem);
- this.shapes.forEach(destroyItem);
- this.clipXAxis = null;
- this.clipYAxis = null;
- erase(chart.labelCollectors, this.labelCollector);
- eventEmitterMixin.destroy.call(this);
- controllableMixin.destroy.call(this);
- destroyObjectProperties(this, chart);
- },
- /**
- * See {@link Highcharts.Annotation#destroy}.
- */
- remove: function () {
- return this.destroy();
- },
- update: function (userOptions) {
- var chart = this.chart,
- labelsAndShapes = this.getLabelsAndShapesOptions(
- this.userOptions,
- userOptions
- ),
- userOptionsIndex = chart.annotations.indexOf(this),
- options = H.merge(true, this.userOptions, userOptions);
- options.labels = labelsAndShapes.labels;
- options.shapes = labelsAndShapes.shapes;
- this.destroy();
- this.constructor(chart, options);
- // Update options in chart options, used in exporting (#9767):
- chart.options.annotations[userOptionsIndex] = options;
- this.redraw();
- },
- /* *************************************************************
- * ITEM SECTION
- * Contains methods for handling a single item in an annotation
- **************************************************************** */
- /**
- * Initialisation of a single shape
- *
- * @param {Object} shapeOptions - a confg object for a single shape
- **/
- initShape: function (shapeOptions, index) {
- var options = merge(
- this.options.shapeOptions,
- {
- controlPointOptions: this.options.controlPointOptions
- },
- shapeOptions
- ),
- shape = new Annotation.shapesMap[options.type](
- this,
- options,
- index
- );
- shape.itemType = 'shape';
- this.shapes.push(shape);
- return shape;
- },
- /**
- * Initialisation of a single label
- *
- * @param {Object} labelOptions
- **/
- initLabel: function (labelOptions, index) {
- var options = merge(
- this.options.labelOptions,
- {
- controlPointOptions: this.options.controlPointOptions
- },
- labelOptions
- ),
- label = new ControllableLabel(
- this,
- options,
- index
- );
- label.itemType = 'label';
- this.labels.push(label);
- return label;
- },
- /**
- * Redraw a single item.
- *
- * @param {Annotation.Label|Annotation.Shape} item
- * @param {boolean} [animation]
- */
- redrawItem: function (item, animation) {
- item.linkPoints();
- if (!item.shouldBeDrawn()) {
- this.destroyItem(item);
- } else {
- if (!item.graphic) {
- this.renderItem(item);
- }
- item.redraw(
- H.pick(animation, true) && item.graphic.placed
- );
- if (item.points.length) {
- this.adjustVisibility(item);
- }
- }
- },
- /**
- * Hide or show annotaiton attached to points.
- *
- * @param {Annotation.Label|Annotation.Shape} item
- */
- adjustVisibility: function (item) { // #9481
- var hasVisiblePoints = false,
- label = item.graphic;
- item.points.forEach(function (point) {
- if (
- point.series.visible !== false &&
- point.visible !== false
- ) {
- hasVisiblePoints = true;
- }
- });
- if (!hasVisiblePoints) {
- label.hide();
- } else if (label.visibility === 'hidden') {
- label.show();
- }
- },
- /**
- * Destroy a single item.
- *
- * @param {Annotation.Label|Annotation.Shape} item
- */
- destroyItem: function (item) {
- // erase from shapes or labels array
- erase(this[item.itemType + 's'], item);
- item.destroy();
- },
- /*
- * @private
- */
- renderItem: function (item) {
- item.render(
- item.itemType === 'label' ?
- this.labelsGroup :
- this.shapesGroup
- );
- }
- }
- );
- /**
- * An object uses for mapping between a shape type and a constructor.
- * To add a new shape type extend this object with type name as a key
- * and a constructor as its value.
- **/
- Annotation.shapesMap = {
- 'rect': ControllableRect,
- 'circle': ControllableCircle,
- 'path': ControllablePath,
- 'image': ControllableImage
- };
- Annotation.types = {};
- Annotation.MockPoint = MockPoint;
- Annotation.ControlPoint = ControlPoint;
- H.extendAnnotation = function (
- Constructor,
- BaseConstructor,
- prototype,
- defaultOptions
- ) {
- BaseConstructor = BaseConstructor || Annotation;
- merge(
- true,
- Constructor.prototype,
- BaseConstructor.prototype,
- prototype
- );
- Constructor.prototype.defaultOptions = merge(
- Constructor.prototype.defaultOptions,
- defaultOptions || {}
- );
- };
- /* *********************************************************************
- *
- * EXTENDING CHART PROTOTYPE
- *
- ******************************************************************** */
- // Let chart.update() work with annotations
- H.Chart.prototype.collectionsWithUpdate.push('annotations');
- H.extend(H.Chart.prototype, /** @lends Highcharts.Chart# */ {
- initAnnotation: function (userOptions) {
- var Constructor =
- Annotation.types[userOptions.type] || Annotation,
- options = H.merge(
- Constructor.prototype.defaultOptions,
- userOptions
- ),
- annotation = new Constructor(this, options);
- this.annotations.push(annotation);
- return annotation;
- },
- /**
- * Add an annotation to the chart after render time.
- *
- * @param {AnnotationOptions} options
- * The annotation options for the new, detailed annotation.
- * @param {boolean} [redraw]
- *
- * @return {Highcharts.Annotation} - The newly generated annotation.
- */
- addAnnotation: function (userOptions, redraw) {
- var annotation = this.initAnnotation(userOptions);
- this.options.annotations.push(annotation.options);
- if (pick(redraw, true)) {
- annotation.redraw();
- }
- return annotation;
- },
- /**
- * Remove an annotation from the chart.
- *
- * @param {String|Annotation} idOrAnnotation - The annotation's id or
- * direct annotation object.
- */
- removeAnnotation: function (idOrAnnotation) {
- var annotations = this.annotations,
- annotation = isString(idOrAnnotation) ? find(
- annotations,
- function (annotation) {
- return annotation.options.id === idOrAnnotation;
- }
- ) : idOrAnnotation;
- if (annotation) {
- erase(this.options.annotations, annotation.options);
- erase(annotations, annotation);
- annotation.destroy();
- }
- },
- drawAnnotations: function () {
- this.plotBoxClip.attr(this.plotBox);
- this.annotations.forEach(function (annotation) {
- annotation.redraw();
- });
- }
- });
- H.Chart.prototype.callbacks.push(function (chart) {
- chart.annotations = [];
- if (!chart.options.annotations) {
- chart.options.annotations = [];
- }
- chart.plotBoxClip = this.renderer.clipRect(this.plotBox);
- chart.controlPointsGroup = chart.renderer
- .g('control-points')
- .attr({ zIndex: 99 })
- .clip(chart.plotBoxClip)
- .add();
- chart.options.annotations.forEach(function (annotationOptions, i) {
- var annotation = chart.initAnnotation(annotationOptions);
- chart.options.annotations[i] = annotation.options;
- });
- chart.drawAnnotations();
- addEvent(chart, 'redraw', chart.drawAnnotations);
- addEvent(chart, 'destroy', function () {
- chart.plotBoxClip.destroy();
- chart.controlPointsGroup.destroy();
- });
- });
- }(Highcharts, controllableMixin, ControllableRect, ControllableCircle, ControllablePath, ControllableImage, ControllableLabel, eventEmitterMixin, MockPoint, ControlPoint));
- var chartNavigation = (function () {
- /**
- * (c) 2010-2018 Paweł Fus
- *
- * License: www.highcharts.com/license
- */
- var chartNavigation = {
- /**
- * Initializes `chart.navigation` object which delegates `update()` methods
- * to all other common classes (used in exporting and navigationBindings).
- *
- * @private
- *
- * @param {Highcharts.Chart} chart
- * The chart instance.
- */
- initUpdate: function (chart) {
- if (!chart.navigation) {
- chart.navigation = {
- updates: [],
- update: function (options, redraw) {
- this.updates.forEach(function (updateConfig) {
- updateConfig.update.call(
- updateConfig.context,
- options,
- redraw
- );
- });
- }
- };
- }
- },
- /**
- * Registers an `update()` method in the `chart.navigation` object.
- *
- * @private
- *
- * @param {function} update
- * The `update()` method that will be called in `chart.update()`.
- *
- * @param {Highcharts.Chart} chart
- * The chart instance. `update()` will use that as a context
- * (`this`).
- */
- addUpdate: function (update, chart) {
- if (!chart.navigation) {
- this.initUpdate(chart);
- }
- chart.navigation.updates.push({
- update: update,
- context: chart
- });
- }
- };
- return chartNavigation;
- }());
- (function (H, chartNavigationMixin) {
- /**
- * (c) 2009-2017 Highsoft, Black Label
- *
- * License: www.highcharts.com/license
- */
- var doc = H.doc,
- addEvent = H.addEvent,
- pick = H.pick,
- merge = H.merge,
- extend = H.extend,
- isNumber = H.isNumber,
- fireEvent = H.fireEvent,
- isArray = H.isArray,
- isObject = H.isObject,
- objectEach = H.objectEach,
- PREFIX = 'highcharts-';
- /**
- * @private
- * @interface bindingsUtils
- */
- var bindingsUtils = {
- /**
- * Update size of background (rect) in some annotations: Measure, Simple
- * Rect.
- *
- * @private
- * @function bindingsUtils.updateRectSize
- *
- * @param {global.Event} event
- * Normalized browser event
- *
- * @param {Highcharts.Annotation} annotation
- * Annotation to be updated
- */
- updateRectSize: function (event, annotation) {
- var options = annotation.options.typeOptions,
- x = this.chart.xAxis[0].toValue(event.chartX),
- y = this.chart.yAxis[0].toValue(event.chartY),
- width = x - options.point.x,
- height = options.point.y - y;
- annotation.update({
- typeOptions: {
- background: {
- width: width,
- height: height
- }
- }
- });
- },
- /**
- * Get field type according to value
- *
- * @private
- * @function bindingsUtils.getFieldType
- *
- * @param {*} value
- * Atomic type (one of: string, number, boolean)
- *
- * @return {string}
- * Field type (one of: text, number, checkbox)
- */
- getFieldType: function (value) {
- return {
- 'string': 'text',
- 'number': 'number',
- 'boolean': 'checkbox'
- }[typeof value];
- }
- };
- H.NavigationBindings = function (chart, options) {
- this.chart = chart;
- this.options = options;
- this.eventsToUnbind = [];
- this.container = doc.getElementsByClassName(
- this.options.bindingsClassName
- );
- };
- // Define which options from annotations should show up in edit box:
- H.NavigationBindings.annotationsEditable = {
- // `typeOptions` are always available
- // Nested and shared options:
- nestedOptions: {
- labelOptions: ['style', 'format', 'backgroundColor'],
- labels: ['style'],
- label: ['style'],
- style: ['fontSize', 'color'],
- background: ['fill', 'strokeWidth', 'stroke'],
- innerBackground: ['fill', 'strokeWidth', 'stroke'],
- outerBackground: ['fill', 'strokeWidth', 'stroke'],
- shapeOptions: ['fill', 'strokeWidth', 'stroke'],
- shapes: ['fill', 'strokeWidth', 'stroke'],
- line: ['strokeWidth', 'stroke'],
- backgroundColors: [true],
- connector: ['fill', 'strokeWidth', 'stroke'],
- crosshairX: ['strokeWidth', 'stroke'],
- crosshairY: ['strokeWidth', 'stroke']
- },
- // Simple shapes:
- circle: ['shapes'],
- verticalLine: [],
- label: ['labelOptions'],
- // Measure
- measure: ['background', 'crosshairY', 'crosshairX'],
- // Others:
- fibonacci: [],
- tunnel: ['background', 'line', 'height'],
- pitchfork: ['innerBackground', 'outerBackground'],
- rect: ['shapes'],
- // Crooked lines, elliots, arrows etc:
- crookedLine: []
- };
- // Define non editable fields per annotation, for example Rectangle inherits
- // options from Measure, but crosshairs are not available
- H.NavigationBindings.annotationsNonEditable = {
- rectangle: ['crosshairX', 'crosshairY', 'label']
- };
- extend(H.NavigationBindings.prototype, {
- // Private properties added by bindings:
- // Active (selected) annotation that is editted through popup/forms
- // activeAnnotation: Annotation
- // Holder for current step, used on mouse move to update bound object
- // mouseMoveEvent: function () {}
- // Next event in `step` array to be called on chart's click
- // nextEvent: function () {}
- // Index in the `step` array of the current event
- // stepIndex: 0
- // Flag to determine if current binding has steps
- // steps: true|false
- // Bindings holder for all events
- // selectedButton: {}
- // Holder for user options, returned from `start` event, and passed on to
- // `step`'s' and `end`.
- // currentUserDetails: {}
- /**
- * Initi all events conencted to NavigationBindings.
- *
- * @private
- * @function Highcharts.NavigationBindings#initEvents
- */
- initEvents: function () {
- var navigation = this,
- chart = navigation.chart,
- bindingsContainer = navigation.container,
- options = navigation.options;
- // Shorthand object for getting events for buttons:
- navigation.boundClassNames = {};
- objectEach(options.bindings, function (value) {
- navigation.boundClassNames[value.className] = value;
- });
- // Handle multiple containers with the same class names:
- [].forEach.call(bindingsContainer, function (subContainer) {
- navigation.eventsToUnbind.push(
- addEvent(
- subContainer,
- 'click',
- function (event) {
- var bindings = navigation.getButtonEvents(
- bindingsContainer,
- event
- );
- if (bindings) {
- navigation.bindingsButtonClick(
- bindings.button,
- bindings.events,
- event
- );
- }
- }
- )
- );
- });
- objectEach(options.events || {}, function (callback, eventName) {
- navigation.eventsToUnbind.push(
- addEvent(
- navigation,
- eventName,
- callback
- )
- );
- });
- navigation.eventsToUnbind.push(
- addEvent(chart.container, 'click', function (e) {
- if (
- !chart.cancelClick &&
- chart.isInsidePlot(
- e.chartX - chart.plotLeft,
- e.chartY - chart.plotTop
- )
- ) {
- navigation.bindingsChartClick(this, e);
- }
- })
- );
- navigation.eventsToUnbind.push(
- addEvent(chart.container, 'mousemove', function (e) {
- navigation.bindingsContainerMouseMove(this, e);
- })
- );
- },
- /**
- * Common chart.update() delegation, shared between bindings and exporting.
- *
- * @private
- * @function Highcharts.NavigationBindings#initUpdate
- */
- initUpdate: function () {
- var navigation = this;
- chartNavigationMixin.addUpdate(
- function (options) {
- navigation.update(options);
- },
- this.chart
- );
- },
- /**
- * Hook for click on a button, method selcts/unselects buttons,
- * then calls `bindings.init` callback.
- *
- * @private
- * @function Highcharts.NavigationBindings#bindingsButtonClick
- *
- * @param {Highcharts.HTMLDOMElement} [button]
- * Clicked button
- *
- * @param {object} [events]
- * Events passed down from bindings (`init`, `start`, `step`, `end`)
- *
- * @param {global.Event} [clickEvent]
- * Browser's click event
- */
- bindingsButtonClick: function (button, events, clickEvent) {
- var navigation = this,
- chart = navigation.chart;
- if (navigation.selectedButtonElement) {
- fireEvent(
- navigation,
- 'deselectButton',
- { button: navigation.selectedButtonElement }
- );
- if (navigation.nextEvent) {
- // Remove in-progress annotations adders:
- if (
- navigation.currentUserDetails &&
- navigation.currentUserDetails.coll === 'annotations'
- ) {
- chart.removeAnnotation(navigation.currentUserDetails);
- }
- navigation.mouseMoveEvent = navigation.nextEvent = false;
- }
- }
- navigation.selectedButton = events;
- navigation.selectedButtonElement = button;
- fireEvent(navigation, 'selectButton', { button: button });
- // Call "init" event, for example to open modal window
- if (events.init) {
- events.init.call(navigation, button, clickEvent);
- }
- if (events.start || events.steps) {
- chart.renderer.boxWrapper.addClass(PREFIX + 'draw-mode');
- }
- },
- /**
- * Hook for click on a chart, first click on a chart calls `start` event,
- * then on all subsequent clicks iterate over `steps` array.
- * When finished, calls `end` event.
- *
- * @private
- * @function Highcharts.NavigationBindings#bindingsChartClick
- *
- * @param {Highcharts.Chart} chart
- * Chart that click was performed on.
- *
- * @param {global.Event} clickEvent
- * Browser's click event.
- */
- bindingsChartClick: function (chartContainer, clickEvent) {
- var navigation = this,
- chart = navigation.chart,
- selectedButton = navigation.selectedButton,
- svgContainer = chart.renderer.boxWrapper;
- if (
- navigation.activeAnnotation &&
- !clickEvent.activeAnnotation &&
- // Element could be removed in the child action, e.g. button
- clickEvent.target.parentNode &&
- // TO DO: Polyfill for IE11?
- !clickEvent.target.closest('.' + PREFIX + 'popup')
- ) {
- fireEvent(navigation, 'closePopup');
- navigation.deselectAnnotation();
- }
- if (!selectedButton || !selectedButton.start) {
- return;
- }
- if (!navigation.nextEvent) {
- // Call init method:
- navigation.currentUserDetails = selectedButton.start.call(
- navigation,
- clickEvent
- );
- // If steps exists (e.g. Annotations), bind them:
- if (selectedButton.steps) {
- navigation.stepIndex = 0;
- navigation.steps = true;
- navigation.mouseMoveEvent = navigation.nextEvent =
- selectedButton.steps[navigation.stepIndex];
- } else {
- fireEvent(
- navigation,
- 'deselectButton',
- { button: navigation.selectedButtonElement }
- );
- svgContainer.removeClass(PREFIX + 'draw-mode');
- navigation.steps = false;
- navigation.selectedButton = null;
- // First click is also the last one:
- if (selectedButton.end) {
- selectedButton.end.call(
- navigation,
- clickEvent,
- navigation.currentUserDetails
- );
- }
- }
- } else {
- navigation.nextEvent(
- clickEvent,
- navigation.currentUserDetails
- );
- if (navigation.steps) {
- navigation.stepIndex++;
- if (selectedButton.steps[navigation.stepIndex]) {
- // If we have more steps, bind them one by one:
- navigation.mouseMoveEvent = navigation.nextEvent =
- selectedButton.steps[navigation.stepIndex];
- } else {
- fireEvent(
- navigation,
- 'deselectButton',
- { button: navigation.selectedButtonElement }
- );
- svgContainer.removeClass(PREFIX + 'draw-mode');
- // That was the last step, call end():
- if (selectedButton.end) {
- selectedButton.end.call(
- navigation,
- clickEvent,
- navigation.currentUserDetails
- );
- }
- navigation.nextEvent = false;
- navigation.mouseMoveEvent = false;
- navigation.selectedButton = null;
- }
- }
- }
- },
- /**
- * Hook for mouse move on a chart's container. It calls current step.
- *
- * @private
- * @function Highcharts.NavigationBindings#bindingsContainerMouseMove
- *
- * @param {Highcharts.HTMLDOMElement} container
- * Chart's container.
- *
- * @param {global.Event} moveEvent
- * Browser's move event.
- */
- bindingsContainerMouseMove: function (container, moveEvent) {
- if (this.mouseMoveEvent) {
- this.mouseMoveEvent(
- moveEvent,
- this.currentUserDetails
- );
- }
- },
- /**
- * Translate fields (e.g. `params.period` or `marker.styles.color`) to
- * Highcharts options object (e.g. `{ params: { period } }`).
- *
- * @private
- * @function Highcharts.NavigationBindings#fieldsToOptions
- *
- * @param {object} fields
- * Fields from popup form.
- *
- * @param {object} config
- * Default config to be modified.
- *
- * @return {object}
- * Modified config
- */
- fieldsToOptions: function (fields, config) {
- objectEach(fields, function (value, field) {
- var parsedValue = parseFloat(value),
- path = field.split('.'),
- parent = config,
- pathLength = path.length - 1;
- // If it's a number (not "forma" options), parse it:
- if (
- isNumber(parsedValue) &&
- !value.match(/px/g) &&
- !field.match(/format/g)
- ) {
- value = parsedValue;
- }
- // Remove empty strings or values like 0
- if (value !== '' && value !== 'undefined') {
- path.forEach(function (name, index) {
- var nextName = pick(path[index + 1], '');
- if (pathLength === index) {
- // Last index, put value:
- parent[name] = value;
- } else if (!parent[name]) {
- // Create middle property:
- parent[name] = nextName.match(/\d/g) ? [] : {};
- parent = parent[name];
- } else {
- // Jump into next property
- parent = parent[name];
- }
- });
- }
- });
- return config;
- },
- /**
- * Shorthand method to deselect an annotation.
- *
- * @function Highcharts.NavigationBindings#deselectAnnotation
- */
- deselectAnnotation: function () {
- if (this.activeAnnotation) {
- this.activeAnnotation.setControlPointsVisibility(false);
- this.activeAnnotation = false;
- }
- },
- /**
- * Generates API config for popup in the same format as options for
- * Annotation object.
- *
- * @function Highcharts.NavigationBindings#annotationToFields
- *
- * @param {Highcharts.Annotation} annotation
- * Annotations object
- *
- * @return {object}
- * Annotation options to be displayed in popup box
- */
- annotationToFields: function (annotation) {
- var options = annotation.options,
- editables = H.NavigationBindings.annotationsEditable,
- nestedEditables = editables.nestedOptions,
- getFieldType = this.utils.getFieldType,
- type = pick(
- options.type,
- options.shapes && options.shapes[0] &&
- options.shapes[0].type,
- options.labels && options.labels[0] &&
- options.labels[0].itemType,
- 'label'
- ),
- nonEditables = H.NavigationBindings
- .annotationsNonEditable[options.langKey] || [],
- visualOptions = {
- langKey: options.langKey,
- type: type
- };
- /**
- * Nested options traversing. Method goes down to the options and copies
- * allowed options (with values) to new object, which is last parameter:
- * "parent".
- *
- * @private
- * @function Highcharts.NavigationBindings#annotationToFields.traverse
- *
- * @param {*} option
- * Atomic type or object/array
- *
- * @param {string} key
- * Option name, for example "visible" or "x", "y"
- *
- * @param {object} allowed
- * Editables from H.NavigationBindings.annotationsEditable
- *
- * @param {object} parent
- * Where new options will be assigned
- */
- function traverse(option, key, parentEditables, parent) {
- var nextParent;
- if (
- parentEditables &&
- nonEditables.indexOf(key) === -1 &&
- (
- (
- parentEditables.indexOf &&
- parentEditables.indexOf(key)
- ) >= 0 ||
- parentEditables[key] || // nested array
- parentEditables === true // simple array
- )
- ) {
- // Roots:
- if (isArray(option)) {
- parent[key] = [];
- option.forEach(function (arrayOption, i) {
- if (!isObject(arrayOption)) {
- // Simple arrays, e.g. [String, Number, Boolean]
- traverse(
- arrayOption,
- 0,
- nestedEditables[key],
- parent[key]
- );
- } else {
- // Advanced arrays, e.g. [Object, Object]
- parent[key][i] = {};
- objectEach(
- arrayOption,
- function (nestedOption, nestedKey) {
- traverse(
- nestedOption,
- nestedKey,
- nestedEditables[key],
- parent[key][i]
- );
- }
- );
- }
- });
- } else if (isObject(option)) {
- nextParent = {};
- if (isArray(parent)) {
- parent.push(nextParent);
- nextParent[key] = {};
- nextParent = nextParent[key];
- } else {
- parent[key] = nextParent;
- }
- objectEach(option, function (nestedOption, nestedKey) {
- traverse(
- nestedOption,
- nestedKey,
- key === 0 ? parentEditables : nestedEditables[key],
- nextParent
- );
- });
- } else {
- // Leaf:
- if (key === 'format') {
- parent[key] = [
- H.format(
- option,
- annotation.labels[0].points[0]
- ).toString(),
- 'text'
- ];
- } else if (isArray(parent)) {
- parent.push([option, getFieldType(option)]);
- } else {
- parent[key] = [option, getFieldType(option)];
- }
- }
- }
- }
- objectEach(options, function (option, key) {
- if (key === 'typeOptions') {
- visualOptions[key] = {};
- objectEach(options[key], function (typeOption, typeKey) {
- traverse(
- typeOption,
- typeKey,
- nestedEditables,
- visualOptions[key],
- true
- );
- });
- } else {
- traverse(option, key, editables[type], visualOptions);
- }
- });
- return visualOptions;
- },
- /**
- * Get all class names for all parents in the element. Iterates until finds
- * main container.
- *
- * @function Highcharts.NavigationBindings#getClickedClassNames
- *
- * @param {Highcharts.HTMLDOMElement}
- * Container that event is bound to.
- *
- * @param {global.Event} event
- * Browser's event.
- *
- * @return {Array<string>}
- * Array of class names with corresponding elements
- */
- getClickedClassNames: function (container, event) {
- var element = event.target,
- classNames = [],
- elemClassName;
- while (element) {
- elemClassName = H.attr(element, 'class');
- if (elemClassName) {
- classNames = classNames.concat(
- elemClassName.split(' ').map(
- function (name) { // eslint-disable-line no-loop-func
- return [
- name,
- element
- ];
- }
- )
- );
- }
- element = element.parentNode;
- if (element === container) {
- return classNames;
- }
- }
- return classNames;
- },
- /**
- * Get events bound to a button. It's a custom event delegation to find all
- * events connected to the element.
- *
- * @function Highcharts.NavigationBindings#getButtonEvents
- *
- * @param {Highcharts.HTMLDOMElement}
- * Container that event is bound to.
- *
- * @param {global.Event} event
- * Browser's event.
- *
- * @return {object}
- * Oject with events (init, start, steps, and end)
- */
- getButtonEvents: function (container, event) {
- var navigation = this,
- classNames = this.getClickedClassNames(container, event),
- bindings;
- classNames.forEach(function (className) {
- if (navigation.boundClassNames[className[0]] && !bindings) {
- bindings = {
- events: navigation.boundClassNames[className[0]],
- button: className[1]
- };
- }
- });
- return bindings;
- },
- /**
- * Bindings are just events, so the whole update process is simply
- * removing old events and adding new ones.
- *
- * @private
- * @function Highcharts.NavigationBindings#update
- */
- update: function (options) {
- this.options = merge(true, this.options, options);
- this.removeEvents();
- this.initEvents();
- },
- /**
- * Remove all events created in the navigation.
- *
- * @private
- * @function Highcharts.NavigationBindings#removeEvents
- */
- removeEvents: function () {
- this.eventsToUnbind.forEach(function (unbinder) {
- unbinder();
- });
- },
- destroy: function () {
- this.removeEvents();
- },
- /**
- * General utils for bindings
- *
- * @private
- * @name Highcharts.NavigationBindings#utils
- * @type {bindingsUtils}
- */
- utils: bindingsUtils
- });
- H.Chart.prototype.initNavigationBindings = function () {
- var chart = this,
- options = chart.options;
- if (options && options.navigation && options.navigation.bindings) {
- chart.navigationBindings = new H.NavigationBindings(
- chart,
- options.navigation
- );
- chart.navigationBindings.initEvents();
- chart.navigationBindings.initUpdate();
- }
- };
- addEvent(H.Chart, 'load', function () {
- this.initNavigationBindings();
- });
- addEvent(H.Chart, 'destroy', function () {
- if (this.navigationBindings) {
- this.navigationBindings.destroy();
- }
- });
- addEvent(H.NavigationBindings, 'deselectButton', function () {
- this.selectedButtonElement = null;
- });
- // Show edit-annotation form:
- function selectableAnnotation(annotationType) {
- var originalClick = annotationType.prototype.defaultOptions.events &&
- annotationType.prototype.defaultOptions.events.click;
- function selectAndshowPopup(event) {
- var annotation = this,
- navigation = annotation.chart.navigationBindings,
- prevAnnotation = navigation.activeAnnotation;
- if (originalClick) {
- originalClick.click.call(annotation, event);
- }
- if (prevAnnotation !== annotation) {
- // Select current:
- navigation.deselectAnnotation();
- navigation.activeAnnotation = annotation;
- annotation.setControlPointsVisibility(true);
- fireEvent(
- navigation,
- 'showPopup',
- {
- annotation: annotation,
- formType: 'annotation-toolbar',
- options: navigation.annotationToFields(annotation),
- onSubmit: function (data) {
- var config = {},
- typeOptions;
- if (data.actionType === 'remove') {
- navigation.activeAnnotation = false;
- navigation.chart.removeAnnotation(annotation);
- } else {
- navigation.fieldsToOptions(data.fields, config);
- navigation.deselectAnnotation();
- typeOptions = config.typeOptions;
- if (annotation.options.type === 'measure') {
- // Manually disable crooshars according to
- // stroke width of the shape:
- typeOptions.crosshairY.enabled =
- typeOptions.crosshairY.strokeWidth !== 0;
- typeOptions.crosshairX.enabled =
- typeOptions.crosshairX.strokeWidth !== 0;
- }
- annotation.update(config);
- }
- }
- }
- );
- } else {
- // Deselect current:
- navigation.deselectAnnotation();
- fireEvent(navigation, 'closePopup');
- }
- // Let bubble event to chart.click:
- event.activeAnnotation = true;
- }
- H.merge(
- true,
- annotationType.prototype.defaultOptions.events,
- {
- click: selectAndshowPopup
- }
- );
- }
- if (H.Annotation) {
- // Basic shapes:
- selectableAnnotation(H.Annotation);
- // Advanced annotations:
- H.objectEach(H.Annotation.types, function (annotationType) {
- selectableAnnotation(annotationType);
- });
- }
- H.setOptions({
- /**
- * @optionparent lang
- */
- lang: {
- /**
- * Configure the Popup strings in the chart. Requires the
- * `annotations.js` or `annotations-advanced.src.js` module to be
- * loaded.
- *
- * @since 7.0.0
- * @type {Object}
- * @product highcharts highstock
- */
- navigation: {
- /**
- * Translations for all field names used in popup.
- *
- * @product highcharts highstock
- * @type {Object}
- */
- popup: {
- simpleShapes: 'Simple shapes',
- lines: 'Lines',
- circle: 'Circle',
- rectangle: 'Rectangle',
- label: 'Label',
- shapeOptions: 'Shape options',
- typeOptions: 'Details',
- fill: 'Fill',
- format: 'Text',
- strokeWidth: 'Line width',
- stroke: 'Line color',
- title: 'Title',
- name: 'Name',
- labelOptions: 'Label options',
- labels: 'Labels',
- backgroundColor: 'Background color',
- backgroundColors: 'Background colors',
- borderColor: 'Border color',
- borderRadius: 'Border radius',
- borderWidth: 'Border width',
- style: 'Style',
- padding: 'Padding',
- fontSize: 'Font size',
- color: 'Color',
- height: 'Height',
- shapes: 'Shape options'
- }
- }
- },
- /**
- * @optionparent navigation
- * @product highcharts highstock
- */
- navigation: {
- /**
- * A CSS class name where all bindings will be attached to. Multiple
- * charts on the same page should have separate class names to prevent
- * duplicating events.
- *
- * @since 7.0.0
- * @type {string}
- */
- bindingsClassName: 'highcharts-bindings-wrapper',
- /**
- * Bindings definitions for custom HTML buttons. Each binding implements
- * simple event-driven interface:
- *
- * - `className`: classname used to bind event to
- *
- * - `init`: initial event, fired on button click
- *
- * - `start`: fired on first click on a chart
- *
- * - `steps`: array of sequential events fired one after another on each
- * of users clicks
- *
- * - `end`: last event to be called after last step event
- *
- * @type {Highcharts.Dictionary<Highcharts.StockToolsBindingsObject>|*}
- * @sample stock/stocktools/stocktools-thresholds
- * Custom bindings in Highstock
- * @since 7.0.0
- * @product highcharts highstock
- */
- bindings: {
- /**
- * A circle annotation bindings. Includes `start` and one event in
- * `steps` array.
- *
- * @type {Highcharts.StockToolsBindingsObject}
- * @default {"className": "highcharts-circle-annotation", "start": function() {}, "steps": [function() {}]}
- */
- circleAnnotation: {
- /** @ignore */
- className: 'highcharts-circle-annotation',
- /** @ignore */
- start: function (e) {
- var x = this.chart.xAxis[0].toValue(e.chartX),
- y = this.chart.yAxis[0].toValue(e.chartY),
- annotation;
- annotation = this.chart.addAnnotation({
- langKey: 'circle',
- shapes: [{
- type: 'circle',
- point: {
- xAxis: 0,
- yAxis: 0,
- x: x,
- y: y
- },
- r: 5,
- controlPoints: [{
- positioner: function (target) {
- var xy = H.Annotation.MockPoint
- .pointToPixels(
- target.points[0]
- ),
- r = target.options.r;
- return {
- x: xy.x + r * Math.cos(Math.PI / 4) -
- this.graphic.width / 2,
- y: xy.y + r * Math.sin(Math.PI / 4) -
- this.graphic.height / 2
- };
- },
- events: {
- // TRANSFORM RADIUS ACCORDING TO Y
- // TRANSLATION
- drag: function (e, target) {
- var annotation = target.annotation,
- position = this
- .mouseMoveToTranslation(e);
- target.setRadius(
- Math.max(
- target.options.r +
- position.y /
- Math.sin(Math.PI / 4),
- 5
- )
- );
- annotation.options.shapes[0] =
- annotation.userOptions.shapes[0] =
- target.options;
- target.redraw(false);
- }
- }
- }]
- }]
- });
- return annotation;
- },
- /** @ignore */
- steps: [
- function (e, annotation) {
- var point = annotation.options.shapes[0].point,
- x = this.chart.xAxis[0].toPixels(point.x),
- y = this.chart.yAxis[0].toPixels(point.y),
- distance = Math.max(
- Math.sqrt(
- Math.pow(x - e.chartX, 2) +
- Math.pow(y - e.chartY, 2)
- ),
- 5
- );
- annotation.update({
- shapes: [{
- r: distance
- }]
- });
- }
- ]
- },
- /**
- * A rectangle annotation bindings. Includes `start` and one event
- * in `steps` array.
- *
- * @type {Highcharts.StockToolsBindingsObject}
- * @default {"className": "highcharts-rectangle-annotation", "start": function() {}, "steps": [function() {}]}
- */
- rectangleAnnotation: {
- /** @ignore */
- className: 'highcharts-rectangle-annotation',
- /** @ignore */
- start: function (e) {
- var x = this.chart.xAxis[0].toValue(e.chartX),
- y = this.chart.yAxis[0].toValue(e.chartY),
- options = {
- langKey: 'rectangle',
- shapes: [{
- type: 'rect',
- point: {
- x: x,
- y: y,
- xAxis: 0,
- yAxis: 0
- },
- width: 5,
- height: 5,
- controlPoints: [{
- positioner: function (target) {
- var xy = H.Annotation.MockPoint
- .pointToPixels(
- target.points[0]
- );
- return {
- x: xy.x + target.options.width - 4,
- y: xy.y + target.options.height - 4
- };
- },
- events: {
- drag: function (e, target) {
- var annotation = target.annotation,
- xy = this
- .mouseMoveToTranslation(e);
- target.options.width = Math.max(
- target.options.width + xy.x,
- 5
- );
- target.options.height = Math.max(
- target.options.height + xy.y,
- 5
- );
- annotation.options.shapes[0] =
- target.options;
- annotation.userOptions.shapes[0] =
- target.options;
- target.redraw(false);
- }
- }
- }]
- }]
- };
- return this.chart.addAnnotation(options);
- },
- /** @ignore */
- steps: [
- function (e, annotation) {
- var xAxis = this.chart.xAxis[0],
- yAxis = this.chart.yAxis[0],
- point = annotation.options.shapes[0].point,
- x = xAxis.toPixels(point.x),
- y = yAxis.toPixels(point.y),
- width = Math.max(e.chartX - x, 5),
- height = Math.max(e.chartY - y, 5);
- annotation.update({
- shapes: [{
- width: width,
- height: height,
- point: {
- x: point.x,
- y: point.y
- }
- }]
- });
- }
- ]
- },
- /**
- * A label annotation bindings. Includes `start` event only.
- *
- * @type {Highcharts.StockToolsBindingsObject}
- * @default {"className": "highcharts-label-annotation", "start": function() {}, "steps": [function() {}]}
- */
- labelAnnotation: {
- /** @ignore */
- className: 'highcharts-label-annotation',
- /** @ignore */
- start: function (e) {
- var x = this.chart.xAxis[0].toValue(e.chartX),
- y = this.chart.yAxis[0].toValue(e.chartY);
- this.chart.addAnnotation({
- langKey: 'label',
- labelOptions: {
- format: '{y:.2f}'
- },
- labels: [{
- point: {
- x: x,
- y: y,
- xAxis: 0,
- yAxis: 0
- },
- controlPoints: [{
- symbol: 'triangle-down',
- positioner: function (target) {
- if (!target.graphic.placed) {
- return {
- x: 0,
- y: -9e7
- };
- }
- var xy = H.Annotation.MockPoint
- .pointToPixels(
- target.points[0]
- );
- return {
- x: xy.x - this.graphic.width / 2,
- y: xy.y - this.graphic.height / 2
- };
- },
- // TRANSLATE POINT/ANCHOR
- events: {
- drag: function (e, target) {
- var xy = this.mouseMoveToTranslation(e);
- target.translatePoint(xy.x, xy.y);
- target.annotation.labels[0].options =
- target.options;
- target.redraw(false);
- }
- }
- }, {
- symbol: 'square',
- positioner: function (target) {
- if (!target.graphic.placed) {
- return {
- x: 0,
- y: -9e7
- };
- }
- return {
- x: target.graphic.alignAttr.x -
- this.graphic.width / 2,
- y: target.graphic.alignAttr.y -
- this.graphic.height / 2
- };
- },
- // TRANSLATE POSITION WITHOUT CHANGING THE
- // ANCHOR
- events: {
- drag: function (e, target) {
- var xy = this.mouseMoveToTranslation(e);
- target.translate(xy.x, xy.y);
- target.annotation.labels[0].options =
- target.options;
- target.redraw(false);
- }
- }
- }],
- overflow: 'none',
- crop: true
- }]
- });
- }
- }
- },
- /**
- * A `showPopup` event. Fired when selecting for example an annotation.
- *
- * @type {Function}
- * @apioption navigation.events.showPopup
- */
- /**
- * A `hidePopop` event. Fired when Popup should be hidden, for exampole
- * when clicking on an annotation again.
- *
- * @type {Function}
- * @apioption navigation.events.hidePopup
- */
- /**
- * Event fired on a button click.
- *
- * @type {Function}
- * @sample highcharts/annotations/gui/
- * Change icon in a dropddown on event
- * @sample highcharts/annotations/gui-buttons/
- * Change button class on event
- * @apioption navigation.events.selectButton
- */
- /**
- * Event fired when button state should change, for example after
- * adding an annotation.
- *
- * @type {Function}
- * @sample highcharts/annotations/gui/
- * Change icon in a dropddown on event
- * @sample highcharts/annotations/gui-buttons/
- * Change button class on event
- * @apioption navigation.events.deselectButton
- */
- /**
- * Events to communicate between Stock Tools and custom GUI.
- *
- * @since 7.0.0
- * @product highcharts highstock
- * @optionparent navigation.events
- */
- events: {}
- }
- });
- }(Highcharts, chartNavigation));
- (function (H) {
- /**
- * Popup generator for Stock tools
- *
- * (c) 2009-2017 Sebastian Bochan
- *
- * License: www.highcharts.com/license
- */
- var addEvent = H.addEvent,
- createElement = H.createElement,
- objectEach = H.objectEach,
- pick = H.pick,
- wrap = H.wrap,
- isString = H.isString,
- isObject = H.isObject,
- isArray = H.isArray,
- indexFilter = /\d/g,
- PREFIX = 'highcharts-',
- DIV = 'div',
- INPUT = 'input',
- LABEL = 'label',
- BUTTON = 'button',
- SELECT = 'select',
- OPTION = 'option',
- SPAN = 'span',
- UL = 'ul',
- LI = 'li',
- H3 = 'h3';
- // onContainerMouseDown blocks internal popup events, due to e.preventDefault.
- // Related issue #4606
- wrap(H.Pointer.prototype, 'onContainerMouseDown', function (proceed, e) {
- var popupClass = e.target && e.target.className;
- // elements is not in popup
- if (!(isString(popupClass) &&
- popupClass.indexOf(PREFIX + 'popup-field') >= 0)
- ) {
- proceed.apply(this, Array.prototype.slice.call(arguments, 1));
- }
- });
- H.Popup = function (parentDiv) {
- this.init(parentDiv);
- };
- H.Popup.prototype = {
- /*
- * Initialize the popup. Create base div and add close button.
- *
- * @param {HTMLDOMElement} - container where popup should be placed
- *
- * @return {HTMLDOMElement} - return created popup's div
- *
- */
- init: function (parentDiv) {
- // create popup div
- this.container = createElement(DIV, {
- className: PREFIX + 'popup'
- }, null, parentDiv);
- this.lang = this.getLangpack();
- // add close button
- this.addCloseBtn();
- },
- /*
- * Create HTML element and attach click event (close popup).
- *
- */
- addCloseBtn: function () {
- var _self = this,
- closeBtn;
- // create close popup btn
- closeBtn = createElement(DIV, {
- className: PREFIX + 'popup-close'
- }, null, this.container);
- ['click', 'touchstart'].forEach(function (eventName) {
- addEvent(closeBtn, eventName, function () {
- _self.closePopup();
- });
- });
- },
- /*
- * Create two columns (divs) in HTML.
- *
- * @param {HTMLDOMElement} - container of columns
- *
- * @return {Object} - reference to two HTML columns
- *
- */
- addColsContainer: function (container) {
- var rhsCol,
- lhsCol;
- // left column
- lhsCol = createElement(DIV, {
- className: PREFIX + 'popup-lhs-col'
- }, null, container);
- // right column
- rhsCol = createElement(DIV, {
- className: PREFIX + 'popup-rhs-col'
- }, null, container);
- // wrapper content
- createElement(DIV, {
- className: PREFIX + 'popup-rhs-col-wrapper'
- }, null, rhsCol);
- return {
- lhsCol: lhsCol,
- rhsCol: rhsCol
- };
- },
- /*
- * Create input with label.
- *
- * @param {String} - chain of fields i.e params.styles.fontSize
- * @param {String} - indicator type
- * @param {HTMLDOMElement} - container where elements should be added
- * @param {String} - dafault value of input i.e period value is 14,
- * extracted from defaultOptions (ADD mode) or series options (EDIT mode)
- *
- */
- addInput: function (option, type, parentDiv, value) {
- var optionParamList = option.split('.'),
- optionName = optionParamList[optionParamList.length - 1],
- lang = this.lang,
- inputName = PREFIX + type + '-' + optionName;
- if (!inputName.match(indexFilter)) {
- // add label
- createElement(
- LABEL, {
- innerHTML: lang[optionName] || optionName,
- htmlFor: inputName
- },
- null,
- parentDiv
- );
- }
- // add input
- createElement(
- INPUT,
- {
- name: inputName,
- value: value[0],
- type: value[1],
- className: PREFIX + 'popup-field'
- },
- null,
- parentDiv
- ).setAttribute(PREFIX + 'data-name', option);
- },
- /*
- * Create button.
- *
- * @param {HTMLDOMElement} - container where elements should be added
- * @param {String} - text placed as button label
- * @param {String} - add | edit | remove
- * @param {Function} - on click callback
- * @param {HTMLDOMElement} - container where inputs are generated
- *
- * @return {HTMLDOMElement} - html button
- */
- addButton: function (parentDiv, label, type, callback, fieldsDiv) {
- var _self = this,
- closePopup = this.closePopup,
- getFields = this.getFields,
- button;
- button = createElement(BUTTON, {
- innerHTML: label
- }, null, parentDiv);
- ['click', 'touchstart'].forEach(function (eventName) {
- addEvent(button, eventName, function () {
- closePopup.call(_self);
- return callback(
- getFields(fieldsDiv, type)
- );
- });
- });
- return button;
- },
- /*
- * Get values from all inputs and create JSON.
- *
- * @param {HTMLDOMElement} - container where inputs are created
- * @param {String} - add | edit | remove
- *
- * @return {Object} - fields
- */
- getFields: function (parentDiv, type) {
- var inputList = parentDiv.querySelectorAll('input'),
- optionSeries = '#' + PREFIX + 'select-series > option:checked',
- optionVolume = '#' + PREFIX + 'select-volume > option:checked',
- linkedTo = parentDiv.querySelectorAll(optionSeries)[0],
- volumeTo = parentDiv.querySelectorAll(optionVolume)[0],
- seriesId,
- param,
- fieldsOutput;
- fieldsOutput = {
- actionType: type,
- linkedTo: linkedTo && linkedTo.getAttribute('value'),
- fields: { }
- };
- inputList.forEach(function (input) {
- param = input.getAttribute(PREFIX + 'data-name');
- seriesId = input.getAttribute(PREFIX + 'data-series-id');
- // params
- if (seriesId) {
- fieldsOutput.seriesId = input.value;
- } else if (param) {
- fieldsOutput.fields[param] = input.value;
- } else {
- // type like sma / ema
- fieldsOutput.type = input.value;
- }
- });
- if (volumeTo) {
- fieldsOutput.fields['params.volumeSeriesID'] = volumeTo
- .getAttribute('value');
- }
- return fieldsOutput;
- },
- /*
- * Reset content of the current popup and show.
- *
- * @param {Chart} - chart
- * @param {Function} - on click callback
- *
- * @return {Object} - fields
- */
- showPopup: function () {
- var popupDiv = this.container,
- toolbarClass = PREFIX + 'annotation-toolbar',
- popupCloseBtn = popupDiv
- .querySelectorAll('.' + PREFIX + 'popup-close')[0];
- // reset content
- popupDiv.innerHTML = '';
- // reset toolbar styles if exists
- if (popupDiv.className.indexOf(toolbarClass) >= 0) {
- popupDiv.classList.remove(toolbarClass);
- // reset toolbar inline styles
- popupDiv.removeAttribute('style');
- }
- // add close button
- popupDiv.appendChild(popupCloseBtn);
- popupDiv.style.display = 'block';
- },
- /*
- * Hide popup.
- *
- */
- closePopup: function () {
- this.popup.container.style.display = 'none';
- },
- /*
- * Create content and show popup.
- *
- * @param {String} - type of popup i.e indicators
- * @param {Chart} - chart
- * @param {Object} - options
- * @param {Function} - on click callback
- *
- */
- showForm: function (type, chart, options, callback) {
- this.popup = chart.navigationBindings.popup;
- // show blank popup
- this.showPopup();
- // indicator form
- if (type === 'indicators') {
- this.indicators.addForm.call(this, chart, options, callback);
- }
- // annotation small toolbar
- if (type === 'annotation-toolbar') {
- this.annotations.addToolbar.call(this, chart, options, callback);
- }
- // annotation edit form
- if (type === 'annotation-edit') {
- this.annotations.addForm.call(this, chart, options, callback);
- }
- // flags form - add / edit
- if (type === 'flag') {
- this.annotations.addForm.call(this, chart, options, callback, true);
- }
- },
- /*
- * Return lang definitions for popup.
- *
- * @return {Object} - elements translations.
- */
- getLangpack: function () {
- return H.getOptions().lang.navigation.popup;
- },
- annotations: {
- /*
- * Create annotation simple form. It contains two buttons
- * (edit / remove) and text label.
- *
- * @param {Chart} - chart
- * @param {Object} - options
- * @param {Function} - on click callback
- *
- */
- addToolbar: function (chart, options, callback) {
- var _self = this,
- lang = this.lang,
- popupDiv = this.popup.container,
- showForm = this.showForm,
- toolbarClass = PREFIX + 'annotation-toolbar',
- button;
- // set small size
- if (popupDiv.className.indexOf(toolbarClass) === -1) {
- popupDiv.className += ' ' + toolbarClass;
- }
- // set position
- popupDiv.style.top = chart.plotTop + 10 + 'px';
- // create label
- createElement(SPAN, {
- innerHTML: pick(
- // Advanced annotations:
- lang[options.langKey] || options.langKey,
- // Basic shapes:
- options.shapes && options.shapes[0].type
- )
- }, null, popupDiv);
- // add buttons
- button = this.addButton(
- popupDiv,
- lang.removeButton || 'remove',
- 'remove',
- callback,
- popupDiv
- );
- button.className += ' ' + PREFIX + 'annotation-remove-button';
- button = this.addButton(
- popupDiv,
- lang.editButton || 'edit',
- 'edit',
- function () {
- showForm.call(
- _self,
- 'annotation-edit',
- chart,
- options,
- callback
- );
- },
- popupDiv
- );
- button.className += ' ' + PREFIX + 'annotation-edit-button';
- },
- /*
- * Create annotation simple form.
- * It contains fields with param names.
- *
- * @param {Chart} - chart
- * @param {Object} - options
- * @param {Function} - on click callback
- * @param {Boolean} - if it is a form declared for init annotation
- *
- */
- addForm: function (chart, options, callback, isInit) {
- var popupDiv = this.popup.container,
- lang = this.lang,
- bottomRow,
- lhsCol;
- // create title of annotations
- lhsCol = createElement('h2', {
- innerHTML: lang[options.langKey] || options.langKey,
- className: PREFIX + 'popup-main-title'
- }, null, popupDiv);
- // left column
- lhsCol = createElement(DIV, {
- className: PREFIX + 'popup-lhs-col ' + PREFIX + 'popup-lhs-full'
- }, null, popupDiv);
- bottomRow = createElement(DIV, {
- className: PREFIX + 'popup-bottom-row'
- }, null, popupDiv);
- this.annotations.addFormFields.call(
- this,
- lhsCol,
- chart,
- '',
- options,
- [],
- true
- );
- this.addButton(
- bottomRow,
- isInit ?
- (lang.addButton || 'add') :
- (lang.saveButton || 'save'),
- isInit ? 'add' : 'save',
- callback,
- popupDiv
- );
- },
- /*
- * Create annotation's form fields.
- *
- * @param {HTMLDOMElement} - div where inputs are placed
- * @param {Chart} - chart
- * @param {String} - name of parent to create chain of names
- * @param {Object} - options
- * @param {Array} - storage - array where all items are stored
- * @param {Boolean} - isRoot - recursive flag for root
- *
- */
- addFormFields: function (
- parentDiv,
- chart,
- parentNode,
- options,
- storage,
- isRoot
- ) {
- var _self = this,
- addFormFields = this.annotations.addFormFields,
- addInput = this.addInput,
- lang = this.lang,
- parentFullName,
- titleName;
- objectEach(options, function (value, option) {
- // create name like params.styles.fontSize
- parentFullName = parentNode !== '' ?
- parentNode + '.' + option : option;
- if (isObject(value)) {
- if (
- // value is object of options
- !isArray(value) ||
- // array of objects with params. i.e labels in Fibonacci
- (isArray(value) && isObject(value[0]))
- ) {
- titleName = lang[option] || option;
- if (!titleName.match(indexFilter)) {
- storage.push([
- true,
- titleName,
- parentDiv
- ]);
- }
- addFormFields.call(
- _self,
- parentDiv,
- chart,
- parentFullName,
- value,
- storage,
- false
- );
- } else {
- storage.push([
- _self,
- parentFullName,
- 'annotation',
- parentDiv,
- value
- ]);
- }
- }
- });
- if (isRoot) {
- storage = storage.sort(function (a) {
- return a[1].match(/format/g) ? -1 : 1;
- });
- storage.forEach(function (genInput) {
- if (genInput[0] === true) {
- createElement(SPAN, {
- className: PREFIX + 'annotation-title',
- innerHTML: genInput[1]
- }, null, genInput[2]);
- } else {
- addInput.apply(genInput[0], genInput.splice(1));
- }
- });
- }
- }
- },
- indicators: {
- /*
- * Create indicator's form. It contains two tabs (ADD and EDIT) with
- * content.
- *
- * @param {Chart} - chart
- * @param {Object} - options
- * @param {Function} - on click callback
- *
- */
- addForm: function (chart, options, callback) {
- var tabsContainers,
- indicators = this.indicators,
- lang = this.lang,
- buttonParentDiv;
- // add tabs
- this.tabs.init.call(this, chart);
- // get all tabs content divs
- tabsContainers = this.popup.container
- .querySelectorAll('.' + PREFIX + 'tab-item-content');
- // ADD tab
- this.addColsContainer(tabsContainers[0]);
- indicators.addIndicatorList.call(
- this,
- chart,
- tabsContainers[0],
- 'add'
- );
- buttonParentDiv = tabsContainers[0]
- .querySelectorAll('.' + PREFIX + 'popup-rhs-col')[0];
- this.addButton(
- buttonParentDiv,
- lang.addButton || 'add',
- 'add',
- callback,
- buttonParentDiv
- );
- // EDIT tab
- this.addColsContainer(tabsContainers[1]);
- indicators.addIndicatorList.call(
- this,
- chart,
- tabsContainers[1],
- 'edit'
- );
- buttonParentDiv = tabsContainers[1]
- .querySelectorAll('.' + PREFIX + 'popup-rhs-col')[0];
- this.addButton(
- buttonParentDiv,
- lang.saveButton || 'save',
- 'edit',
- callback,
- buttonParentDiv
- );
- this.addButton(
- buttonParentDiv,
- lang.removeButton || 'remove',
- 'remove',
- callback,
- buttonParentDiv
- );
- },
- /*
- * Create HTML list of all indicators (ADD mode) or added indicators
- * (EDIT mode).
- *
- * @param {Chart} - chart
- * @param {HTMLDOMElement} - container where list is added
- * @param {String} - 'edit' or 'add' mode
- *
- */
- addIndicatorList: function (chart, parentDiv, listType) {
- var _self = this,
- lhsCol = parentDiv
- .querySelectorAll('.' + PREFIX + 'popup-lhs-col')[0],
- rhsCol = parentDiv
- .querySelectorAll('.' + PREFIX + 'popup-rhs-col')[0],
- defaultOptions = H.getOptions(),
- isEdit = listType === 'edit',
- series = isEdit ? chart.series : // EDIT mode
- defaultOptions.plotOptions, // ADD mode
- addFormFields = this.indicators.addFormFields,
- rhsColWrapper,
- indicatorList,
- item;
- // create wrapper for list
- indicatorList = createElement(UL, {
- className: PREFIX + 'indicator-list'
- }, null, lhsCol);
- rhsColWrapper = rhsCol
- .querySelectorAll('.' + PREFIX + 'popup-rhs-col-wrapper')[0];
- objectEach(series, function (serie, value) {
- var seriesOptions = serie.options;
- if (
- serie.params ||
- seriesOptions && seriesOptions.params
- ) {
- var indicatorNameType = _self.indicators
- .getNameType(serie, value),
- indicatorType = indicatorNameType.type;
- item = createElement(LI, {
- className: PREFIX + 'indicator-list',
- innerHTML: indicatorNameType.name
- }, null, indicatorList);
- ['click', 'touchstart'].forEach(function (eventName) {
- addEvent(item, eventName, function () {
- addFormFields.call(
- _self,
- chart,
- isEdit ? serie : series[indicatorType],
- indicatorNameType.type,
- rhsColWrapper
- );
- // add hidden input with series.id
- if (isEdit && serie.options) {
- createElement(INPUT, {
- type: 'hidden',
- name: PREFIX + 'id-' + indicatorType,
- value: serie.options.id
- }, null, rhsColWrapper)
- .setAttribute(
- PREFIX + 'data-series-id',
- serie.options.id
- );
- }
- });
- });
- }
- });
- // select first item from the list
- if (indicatorList.childNodes.length > 0) {
- indicatorList.childNodes[0].click();
- }
- },
- /*
- * Extract full name and type of requested indicator.
- *
- * @param {Series} - series which name is needed.
- * (EDIT mode - defaultOptions.series, ADD mode - indicator series).
- * @param {String} - indicator type like: sma, ema, etc.
- *
- * @return {Object} - series name and type like: sma, ema, etc.
- *
- */
- getNameType: function (series, type) {
- var options = series.options,
- seriesTypes = H.seriesTypes,
- // add mode
- seriesName = seriesTypes[type] &&
- seriesTypes[type].prototype.nameBase || type.toUpperCase(),
- seriesType = type;
- // edit
- if (options && options.type) {
- seriesType = series.options.type;
- seriesName = series.name;
- }
- return {
- name: seriesName,
- type: seriesType
- };
- },
- /*
- * List all series with unique ID. Its mandatory for indicators to set
- * correct linking.
- *
- * @param {String} - indicator type like: sma, ema, etc.
- * @param {String} - type of select i.e series or volume.
- * @param {Chart} - chart
- * @param {HTMLDOMElement} - element where created HTML list is added
- *
- */
- listAllSeries: function (type, optionName, chart, parentDiv) {
- var selectName = PREFIX + optionName + '-type-' + type,
- lang = this.lang,
- selectBox,
- seriesOptions;
- createElement(
- LABEL, {
- innerHTML: lang[optionName] || optionName,
- htmlFor: selectName
- },
- null,
- parentDiv
- );
- // select type
- selectBox = createElement(
- SELECT,
- {
- name: selectName,
- className: PREFIX + 'popup-field'
- },
- null,
- parentDiv
- );
- selectBox.setAttribute('id', PREFIX + 'select-' + optionName);
- // list all series which have id - mandatory for creating indicator
- chart.series.forEach(function (serie) {
- seriesOptions = serie.options;
- if (
- !seriesOptions.params &&
- seriesOptions.id &&
- seriesOptions.id !== PREFIX + 'navigator-series'
- ) {
- createElement(
- OPTION,
- {
- innerHTML: seriesOptions.name || seriesOptions.id,
- value: seriesOptions.id
- },
- null,
- selectBox
- );
- }
- });
- },
- /*
- * Create typical inputs for chosen indicator. Fields are extracted from
- * defaultOptions (ADD mode) or current indicator (ADD mode). Two extra
- * fields are added:
- * - hidden input - contains indicator type (required for callback)
- * - select - list of series which can be linked with indicator
- *
- * @param {Chart} - chart
- * @param {Series} - indicator
- * @param {String} - indicator type like: sma, ema, etc.
- * @param {HTMLDOMElement} - element where created HTML list is added
- *
- */
- addFormFields: function (chart, series, seriesType, rhsColWrapper) {
- var fields = series.params || series.options.params,
- getNameType = this.indicators.getNameType;
- // reset current content
- rhsColWrapper.innerHTML = '';
- // create title (indicator name in the right column)
- createElement(
- H3,
- {
- className: PREFIX + 'indicator-title',
- innerHTML: getNameType(series, seriesType).name
- },
- null,
- rhsColWrapper
- );
- // input type
- createElement(
- INPUT,
- {
- type: 'hidden',
- name: PREFIX + 'type-' + seriesType,
- value: seriesType
- },
- null,
- rhsColWrapper
- );
- // list all series with id
- this.indicators.listAllSeries.call(
- this,
- seriesType,
- 'series',
- chart,
- rhsColWrapper
- );
- if (fields.volumeSeriesID) {
- this.indicators.listAllSeries.call(
- this,
- seriesType,
- 'volume',
- chart,
- rhsColWrapper
- );
- }
- // add param fields
- this.indicators.addParamInputs.call(
- this,
- chart,
- 'params',
- fields,
- seriesType,
- rhsColWrapper
- );
- },
- /*
- * Recurent function which lists all fields, from params object and
- * create them as inputs. Each input has unique `data-name` attribute,
- * which keeps chain of fields i.e params.styles.fontSize.
- *
- * @param {Chart} - chart
- * @param {String} - name of parent to create chain of names
- * @param {Series} - fields - params which are based for input create
- * @param {String} - indicator type like: sma, ema, etc.
- * @param {HTMLDOMElement} - element where created HTML list is added
- *
- */
- addParamInputs: function (chart, parentNode, fields, type, parentDiv) {
- var _self = this,
- addParamInputs = this.indicators.addParamInputs,
- addInput = this.addInput,
- parentFullName;
- objectEach(fields, function (value, fieldName) {
- // create name like params.styles.fontSize
- parentFullName = parentNode + '.' + fieldName;
- if (isObject(value)) {
- addParamInputs.call(
- _self,
- chart,
- parentFullName,
- value,
- type,
- parentDiv
- );
- } else if (
- // skip volume field which is created by addFormFields
- parentFullName !== 'params.volumeSeriesID'
- ) {
- addInput.call(
- _self,
- parentFullName,
- type,
- parentDiv,
- [value, 'text'] // all inputs are text type
- );
- }
- });
- },
- /*
- * Get amount of indicators added to chart.
- *
- * @return {Number} - Amount of indicators
- */
- getAmount: function () {
- var series = this.series,
- counter = 0;
- objectEach(series, function (serie) {
- var seriesOptions = serie.options;
- if (
- serie.params ||
- seriesOptions && seriesOptions.params
- ) {
- counter++;
- }
- });
- return counter;
- }
- },
- tabs: {
- /*
- * Init tabs. Create tab menu items, tabs containers
- *
- * @param {Chart} - reference to current chart
- *
- */
- init: function (chart) {
- var tabs = this.tabs,
- indicatorsCount = this.indicators.getAmount.call(chart),
- firstTab; // run by default
- // create menu items
- firstTab = tabs.addMenuItem.call(this, 'add');
- tabs.addMenuItem.call(this, 'edit', indicatorsCount);
- // create tabs containers
- tabs.addContentItem.call(this, 'add');
- tabs.addContentItem.call(this, 'edit');
- tabs.switchTabs.call(this, indicatorsCount);
- // activate first tab
- tabs.selectTab.call(this, firstTab, 0);
- },
- /*
- * Create tab menu item
- *
- * @param {String} - `add` or `edit`
- * @param {Number} - Disable tab when 0
- *
- * @return {HTMLDOMElement} - created HTML tab-menu element
- */
- addMenuItem: function (tabName, disableTab) {
- var popupDiv = this.popup.container,
- className = PREFIX + 'tab-item',
- lang = this.lang,
- menuItem;
- if (disableTab === 0) {
- className += ' ' + PREFIX + 'tab-disabled';
- }
- // tab 1
- menuItem = createElement(
- SPAN,
- {
- innerHTML: lang[tabName + 'Button'] || tabName,
- className: className
- },
- null,
- popupDiv
- );
- menuItem.setAttribute(PREFIX + 'data-tab-type', tabName);
- return menuItem;
- },
- /*
- * Create tab content
- *
- * @return {HTMLDOMElement} - created HTML tab-content element
- *
- */
- addContentItem: function () {
- var popupDiv = this.popup.container;
- return createElement(
- DIV,
- {
- className: PREFIX + 'tab-item-content'
- },
- null,
- popupDiv
- );
- },
- /*
- * Add click event to each tab
- *
- * @param {Number} - Disable tab when 0
- *
- */
- switchTabs: function (disableTab) {
- var _self = this,
- popupDiv = this.popup.container,
- tabs = popupDiv.querySelectorAll('.' + PREFIX + 'tab-item'),
- dataParam;
- tabs.forEach(function (tab, i) {
- dataParam = tab.getAttribute(PREFIX + 'data-tab-type');
- if (dataParam === 'edit' && disableTab === 0) {
- return;
- }
- ['click', 'touchstart'].forEach(function (eventName) {
- addEvent(tab, eventName, function () {
- // reset class on other elements
- _self.tabs.deselectAll.call(_self);
- _self.tabs.selectTab.call(_self, this, i);
- });
- });
- });
- },
- /*
- * Set tab as visible
- *
- * @param {HTMLDOMElement} - current tab
- * @param {Number} - Index of tab in menu
- *
- */
- selectTab: function (tab, index) {
- var allTabs = this.popup.container
- .querySelectorAll('.' + PREFIX + 'tab-item-content');
- tab.className += ' ' + PREFIX + 'tab-item-active';
- allTabs[index].className += ' ' + PREFIX + 'tab-item-show';
- },
- /*
- * Set all tabs as invisible.
- *
- */
- deselectAll: function () {
- var popupDiv = this.popup.container,
- tabs = popupDiv
- .querySelectorAll('.' + PREFIX + 'tab-item'),
- tabsContent = popupDiv
- .querySelectorAll('.' + PREFIX + 'tab-item-content'),
- i;
- for (i = 0; i < tabs.length; i++) {
- tabs[i].classList.remove(PREFIX + 'tab-item-active');
- tabsContent[i].classList.remove(PREFIX + 'tab-item-show');
- }
- }
- }
- };
- addEvent(H.NavigationBindings, 'showPopup', function (config) {
- if (!this.popup) {
- // Add popup to main container
- this.popup = new H.Popup(this.chart.container);
- }
- this.popup.showForm(
- config.formType,
- this.chart,
- config.options,
- config.onSubmit
- );
- });
- addEvent(H.NavigationBindings, 'closePopup', function () {
- if (this.popup) {
- this.popup.closePopup();
- }
- });
- }(Highcharts));
- return (function () {
- }());
- }));
|