Feature/51 bookmarks widget

samples/dymaptic.GeoBlazor.Core.Sample.Shared/Pages/Bookmarks.razor

@@ -0,0 +1,53 @@
+@page "/Bookmarks"
+@using dymaptic.GeoBlazor.Core.Components.Widgets;
+
+<PageTitle>Bookmarks and Bookmarks Widget</PageTitle>
+<h1>Bookmarks Widget</h1>
+
+<div class="links-div">
+    <a class="btn btn-secondary" target="_blank" href="https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html">ArcGIS API for JavaScript Reference</a>
+    <a class="btn btn-primary" target="_blank" href="https://www.arcgis.com/home/item.html?id=70b726074af04a7e9839d8a07f64c039">Bookmarks widget</a>
+</div>
+
+<p class="instructions">
+    Sample demonstrates the use of the Bookmarks widget and Bookmark actions.
+</p>
+
+<div class="form-group">
+    <label>Show Bookmarks and Bookmarks Widget: <input type="checkbox" class="form-check-input" @onchange="@(()=> _showBookmarks = !_showBookmarks)"></label>
+</div>
+
+<MapView @ref="MapView" Class="map-view">
+    <Map>
+        <Basemap>           
+            <PortalItem Id="70b726074af04a7e9839d8a07f64c039" />
+        </Basemap>
+    </Map>
+    @if (_showBookmarks)
+    {
+        <ExpandWidget ContainerId="BookmarkDiv" Position="OverlayPosition.TopRight">
+            <div class="container">
+                <div class="row">
+                    <div class="col-12">
+                        <p>Click on a bookmark to navigate to its location.</p>
+                        <BookmarksWidget  />
+                    </div>
+                </div>
+            </div>
+        </ExpandWidget>
+    }   
+
+
+
+
+
+
+</MapView>
+
+@code {
+    private MapView? MapView { get; set; }
+    private bool _showBookmarks;
+
+
+
+}

samples/dymaptic.GeoBlazor.Core.Sample.Shared/Pages/Widgets.razor

@@ -1,4 +1,5 @@
 @page "/widgets"
+@using GeoBlazor.Core.Components.Widgets;
 
 <PageTitle>Widgets</PageTitle>
 <h1>Widgets</h1>
@@ -37,6 +38,10 @@
         <div class="form-group">
             <label>Compass: <input type="checkbox" class="form-check-input" @onchange="@(() => ToggleWidget(nameof(CompassWidget)))"></label>
         </div>
+
+        <div class="form-group">
+            <label>Bookmarks + Expander: <input type="checkbox" class="form-check-input" @onchange="@(() => ToggleWidget(nameof(BookmarksWidget)))"></label>
+        </div>
         <div id="gallery-box"></div>
     </div>
 </div>
@@ -76,6 +81,20 @@
     {
         <CompassWidget Position="OverlayPosition.TopLeft" />
     }
+    @if (_showBookmarks)
+    {
+        <ExpandWidget Position="OverlayPosition.TopRight" Expanded="true" ExpandIcon="refresh" CollapseIcon="submit" >
+            <BookmarksWidget @ref="_bookmarkWidget"  EditingEnabled="true">
+                @*<Bookmark Name="InlineExample">
+            <Viewpoint  >
+            <Extent Xmin="-13139131.948889678" Ymin="4047767.307589972" Xmax="-13105131.948889678" Ymax="4067767.307589972">
+            <SpatialReference Wkid="102100"></SpatialReference>
+            </Extent>
+            </Viewpoint>
+            </Bookmark>*@
+            </BookmarksWidget>
+        </ExpandWidget>
+    }
 </MapView>
 
 @code {
@@ -109,9 +128,72 @@
             case nameof(CompassWidget):
                 _showCompass = !_showCompass;
                 break;
+            case nameof(BookmarksWidget):
+                _showBookmarks = !_showBookmarks;
+                break;
+        }
+    }
+
+    protected override void OnAfterRender(bool firstRender)
+    {
+        if (_showBookmarks)
+        {
+            //the MapView.Refresh() is needed because the bookmarks are added after the BookmarksWidget is rendered
+            _bookmarkWidget!.Bookmarks = _bookmarks;
+            MapView!.Refresh();
         }
     }
 
+    private List<Bookmark> _bookmarks = new List<Bookmark>()
+    {
+        new Bookmark()
+        {
+            Name="Angeles National Forest",
+            Thumbnail="/_content/dymaptic.GeoBlazor.Core.Sample.Shared/images/Blazor-API-60px.png",
+            Viewpoint = new Viewpoint()
+            {
+                TargetGeometry = new Extent()
+                {
+                    SpatialReference = new SpatialReference(102100),
+                    Xmin = -13139131.948889678,
+                    Ymin = 4047767.23531948,
+                    Xmax = -13092887.54677721,
+                    Ymax = 4090610.189673263,
+                }
+            }
+        },
+        new Bookmark()
+        {
+            Name = "Crystal Lake",
+            Viewpoint = new Viewpoint()
+            {
+                TargetGeometry = new Extent()
+                {
+                    SpatialReference = new SpatialReference(102100),
+                    Xmin = -13125852.551697943,
+                    Ymin = 4066904.1101411926,
+                    Xmax = -13114291.451169826,
+                    Ymax = 4077614.8487296384
+                }
+            }
+        },
+        new Bookmark()
+        {
+            Name = "Mt. Waterman",
+            Viewpoint = new Viewpoint()
+            {
+                TargetGeometry = new Extent()
+                {
+                    SpatialReference = new SpatialReference(102100),
+                    Xmin= -13185668.186639601,
+                    Ymin= 4066176.418652561,
+                    Xmax= -13183855.195875114,
+                    Ymax= 4067515.260976006
+                }
+            }
+        }
+    };
+
     private bool _showSearch;
     private bool _showLocate;
     private bool _showBasemapToggle;
@@ -120,4 +202,7 @@
     private bool _showLegend;
     private bool _showHome;
     private bool _showCompass;
+    private bool _showBookmarks;
+
+    private BookmarksWidget? _bookmarkWidget;
 }

samples/dymaptic.GeoBlazor.Core.Sample.Shared/Shared/NavMenu.razor

@@ -77,6 +77,7 @@
         new("basemaps", "Basemaps", "oi-map"),
         new("feature-layers", "Feature Layers", "oi-layers"),
         new("popups", "Popups", "oi-chat"),
+        new("bookmarks", "Bookmarks", "oi-bookmark"),
         new("popup-actions", "Popup Actions", "oi-bullhorn"),
         new("vector-layer", "Vector Layer", "oi-arrow-right"),
         new("layer-lists", "Layer Lists", "oi-list"),

src/dymaptic.GeoBlazor.Core/Components/Views/Viewpoint.cs

@@ -0,0 +1,62 @@
+using dymaptic.GeoBlazor.Core.Components.Geometries;
+using dymaptic.GeoBlazor.Core.Components.Widgets;
+using Microsoft.AspNetCore.Components;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Text.Json.Serialization;
+using System.Threading.Tasks;
+
+namespace dymaptic.GeoBlazor.Core.Components.Views;
+
+public class Viewpoint : MapComponent
+{
+    ///public Camera Camera { get; set; }
+
+    /// <summary>
+    /// The rotation of due north in relation to the top of the view in degrees.
+    /// </summary>
+    [Parameter]
+    public int? Rotation { get; set; } = 0;
+
+    /// <summary>
+    ///  The scale of the viewpoint.
+    /// </summary>
+    [Parameter]
+    public int Scale { get; set; } = 0;
+
+    /// <summary>
+    /// The target geometry framed by the viewpoint.
+    /// </summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public Geometry? TargetGeometry { get; set; }
+
+    public override async Task RegisterChildComponent(MapComponent child)
+    {
+        switch (child)
+        {
+            case Geometry geometry:
+                TargetGeometry = geometry;
+                break;
+            default:
+                await base.RegisterChildComponent(child);
+                break;
+        }
+    }
+
+    public override async Task UnregisterChildComponent(MapComponent child)
+    {
+        switch (child)
+        {
+            case Geometry geometry:
+                TargetGeometry = null;
+                break;
+            default:
+                await base.UnregisterChildComponent(child);
+                break;
+        }
+
+    }
+
+}

src/dymaptic.GeoBlazor.Core/Components/Widgets/Bookmark.cs

@@ -0,0 +1,71 @@
+using dymaptic.GeoBlazor.Core.Components.Views;
+using dymaptic.GeoBlazor.Core.Objects;
+using Microsoft.AspNetCore.Components;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Text.Json.Serialization;
+using System.Threading.Tasks;
+
+namespace dymaptic.GeoBlazor.Core.Components.Widgets;
+
+public class Bookmark : MapComponent
+{
+    /// <summary>
+    ///    ///     The extent of the specified bookmark.
+    ///    /// </summary>
+    [Parameter]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public TimeExtent? TimeExtent { get; set; }
+    ///
+    ///    /// <summary>
+    ///    ///     The name of the bookmark.
+    ///    /// </summary>
+    [Parameter]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public string? Name { get; set; }
+
+    /// <summary>
+    /// The URL for a thumbnail image.
+    /// </summary>
+    [Parameter]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public string? Thumbnail { get; set; }
+
+    /// <summary>
+    /// The URL for a thumbnail image.
+    /// </summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public Viewpoint? Viewpoint { get; set; }
+
+
+    public override async Task RegisterChildComponent(MapComponent child)
+    {
+        switch (child)
+        {
+            case Viewpoint viewpoint:
+                Viewpoint = viewpoint;
+                break;
+            default:
+                await base.RegisterChildComponent(child);
+                break;
+        }
+    }
+
+    public override async Task UnregisterChildComponent(MapComponent child)
+    {
+        switch (child)
+        {
+            case Viewpoint viewpoint:
+                Viewpoint = null;
+                break;
+            default:
+                await base.UnregisterChildComponent(child);
+                break;
+        }
+    }
+}
+
+
+

src/dymaptic.GeoBlazor.Core/Components/Widgets/BookmarksWidget.cs

@@ -0,0 +1,79 @@
+using Microsoft.AspNetCore.Components;
+using System.Text.Json.Serialization;
+
+
+namespace dymaptic.GeoBlazor.Core.Components.Widgets;
+
+/// <summary>
+///     The Bookmarks widget allows end users to quickly navigate to a particular area of interest. It displays a list of bookmarks, which are typically defined inside the WebMap.
+///     <a target="_blank" href="https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html">
+///         ArcGIS
+///         JS API
+///     </a>
+/// </summary>
+public class BookmarksWidget : Widget
+{
+    /// <inheritdoc />
+    [JsonPropertyName("type")]
+    public override string WidgetType => "bookmarks";
+
+    /// <summary>
+    ///     When true, the widget is visually withdrawn and cannot be interacted with.
+    /// </summary>
+    [Parameter]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public bool? Disabled { get; set; }
+
+
+    /// <summary>
+    ///    Indicates whether the bookmarks are able to be edited.
+    /// </summary>
+    [Parameter]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public bool? EditingEnabled { get; set; }
+
+    /// <summary>
+    /// Indicates the heading level to use for the message "No bookmarks" when no bookmarks are available in this widget.
+    /// </summary>
+    [Parameter]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public int? HeadingLevel { get; set; }
+
+    /// <summary>
+    /// A collection of Bookmarks.
+    /// </summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public List<Bookmark> Bookmarks { get; set; } = new();
+
+
+    /// <inheritdoc />
+    public override async Task RegisterChildComponent(MapComponent child)
+    {
+        switch (child)
+        {
+            case Bookmark bookmark:
+                if (!Bookmarks.Contains(bookmark)) Bookmarks.Add(bookmark);
+                WidgetChanged = true;
+                break;
+            default:
+                await base.RegisterChildComponent(child);
+                break;
+        }
+    }
+
+
+    /// <inheritdoc />
+    public override async Task UnregisterChildComponent(MapComponent child)
+    {
+        switch (child)
+        {
+            case Bookmark bookmark:
+                if (Bookmarks.Contains(bookmark)) Bookmarks.Remove(bookmark);
+                WidgetChanged = true;
+                break;
+            default:
+                await base.UnregisterChildComponent(child);
+                break;
+        }
+    }
+}