Add TargetName parameter to New-HTMLCalendar

The `New-HTMLCalendar` command now supports a new parameter called `TargetName`. This parameter allows specifying the name of the target frame or window in which to open the URL of an event. The default value for this parameter is `_self`.

Author: PrzemyslawKlys

CHANGELOG.MD

@@ -4,6 +4,9 @@
 Unfortunetly some code is very old, some code doesn't serve it's purpose anymore, and requires heavy changes that may have an impact on already deployed code.
 Please make sure to read changes before updating, as we're undergoing some breaking changes.
 
+## 1.7.0
+- Add `TargetName` to `New-HTMLCalendar`
+
 ## 1.6.0
 - Add `New-HTMLMarkdown` command
 

Public/New-CalendarEvent.ps1

@@ -36,6 +36,9 @@
     .PARAMETER Url
     A URL that will be visited when this event is clicked by the user.
 
+    .PARAMETER TargetName
+    Specifies the name of the target frame or window. Default is _self
+
     .PARAMETER AllDayEvent
     Determines if the event is shown in the “all-day” section of the view, if applicable. Determines if time text is displayed in the event. If this value is not specified, it will be inferred by the start and end properties
 
@@ -62,7 +65,8 @@
         [string] $BorderColor,
         [string] $TextColor,
         [alias('Uri')][string] $Url,
-        [switch] $AllDayEvent
+        [switch] $AllDayEvent,
+        [string] $TargetName
     )
     $Object = [PSCustomObject] @{
         Type     = 'CalendarEvent'
@@ -75,6 +79,7 @@
             borderColor     = ConvertFrom-Color -Color $BorderColor
             textColor       = ConvertFrom-Color -Color $TextColor
             url             = $Url
+            targetName      = $targetName
         }
     }
     if ($AllDayEvent) {

Public/New-HTMLCalendar.ps1

@@ -81,9 +81,8 @@
             listYear  = @{ buttonText = 'list year' }
         }
     }
-    if ($UrlTargetName) {
-        $Calendar['eventClick'] = 'eventClickReplaceMe'
-    }
+    $Calendar['eventClick'] = 'eventClickReplaceMe'
+
     Remove-EmptyValue -Hashtable $Calendar -Recursive
     $CalendarJSON = $Calendar | ConvertTo-Json -Depth 7
 
@@ -99,15 +98,30 @@
     }
 "@
 
-    $eventClick = @"
+    if ($UrlTarget) {
+        # this allows to open links in new tab, frames etc but on global basis
+        $eventClick = @"
     eventClick: function (info) {
         var eventObj = info.event;
         if (eventObj.url) {
-            window.open(eventObj.url, '$UrlTargetName');
+            window.open(eventObj.url, '$UrlTarget');
             info.jsEvent.preventDefault(); // prevents browser from following link in current tab.
         }
     }
 "@
+    } else {
+        # this allows to open links in new tab, frames etc but on link per link basis via New-CalendarEvent -TargetName '_blank'
+        $eventClick = @"
+    eventClick: function (info) {
+        var eventObj = info.event;
+        if (eventObj.extendedProps.targetName) {
+            window.open(eventObj.url, eventObj.extendedProps.targetName);
+            info.jsEvent.preventDefault(); // prevents browser from following link in current tab.
+        }
+    }
+"@
+    }
+
     if ($PSEdition -eq 'Desktop') {
         $TextToFind = '"eventDidMount":  "eventDidMountReplaceMe"'
     } else {