Required include for Zverik's patch
[potlatch2.git] / net / systemeD / potlatch2 / TagViewer.mxml
1 <?xml version="1.0" encoding="utf-8"?>
2 <mx:VBox
3     xmlns:fx="http://ns.adobe.com/mxml/2009"
4         xmlns:mx="library://ns.adobe.com/flex/mx"
5         xmlns:flexlib="flexlib.containers.*"
6         xmlns:controls="net.systemeD.controls.*"
7         xmlns:potlatch2="net.systemeD.potlatch2.*"
8     xmlns:sidepanel="net.systemeD.potlatch2.panels.*"
9         horizontalScrollPolicy="off"
10     backgroundColor="white"
11     initialize="loadFeatures()">
12
13 <mx:ViewStack id="sidebar" width="100%" height="100%" creationPolicy="all">
14
15   <!-- Drag & drop icon panel -->
16
17   <mx:VBox id="dndPanel" width="100%" height="100%" horizontalScrollPolicy="off" styleName="dndPanelVbox">
18     <mx:Text id="dndPanelText" text="{dndPrompt}" width="100%" styleName="helpInfo" />
19         <mx:Repeater id="dndRep" dataProvider="{MapFeatures.getInstance().getCategoriesForType('point')}" styleName="dndRepeater">
20                 <mx:HBox width="100%" styleName="dndPanelCategory">
21                         <mx:Label text="{dndRep.currentItem.name}:" styleName="dndPanelCategoryLabel"/>
22                 </mx:HBox>
23
24                 <mx:TileList dataProvider="{dndRep.currentItem.getFeaturesForType('point', true)}" width="100%" height="1"
25                                      rowHeight="32" columnWidth="32" updateComplete="resizePOIGrid(event)" styleName="dndPanelTileList">
26                         <mx:itemRenderer>
27                                 <fx:Component>
28                                         <mx:VBox toolTip="{data.name}">
29                                                 <fx:Script><![CDATA[
30                                                         import mx.events.DragEvent;
31                                                         import mx.managers.DragManager;
32                                                         import mx.core.DragSource;
33
34                                                         private function dragPOI(event:MouseEvent, tags:Array):void {
35                                                                 // Get the drag initiator component from the event object.
36                                                                 var dragInitiator:Image = event.currentTarget as Image;
37                                                                 var dragSource:DragSource = new DragSource();
38                                                                 dragSource.addData(tags, 'tags');
39                                                                 dragSource.addData(event.target.parent.parent.parent.parent, 'container');
40
41                                                                 var dragProxy:Image = new Image();
42                                                                 dragProxy.source = dragInitiator.source;
43                                                                 dragProxy.width = dragInitiator.width;   // must set width and height explicitly
44                                                                 dragProxy.height = dragInitiator.height; // for non-embedded images
45                                                                 DragManager.doDrag(dragInitiator, dragSource, event, dragProxy);
46                                                         }
47                                                 ]]></fx:Script>
48                                                 <mx:Image id="foo" source="{data.dndimage}" height="24" width="24" mouseMove="dragPOI(event, data.tags)" toolTip="{data.name}" />
49                                         </mx:VBox>
50                                 </fx:Component>
51                         </mx:itemRenderer>
52                 </mx:TileList>
53         </mx:Repeater>
54   </mx:VBox>
55
56   <!-- Standard tagging panel -->
57
58   <mx:VBox id="tagsPanel" width="100%" height="100%" creationPolicy="auto">
59     <mx:ViewStack id="stack" width="100%" height="100%">
60       <mx:VBox width="100%" height="100%" label="Simple" id="editorContainer" creationComplete="initEditorStackUIs()" styleName="dndPanelVbox">
61         <mx:VBox width="100%" verticalGap="1" styleName="dndTagHeader">
62           <mx:HBox width="100%" id="iconContainer" styleName="featureSelector">
63             <mx:Image id="iconImage"/>
64             <mx:Text condenseWhite="true" width="100%" id="iconText" styleName="dndIconText"/>
65           </mx:HBox>
66           <mx:HBox width="100%">
67             <mx:PopUpButton id="popupChange" openAlways="true" width="100%" styleName="dndTagPopUpMenu" closeDuration="0" />
68             <mx:LinkButton icon="@Embed('../../../embedded/information.svg')" click="openDescription()" id="helpLabel" styleName="helpInfo"/>
69           </mx:HBox>
70         </mx:VBox>
71       </mx:VBox>
72       <mx:VBox width="100%" height="100%" label="Advanced" id="advancedContainer" initialize="checkAdvanced()" verticalGap="1">
73         <mx:Label id="advancedID" click="openEntityPage()">
74           <mx:htmlText><![CDATA[<i>No Selection</i>]]></mx:htmlText>
75         </mx:Label>
76
77                 <potlatch2:TagGrid id="advancedTagGrid" width="100%" height="75%" />
78
79         <mx:HBox horizontalAlign="right" width="100%">
80           <mx:LinkButton label="Delete" click="advancedTagGrid.removeTag()" id="advancedDeleteButton" enabled="{advancedTagGrid.selectedItem != null? true : false}"/>
81           <mx:LinkButton label="Add" click="advancedTagGrid.addNewTag()" id="advancedAddButton"/>
82         </mx:HBox>
83
84         <mx:DataGrid editable="true" width="100%" height="25%" id="relationsGrid"
85             doubleClickEnabled="true"
86             itemDoubleClick="editRelation(relationsGrid.selectedItem.id)"
87             doubleClick="if (event.target.parent==relationsGrid) { addToRelation(); }">
88             <mx:columns>
89                 <mx:DataGridColumn editable="false" dataField="description" headerText="Relation"/>
90                 <mx:DataGridColumn editable="false" dataField="id_idx" headerText="ID"/>
91                 <mx:DataGridColumn editable="true" dataField="role" headerText="Role">
92                     <mx:itemEditor><fx:Component><mx:TextInput restrict="&#x0020;-&#x10FFFF;" /></fx:Component></mx:itemEditor>
93                 </mx:DataGridColumn>
94                                 <mx:DataGridColumn width="20" editable="false">
95                                         <mx:itemRenderer>
96                                                 <fx:Component>
97                                     <mx:HBox horizontalAlign="center" verticalAlign="middle">
98                                                                 <mx:PopUpButton arrowButtonWidth="12" paddingLeft="0" paddingRight="0" width="12" height="12" 
99                                                                                 open="{outerDocument.updateRelationMenu(event);}" 
100                                                                                 creationComplete="{outerDocument.createRelationMenu(PopUpButton(event.target));}"/>
101                                                         </mx:HBox>
102                                                 </fx:Component>
103                                         </mx:itemRenderer>
104                                 </mx:DataGridColumn>
105             </mx:columns>
106         </mx:DataGrid>
107
108         <mx:HBox horizontalAlign="right" width="100%">
109           <mx:LinkButton label="Remove from" click="removeFromRelation(relationsGrid.selectedItem.id, relationsGrid.selectedItem.index)"
110                           enabled="{relationsGrid.selectedItem != null? true : false}"/>
111           <mx:LinkButton label="Add to" click="addToRelation()"/>
112         </mx:HBox>
113
114       </mx:VBox>
115
116       <mx:VBox width="100%" height="100%" label="Members" id="membersVBox" initialize="checkMembers()" verticalGap="1">
117         <mx:Label id="membersText" text="Relation Members"/>
118         <mx:DataGrid editable="true" width="100%" height="100%" id="membersGrid"
119                       dragEnabled="true" dragMoveEnabled="true" dropEnabled="true">
120           <mx:columns>
121             <mx:DataGridColumn editable="false" dataField="type" headerText="Type"/>
122             <mx:DataGridColumn editable="false" dataField="id" headerText="ID"/>
123             <mx:DataGridColumn editable="true" dataField="role" headerText="Role">
124                                 <mx:itemEditor><fx:Component><mx:TextInput restrict="&#x0020;-&#x10FFFF;" /></fx:Component></mx:itemEditor>
125                         </mx:DataGridColumn>
126           </mx:columns>
127         </mx:DataGrid>
128       </mx:VBox>
129
130       </mx:ViewStack>
131
132           <mx:HBox width="100%">
133                 <mx:LinkBar dataProvider="{stack}"/>
134                 <mx:Spacer width="100%"/>
135                 <mx:LinkButton
136                         icon="@Embed('../../../embedded/view_tabbed.png')"
137                         disabledIcon="@Embed('../../../embedded/view_tabbed_disabled.png')"
138                         click="setEditorStackUI(true)" id="tabNavigatorLabel" paddingTop="6"
139                         toolTip="Show in tabs"
140                         enabled="{editorStack is Accordion &amp;&amp; stack.selectedIndex==0}" />
141                 <mx:LinkButton
142                         icon="@Embed('../../../embedded/view_accordion.png')"
143                         disabledIcon="@Embed('../../../embedded/view_accordion_disabled.png')"
144                         click="setEditorStackUI(false)" id="accordionLabel" paddingTop="6"
145                         toolTip="Show in sliding windows"
146                         enabled="{editorStack is TabNavigator &amp;&amp; stack.selectedIndex==0}" />
147           </mx:HBox>
148   </mx:VBox>
149
150   <!-- Multiple selection -->
151
152   <mx:VBox id="multiplePanel" width="100%" height="100%" horizontalScrollPolicy="off" styleName="dndPanelVbox">
153     <potlatch2:TagGrid id="multiAdvancedTagGrid" width="100%" height="75%" />
154         <mx:HBox horizontalAlign="right" width="100%">
155           <mx:LinkButton label="Delete" click="multiAdvancedTagGrid.removeTag()" enabled="{multiAdvancedTagGrid.selectedItem != null? true : false}"/>
156           <mx:LinkButton label="Add" click="multiAdvancedTagGrid.addNewTag()" />
157         </mx:HBox>
158
159     <mx:DataGrid editable="true" width="100%" height="25%" id="multiRelationsGrid"
160         doubleClickEnabled="true"
161         itemDoubleClick="editRelation(multiRelationsGrid.selectedItem.id)"
162         doubleClick="if (event.target.parent==multiRelationsGrid) { addToRelation(); }">
163         <mx:columns>
164             <mx:DataGridColumn editable="false" dataField="description" headerText="Relation"/>
165             <mx:DataGridColumn editable="false" dataField="id_idx" headerText="ID"/>
166             <mx:DataGridColumn editable="true" dataField="role" headerText="Role">
167                 <mx:itemEditor><fx:Component><mx:TextInput restrict="&#x0020;-&#x10FFFF;" /></fx:Component></mx:itemEditor>
168             </mx:DataGridColumn>
169                         <mx:DataGridColumn width="20" editable="false">
170                                 <mx:itemRenderer>
171                                         <fx:Component>
172                             <mx:HBox horizontalAlign="center" verticalAlign="middle">
173                                                         <mx:PopUpButton arrowButtonWidth="12" paddingLeft="0" paddingRight="0" width="12" height="12" 
174                                                                         open="{outerDocument.updateRelationMenu(event);}" 
175                                                                         creationComplete="{outerDocument.createRelationMenu(PopUpButton(event.target));}"/>
176                                                 </mx:HBox>
177                                         </fx:Component>
178                                 </mx:itemRenderer>
179                         </mx:DataGridColumn>
180         </mx:columns>
181     </mx:DataGrid>
182     <mx:HBox horizontalAlign="right" width="100%">
183       <mx:LinkButton label="Remove from" click="removeFromRelation(multiRelationsGrid.selectedItem.id)"
184                       enabled="{multiRelationsGrid.selectedItem != null? true : false}"/>
185       <mx:LinkButton label="Add to" click="addToRelation()"/>
186     </mx:HBox>
187
188   </mx:VBox>
189
190   <!-- Multiple selection but items cannot be edited -->
191
192   <mx:VBox id="multipleInvalidPanel" width="100%" height="100%" horizontalScrollPolicy="off" styleName="dndPanelVbox">
193         <mx:Text id="multipleInvalidPanelText" text="You have selected multiple items." width="100%" styleName="helpInfo" />
194   </mx:VBox>
195
196   <!-- Generic marker panel -->
197
198   <mx:VBox id="markerPanel" width="100%" height="100%" horizontalScrollPolicy="off" styleName="dndPanelVbox">
199     <sidepanel:MarkerPanel id="markerPanelContents" width="100%"/>
200   </mx:VBox>
201
202   <!-- Bug editing panel -->
203
204   <mx:VBox id="bugPanel" width="100%" height="100%" horizontalScrollPolicy="off" styleName="dndPanelVbox">
205     <sidepanel:BugPanel id="bugPanelContents" width="100%"/>
206   </mx:VBox>
207
208   <!-- Background layer selection -->
209
210   <mx:VBox id="backgroundPanel" width="100%" height="100%" horizontalScrollPolicy="off" styleName="dndPanelVbox">
211     <sidepanel:BackgroundPanel id="backgroundPanelContents" width="100%"/>
212   </mx:VBox>
213
214   <!-- merge tags from background layer -->
215
216   <mx:VBox id="backgroundMergePanel" width="100%" height="100%" horizontalScrollPolicy="off" styleName="dndPanelVbox">
217     <sidepanel:BackgroundMergePanel id="backgroundMergePanelContents" width="100%" />
218   </mx:VBox>
219
220 </mx:ViewStack>
221
222   <fx:Script><![CDATA[
223       import net.systemeD.halcyon.connection.*;
224       import net.systemeD.halcyon.MapPaint;
225       import net.systemeD.potlatch2.EditController;
226       import net.systemeD.potlatch2.mapfeatures.*;
227       import net.systemeD.potlatch2.mapfeatures.editors.*;
228       import net.systemeD.potlatch2.utils.*;
229       import net.systemeD.controls.CollapsiblePanel;
230
231       import mx.collections.*;
232       import mx.containers.*;
233       import mx.events.*;
234       import mx.core.*;
235       import mx.managers.PopUpManager;
236       import mx.controls.Menu;
237       import mx.controls.Alert;
238       import flash.geom.Point;
239       import flash.net.*;
240       import mx.events.DragEvent;
241       import mx.managers.DragManager;
242       import mx.core.DragSource;
243       import mx.controls.TabBar;
244 //    import flexlib.containers.SuperTabNavigator;
245
246       [Bindable] [Embed(source="../../../embedded/tab_basic.png"       )] private var tabIconBasic:Class;
247       [Bindable] [Embed(source="../../../embedded/tab_address.png"     )] private var tabIconAddress:Class;
248       [Bindable] [Embed(source="../../../embedded/tab_cycle.png"       )] private var tabIconCycle:Class;
249       [Bindable] [Embed(source="../../../embedded/tab_details.png"     )] private var tabIconDetails:Class;
250       [Bindable] [Embed(source="../../../embedded/tab_restrictions.png")] private var tabIconRestrictions:Class;
251       [Bindable] [Embed(source="../../../embedded/tab_transport.png"   )] private var tabIconTransport:Class;
252       [Bindable] [Embed(source="../../../embedded/tab_walk.png"        )] private var tabIconWalk:Class;
253       private var tabIcons:Object= { Basic:tabIconBasic, Details:tabIconDetails, Address:tabIconAddress, Walk:tabIconWalk, Cycle:tabIconCycle, 
254                                          Transport:tabIconTransport, Restrictions:tabIconRestrictions};
255
256       [Bindable]
257       public var dndPrompt:String="Add new points by dragging them onto the map";
258
259       private var editorStackTabNavigator:TabNavigator;
260       private var editorStackAccordion:Accordion;
261       [Bindable] private var editorStack:Container;
262
263       public var mapFeatures:MapFeatures;
264       public var controller:EditController;
265       private var selectedEntity:Entity;
266       private var connection:Connection;
267       private var currentCategorySelector:CategorySelector;
268       private var categorySelectors:Object = {};        // hash of categorySelectors for each limitType
269       private var feature:Feature = null;
270
271       private var rowData:Object;               // relation membership reference, needed so it's accessible from relation actions menu
272
273           public function setEntity(entities:Array, layer:MapPaint=null):void {
274                 UIComponent.suspendBackgroundProcessing();
275                 connection=null;
276
277                 var firstSelected:Entity=null;
278                 if (entities.length==1) { firstSelected=entities[0]; }
279
280                 if (selectedEntity!=firstSelected && selectedEntity!=null) {
281                         selectedEntity.removeEventListener(Connection.TAG_CHANGED, tagChanged);
282                         selectedEntity.removeEventListener(Connection.ADDED_TO_RELATION, addedToRelation);
283                         selectedEntity.removeEventListener(Connection.REMOVED_FROM_RELATION, removedFromRelation);
284                 }
285
286                 if (entities.length==0) {
287                         // Nothing selected, so show drag-and-drop panel
288                         sidebar.selectedChild = dndPanel;
289
290                 } else if (entities.length==1) {
291                         // Single entity selected, so show tag panel
292                         selectedEntity=firstSelected;
293                         connection=firstSelected.connection;
294                         if (selectedEntity!=null) { selectedEntity.addEventListener(Connection.TAG_CHANGED, tagChanged); }
295                         if (advancedID!=null) { setupAdvanced(firstSelected); }
296                         if (firstSelected is Relation) { stack.addChild(membersVBox); }
297             if (selectedEntity is Marker && connection is BugConnection) {
298               bugPanelContents.init(selectedEntity, BugConnection(connection));
299               sidebar.selectedChild = bugPanel;
300             } else if (selectedEntity is Marker) {
301               markerPanelContents.init(selectedEntity, layer);
302               sidebar.selectedChild = markerPanel;
303             } else if (connection is SnapshotConnection) {
304               backgroundPanelContents.init(selectedEntity, layer);
305               sidebar.selectedChild = backgroundPanel;
306             } else {
307               refreshFeatureIcon();
308               initialiseEditors();
309               sidebar.selectedChild = tagsPanel;
310             }
311
312         } else if (entities.length==2
313                       && xor(entities[0].connection is SnapshotConnection, entities[1].connection is SnapshotConnection)
314                       && xor(!controller.map.getLayerForEntity(entities[0]).isBackground, !controller.map.getLayerForEntity(entities[1]).isBackground) ) {
315             backgroundMergePanelContents.init(entities);
316             sidebar.selectedChild = backgroundMergePanel;
317
318                 } else if(isMultipleEditable(entities)) {
319                         selectedEntity = new EntityCollection(entities);
320                         selectedEntity.addEventListener(Connection.TAG_CHANGED, tagChanged);
321             sidebar.selectedChild = multiplePanel;
322                         setupMultiAdvanced(selectedEntity);
323                         connection=entities[0].connection;
324                         
325                 } else {
326                         //The selection contains elements which can't be edited all together.
327                         sidebar.selectedChild = multipleInvalidPanel;
328                 }
329                 UIComponent.resumeBackgroundProcessing();
330       }
331
332       private function xor(a:Boolean, b:Boolean):Boolean {
333           return ( a || b) && !(a && b);
334       }
335
336       private function refreshFeatureIcon():void {
337           var oldFeature:Feature = feature;
338           feature = selectedEntity == null ? null : mapFeatures.findMatchingFeature(selectedEntity);
339           if ( feature != oldFeature ) {
340               if ( oldFeature != null )
341                   oldFeature.removeEventListener("imageChanged", featureImageChanged);
342               if ( feature != null )
343                   feature.addEventListener("imageChanged", featureImageChanged);
344           }
345           setCategorySelector(selectedEntity, feature);
346       }
347
348       private function featureImageChanged(event:Event):void {
349           setCategorySelector(selectedEntity, feature);
350       }
351
352       /** Set the icon, categorySelector and help text for the current entity. */
353       private function setCategorySelector(entity:Entity, feature:Feature):void {
354                         // Remove the "user has selected something" event listener from previous categorySelector,
355                         // and make it invisible because Flex is crap at updating click areas otherwise
356                         if (currentCategorySelector) { 
357                                 currentCategorySelector.removeEventListener("selectedType", changeFeatureType);
358                                 currentCategorySelector.visible=false;
359                         }
360                         
361                         // Have we cached the categorySelector for this limitType? If not, create one
362                         var lt:String=limitType(entity);
363                         if (!categorySelectors[lt]) {
364                                 categorySelectors[lt]=new CategorySelector();
365                                 categorySelectors[lt].setLimitTypes(lt);
366                         }
367                         currentCategorySelector=categorySelectors[lt];
368                         currentCategorySelector.addEventListener("selectedType", changeFeatureType, false, 0, true);
369
370                         // Update surrounding icon/text display
371                         if (feature) {
372                                 iconImage.source = feature.image;
373                                 iconText.htmlText = feature.htmlDetails(entity);
374                                 popupChange.label = feature.name;
375                                 helpLabel.visible = feature.hasHelpURL();
376                                 currentCategorySelector.setSelectedFeature(feature);
377                         } else {
378                                 iconImage.source = null;
379                                 popupChange.label = "unknown";
380                                 helpLabel.visible = false;
381                                 if (entity==null) {
382                                         iconText.htmlText = "<i>Nothing selected</i>";
383                                 } else if (entity.hasTags()) {
384                                         iconText.htmlText = "<b>Not recognised</b><br/><font size='10pt'>Try looking at the tags under the advanced properties</font>";
385                                 } else {
386                                         iconText.htmlText = "<b>No tags set</b><br/><font size='10pt'>Please use the menu below to define what this "+entity.getType()+" is</font>";
387                                 }
388                                 currentCategorySelector.setSelectedFeature(null);
389                         }
390
391                         // Set it as the popup, and make sure it's visible
392                         popupChange.popUp=currentCategorySelector;
393                         currentCategorySelector.visible=true;
394       }
395
396           private function isMultipleEditable(entities:Array):Boolean {
397                 for each(var entity:Entity in entities) {
398                         if(!(entity is Node || entity is Way))
399                                 return false;
400                 }
401                 return true;
402           }
403
404       private function limitType(entity:Entity):String {
405           if      (entity is Node    ) return "point";
406           else if (entity is Way     ) return Way(entity).isArea() ? "area" : "line";
407           else if (entity is Relation) return "relation";
408           return null;
409       }
410
411       private var tabComponents:Object = {};
412       private var subpanelComponents:Object = {};
413
414       private function initialiseEditors():void {
415                 editorStack.removeAllChildren();
416                 if ( selectedEntity == null || feature == null )
417                         return;
418
419                 var basicEditorBox:VBox = createEditorBox();
420                 basicEditorBox.label = "Basic";
421                 basicEditorBox.icon=tabIconBasic;
422                 editorStack.addChild(basicEditorBox);
423
424                 var tabs:Object = {};
425                 var tabList:Array = [];
426                 tabComponents = {};
427                 var subpanels:Object = {};
428                 subpanelComponents = {};
429
430                 // First create the tabs
431                 for each (var factory:EditorFactory in feature.editors) {
432                         var category:String = factory.category;
433                         if (category!='') {
434                                 var tab:VBox = tabs[category];
435                                 if ( tab == null) {
436                                         tab = createEditorBox();
437                                         tab.label = category;
438                                         if (tabIcons[category]) tab.icon=tabIcons[category];
439                                         tabs[category] = tab;
440                                         tabList.push(tab);      
441                                 }
442                         }
443                 }
444
445                 // Put the tabs on-screen in order
446                 tabList.sort(sortCategories,16);
447                 for each (tab in tabList) {
448                         editorStack.addChild(tab);
449                         tabComponents[tab] = [];
450                 }
451
452                 // Then add the individual editors to them
453                 for each (factory in feature.editors) {
454
455                         // Add to basic editor box first
456                         if ( factory.presence.isEditorPresent(factory, selectedEntity, null) ) {
457                                 var editor:DisplayObject = factory.createEditorInstance(selectedEntity);
458                                 if (editor) basicEditorBox.addChild(editor);
459                         }
460
461                         // Then prepare to add to category panel
462                         category=factory.category;
463                         if (factory.category=='') continue;
464                         var catEditor:DisplayObject = factory.createEditorInstance(selectedEntity);
465                         if (!catEditor) continue;
466                         tab=tabs[category];
467                         
468                         // Create subcategory panel if needed
469                         if (factory.subcategory) {
470                                 var subcategory:String = factory.subcategory;
471                                 if (!subpanels[category]) { subpanels[category]={}; }
472                                 var subpanel:CollapsiblePanel = subpanels[category][subcategory];
473                                 if (!subpanel) {
474                                         subpanel=new CollapsiblePanel(false);
475                                         subpanel.percentWidth=100;
476                                         subpanel.styleName="subcategoryPanel";
477                                         subpanel.title=subcategory;
478                                         subpanels[category][subcategory]=subpanel;
479                                         tabComponents[tab].push(subpanel);
480                                 }
481                                 subpanel.addChild(catEditor);
482                         } else {
483                                 tabComponents[tab].push(catEditor);
484                         }
485                 }
486       }
487
488         // ** FIXME: Order probably shouldn't be hard-coded, but configurable
489         private static var categoryOrder:Array=["Restrictions","Transport","Cycle","Walk","Address","Details"]; // reverse order
490         private function sortCategories(a:VBox,b:VBox):int {
491                 var a1:int=categoryOrder.indexOf(a.label);
492                 var a2:int=categoryOrder.indexOf(b.label);
493                 if (a1<a2) { return 1; }
494                 else if (a1>a2) { return -1; }
495                 return 0;
496         }
497         
498       private function createEditorBox():VBox {
499           var box:VBox = new VBox();
500           box.percentWidth = 100;
501           box.percentHeight = 100;
502           box.styleName = "dndEditorContainer";
503           return box;
504       }
505
506       private function ensureEditorsPopulated(tab:VBox):void {
507           var components:Array = tabComponents[tab];
508           if ( components == null || tab == null || tab.numChildren >= components.length )
509               return;
510           for each (var component:DisplayObject in components ) {
511               tab.addChild(component);
512           }
513       }
514
515         private function initEditorStackUIs():void {
516                 editorStackTabNavigator = new TabNavigator();
517 //              editorStackTabNavigator.allowTabSqueezing=false;
518 //              editorStackTabNavigator.minTabWidth=10;
519 //              editorStackTabNavigator.closePolicy="close_never";
520 //              editorStackTabNavigator.scrollSpeed=20;
521                 editorStackTabNavigator.creationPolicy="auto";
522                 editorStackTabNavigator.percentWidth=100;
523                 editorStackTabNavigator.percentHeight=100;
524                 editorStackTabNavigator.styleName="dndStackTab";
525 //              editorStackTabNavigator.popUpButtonPolicy="off"
526
527
528                 editorStackAccordion = new Accordion();
529                 editorStackAccordion.percentWidth=100;
530                 editorStackAccordion.percentHeight=100;
531                 editorStackAccordion.creationPolicy="auto";
532                 editorStackAccordion.styleName="dndStackAccordion";
533                 /* FIXME: the accordion icons should be right-aligned. See:
534                 http://www.kristoferjoseph.com/blog/2008/11/06/positioning-the-flex-accordion-header-icon
535                 http://blog.flexexamples.com/2007/09/13/changing-text-alignment-in-an-flex-accordion-header/
536                 */
537
538                 setEditorStackUI(true);
539         }
540
541         private function setEditorStackUI(isTabbed:Boolean):void {
542                 var children:Array=[]; var i:uint;
543
544                 if (editorStack) {
545                         // blank existing component
546                         editorStack.removeEventListener("change",editorStackUIChange);
547                         editorStack.removeEventListener("updateComplete",editorStackUIUpdate);
548                         editorStack.removeAllChildren();
549                         editorContainer.removeChildAt(1);
550                 }
551
552                 // replace with new component
553                 editorStack = (isTabbed ? editorStackTabNavigator : editorStackAccordion) as Container;
554                 editorContainer.addChild(editorStack);
555
556                 // re-add children and listeners
557                 initialiseEditors();
558                 editorStack.addEventListener("change",editorStackUIChange);
559                 editorStack.addEventListener("updateComplete",editorStackUIUpdate);
560         }
561
562         private function editorStackUIChange(event:Event):void {
563                 ensureEditorsPopulated(IndexChangedEvent(event).relatedObject as VBox);
564         }
565
566         private function editorStackUIUpdate(event:Event):void {
567                 if (editorStack is TabNavigator) {
568                         var e:TabNavigator = editorStack as TabNavigator;
569                         if (e.selectedIndex<0) { return; }
570                         for (var i:uint=0; i<e.numChildren; i++) {
571                                 e.getTabAt(i).selected=(i==e.selectedIndex);
572                         }
573                 }
574         }
575
576
577         public function togglePanel():void {
578                 if (stack.selectedChild==editorContainer && selectedEntity!=null) {
579                         stack.selectedChild=advancedContainer;
580                 } else if (stack.selectedChild!=editorContainer) {
581                         stack.selectedChild=editorContainer;
582                 }
583         }
584
585         public function selectAdvancedPanel():void {
586                 checkAdvanced();
587                 stack.selectedChild=advancedContainer;
588         }
589
590       private function checkAdvanced():void {
591           if ( selectedEntity != null )
592              setupAdvanced(selectedEntity);
593       }
594
595       private var listeningToRelations:Array = [];
596
597       private function setupAdvanced(entity:Entity):void {
598                 if (!advancedTagGrid) advancedContainer.createComponentsFromDescriptors();      // if Flex hasn't created it, force it
599                 advancedTagGrid.init(entity);
600
601                 if ( entity == null ) {
602                         advancedID.htmlText = "";
603                 } else {
604                         var entityText:String = "xx";
605                         if      ( entity is Node     ) entityText = "Node";
606                         else if ( entity is Way      ) entityText = "Way";
607                         else if ( entity is Relation ) entityText = "Relation";
608                         advancedID.htmlText = entityText+": <b>"+entity.id+"</b>";
609                 }
610
611                 removeRelationListeners();
612
613                 if ( entity == null ) {
614                         relationsGrid.dataProvider = null;
615                 } else {
616                         resetRelationsGrid(entity);
617                         entity.addEventListener(Connection.ADDED_TO_RELATION, addedToRelation);
618                         entity.addEventListener(Connection.REMOVED_FROM_RELATION, removedFromRelation);
619                 }
620       }
621
622           private function setupMultiAdvanced(entity:Entity):void {
623                 multiAdvancedTagGrid.init(entity);
624                 resetRelationsGrid(entity);
625                 entity.addEventListener(Connection.ADDED_TO_RELATION, addedToRelation, false, 0, true);
626                 entity.addEventListener(Connection.REMOVED_FROM_RELATION, removedFromRelation, false, 0, true);
627       }
628
629           public function addNewTag():void {
630                 if (stack.selectedChild!=advancedContainer) { return; }
631                 advancedTagGrid.addNewTag();
632           }
633
634       private function addedToRelation(event:RelationMemberEvent):void {
635          resetRelationsGrid(selectedEntity);
636       }
637
638       private function removedFromRelation(event:RelationMemberEvent):void {
639          resetRelationsGrid(selectedEntity);
640       }
641
642       private function removeRelationListeners():void {
643           for each( var rel:Relation in listeningToRelations ) {
644               rel.removeEventListener(Connection.TAG_CHANGED, relationTagChanged);
645               rel.removeEventListener(Connection.RELATION_MEMBER_ADDED, entityRelationMemberChanged);
646               rel.removeEventListener(Connection.RELATION_MEMBER_REMOVED, entityRelationMemberChanged);
647           }
648           listeningToRelations = [];
649           if (relationsGrid) relationsGrid.removeEventListener(DataGridEvent.ITEM_EDIT_END, relationRoleChanged);
650           if (multiRelationsGrid) multiRelationsGrid.removeEventListener(DataGridEvent.ITEM_EDIT_END, relationRoleChanged);
651       }
652
653       private function resetRelationsGrid(entity:Entity):void {
654           removeRelationListeners();
655
656           var instance:DataGrid=relationsGrid;
657           if (entity is EntityCollection) instance=multiRelationsGrid;
658           var memberships:Array = entity.getRelationMemberships();
659           for each (var m:Object in memberships) {
660               m.relation.addEventListener(Connection.TAG_CHANGED, relationTagChanged);
661               m.relation.addEventListener(Connection.RELATION_MEMBER_ADDED, entityRelationMemberChanged);
662               m.relation.addEventListener(Connection.RELATION_MEMBER_REMOVED, entityRelationMemberChanged);
663               listeningToRelations.push(m.relation);
664           }
665           instance.dataProvider = memberships;
666           instance.addEventListener(DataGridEvent.ITEM_EDIT_END, relationRoleChanged, false, -100);
667       }
668
669       private function relationRoleChanged(event:DataGridEvent):void {
670                 if (event.dataField != 'role') { return; }      // shouldn't really happen
671
672                 var relations:Array=event.currentTarget.dataProvider.toArray();
673                 var props:Object=relations[event.rowIndex];
674
675                 var relation:Relation=props['relation'];
676                 var newRole:String=event.itemRenderer.data['role'];
677
678                 if (selectedEntity is EntityCollection) {
679                         for each (var entity:Entity in EntityCollection(selectedEntity).entities) {
680                                 var indexes:Array=relation.findEntityMemberIndexes(entity);
681                                 for each (var index:int in indexes) {
682                                         relation.setMember(index, new RelationMember(entity,newRole), MainUndoStack.getGlobalStack().addAction);
683                                 }
684                         }
685                 } else {
686                         relation.setMember(props['index'], new RelationMember(selectedEntity,newRole), MainUndoStack.getGlobalStack().addAction);
687                 }
688       }
689
690       private function relationTagChanged(event:TagEvent):void {
691           resetRelationsGrid(selectedEntity);
692       }
693
694       private function entityRelationMemberChanged(event:RelationMemberEvent):void {
695           resetRelationsGrid(selectedEntity);
696       }
697
698       private function checkMembers():void {
699           if (selectedEntity is Relation) {
700             setupMembers(selectedEntity as Relation);
701           }
702       }
703
704       private function setupMembers(rel:Relation):void {
705           var members:Array = [];
706           for (var i:int=0 ; i<rel.length; i++) {
707             var props:Object = {};
708             var member:RelationMember = rel.getMember(i);
709             props["id"] = member.entity.id;
710             props["type"] = member.entity.getType();
711             props["role"] = member.role;
712
713             members.push(props);
714           }
715           membersGrid.dataProvider = members;
716           membersGrid.dataProvider.addEventListener('collectionChange', membersChange);
717       }
718
719       private function membersChange(event:Event):void {
720           // Dropping all the members and re-adding them isn't exactly optimal
721           // but is at least robust for any kind of change.
722           // Figuring out a better way is someone else's FIXME
723
724           var rel:Relation = selectedEntity as Relation;
725           var action:CompositeUndoableAction = new CompositeUndoableAction("Rearrange relation members for "+rel);
726
727           // drop members
728           for (var i:int=rel.length-1 ; i>=0; i--) {
729             rel.removeMemberByIndex(i, action.push);
730           }
731
732           // add members in new order
733           for each(var memberObject:Object in membersGrid.dataProvider) {
734             var e:Entity;
735             var id:Number = memberObject.id;
736                         switch (memberObject.type) {
737                                 case 'node':            e = connection.getNode(id); break;
738                 case 'way':                     e = connection.getWay(id); break;
739                                 case 'relation':        e = connection.getRelation(id); break;
740             }
741             rel.appendMember(new RelationMember(e, memberObject.role), action.push);
742           }
743           MainUndoStack.getGlobalStack().addAction(action);
744       }
745
746       private function editRelation(id:Number):void {
747           var panel:RelationEditorPanel = RelationEditorPanel(
748               PopUpManager.createPopUp(Application(FlexGlobals.topLevelApplication), RelationEditorPanel, true));
749           panel.setRelation(connection.getRelation(id));
750           PopUpManager.centerPopUp(panel);
751       }
752
753         /** Create relation actions menu */
754
755         public function createRelationMenu(button:PopUpButton):void {
756                 var menu:Menu = new Menu(); 
757                 var dp:Object = [ {label: "Select all members"}, 
758                                                   {label: "Deselect all members"}, 
759                                                   {label: "Add selection to this relation", enabled: false},
760                                                   {label: "Delete relation"} ]; 
761                 menu.dataProvider = dp; 
762                 menu.addEventListener("itemClick", selectRelationMenu); 
763                 button.popUp = menu;
764         }
765
766         /** Enable 'add selection to...' entry only if some of the selection isn't in the relation.
767             Called each time the menu is clicked. */
768         
769         public function updateRelationMenu(event:Event):void {
770                 rowData=event.target.parent.data;       // this makes it accessible from selectRelationMenu
771                 var menu:Menu = Menu(event.target.popUp);
772                 var enable:Boolean = false;
773                 if (selectedEntity != null && selectedEntity is EntityCollection) {
774                         // Enable only if some entities aren't a member of the relation
775                         enable=!rowData.universal;
776                 }
777                 if (enable==menu.dataProvider[2].enabled) return;
778                 menu.dataProvider[2].enabled=enable;
779                 menu.invalidateList();
780         }
781
782         /** Do the action selected in the relation actions menu */
783
784         public function selectRelationMenu(event:MenuEvent):void {
785                 var rel:Relation=rowData.relation;
786                 var entities:Array;
787                 var controller:EditController=FlexGlobals.topLevelApplication.theController;
788                 switch (event.index) {
789                         case 0: // Select all members
790                                 entities=selectedEntity.entities.concat(rel.memberEntities);
791                                 entities=entities.filter(function(e:*, i:int, arr:Array):Boolean { return arr.indexOf(e) == i } );      // remove duplicates
792                                 // ** FIXME: This is a really horrible way of changing the controller state
793                                 controller.setState(controller.findStateForSelection(entities));
794                                 break;
795
796                         case 1: // Deselect all members
797                                 entities=selectedEntity.entities;
798                                 entities=entities.filter(function(e:*, i:int, arr:Array):Boolean { return !e.hasParent(rel) } );
799                                 controller.setState(controller.findStateForSelection(entities));
800                                 break;
801
802                         case 2: // Add selection to this relation
803                                 var undo:CompositeUndoableAction=new CompositeUndoableAction("Remove selection from relations");
804                                 for each (var entity:Entity in selectedEntity.entities) {
805                                         if (!entity.hasParent(rel)) {
806                                                 rel.appendMember(new RelationMember(entity,''), undo.push);
807                                         }
808                                 }
809                                 MainUndoStack.getGlobalStack().addAction(undo);
810                                 break;
811                         
812                         case 3: // Delete relation
813                                 Alert.show("Do you really want to delete the relation?","Are you sure?",Alert.YES | Alert.CANCEL,null,
814                                         function(event:CloseEvent):void { 
815                                                 if (event.detail==Alert.CANCEL) return;
816                                                 rel.remove(MainUndoStack.getGlobalStack().addAction);
817                                         } );
818                                 break;
819                 }
820         }
821
822       private function tagChanged(event:TagEvent):void {
823           refreshFeatureIcon();
824       }
825
826       public function loadFeatures():void {
827           mapFeatures = MapFeatures.getInstance();
828           stack.removeChild(membersVBox); // remove by default, will be added if relation
829       }
830
831       /** Open up a new browser page, showing the help page as defined in Map Features XML file .*/
832       public function openDescription():void {
833           if ( feature != null && feature.hasHelpURL() )
834               navigateToURL(new URLRequest(feature.helpURL), "potlatch_help");
835       }
836
837       /** Open up a new browser page showing OSM's view of the current entity. */
838       public function openEntityPage():void {
839           if (selectedEntity != null && selectedEntity.id >= 0) {
840               // This is slightly hard-coded, but not drastically. The ../s could be changed for string manipulation of the apiBase
841               var urlBase:String = connection.apiBase + '../../browse/'
842               navigateToURL(new URLRequest(urlBase+selectedEntity.getType()+'/'+selectedEntity.id), "potlatch_browse");
843           }
844       }
845
846       public function addToRelation():void {
847           new RelationSelectPanel().init(selectedEntity,new Object());
848       }
849
850       private function removeFromRelation(id:Number, index:int=-1):void {
851                 var rel:Relation=connection.getRelation(id);
852                 if (index>-1) {
853                         rel.removeMemberByIndex(index, MainUndoStack.getGlobalStack().addAction);
854                 } else if (selectedEntity is EntityCollection) {
855                         var undo:CompositeUndoableAction=new CompositeUndoableAction("Remove selection from relations");
856                         for each (var e:Entity in EntityCollection(selectedEntity).entities) rel.removeMember(e,undo.push);
857                         MainUndoStack.getGlobalStack().addAction(undo);
858                 }
859       }
860
861       public function changeFeatureType(event:Event):void {
862           if ( selectedEntity == null )
863               return;
864
865           UIComponent.suspendBackgroundProcessing();
866           var newFeature:Feature = currentCategorySelector.selectedType;
867           var undoStack:Function = MainUndoStack.getGlobalStack().addAction;
868           var action:CompositeUndoableAction = new CompositeUndoableAction(
869                   "Set "+selectedEntity.getType()+" "+selectedEntity.id+" to "+newFeature.name);
870                   selectedEntity.suspend();
871           
872           // build a list of tags that are editable in new feature
873           var editableTags:Array = new Array();
874           for each( var editor:EditorFactory in newFeature.editors ) {
875               if ( editor is SingleTagEditorFactory ) {
876                   var singleTagEditor:SingleTagEditorFactory = editor as SingleTagEditorFactory;
877                   editableTags.push(singleTagEditor.key);
878               }
879           }
880
881           // remove tags from the current feature
882           if ( feature != null ) {
883               for each( var oldtag:Object in feature.tags ) {
884                   if ( editableTags.indexOf(oldtag["k"]) < 0 ) {
885                       selectedEntity.setTag(oldtag["k"], null, action.push);
886                   }
887               }
888           }
889
890           // set tags for new feature
891           if ( newFeature != null ) {
892               for each( var newtag:Object in newFeature.tags ) {
893                   selectedEntity.setTag(newtag["k"], newtag["v"], action.push);
894               }
895           }
896
897                   selectedEntity.resume();
898           undoStack(action);
899           popupChange.close();
900           initialiseEditors();
901           UIComponent.resumeBackgroundProcessing();
902       }
903
904         private function resizePOIGrid(event:Event):void {
905                 var rows:Number=event.target.dataProvider.length/event.target.columnCount;
906                 if (rows!=Math.floor(rows)) { rows=Math.floor(rows+1); }
907                 event.target.height=rows*(event.target.rowHeight+1);
908         }
909   ]]></fx:Script>
910 </mx:VBox>
911