Added event trigger extension method for @ontoggle

Author: egil

CHANGELOG.md

@@ -11,6 +11,8 @@ The following section list all changes in 1.0.0 preview 01.
 ### Added
 List of new features.
 
+- Added support for triggering `@ontoggle` event handlers through a dedicated `Toggle()` method. By [@egil](https://github.com/egil) in [#248](https://github.com/egil/bUnit/pull/248).
+
 ### Changed
 List of changes in existing functionality.
 

src/bunit.web/EventDispatchExtensions/DetailsElementEventDispatcherExtensions.cs

@@ -0,0 +1,31 @@
+#if NET5_0
+using System;
+using System.Threading.Tasks;
+using AngleSharp.Dom;
+
+namespace Bunit
+{
+	/// <summary>
+	/// General event dispatch helper extension methods.
+	/// </summary>
+	public static class DetailsElementEventDispatcherExtensions
+	{
+		/// <summary>
+		/// Raises the <c>@ontoggle</c> event on <paramref name="element"/>
+		/// to the event handler.
+		/// </summary>
+		/// <param name="element">The element to raise the event on.</param>
+		public static void Toggle(this IElement element)
+			=> _ = ToggleAsync(element, EventArgs.Empty);
+
+		/// <summary>
+		/// Raises the <c>@ontoggle</c> event on <paramref name="element"/>, passing the provided <paramref name="eventArgs"/>
+		/// to the event handler.
+		/// </summary>
+		/// <param name="element">The element to raise the event on.</param>
+		/// <param name="eventArgs">The event arguments to pass to the event handler.</param>
+		/// <returns>A task that completes when the event handler is done.</returns>
+		private static Task ToggleAsync(this IElement element, EventArgs eventArgs) => element.TriggerEventAsync("ontoggle", eventArgs);
+	}
+}
+#endif

tests/bunit.testassets/SampleComponents/ToggleableDetails.razor

@@ -0,0 +1,19 @@
+<div>
+	@if (detailsExpanded)
+	{
+		<p>Read the details carefully!</p>
+	}
+	<details id="details-toggle" @ontoggle="OnToggle">
+		<summary>Summary</summary>
+		<p>Detailed content</p>
+	</details>
+</div>
+
+@code {
+	bool detailsExpanded;
+
+	void OnToggle()
+	{
+		detailsExpanded = !detailsExpanded;
+	}
+}

tests/bunit.web.tests/EventDispatchExtensions/DetailsElementEventDispatcherExtensionsTest.cs

@@ -0,0 +1,28 @@
+#if NET5_0
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using Bunit;
+using Bunit.TestAssets.SampleComponents;
+using Shouldly;
+using Xunit;
+
+namespace Bunit.EventDispatchExtensions
+{
+    public class DetailsElementEventDispatcherExtensionsTest : TestContext
+    {
+		[Fact(DisplayName = "Toggle raises ontoggle events")]
+		public void Test200()
+		{
+			var cut = RenderComponent<ToggleableDetails>();
+			cut.FindAll("div > p").Count.ShouldBe(0);
+
+			cut.Find("details").Toggle();
+
+			cut.FindAll("div > p").Count.ShouldBe(1);
+		}
+	}
+}
+#endif