net/systemeD/potlatch2/TagViewer.mxml

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