1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118 |
- /**
- * Copyright (c) 2006-2019, JGraph Ltd
- * Copyright (c) 2006-2019, draw.io AG
- */
- /**
- * Class: mxEditor
- *
- * Extends <mxEventSource> to implement an application wrapper for a graph that
- * adds <actions>, I/O using <mxCodec>, auto-layout using <mxLayoutManager>,
- * command history using <undoManager>, and standard dialogs and widgets, eg.
- * properties, help, outline, toolbar, and popupmenu. It also adds <templates>
- * to be used as cells in toolbars, auto-validation using the <validation>
- * flag, attribute cycling using <cycleAttributeValues>, higher-level events
- * such as <root>, and backend integration using <urlPost> and <urlImage>.
- *
- * Actions:
- *
- * Actions are functions stored in the <actions> array under their names. The
- * functions take the <mxEditor> as the first, and an optional <mxCell> as the
- * second argument and are invoked using <execute>. Any additional arguments
- * passed to execute are passed on to the action as-is.
- *
- * A list of built-in actions is available in the <addActions> description.
- *
- * Read/write Diagrams:
- *
- * To read a diagram from an XML string, for example from a textfield within the
- * page, the following code is used:
- *
- * (code)
- * var doc = mxUtils.parseXML(xmlString);
- * var node = doc.documentElement;
- * editor.readGraphModel(node);
- * (end)
- *
- * For reading a diagram from a remote location, use the <open> method.
- *
- * To save diagrams in XML on a server, you can set the <urlPost> variable.
- * This variable will be used in <getUrlPost> to construct a URL for the post
- * request that is issued in the <save> method. The post request contains the
- * XML representation of the diagram as returned by <writeGraphModel> in the
- * xml parameter.
- *
- * On the server side, the post request is processed using standard
- * technologies such as Java Servlets, CGI, .NET or ASP.
- *
- * Here are some examples of processing a post request in various languages.
- *
- * - Java: URLDecoder.decode(request.getParameter("xml"), "UTF-8").replace("\n", "
")
- *
- * Note that the linefeeds should only be replaced if the XML is
- * processed in Java, for example when creating an image, but not
- * if the XML is passed back to the client-side.
- *
- * - .NET: HttpUtility.UrlDecode(context.Request.Params["xml"])
- * - PHP: urldecode($_POST["xml"])
- *
- * Creating images:
- *
- * A backend (Java, PHP or C#) is required for creating images. The
- * distribution contains an example for each backend (ImageHandler.java,
- * ImageHandler.cs and graph.php). More information about using a backend
- * to create images can be found in the readme.html files. Note that the
- * preview is implemented using VML/SVG in the browser and does not require
- * a backend. The backend is only required to creates images (bitmaps).
- *
- * Special characters:
- *
- * Note There are five characters that should always appear in XML content as
- * escapes, so that they do not interact with the syntax of the markup. These
- * are part of the language for all documents based on XML and for HTML.
- *
- * - < (<)
- * - > (>)
- * - & (&)
- * - " (")
- * - ' (')
- *
- * Although it is part of the XML language, ' is not defined in HTML.
- * For this reason the XHTML specification recommends instead the use of
- * ' if text may be passed to a HTML user agent.
- *
- * If you are having problems with special characters on the server-side then
- * you may want to try the <escapePostData> flag.
- *
- * For converting decimal escape sequences inside strings, a user has provided
- * us with the following function:
- *
- * (code)
- * function html2js(text)
- * {
- * var entitySearch = /&#[0-9]+;/;
- * var entity;
- *
- * while (entity = entitySearch.exec(text))
- * {
- * var charCode = entity[0].substring(2, entity[0].length -1);
- * text = text.substring(0, entity.index)
- * + String.fromCharCode(charCode)
- * + text.substring(entity.index + entity[0].length);
- * }
- *
- * return text;
- * }
- * (end)
- *
- * Otherwise try using hex escape sequences and the built-in unescape function
- * for converting such strings.
- *
- * Local Files:
- *
- * For saving and opening local files, no standardized method exists that
- * works across all browsers. The recommended way of dealing with local files
- * is to create a backend that streams the XML data back to the browser (echo)
- * as an attachment so that a Save-dialog is displayed on the client-side and
- * the file can be saved to the local disk.
- *
- * For example, in PHP the code that does this looks as follows.
- *
- * (code)
- * $xml = stripslashes($_POST["xml"]);
- * header("Content-Disposition: attachment; filename=\"diagram.xml\"");
- * echo($xml);
- * (end)
- *
- * To open a local file, the file should be uploaded via a form in the browser
- * and then opened from the server in the editor.
- *
- * Cell Properties:
- *
- * The properties displayed in the properties dialog are the attributes and
- * values of the cell's user object, which is an XML node. The XML node is
- * defined in the templates section of the config file.
- *
- * The templates are stored in <mxEditor.templates> and contain cells which
- * are cloned at insertion time to create new vertices by use of drag and
- * drop from the toolbar. Each entry in the toolbar for adding a new vertex
- * must refer to an existing template.
- *
- * In the following example, the task node is a business object and only the
- * mxCell node and its mxGeometry child contain graph information:
- *
- * (code)
- * <Task label="Task" description="">
- * <mxCell vertex="true">
- * <mxGeometry as="geometry" width="72" height="32"/>
- * </mxCell>
- * </Task>
- * (end)
- *
- * The idea is that the XML representation is inverse from the in-memory
- * representation: The outer XML node is the user object and the inner node is
- * the cell. This means the user object of the cell is the Task node with no
- * children for the above example:
- *
- * (code)
- * <Task label="Task" description=""/>
- * (end)
- *
- * The Task node can have any tag name, attributes and child nodes. The
- * <mxCodec> will use the XML hierarchy as the user object, while removing the
- * "known annotations", such as the mxCell node. At save-time the cell data
- * will be "merged" back into the user object. The user object is only modified
- * via the properties dialog during the lifecycle of the cell.
- *
- * In the default implementation of <createProperties>, the user object's
- * attributes are put into a form for editing. Attributes are changed using
- * the <mxCellAttributeChange> action in the model. The dialog can be replaced
- * by overriding the <createProperties> hook or by replacing the showProperties
- * action in <actions>. Alternatively, the entry in the config file's popupmenu
- * section can be modified to invoke a different action.
- *
- * If you want to displey the properties dialog on a doubleclick, you can set
- * <mxEditor.dblClickAction> to showProperties as follows:
- *
- * (code)
- * editor.dblClickAction = 'showProperties';
- * (end)
- *
- * Popupmenu and Toolbar:
- *
- * The toolbar and popupmenu are typically configured using the respective
- * sections in the config file, that is, the popupmenu is defined as follows:
- *
- * (code)
- * <mxEditor>
- * <mxDefaultPopupMenu as="popupHandler">
- * <add as="cut" action="cut" icon="images/cut.gif"/>
- * ...
- * (end)
- *
- * New entries can be added to the toolbar by inserting an add-node into the
- * above configuration. Existing entries may be removed and changed by
- * modifying or removing the respective entries in the configuration.
- * The configuration is read by the <mxDefaultPopupMenuCodec>, the format of the
- * configuration is explained in <mxDefaultPopupMenu.decode>.
- *
- * The toolbar is defined in the mxDefaultToolbar section. Items can be added
- * and removed in this section.
- *
- * (code)
- * <mxEditor>
- * <mxDefaultToolbar>
- * <add as="save" action="save" icon="images/save.gif"/>
- * <add as="Swimlane" template="swimlane" icon="images/swimlane.gif"/>
- * ...
- * (end)
- *
- * The format of the configuration is described in
- * <mxDefaultToolbarCodec.decode>.
- *
- * Ids:
- *
- * For the IDs, there is an implicit behaviour in <mxCodec>: It moves the Id
- * from the cell to the user object at encoding time and vice versa at decoding
- * time. For example, if the Task node from above has an id attribute, then
- * the <mxCell.id> of the corresponding cell will have this value. If there
- * is no Id collision in the model, then the cell may be retrieved using this
- * Id with the <mxGraphModel.getCell> function. If there is a collision, a new
- * Id will be created for the cell using <mxGraphModel.createId>. At encoding
- * time, this new Id will replace the value previously stored under the id
- * attribute in the Task node.
- *
- * See <mxEditorCodec>, <mxDefaultToolbarCodec> and <mxDefaultPopupMenuCodec>
- * for information about configuring the editor and user interface.
- *
- * Programmatically inserting cells:
- *
- * For inserting a new cell, say, by clicking a button in the document,
- * the following code can be used. This requires an reference to the editor.
- *
- * (code)
- * var userObject = new Object();
- * var parent = editor.graph.getDefaultParent();
- * var model = editor.graph.model;
- * model.beginUpdate();
- * try
- * {
- * editor.graph.insertVertex(parent, null, userObject, 20, 20, 80, 30);
- * }
- * finally
- * {
- * model.endUpdate();
- * }
- * (end)
- *
- * If a template cell from the config file should be inserted, then a clone
- * of the template can be created as follows. The clone is then inserted using
- * the add function instead of addVertex.
- *
- * (code)
- * var template = editor.templates['task'];
- * var clone = editor.graph.model.cloneCell(template);
- * (end)
- *
- * Resources:
- *
- * resources/editor - Language resources for mxEditor
- *
- * Callback: onInit
- *
- * Called from within the constructor. In the callback,
- * "this" refers to the editor instance.
- *
- * Cookie: mxgraph=seen
- *
- * Set when the editor is started. Never expires. Use
- * <resetFirstTime> to reset this cookie. This cookie
- * only exists if <onInit> is implemented.
- *
- * Event: mxEvent.OPEN
- *
- * Fires after a file was opened in <open>. The <code>filename</code> property
- * contains the filename that was used. The same value is also available in
- * <filename>.
- *
- * Event: mxEvent.SAVE
- *
- * Fires after the current file was saved in <save>. The <code>url</code>
- * property contains the URL that was used for saving.
- *
- * Event: mxEvent.POST
- *
- * Fires if a successful response was received in <postDiagram>. The
- * <code>request</code> property contains the <mxXmlRequest>, the
- * <code>url</code> and <code>data</code> properties contain the URL and the
- * data that were used in the post request.
- *
- * Event: mxEvent.ROOT
- *
- * Fires when the current root has changed, or when the title of the current
- * root has changed. This event has no properties.
- *
- * Event: mxEvent.BEFORE_ADD_VERTEX
- *
- * Fires before a vertex is added in <addVertex>. The <code>vertex</code>
- * property contains the new vertex and the <code>parent</code> property
- * contains its parent.
- *
- * Event: mxEvent.ADD_VERTEX
- *
- * Fires between begin- and endUpdate in <addVertex>. The <code>vertex</code>
- * property contains the vertex that is being inserted.
- *
- * Event: mxEvent.AFTER_ADD_VERTEX
- *
- * Fires after a vertex was inserted and selected in <addVertex>. The
- * <code>vertex</code> property contains the new vertex.
- *
- * Example:
- *
- * For starting an in-place edit after a new vertex has been added to the
- * graph, the following code can be used.
- *
- * (code)
- * editor.addListener(mxEvent.AFTER_ADD_VERTEX, function(sender, evt)
- * {
- * var vertex = evt.getProperty('vertex');
- *
- * if (editor.graph.isCellEditable(vertex))
- * {
- * editor.graph.startEditingAtCell(vertex);
- * }
- * });
- * (end)
- *
- * Event: mxEvent.ESCAPE
- *
- * Fires when the escape key is pressed. The <code>event</code> property
- * contains the key event.
- *
- * Constructor: mxEditor
- *
- * Constructs a new editor. This function invokes the <onInit> callback
- * upon completion.
- *
- * Example:
- *
- * (code)
- * var config = mxUtils.load('config/diagrameditor.xml').getDocumentElement();
- * var editor = new mxEditor(config);
- * (end)
- *
- * Parameters:
- *
- * config - Optional XML node that contains the configuration.
- */
- function mxEditor(config)
- {
- this.actions = [];
- this.addActions();
- // Executes the following only if a document has been instanciated.
- // That is, don't execute when the editorcodec is setup.
- if (document.body != null)
- {
- // Defines instance fields
- this.cycleAttributeValues = [];
- this.popupHandler = new mxDefaultPopupMenu();
- this.undoManager = new mxUndoManager();
- // Creates the graph and toolbar without the containers
- this.graph = this.createGraph();
- this.toolbar = this.createToolbar();
- // Creates the global keyhandler (requires graph instance)
- this.keyHandler = new mxDefaultKeyHandler(this);
- // Configures the editor using the URI
- // which was passed to the ctor
- this.configure(config);
- // Assigns the swimlaneIndicatorColorAttribute on the graph
- this.graph.swimlaneIndicatorColorAttribute = this.cycleAttributeName;
- // Checks if the <onInit> hook has been set
- if (this.onInit != null)
- {
- // Invokes the <onInit> hook
- this.onInit();
- }
- // Automatic deallocation of memory
- if (mxClient.IS_IE)
- {
- mxEvent.addListener(window, 'unload', mxUtils.bind(this, function()
- {
- this.destroy();
- }));
- }
- }
- };
- /**
- * Installs the required language resources at class
- * loading time.
- */
- if (mxLoadResources)
- {
- mxResources.add(mxClient.basePath + '/resources/editor');
- }
- else
- {
- mxClient.defaultBundles.push(mxClient.basePath + '/resources/editor');
- }
- /**
- * Extends mxEventSource.
- */
- mxEditor.prototype = new mxEventSource();
- mxEditor.prototype.constructor = mxEditor;
- /**
- * Group: Controls and Handlers
- */
- /**
- * Variable: askZoomResource
- *
- * Specifies the resource key for the zoom dialog. If the resource for this
- * key does not exist then the value is used as the error message. Default
- * is 'askZoom'.
- */
- mxEditor.prototype.askZoomResource = (mxClient.language != 'none') ? 'askZoom' : '';
- /**
- * Variable: lastSavedResource
- *
- * Specifies the resource key for the last saved info. If the resource for
- * this key does not exist then the value is used as the error message.
- * Default is 'lastSaved'.
- */
- mxEditor.prototype.lastSavedResource = (mxClient.language != 'none') ? 'lastSaved' : '';
- /**
- * Variable: currentFileResource
- *
- * Specifies the resource key for the current file info. If the resource for
- * this key does not exist then the value is used as the error message.
- * Default is 'currentFile'.
- */
- mxEditor.prototype.currentFileResource = (mxClient.language != 'none') ? 'currentFile' : '';
- /**
- * Variable: propertiesResource
- *
- * Specifies the resource key for the properties window title. If the
- * resource for this key does not exist then the value is used as the
- * error message. Default is 'properties'.
- */
- mxEditor.prototype.propertiesResource = (mxClient.language != 'none') ? 'properties' : '';
- /**
- * Variable: tasksResource
- *
- * Specifies the resource key for the tasks window title. If the
- * resource for this key does not exist then the value is used as the
- * error message. Default is 'tasks'.
- */
- mxEditor.prototype.tasksResource = (mxClient.language != 'none') ? 'tasks' : '';
- /**
- * Variable: helpResource
- *
- * Specifies the resource key for the help window title. If the
- * resource for this key does not exist then the value is used as the
- * error message. Default is 'help'.
- */
- mxEditor.prototype.helpResource = (mxClient.language != 'none') ? 'help' : '';
- /**
- * Variable: outlineResource
- *
- * Specifies the resource key for the outline window title. If the
- * resource for this key does not exist then the value is used as the
- * error message. Default is 'outline'.
- */
- mxEditor.prototype.outlineResource = (mxClient.language != 'none') ? 'outline' : '';
- /**
- * Variable: outline
- *
- * Reference to the <mxWindow> that contains the outline. The <mxOutline>
- * is stored in outline.outline.
- */
- mxEditor.prototype.outline = null;
- /**
- * Variable: graph
- *
- * Holds a <mxGraph> for displaying the diagram. The graph
- * is created in <setGraphContainer>.
- */
- mxEditor.prototype.graph = null;
- /**
- * Variable: graphRenderHint
- *
- * Holds the render hint used for creating the
- * graph in <setGraphContainer>. See <mxGraph>.
- * Default is null.
- */
- mxEditor.prototype.graphRenderHint = null;
- /**
- * Variable: toolbar
- *
- * Holds a <mxDefaultToolbar> for displaying the toolbar. The
- * toolbar is created in <setToolbarContainer>.
- */
- mxEditor.prototype.toolbar = null;
- /**
- * Variable: status
- *
- * DOM container that holds the statusbar. Default is null.
- * Use <setStatusContainer> to set this value.
- */
- mxEditor.prototype.status = null;
- /**
- * Variable: popupHandler
- *
- * Holds a <mxDefaultPopupMenu> for displaying
- * popupmenus.
- */
- mxEditor.prototype.popupHandler = null;
- /**
- * Variable: undoManager
- *
- * Holds an <mxUndoManager> for the command history.
- */
- mxEditor.prototype.undoManager = null;
- /**
- * Variable: keyHandler
- *
- * Holds a <mxDefaultKeyHandler> for handling keyboard events.
- * The handler is created in <setGraphContainer>.
- */
- mxEditor.prototype.keyHandler = null;
- /**
- * Group: Actions and Options
- */
- /**
- * Variable: actions
- *
- * Maps from actionnames to actions, which are functions taking
- * the editor and the cell as arguments. Use <addAction>
- * to add or replace an action and <execute> to execute an action
- * by name, passing the cell to be operated upon as the second
- * argument.
- */
- mxEditor.prototype.actions = null;
- /**
- * Variable: dblClickAction
- *
- * Specifies the name of the action to be executed
- * when a cell is double clicked. Default is 'edit'.
- *
- * To handle a singleclick, use the following code.
- *
- * (code)
- * editor.graph.addListener(mxEvent.CLICK, function(sender, evt)
- * {
- * var e = evt.getProperty('event');
- * var cell = evt.getProperty('cell');
- *
- * if (cell != null && !e.isConsumed())
- * {
- * // Do something useful with cell...
- * e.consume();
- * }
- * });
- * (end)
- */
- mxEditor.prototype.dblClickAction = 'edit';
- /**
- * Variable: swimlaneRequired
- *
- * Specifies if new cells must be inserted
- * into an existing swimlane. Otherwise, cells
- * that are not swimlanes can be inserted as
- * top-level cells. Default is false.
- */
- mxEditor.prototype.swimlaneRequired = false;
- /**
- * Variable: disableContextMenu
- *
- * Specifies if the context menu should be disabled in the graph container.
- * Default is true.
- */
- mxEditor.prototype.disableContextMenu = true;
- /**
- * Group: Templates
- */
- /**
- * Variable: insertFunction
- *
- * Specifies the function to be used for inserting new
- * cells into the graph. This is assigned from the
- * <mxDefaultToolbar> if a vertex-tool is clicked.
- */
- mxEditor.prototype.insertFunction = null;
- /**
- * Variable: forcedInserting
- *
- * Specifies if a new cell should be inserted on a single
- * click even using <insertFunction> if there is a cell
- * under the mousepointer, otherwise the cell under the
- * mousepointer is selected. Default is false.
- */
- mxEditor.prototype.forcedInserting = false;
- /**
- * Variable: templates
- *
- * Maps from names to protoype cells to be used
- * in the toolbar for inserting new cells into
- * the diagram.
- */
- mxEditor.prototype.templates = null;
- /**
- * Variable: defaultEdge
- *
- * Prototype edge cell that is used for creating
- * new edges.
- */
- mxEditor.prototype.defaultEdge = null;
- /**
- * Variable: defaultEdgeStyle
- *
- * Specifies the edge style to be returned in <getEdgeStyle>.
- * Default is null.
- */
- mxEditor.prototype.defaultEdgeStyle = null;
- /**
- * Variable: defaultGroup
- *
- * Prototype group cell that is used for creating
- * new groups.
- */
- mxEditor.prototype.defaultGroup = null;
- /**
- * Variable: groupBorderSize
- *
- * Default size for the border of new groups. If null,
- * then then <mxGraph.gridSize> is used. Default is
- * null.
- */
- mxEditor.prototype.groupBorderSize = null;
- /**
- * Group: Backend Integration
- */
- /**
- * Variable: filename
- *
- * Contains the URL of the last opened file as a string.
- * Default is null.
- */
- mxEditor.prototype.filename = null;
- /**
- * Variable: lineFeed
- *
- * Character to be used for encoding linefeeds in <save>. Default is '
'.
- */
- mxEditor.prototype.linefeed = '
';
- /**
- * Variable: postParameterName
- *
- * Specifies if the name of the post parameter that contains the diagram
- * data in a post request to the server. Default is 'xml'.
- */
- mxEditor.prototype.postParameterName = 'xml';
- /**
- * Variable: escapePostData
- *
- * Specifies if the data in the post request for saving a diagram
- * should be converted using encodeURIComponent. Default is true.
- */
- mxEditor.prototype.escapePostData = true;
- /**
- * Variable: urlPost
- *
- * Specifies the URL to be used for posting the diagram
- * to a backend in <save>.
- */
- mxEditor.prototype.urlPost = null;
- /**
- * Variable: urlImage
- *
- * Specifies the URL to be used for creating a bitmap of
- * the graph in the image action.
- */
- mxEditor.prototype.urlImage = null;
- /**
- * Group: Autolayout
- */
- /**
- * Variable: horizontalFlow
- *
- * Specifies the direction of the flow
- * in the diagram. This is used in the
- * layout algorithms. Default is false,
- * ie. vertical flow.
- */
- mxEditor.prototype.horizontalFlow = false;
- /**
- * Variable: layoutDiagram
- *
- * Specifies if the top-level elements in the
- * diagram should be layed out using a vertical
- * or horizontal stack depending on the setting
- * of <horizontalFlow>. The spacing between the
- * swimlanes is specified by <swimlaneSpacing>.
- * Default is false.
- *
- * If the top-level elements are swimlanes, then
- * the intra-swimlane layout is activated by
- * the <layoutSwimlanes> switch.
- */
- mxEditor.prototype.layoutDiagram = false;
- /**
- * Variable: swimlaneSpacing
- *
- * Specifies the spacing between swimlanes if
- * automatic layout is turned on in
- * <layoutDiagram>. Default is 0.
- */
- mxEditor.prototype.swimlaneSpacing = 0;
- /**
- * Variable: maintainSwimlanes
- *
- * Specifies if the swimlanes should be kept at the same
- * width or height depending on the setting of
- * <horizontalFlow>. Default is false.
- *
- * For horizontal flows, all swimlanes
- * have the same height and for vertical flows, all swimlanes
- * have the same width. Furthermore, the swimlanes are
- * automatically "stacked" if <layoutDiagram> is true.
- */
- mxEditor.prototype.maintainSwimlanes = false;
- /**
- * Variable: layoutSwimlanes
- *
- * Specifies if the children of swimlanes should
- * be layed out, either vertically or horizontally
- * depending on <horizontalFlow>.
- * Default is false.
- */
- mxEditor.prototype.layoutSwimlanes = false;
- /**
- * Group: Attribute Cycling
- */
- /**
- * Variable: cycleAttributeValues
- *
- * Specifies the attribute values to be cycled when
- * inserting new swimlanes. Default is an empty
- * array.
- */
- mxEditor.prototype.cycleAttributeValues = null;
- /**
- * Variable: cycleAttributeIndex
- *
- * Index of the last consumed attribute index. If a new
- * swimlane is inserted, then the <cycleAttributeValues>
- * at this index will be used as the value for
- * <cycleAttributeName>. Default is 0.
- */
- mxEditor.prototype.cycleAttributeIndex = 0;
- /**
- * Variable: cycleAttributeName
- *
- * Name of the attribute to be assigned a <cycleAttributeValues>
- * when inserting new swimlanes. Default is 'fillColor'.
- */
- mxEditor.prototype.cycleAttributeName = 'fillColor';
- /**
- * Group: Windows
- */
- /**
- * Variable: tasks
- *
- * Holds the <mxWindow> created in <showTasks>.
- */
- mxEditor.prototype.tasks = null;
- /**
- * Variable: tasksWindowImage
- *
- * Icon for the tasks window.
- */
- mxEditor.prototype.tasksWindowImage = null;
- /**
- * Variable: tasksTop
- *
- * Specifies the top coordinate of the tasks window in pixels.
- * Default is 20.
- */
- mxEditor.prototype.tasksTop = 20;
- /**
- * Variable: help
- *
- * Holds the <mxWindow> created in <showHelp>.
- */
- mxEditor.prototype.help = null;
- /**
- * Variable: helpWindowImage
- *
- * Icon for the help window.
- */
- mxEditor.prototype.helpWindowImage = null;
- /**
- * Variable: urlHelp
- *
- * Specifies the URL to be used for the contents of the
- * Online Help window. This is usually specified in the
- * resources file under urlHelp for language-specific
- * online help support.
- */
- mxEditor.prototype.urlHelp = null;
- /**
- * Variable: helpWidth
- *
- * Specifies the width of the help window in pixels.
- * Default is 300.
- */
- mxEditor.prototype.helpWidth = 300;
- /**
- * Variable: helpHeight
- *
- * Specifies the height of the help window in pixels.
- * Default is 260.
- */
- mxEditor.prototype.helpHeight = 260;
- /**
- * Variable: propertiesWidth
- *
- * Specifies the width of the properties window in pixels.
- * Default is 240.
- */
- mxEditor.prototype.propertiesWidth = 240;
- /**
- * Variable: propertiesHeight
- *
- * Specifies the height of the properties window in pixels.
- * If no height is specified then the window will be automatically
- * sized to fit its contents. Default is null.
- */
- mxEditor.prototype.propertiesHeight = null;
- /**
- * Variable: movePropertiesDialog
- *
- * Specifies if the properties dialog should be automatically
- * moved near the cell it is displayed for, otherwise the
- * dialog is not moved. This value is only taken into
- * account if the dialog is already visible. Default is false.
- */
- mxEditor.prototype.movePropertiesDialog = false;
- /**
- * Variable: validating
- *
- * Specifies if <mxGraph.validateGraph> should automatically be invoked after
- * each change. Default is false.
- */
- mxEditor.prototype.validating = false;
- /**
- * Variable: modified
- *
- * True if the graph has been modified since it was last saved.
- */
- mxEditor.prototype.modified = false;
- /**
- * Function: isModified
- *
- * Returns <modified>.
- */
- mxEditor.prototype.isModified = function ()
- {
- return this.modified;
- };
- /**
- * Function: setModified
- *
- * Sets <modified> to the specified boolean value.
- */
- mxEditor.prototype.setModified = function (value)
- {
- this.modified = value;
- };
- /**
- * Function: addActions
- *
- * Adds the built-in actions to the editor instance.
- *
- * save - Saves the graph using <urlPost>.
- * print - Shows the graph in a new print preview window.
- * show - Shows the graph in a new window.
- * exportImage - Shows the graph as a bitmap image using <getUrlImage>.
- * refresh - Refreshes the graph's display.
- * cut - Copies the current selection into the clipboard
- * and removes it from the graph.
- * copy - Copies the current selection into the clipboard.
- * paste - Pastes the clipboard into the graph.
- * delete - Removes the current selection from the graph.
- * group - Puts the current selection into a new group.
- * ungroup - Removes the selected groups and selects the children.
- * undo - Undoes the last change on the graph model.
- * redo - Redoes the last change on the graph model.
- * zoom - Sets the zoom via a dialog.
- * zoomIn - Zooms into the graph.
- * zoomOut - Zooms out of the graph
- * actualSize - Resets the scale and translation on the graph.
- * fit - Changes the scale so that the graph fits into the window.
- * showProperties - Shows the properties dialog.
- * selectAll - Selects all cells.
- * selectNone - Clears the selection.
- * selectVertices - Selects all vertices.
- * selectEdges = Selects all edges.
- * edit - Starts editing the current selection cell.
- * enterGroup - Drills down into the current selection cell.
- * exitGroup - Moves up in the drilling hierachy
- * home - Moves to the topmost parent in the drilling hierarchy
- * selectPrevious - Selects the previous cell.
- * selectNext - Selects the next cell.
- * selectParent - Selects the parent of the selection cell.
- * selectChild - Selects the first child of the selection cell.
- * collapse - Collapses the currently selected cells.
- * expand - Expands the currently selected cells.
- * bold - Toggle bold text style.
- * italic - Toggle italic text style.
- * underline - Toggle underline text style.
- * alignCellsLeft - Aligns the selection cells at the left.
- * alignCellsCenter - Aligns the selection cells in the center.
- * alignCellsRight - Aligns the selection cells at the right.
- * alignCellsTop - Aligns the selection cells at the top.
- * alignCellsMiddle - Aligns the selection cells in the middle.
- * alignCellsBottom - Aligns the selection cells at the bottom.
- * alignFontLeft - Sets the horizontal text alignment to left.
- * alignFontCenter - Sets the horizontal text alignment to center.
- * alignFontRight - Sets the horizontal text alignment to right.
- * alignFontTop - Sets the vertical text alignment to top.
- * alignFontMiddle - Sets the vertical text alignment to middle.
- * alignFontBottom - Sets the vertical text alignment to bottom.
- * toggleTasks - Shows or hides the tasks window.
- * toggleHelp - Shows or hides the help window.
- * toggleOutline - Shows or hides the outline window.
- * toggleConsole - Shows or hides the console window.
- */
- mxEditor.prototype.addActions = function ()
- {
- this.addAction('save', function(editor)
- {
- editor.save();
- });
- this.addAction('print', function(editor)
- {
- var preview = new mxPrintPreview(editor.graph, 1);
- preview.open();
- });
- this.addAction('show', function(editor)
- {
- mxUtils.show(editor.graph, null, 10, 10);
- });
- this.addAction('exportImage', function(editor)
- {
- var url = editor.getUrlImage();
- if (url == null || mxClient.IS_LOCAL)
- {
- editor.execute('show');
- }
- else
- {
- var node = mxUtils.getViewXml(editor.graph, 1);
- var xml = mxUtils.getXml(node, '\n');
- mxUtils.submit(url, editor.postParameterName + '=' +
- encodeURIComponent(xml), document, '_blank');
- }
- });
- this.addAction('refresh', function(editor)
- {
- editor.graph.refresh();
- });
- this.addAction('cut', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- mxClipboard.cut(editor.graph);
- }
- });
- this.addAction('copy', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- mxClipboard.copy(editor.graph);
- }
- });
- this.addAction('paste', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- mxClipboard.paste(editor.graph);
- }
- });
- this.addAction('delete', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.removeCells();
- }
- });
- this.addAction('group', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.setSelectionCell(editor.groupCells());
- }
- });
- this.addAction('ungroup', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.setSelectionCells(editor.graph.ungroupCells());
- }
- });
- this.addAction('removeFromParent', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.removeCellsFromParent();
- }
- });
- this.addAction('undo', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.undo();
- }
- });
- this.addAction('redo', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.redo();
- }
- });
- this.addAction('zoomIn', function(editor)
- {
- editor.graph.zoomIn();
- });
- this.addAction('zoomOut', function(editor)
- {
- editor.graph.zoomOut();
- });
- this.addAction('actualSize', function(editor)
- {
- editor.graph.zoomActual();
- });
- this.addAction('fit', function(editor)
- {
- editor.graph.fit();
- });
- this.addAction('showProperties', function(editor, cell)
- {
- editor.showProperties(cell);
- });
- this.addAction('selectAll', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.selectAll();
- }
- });
- this.addAction('selectNone', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.clearSelection();
- }
- });
- this.addAction('selectVertices', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.selectVertices();
- }
- });
- this.addAction('selectEdges', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.selectEdges();
- }
- });
- this.addAction('edit', function(editor, cell)
- {
- if (editor.graph.isEnabled() &&
- editor.graph.isCellEditable(cell))
- {
- editor.graph.startEditingAtCell(cell);
- }
- });
- this.addAction('toBack', function(editor, cell)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.orderCells(true);
- }
- });
- this.addAction('toFront', function(editor, cell)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.orderCells(false);
- }
- });
- this.addAction('enterGroup', function(editor, cell)
- {
- editor.graph.enterGroup(cell);
- });
- this.addAction('exitGroup', function(editor)
- {
- editor.graph.exitGroup();
- });
- this.addAction('home', function(editor)
- {
- editor.graph.home();
- });
- this.addAction('selectPrevious', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.selectPreviousCell();
- }
- });
- this.addAction('selectNext', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.selectNextCell();
- }
- });
- this.addAction('selectParent', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.selectParentCell();
- }
- });
- this.addAction('selectChild', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.selectChildCell();
- }
- });
- this.addAction('collapse', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.foldCells(true);
- }
- });
- this.addAction('collapseAll', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- var cells = editor.graph.getChildVertices();
- editor.graph.foldCells(true, false, cells);
- }
- });
- this.addAction('expand', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.foldCells(false);
- }
- });
- this.addAction('expandAll', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- var cells = editor.graph.getChildVertices();
- editor.graph.foldCells(false, false, cells);
- }
- });
- this.addAction('bold', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.toggleCellStyleFlags(
- mxConstants.STYLE_FONTSTYLE,
- mxConstants.FONT_BOLD);
- }
- });
- this.addAction('italic', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.toggleCellStyleFlags(
- mxConstants.STYLE_FONTSTYLE,
- mxConstants.FONT_ITALIC);
- }
- });
- this.addAction('underline', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.toggleCellStyleFlags(
- mxConstants.STYLE_FONTSTYLE,
- mxConstants.FONT_UNDERLINE);
- }
- });
- this.addAction('alignCellsLeft', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.alignCells(mxConstants.ALIGN_LEFT);
- }
- });
- this.addAction('alignCellsCenter', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.alignCells(mxConstants.ALIGN_CENTER);
- }
- });
- this.addAction('alignCellsRight', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.alignCells(mxConstants.ALIGN_RIGHT);
- }
- });
- this.addAction('alignCellsTop', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.alignCells(mxConstants.ALIGN_TOP);
- }
- });
- this.addAction('alignCellsMiddle', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.alignCells(mxConstants.ALIGN_MIDDLE);
- }
- });
- this.addAction('alignCellsBottom', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.alignCells(mxConstants.ALIGN_BOTTOM);
- }
- });
- this.addAction('alignFontLeft', function(editor)
- {
- editor.graph.setCellStyles(
- mxConstants.STYLE_ALIGN,
- mxConstants.ALIGN_LEFT);
- });
- this.addAction('alignFontCenter', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.setCellStyles(
- mxConstants.STYLE_ALIGN,
- mxConstants.ALIGN_CENTER);
- }
- });
- this.addAction('alignFontRight', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.setCellStyles(
- mxConstants.STYLE_ALIGN,
- mxConstants.ALIGN_RIGHT);
- }
- });
- this.addAction('alignFontTop', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.setCellStyles(
- mxConstants.STYLE_VERTICAL_ALIGN,
- mxConstants.ALIGN_TOP);
- }
- });
- this.addAction('alignFontMiddle', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.setCellStyles(
- mxConstants.STYLE_VERTICAL_ALIGN,
- mxConstants.ALIGN_MIDDLE);
- }
- });
- this.addAction('alignFontBottom', function(editor)
- {
- if (editor.graph.isEnabled())
- {
- editor.graph.setCellStyles(
- mxConstants.STYLE_VERTICAL_ALIGN,
- mxConstants.ALIGN_BOTTOM);
- }
- });
- this.addAction('zoom', function(editor)
- {
- var current = editor.graph.getView().scale*100;
- var scale = parseFloat(mxUtils.prompt(
- mxResources.get(editor.askZoomResource) ||
- editor.askZoomResource,
- current))/100;
- if (!isNaN(scale))
- {
- editor.graph.getView().setScale(scale);
- }
- });
- this.addAction('toggleTasks', function(editor)
- {
- if (editor.tasks != null)
- {
- editor.tasks.setVisible(!editor.tasks.isVisible());
- }
- else
- {
- editor.showTasks();
- }
- });
- this.addAction('toggleHelp', function(editor)
- {
- if (editor.help != null)
- {
- editor.help.setVisible(!editor.help.isVisible());
- }
- else
- {
- editor.showHelp();
- }
- });
- this.addAction('toggleOutline', function(editor)
- {
- if (editor.outline == null)
- {
- editor.showOutline();
- }
- else
- {
- editor.outline.setVisible(!editor.outline.isVisible());
- }
- });
- this.addAction('toggleConsole', function(editor)
- {
- mxLog.setVisible(!mxLog.isVisible());
- });
- };
- /**
- * Function: configure
- *
- * Configures the editor using the specified node. To load the
- * configuration from a given URL the following code can be used to obtain
- * the XML node.
- *
- * (code)
- * var node = mxUtils.load(url).getDocumentElement();
- * (end)
- *
- * Parameters:
- *
- * node - XML node that contains the configuration.
- */
- mxEditor.prototype.configure = function (node)
- {
- if (node != null)
- {
- // Creates a decoder for the XML data
- // and uses it to configure the editor
- var dec = new mxCodec(node.ownerDocument);
- dec.decode(node, this);
- // Resets the counters, modified state and
- // command history
- this.resetHistory();
- }
- };
- /**
- * Function: resetFirstTime
- *
- * Resets the cookie that is used to remember if the editor has already
- * been used.
- */
- mxEditor.prototype.resetFirstTime = function ()
- {
- document.cookie =
- 'mxgraph=seen; expires=Fri, 27 Jul 2001 02:47:11 UTC; path=/';
- };
- /**
- * Function: resetHistory
- *
- * Resets the command history, modified state and counters.
- */
- mxEditor.prototype.resetHistory = function ()
- {
- this.lastSnapshot = new Date().getTime();
- this.undoManager.clear();
- this.ignoredChanges = 0;
- this.setModified(false);
- };
- /**
- * Function: addAction
- *
- * Binds the specified actionname to the specified function.
- *
- * Parameters:
- *
- * actionname - String that specifies the name of the action
- * to be added.
- * funct - Function that implements the new action. The first
- * argument of the function is the editor it is used
- * with, the second argument is the cell it operates
- * upon.
- *
- * Example:
- * (code)
- * editor.addAction('test', function(editor, cell)
- * {
- * mxUtils.alert("test "+cell);
- * });
- * (end)
- */
- mxEditor.prototype.addAction = function (actionname, funct)
- {
- this.actions[actionname] = funct;
- };
- /**
- * Function: execute
- *
- * Executes the function with the given name in <actions> passing the
- * editor instance and given cell as the first and second argument. All
- * additional arguments are passed to the action as well. This method
- * contains a try-catch block and displays an error message if an action
- * causes an exception. The exception is re-thrown after the error
- * message was displayed.
- *
- * Example:
- *
- * (code)
- * editor.execute("showProperties", cell);
- * (end)
- */
- mxEditor.prototype.execute = function (actionname, cell, evt)
- {
- var action = this.actions[actionname];
- if (action != null)
- {
- try
- {
- // Creates the array of arguments by replacing the actionname
- // with the editor instance in the args of this function
- var args = arguments;
- args[0] = this;
- // Invokes the function on the editor using the args
- action.apply(this, args);
- }
- catch (e)
- {
- mxUtils.error('Cannot execute ' + actionname +
- ': ' + e.message, 280, true);
- throw e;
- }
- }
- else
- {
- mxUtils.error('Cannot find action '+actionname, 280, true);
- }
- };
- /**
- * Function: addTemplate
- *
- * Adds the specified template under the given name in <templates>.
- */
- mxEditor.prototype.addTemplate = function (name, template)
- {
- this.templates[name] = template;
- };
- /**
- * Function: getTemplate
- *
- * Returns the template for the given name.
- */
- mxEditor.prototype.getTemplate = function (name)
- {
- return this.templates[name];
- };
- /**
- * Function: createGraph
- *
- * Creates the <graph> for the editor. The graph is created with no
- * container and is initialized from <setGraphContainer>.
- */
- mxEditor.prototype.createGraph = function ()
- {
- var graph = new mxGraph(null, null, this.graphRenderHint);
- // Enables rubberband, tooltips, panning
- graph.setTooltips(true);
- graph.setPanning(true);
- // Overrides the dblclick method on the graph to
- // invoke the dblClickAction for a cell and reset
- // the selection tool in the toolbar
- this.installDblClickHandler(graph);
- // Installs the command history
- this.installUndoHandler(graph);
- // Installs the handlers for the root event
- this.installDrillHandler(graph);
- // Installs the handler for validation
- this.installChangeHandler(graph);
- // Installs the handler for calling the
- // insert function and consume the
- // event if an insert function is defined
- this.installInsertHandler(graph);
- // Redirects the function for creating the
- // popupmenu items
- graph.popupMenuHandler.factoryMethod =
- mxUtils.bind(this, function(menu, cell, evt)
- {
- return this.createPopupMenu(menu, cell, evt);
- });
- // Redirects the function for creating
- // new connections in the diagram
- graph.connectionHandler.factoryMethod =
- mxUtils.bind(this, function(source, target)
- {
- return this.createEdge(source, target);
- });
- // Maintains swimlanes and installs autolayout
- this.createSwimlaneManager(graph);
- this.createLayoutManager(graph);
- return graph;
- };
- /**
- * Function: createSwimlaneManager
- *
- * Sets the graph's container using <mxGraph.init>.
- */
- mxEditor.prototype.createSwimlaneManager = function (graph)
- {
- var swimlaneMgr = new mxSwimlaneManager(graph, false);
- swimlaneMgr.isHorizontal = mxUtils.bind(this, function()
- {
- return this.horizontalFlow;
- });
- swimlaneMgr.isEnabled = mxUtils.bind(this, function()
- {
- return this.maintainSwimlanes;
- });
- return swimlaneMgr;
- };
- /**
- * Function: createLayoutManager
- *
- * Creates a layout manager for the swimlane and diagram layouts, that
- * is, the locally defined inter- and intraswimlane layouts.
- */
- mxEditor.prototype.createLayoutManager = function (graph)
- {
- var layoutMgr = new mxLayoutManager(graph);
- var self = this; // closure
- layoutMgr.getLayout = function(cell)
- {
- var layout = null;
- var model = self.graph.getModel();
- if (model.getParent(cell) != null)
- {
- // Executes the swimlane layout if a child of
- // a swimlane has been changed. The layout is
- // lazy created in createSwimlaneLayout.
- if (self.layoutSwimlanes &&
- graph.isSwimlane(cell))
- {
- if (self.swimlaneLayout == null)
- {
- self.swimlaneLayout = self.createSwimlaneLayout();
- }
- layout = self.swimlaneLayout;
- }
- // Executes the diagram layout if the modified
- // cell is a top-level cell. The layout is
- // lazy created in createDiagramLayout.
- else if (self.layoutDiagram &&
- (graph.isValidRoot(cell) ||
- model.getParent(model.getParent(cell)) == null))
- {
- if (self.diagramLayout == null)
- {
- self.diagramLayout = self.createDiagramLayout();
- }
- layout = self.diagramLayout;
- }
- }
- return layout;
- };
- return layoutMgr;
- };
- /**
- * Function: setGraphContainer
- *
- * Sets the graph's container using <mxGraph.init>.
- */
- mxEditor.prototype.setGraphContainer = function (container)
- {
- if (this.graph.container == null)
- {
- // Creates the graph instance inside the given container and render hint
- //this.graph = new mxGraph(container, null, this.graphRenderHint);
- this.graph.init(container);
- // Install rubberband selection as the last
- // action handler in the chain
- this.rubberband = new mxRubberband(this.graph);
- // Disables the context menu
- if (this.disableContextMenu)
- {
- mxEvent.disableContextMenu(container);
- }
- // Workaround for stylesheet directives in IE
- if (mxClient.IS_QUIRKS)
- {
- new mxDivResizer(container);
- }
- }
- };
- /**
- * Function: installDblClickHandler
- *
- * Overrides <mxGraph.dblClick> to invoke <dblClickAction>
- * on a cell and reset the selection tool in the toolbar.
- */
- mxEditor.prototype.installDblClickHandler = function (graph)
- {
- // Installs a listener for double click events
- graph.addListener(mxEvent.DOUBLE_CLICK,
- mxUtils.bind(this, function(sender, evt)
- {
- var cell = evt.getProperty('cell');
- if (cell != null &&
- graph.isEnabled() &&
- this.dblClickAction != null)
- {
- this.execute(this.dblClickAction, cell);
- evt.consume();
- }
- })
- );
- };
- /**
- * Function: installUndoHandler
- *
- * Adds the <undoManager> to the graph model and the view.
- */
- mxEditor.prototype.installUndoHandler = function (graph)
- {
- var listener = mxUtils.bind(this, function(sender, evt)
- {
- var edit = evt.getProperty('edit');
- this.undoManager.undoableEditHappened(edit);
- });
- graph.getModel().addListener(mxEvent.UNDO, listener);
- graph.getView().addListener(mxEvent.UNDO, listener);
- // Keeps the selection state in sync
- var undoHandler = function(sender, evt)
- {
- var changes = evt.getProperty('edit').changes;
- graph.setSelectionCells(graph.getSelectionCellsForChanges(changes));
- };
- this.undoManager.addListener(mxEvent.UNDO, undoHandler);
- this.undoManager.addListener(mxEvent.REDO, undoHandler);
- };
- /**
- * Function: installDrillHandler
- *
- * Installs listeners for dispatching the <root> event.
- */
- mxEditor.prototype.installDrillHandler = function (graph)
- {
- var listener = mxUtils.bind(this, function(sender)
- {
- this.fireEvent(new mxEventObject(mxEvent.ROOT));
- });
- graph.getView().addListener(mxEvent.DOWN, listener);
- graph.getView().addListener(mxEvent.UP, listener);
- };
- /**
- * Function: installChangeHandler
- *
- * Installs the listeners required to automatically validate
- * the graph. On each change of the root, this implementation
- * fires a <root> event.
- */
- mxEditor.prototype.installChangeHandler = function (graph)
- {
- var listener = mxUtils.bind(this, function(sender, evt)
- {
- // Updates the modified state
- this.setModified(true);
- // Automatically validates the graph
- // after each change
- if (this.validating == true)
- {
- graph.validateGraph();
- }
- // Checks if the root has been changed
- var changes = evt.getProperty('edit').changes;
- for (var i = 0; i < changes.length; i++)
- {
- var change = changes[i];
- if (change instanceof mxRootChange ||
- (change instanceof mxValueChange &&
- change.cell == this.graph.model.root) ||
- (change instanceof mxCellAttributeChange &&
- change.cell == this.graph.model.root))
- {
- this.fireEvent(new mxEventObject(mxEvent.ROOT));
- break;
- }
- }
- });
- graph.getModel().addListener(mxEvent.CHANGE, listener);
- };
- /**
- * Function: installInsertHandler
- *
- * Installs the handler for invoking <insertFunction> if
- * one is defined.
- */
- mxEditor.prototype.installInsertHandler = function (graph)
- {
- var self = this; // closure
- var insertHandler =
- {
- mouseDown: function(sender, me)
- {
- if (self.insertFunction != null &&
- !me.isPopupTrigger() &&
- (self.forcedInserting ||
- me.getState() == null))
- {
- self.graph.clearSelection();
- self.insertFunction(me.getEvent(), me.getCell());
- // Consumes the rest of the events
- // for this gesture (down, move, up)
- this.isActive = true;
- me.consume();
- }
- },
- mouseMove: function(sender, me)
- {
- if (this.isActive)
- {
- me.consume();
- }
- },
- mouseUp: function(sender, me)
- {
- if (this.isActive)
- {
- this.isActive = false;
- me.consume();
- }
- }
- };
- graph.addMouseListener(insertHandler);
- };
- /**
- * Function: createDiagramLayout
- *
- * Creates the layout instance used to layout the
- * swimlanes in the diagram.
- */
- mxEditor.prototype.createDiagramLayout = function ()
- {
- var gs = this.graph.gridSize;
- var layout = new mxStackLayout(this.graph, !this.horizontalFlow,
- this.swimlaneSpacing, 2*gs, 2*gs);
- // Overrides isIgnored to only take into account swimlanes
- layout.isVertexIgnored = function(cell)
- {
- return !layout.graph.isSwimlane(cell);
- };
- return layout;
- };
- /**
- * Function: createSwimlaneLayout
- *
- * Creates the layout instance used to layout the
- * children of each swimlane.
- */
- mxEditor.prototype.createSwimlaneLayout = function ()
- {
- return new mxCompactTreeLayout(this.graph, this.horizontalFlow);
- };
- /**
- * Function: createToolbar
- *
- * Creates the <toolbar> with no container.
- */
- mxEditor.prototype.createToolbar = function ()
- {
- return new mxDefaultToolbar(null, this);
- };
- /**
- * Function: setToolbarContainer
- *
- * Initializes the toolbar for the given container.
- */
- mxEditor.prototype.setToolbarContainer = function (container)
- {
- this.toolbar.init(container);
- // Workaround for stylesheet directives in IE
- if (mxClient.IS_QUIRKS)
- {
- new mxDivResizer(container);
- }
- };
- /**
- * Function: setStatusContainer
- *
- * Creates the <status> using the specified container.
- *
- * This implementation adds listeners in the editor to
- * display the last saved time and the current filename
- * in the status bar.
- *
- * Parameters:
- *
- * container - DOM node that will contain the statusbar.
- */
- mxEditor.prototype.setStatusContainer = function (container)
- {
- if (this.status == null)
- {
- this.status = container;
- // Prints the last saved time in the status bar
- // when files are saved
- this.addListener(mxEvent.SAVE, mxUtils.bind(this, function()
- {
- var tstamp = new Date().toLocaleString();
- this.setStatus((mxResources.get(this.lastSavedResource) ||
- this.lastSavedResource)+': '+tstamp);
- }));
- // Updates the statusbar to display the filename
- // when new files are opened
- this.addListener(mxEvent.OPEN, mxUtils.bind(this, function()
- {
- this.setStatus((mxResources.get(this.currentFileResource) ||
- this.currentFileResource)+': '+this.filename);
- }));
- // Workaround for stylesheet directives in IE
- if (mxClient.IS_QUIRKS)
- {
- new mxDivResizer(container);
- }
- }
- };
- /**
- * Function: setStatus
- *
- * Display the specified message in the status bar.
- *
- * Parameters:
- *
- * message - String the specified the message to
- * be displayed.
- */
- mxEditor.prototype.setStatus = function (message)
- {
- if (this.status != null && message != null)
- {
- this.status.innerHTML = message;
- }
- };
- /**
- * Function: setTitleContainer
- *
- * Creates a listener to update the inner HTML of the
- * specified DOM node with the value of <getTitle>.
- *
- * Parameters:
- *
- * container - DOM node that will contain the title.
- */
- mxEditor.prototype.setTitleContainer = function (container)
- {
- this.addListener(mxEvent.ROOT, mxUtils.bind(this, function(sender)
- {
- container.innerHTML = this.getTitle();
- }));
- // Workaround for stylesheet directives in IE
- if (mxClient.IS_QUIRKS)
- {
- new mxDivResizer(container);
- }
- };
- /**
- * Function: treeLayout
- *
- * Executes a vertical or horizontal compact tree layout
- * using the specified cell as an argument. The cell may
- * either be a group or the root of a tree.
- *
- * Parameters:
- *
- * cell - <mxCell> to use in the compact tree layout.
- * horizontal - Optional boolean to specify the tree's
- * orientation. Default is true.
- */
- mxEditor.prototype.treeLayout = function (cell, horizontal)
- {
- if (cell != null)
- {
- var layout = new mxCompactTreeLayout(this.graph, horizontal);
- layout.execute(cell);
- }
- };
- /**
- * Function: getTitle
- *
- * Returns the string value for the current root of the
- * diagram.
- */
- mxEditor.prototype.getTitle = function ()
- {
- var title = '';
- var graph = this.graph;
- var cell = graph.getCurrentRoot();
- while (cell != null &&
- graph.getModel().getParent(
- graph.getModel().getParent(cell)) != null)
- {
- // Append each label of a valid root
- if (graph.isValidRoot(cell))
- {
- title = ' > ' +
- graph.convertValueToString(cell) + title;
- }
- cell = graph.getModel().getParent(cell);
- }
- var prefix = this.getRootTitle();
- return prefix + title;
- };
- /**
- * Function: getRootTitle
- *
- * Returns the string value of the root cell in
- * <mxGraph.model>.
- */
- mxEditor.prototype.getRootTitle = function ()
- {
- var root = this.graph.getModel().getRoot();
- return this.graph.convertValueToString(root);
- };
- /**
- * Function: undo
- *
- * Undo the last change in <graph>.
- */
- mxEditor.prototype.undo = function ()
- {
- this.undoManager.undo();
- };
- /**
- * Function: redo
- *
- * Redo the last change in <graph>.
- */
- mxEditor.prototype.redo = function ()
- {
- this.undoManager.redo();
- };
- /**
- * Function: groupCells
- *
- * Invokes <createGroup> to create a new group cell and the invokes
- * <mxGraph.groupCells>, using the grid size of the graph as the spacing
- * in the group's content area.
- */
- mxEditor.prototype.groupCells = function ()
- {
- var border = (this.groupBorderSize != null) ?
- this.groupBorderSize :
- this.graph.gridSize;
- return this.graph.groupCells(this.createGroup(), border);
- };
- /**
- * Function: createGroup
- *
- * Creates and returns a clone of <defaultGroup> to be used
- * as a new group cell in <group>.
- */
- mxEditor.prototype.createGroup = function ()
- {
- var model = this.graph.getModel();
- return model.cloneCell(this.defaultGroup);
- };
- /**
- * Function: open
- *
- * Opens the specified file synchronously and parses it using
- * <readGraphModel>. It updates <filename> and fires an <open>-event after
- * the file has been opened. Exceptions should be handled as follows:
- *
- * (code)
- * try
- * {
- * editor.open(filename);
- * }
- * catch (e)
- * {
- * mxUtils.error('Cannot open ' + filename +
- * ': ' + e.message, 280, true);
- * }
- * (end)
- *
- * Parameters:
- *
- * filename - URL of the file to be opened.
- */
- mxEditor.prototype.open = function (filename)
- {
- if (filename != null)
- {
- var xml = mxUtils.load(filename).getXml();
- this.readGraphModel(xml.documentElement);
- this.filename = filename;
- this.fireEvent(new mxEventObject(mxEvent.OPEN, 'filename', filename));
- }
- };
- /**
- * Function: readGraphModel
- *
- * Reads the specified XML node into the existing graph model and resets
- * the command history and modified state.
- */
- mxEditor.prototype.readGraphModel = function (node)
- {
- var dec = new mxCodec(node.ownerDocument);
- dec.decode(node, this.graph.getModel());
- this.resetHistory();
- };
- /**
- * Function: save
- *
- * Posts the string returned by <writeGraphModel> to the given URL or the
- * URL returned by <getUrlPost>. The actual posting is carried out by
- * <postDiagram>. If the URL is null then the resulting XML will be
- * displayed using <mxUtils.popup>. Exceptions should be handled as
- * follows:
- *
- * (code)
- * try
- * {
- * editor.save();
- * }
- * catch (e)
- * {
- * mxUtils.error('Cannot save : ' + e.message, 280, true);
- * }
- * (end)
- */
- mxEditor.prototype.save = function (url, linefeed)
- {
- // Gets the URL to post the data to
- url = url || this.getUrlPost();
- // Posts the data if the URL is not empty
- if (url != null && url.length > 0)
- {
- var data = this.writeGraphModel(linefeed);
- this.postDiagram(url, data);
- // Resets the modified flag
- this.setModified(false);
- }
- // Dispatches a save event
- this.fireEvent(new mxEventObject(mxEvent.SAVE, 'url', url));
- };
- /**
- * Function: postDiagram
- *
- * Hook for subclassers to override the posting of a diagram
- * represented by the given node to the given URL. This fires
- * an asynchronous <post> event if the diagram has been posted.
- *
- * Example:
- *
- * To replace the diagram with the diagram in the response, use the
- * following code.
- *
- * (code)
- * editor.addListener(mxEvent.POST, function(sender, evt)
- * {
- * // Process response (replace diagram)
- * var req = evt.getProperty('request');
- * var root = req.getDocumentElement();
- * editor.graph.readGraphModel(root)
- * });
- * (end)
- */
- mxEditor.prototype.postDiagram = function (url, data)
- {
- if (this.escapePostData)
- {
- data = encodeURIComponent(data);
- }
- mxUtils.post(url, this.postParameterName+'='+data,
- mxUtils.bind(this, function(req)
- {
- this.fireEvent(new mxEventObject(mxEvent.POST,
- 'request', req, 'url', url, 'data', data));
- })
- );
- };
- /**
- * Function: writeGraphModel
- *
- * Hook to create the string representation of the diagram. The default
- * implementation uses an <mxCodec> to encode the graph model as
- * follows:
- *
- * (code)
- * var enc = new mxCodec();
- * var node = enc.encode(this.graph.getModel());
- * return mxUtils.getXml(node, this.linefeed);
- * (end)
- *
- * Parameters:
- *
- * linefeed - Optional character to be used as the linefeed. Default is
- * <linefeed>.
- */
- mxEditor.prototype.writeGraphModel = function (linefeed)
- {
- linefeed = (linefeed != null) ? linefeed : this.linefeed;
- var enc = new mxCodec();
- var node = enc.encode(this.graph.getModel());
- return mxUtils.getXml(node, linefeed);
- };
- /**
- * Function: getUrlPost
- *
- * Returns the URL to post the diagram to. This is used
- * in <save>. The default implementation returns <urlPost>,
- * adding <code>?draft=true</code>.
- */
- mxEditor.prototype.getUrlPost = function ()
- {
- return this.urlPost;
- };
- /**
- * Function: getUrlImage
- *
- * Returns the URL to create the image with. This is typically
- * the URL of a backend which accepts an XML representation
- * of a graph view to create an image. The function is used
- * in the image action to create an image. This implementation
- * returns <urlImage>.
- */
- mxEditor.prototype.getUrlImage = function ()
- {
- return this.urlImage;
- };
- /**
- * Function: swapStyles
- *
- * Swaps the styles for the given names in the graph's
- * stylesheet and refreshes the graph.
- */
- mxEditor.prototype.swapStyles = function (first, second)
- {
- var style = this.graph.getStylesheet().styles[second];
- this.graph.getView().getStylesheet().putCellStyle(
- second, this.graph.getStylesheet().styles[first]);
- this.graph.getStylesheet().putCellStyle(first, style);
- this.graph.refresh();
- };
- /**
- * Function: showProperties
- *
- * Creates and shows the properties dialog for the given
- * cell. The content area of the dialog is created using
- * <createProperties>.
- */
- mxEditor.prototype.showProperties = function (cell)
- {
- cell = cell || this.graph.getSelectionCell();
- // Uses the root node for the properties dialog
- // if not cell was passed in and no cell is
- // selected
- if (cell == null)
- {
- cell = this.graph.getCurrentRoot();
- if (cell == null)
- {
- cell = this.graph.getModel().getRoot();
- }
- }
- if (cell != null)
- {
- // Makes sure there is no in-place editor in the
- // graph and computes the location of the dialog
- this.graph.stopEditing(true);
- var offset = mxUtils.getOffset(this.graph.container);
- var x = offset.x+10;
- var y = offset.y;
- // Avoids moving the dialog if it is alredy open
- if (this.properties != null && !this.movePropertiesDialog)
- {
- x = this.properties.getX();
- y = this.properties.getY();
- }
- // Places the dialog near the cell for which it
- // displays the properties
- else
- {
- var bounds = this.graph.getCellBounds(cell);
- if (bounds != null)
- {
- x += bounds.x+Math.min(200, bounds.width);
- y += bounds.y;
- }
- }
- // Hides the existing properties dialog and creates a new one with the
- // contents created in the hook method
- this.hideProperties();
- var node = this.createProperties(cell);
- if (node != null)
- {
- // Displays the contents in a window and stores a reference to the
- // window for later hiding of the window
- this.properties = new mxWindow(mxResources.get(this.propertiesResource) ||
- this.propertiesResource, node, x, y, this.propertiesWidth, this.propertiesHeight, false);
- this.properties.setVisible(true);
- }
- }
- };
- /**
- * Function: isPropertiesVisible
- *
- * Returns true if the properties dialog is currently visible.
- */
- mxEditor.prototype.isPropertiesVisible = function ()
- {
- return this.properties != null;
- };
- /**
- * Function: createProperties
- *
- * Creates and returns the DOM node that represents the contents
- * of the properties dialog for the given cell. This implementation
- * works for user objects that are XML nodes and display all the
- * node attributes in a form.
- */
- mxEditor.prototype.createProperties = function (cell)
- {
- var model = this.graph.getModel();
- var value = model.getValue(cell);
- if (mxUtils.isNode(value))
- {
- // Creates a form for the user object inside
- // the cell
- var form = new mxForm('properties');
- // Adds a readonly field for the cell id
- var id = form.addText('ID', cell.getId());
- id.setAttribute('readonly', 'true');
- var geo = null;
- var yField = null;
- var xField = null;
- var widthField = null;
- var heightField = null;
- // Adds fields for the location and size
- if (model.isVertex(cell))
- {
- geo = model.getGeometry(cell);
- if (geo != null)
- {
- yField = form.addText('top', geo.y);
- xField = form.addText('left', geo.x);
- widthField = form.addText('width', geo.width);
- heightField = form.addText('height', geo.height);
- }
- }
- // Adds a field for the cell style
- var tmp = model.getStyle(cell);
- var style = form.addText('Style', tmp || '');
- // Creates textareas for each attribute of the
- // user object within the cell
- var attrs = value.attributes;
- var texts = [];
- for (var i = 0; i < attrs.length; i++)
- {
- // Creates a textarea with more lines for
- // the cell label
- var val = attrs[i].value;
- texts[i] = form.addTextarea(attrs[i].nodeName, val,
- (attrs[i].nodeName == 'label') ? 4 : 2);
- }
- // Adds an OK and Cancel button to the dialog
- // contents and implements the respective
- // actions below
- // Defines the function to be executed when the
- // OK button is pressed in the dialog
- var okFunction = mxUtils.bind(this, function()
- {
- // Hides the dialog
- this.hideProperties();
- // Supports undo for the changes on the underlying
- // XML structure / XML node attribute changes.
- model.beginUpdate();
- try
- {
- if (geo != null)
- {
- geo = geo.clone();
- geo.x = parseFloat(xField.value);
- geo.y = parseFloat(yField.value);
- geo.width = parseFloat(widthField.value);
- geo.height = parseFloat(heightField.value);
- model.setGeometry(cell, geo);
- }
- // Applies the style
- if (style.value.length > 0)
- {
- model.setStyle(cell, style.value);
- }
- else
- {
- model.setStyle(cell, null);
- }
- // Creates an undoable change for each
- // attribute and executes it using the
- // model, which will also make the change
- // part of the current transaction
- for (var i=0; i<attrs.length; i++)
- {
- var edit = new mxCellAttributeChange(
- cell, attrs[i].nodeName,
- texts[i].value);
- model.execute(edit);
- }
- // Checks if the graph wants cells to
- // be automatically sized and updates
- // the size as an undoable step if
- // the feature is enabled
- if (this.graph.isAutoSizeCell(cell))
- {
- this.graph.updateCellSize(cell);
- }
- }
- finally
- {
- model.endUpdate();
- }
- });
- // Defines the function to be executed when the
- // Cancel button is pressed in the dialog
- var cancelFunction = mxUtils.bind(this, function()
- {
- // Hides the dialog
- this.hideProperties();
- });
- form.addButtons(okFunction, cancelFunction);
- return form.table;
- }
- return null;
- };
- /**
- * Function: hideProperties
- *
- * Hides the properties dialog.
- */
- mxEditor.prototype.hideProperties = function ()
- {
- if (this.properties != null)
- {
- this.properties.destroy();
- this.properties = null;
- }
- };
- /**
- * Function: showTasks
- *
- * Shows the tasks window. The tasks window is created using <createTasks>. The
- * default width of the window is 200 pixels, the y-coordinate of the location
- * can be specifies in <tasksTop> and the x-coordinate is right aligned with a
- * 20 pixel offset from the right border. To change the location of the tasks
- * window, the following code can be used:
- *
- * (code)
- * var oldShowTasks = mxEditor.prototype.showTasks;
- * mxEditor.prototype.showTasks = function()
- * {
- * oldShowTasks.apply(this, arguments); // "supercall"
- *
- * if (this.tasks != null)
- * {
- * this.tasks.setLocation(10, 10);
- * }
- * };
- * (end)
- */
- mxEditor.prototype.showTasks = function ()
- {
- if (this.tasks == null)
- {
- var div = document.createElement('div');
- div.style.padding = '4px';
- div.style.paddingLeft = '20px';
- var w = document.body.clientWidth;
- var wnd = new mxWindow(
- mxResources.get(this.tasksResource) ||
- this.tasksResource,
- div, w - 220, this.tasksTop, 200);
- wnd.setClosable(true);
- wnd.destroyOnClose = false;
- // Installs a function to update the contents
- // of the tasks window on every change of the
- // model, selection or root.
- var funct = mxUtils.bind(this, function(sender)
- {
- mxEvent.release(div);
- div.innerHTML = '';
- this.createTasks(div);
- });
- this.graph.getModel().addListener(mxEvent.CHANGE, funct);
- this.graph.getSelectionModel().addListener(mxEvent.CHANGE, funct);
- this.graph.addListener(mxEvent.ROOT, funct);
- // Assigns the icon to the tasks window
- if (this.tasksWindowImage != null)
- {
- wnd.setImage(this.tasksWindowImage);
- }
- this.tasks = wnd;
- this.createTasks(div);
- }
- this.tasks.setVisible(true);
- };
- /**
- * Function: refreshTasks
- *
- * Updates the contents of the tasks window using <createTasks>.
- */
- mxEditor.prototype.refreshTasks = function (div)
- {
- if (this.tasks != null)
- {
- var div = this.tasks.content;
- mxEvent.release(div);
- div.innerHTML = '';
- this.createTasks(div);
- }
- };
- /**
- * Function: createTasks
- *
- * Updates the contents of the given DOM node to
- * display the tasks associated with the current
- * editor state. This is invoked whenever there
- * is a possible change of state in the editor.
- * Default implementation is empty.
- */
- mxEditor.prototype.createTasks = function (div)
- {
- // override
- };
- /**
- * Function: showHelp
- *
- * Shows the help window. If the help window does not exist
- * then it is created using an iframe pointing to the resource
- * for the <code>urlHelp</code> key or <urlHelp> if the resource
- * is undefined.
- */
- mxEditor.prototype.showHelp = function (tasks)
- {
- if (this.help == null)
- {
- var frame = document.createElement('iframe');
- frame.setAttribute('src', mxResources.get('urlHelp') || this.urlHelp);
- frame.setAttribute('height', '100%');
- frame.setAttribute('width', '100%');
- frame.setAttribute('frameBorder', '0');
- frame.style.backgroundColor = 'white';
- var w = document.body.clientWidth;
- var h = (document.body.clientHeight || document.documentElement.clientHeight);
- var wnd = new mxWindow(mxResources.get(this.helpResource) || this.helpResource,
- frame, (w-this.helpWidth)/2, (h-this.helpHeight)/3, this.helpWidth, this.helpHeight);
- wnd.setMaximizable(true);
- wnd.setClosable(true);
- wnd.destroyOnClose = false;
- wnd.setResizable(true);
- // Assigns the icon to the help window
- if (this.helpWindowImage != null)
- {
- wnd.setImage(this.helpWindowImage);
- }
- // Workaround for ignored iframe height 100% in FF
- if (mxClient.IS_NS)
- {
- var handler = function(sender)
- {
- var h = wnd.div.offsetHeight;
- frame.setAttribute('height', (h-26)+'px');
- };
- wnd.addListener(mxEvent.RESIZE_END, handler);
- wnd.addListener(mxEvent.MAXIMIZE, handler);
- wnd.addListener(mxEvent.NORMALIZE, handler);
- wnd.addListener(mxEvent.SHOW, handler);
- }
- this.help = wnd;
- }
- this.help.setVisible(true);
- };
- /**
- * Function: showOutline
- *
- * Shows the outline window. If the window does not exist, then it is
- * created using an <mxOutline>.
- */
- mxEditor.prototype.showOutline = function ()
- {
- var create = this.outline == null;
- if (create)
- {
- var div = document.createElement('div');
- div.style.overflow = 'hidden';
- div.style.position = 'relative';
- div.style.width = '100%';
- div.style.height = '100%';
- div.style.background = 'white';
- div.style.cursor = 'move';
- if (document.documentMode == 8)
- {
- div.style.filter = 'progid:DXImageTransform.Microsoft.alpha(opacity=100)';
- }
- var wnd = new mxWindow(
- mxResources.get(this.outlineResource) ||
- this.outlineResource,
- div, 600, 480, 200, 200, false);
- // Creates the outline in the specified div
- // and links it to the existing graph
- var outline = new mxOutline(this.graph, div);
- wnd.setClosable(true);
- wnd.setResizable(true);
- wnd.destroyOnClose = false;
- wnd.addListener(mxEvent.RESIZE_END, function()
- {
- outline.update();
- });
- this.outline = wnd;
- this.outline.outline = outline;
- }
- // Finally shows the outline
- this.outline.setVisible(true);
- this.outline.outline.update(true);
- };
- /**
- * Function: setMode
- *
- * Puts the graph into the specified mode. The following modenames are
- * supported:
- *
- * select - Selects using the left mouse button, new connections
- * are disabled.
- * connect - Selects using the left mouse button or creates new
- * connections if mouse over cell hotspot. See <mxConnectionHandler>.
- * pan - Pans using the left mouse button, new connections are disabled.
- */
- mxEditor.prototype.setMode = function(modename)
- {
- if (modename == 'select')
- {
- this.graph.panningHandler.useLeftButtonForPanning = false;
- this.graph.setConnectable(false);
- }
- else if (modename == 'connect')
- {
- this.graph.panningHandler.useLeftButtonForPanning = false;
- this.graph.setConnectable(true);
- }
- else if (modename == 'pan')
- {
- this.graph.panningHandler.useLeftButtonForPanning = true;
- this.graph.setConnectable(false);
- }
- };
- /**
- * Function: createPopupMenu
- *
- * Uses <popupHandler> to create the menu in the graph's
- * panning handler. The redirection is setup in
- * <setToolbarContainer>.
- */
- mxEditor.prototype.createPopupMenu = function (menu, cell, evt)
- {
- this.popupHandler.createMenu(this, menu, cell, evt);
- };
- /**
- * Function: createEdge
- *
- * Uses <defaultEdge> as the prototype for creating new edges
- * in the connection handler of the graph. The style of the
- * edge will be overridden with the value returned by
- * <getEdgeStyle>.
- */
- mxEditor.prototype.createEdge = function (source, target)
- {
- // Clones the defaultedge prototype
- var e = null;
- if (this.defaultEdge != null)
- {
- var model = this.graph.getModel();
- e = model.cloneCell(this.defaultEdge);
- }
- else
- {
- e = new mxCell('');
- e.setEdge(true);
- var geo = new mxGeometry();
- geo.relative = true;
- e.setGeometry(geo);
- }
- // Overrides the edge style
- var style = this.getEdgeStyle();
- if (style != null)
- {
- e.setStyle(style);
- }
- return e;
- };
- /**
- * Function: getEdgeStyle
- *
- * Returns a string identifying the style of new edges.
- * The function is used in <createEdge> when new edges
- * are created in the graph.
- */
- mxEditor.prototype.getEdgeStyle = function ()
- {
- return this.defaultEdgeStyle;
- };
- /**
- * Function: consumeCycleAttribute
- *
- * Returns the next attribute in <cycleAttributeValues>
- * or null, if not attribute should be used in the
- * specified cell.
- */
- mxEditor.prototype.consumeCycleAttribute = function (cell)
- {
- return (this.cycleAttributeValues != null &&
- this.cycleAttributeValues.length > 0 &&
- this.graph.isSwimlane(cell)) ?
- this.cycleAttributeValues[this.cycleAttributeIndex++ %
- this.cycleAttributeValues.length] : null;
- };
- /**
- * Function: cycleAttribute
- *
- * Uses the returned value from <consumeCycleAttribute>
- * as the value for the <cycleAttributeName> key in
- * the given cell's style.
- */
- mxEditor.prototype.cycleAttribute = function (cell)
- {
- if (this.cycleAttributeName != null)
- {
- var value = this.consumeCycleAttribute(cell);
- if (value != null)
- {
- cell.setStyle(cell.getStyle()+';'+
- this.cycleAttributeName+'='+value);
- }
- }
- };
- /**
- * Function: addVertex
- *
- * Adds the given vertex as a child of parent at the specified
- * x and y coordinate and fires an <addVertex> event.
- */
- mxEditor.prototype.addVertex = function (parent, vertex, x, y)
- {
- var model = this.graph.getModel();
- while (parent != null && !this.graph.isValidDropTarget(parent))
- {
- parent = model.getParent(parent);
- }
- parent = (parent != null) ? parent : this.graph.getSwimlaneAt(x, y);
- var scale = this.graph.getView().scale;
- var geo = model.getGeometry(vertex);
- var pgeo = model.getGeometry(parent);
- if (this.graph.isSwimlane(vertex) &&
- !this.graph.swimlaneNesting)
- {
- parent = null;
- }
- else if (parent == null && this.swimlaneRequired)
- {
- return null;
- }
- else if (parent != null && pgeo != null)
- {
- // Keeps vertex inside parent
- var state = this.graph.getView().getState(parent);
- if (state != null)
- {
- x -= state.origin.x * scale;
- y -= state.origin.y * scale;
- if (this.graph.isConstrainedMoving)
- {
- var width = geo.width;
- var height = geo.height;
- var tmp = state.x+state.width;
- if (x+width > tmp)
- {
- x -= x+width - tmp;
- }
- tmp = state.y+state.height;
- if (y+height > tmp)
- {
- y -= y+height - tmp;
- }
- }
- }
- else if (pgeo != null)
- {
- x -= pgeo.x*scale;
- y -= pgeo.y*scale;
- }
- }
- geo = geo.clone();
- geo.x = this.graph.snap(x / scale -
- this.graph.getView().translate.x -
- this.graph.gridSize/2);
- geo.y = this.graph.snap(y / scale -
- this.graph.getView().translate.y -
- this.graph.gridSize/2);
- vertex.setGeometry(geo);
- if (parent == null)
- {
- parent = this.graph.getDefaultParent();
- }
- this.cycleAttribute(vertex);
- this.fireEvent(new mxEventObject(mxEvent.BEFORE_ADD_VERTEX,
- 'vertex', vertex, 'parent', parent));
- model.beginUpdate();
- try
- {
- vertex = this.graph.addCell(vertex, parent);
- if (vertex != null)
- {
- this.graph.constrainChild(vertex);
- this.fireEvent(new mxEventObject(mxEvent.ADD_VERTEX, 'vertex', vertex));
- }
- }
- finally
- {
- model.endUpdate();
- }
- if (vertex != null)
- {
- this.graph.setSelectionCell(vertex);
- this.graph.scrollCellToVisible(vertex);
- this.fireEvent(new mxEventObject(mxEvent.AFTER_ADD_VERTEX, 'vertex', vertex));
- }
- return vertex;
- };
- /**
- * Function: destroy
- *
- * Removes the editor and all its associated resources. This does not
- * normally need to be called, it is called automatically when the window
- * unloads.
- */
- mxEditor.prototype.destroy = function ()
- {
- if (!this.destroyed)
- {
- this.destroyed = true;
- if (this.tasks != null)
- {
- this.tasks.destroy();
- }
- if (this.outline != null)
- {
- this.outline.destroy();
- }
- if (this.properties != null)
- {
- this.properties.destroy();
- }
- if (this.keyHandler != null)
- {
- this.keyHandler.destroy();
- }
- if (this.rubberband != null)
- {
- this.rubberband.destroy();
- }
- if (this.toolbar != null)
- {
- this.toolbar.destroy();
- }
- if (this.graph != null)
- {
- this.graph.destroy();
- }
- this.status = null;
- this.templates = null;
- }
- };
|