Add Literal componet (#145)

* Add Literal Component, docs, unit tests

Co-authored-by: Jeffrey T. Fritz <[email protected]>

Author: hishamco

README.md

@@ -26,6 +26,7 @@ There are a significant number of controls in ASP.NET Web Forms, and we will foc
 		- [ImageButton](docs/ImageButton.md)
 		- [Label](docs/Label.md)
     - [LinkButton](docs/LinkButton.md)
+		- [Literal](docs/Literal.md)
   - Data Controls
     - Chart(?)
     - [DataList](docs/DataList.md)

docs/Literal.md

@@ -0,0 +1,29 @@
+# LinkButton
+
+The Literal component is meant to emulate the asp:Literal control in markup and is defined in the https://docs.microsoft.com/en-us/dotnet/api/system.web.ui.webcontrols.literal?view=netframework-4.8
+
+## Blazor Features Supported
+
+- `Mode` specifies how the content in the Literal component is rendered
+- `Text` the text content of the Literal component
+
+## WebForms Syntax
+
+```html
+<asp:Literal
+    EnableTheming="True|False"
+    EnableViewState="True|False"
+    ID="string"
+    Mode="Transform|PassThrough|Encode"
+    OnDataBinding="DataBinding event handler"
+    OnDisposed="Disposed event handler"
+    OnInit="Init event handler"
+    OnLoad="Load event handler"
+    OnPreRender="PreRender event handler"
+    OnUnload="Unload event handler"
+    runat="server"
+    SkinID="string"
+    Text="string"
+    Visible="True|False"
+/>
+```

src/BlazorWebFormsComponents.Test/Literal/BasicFormat.razor

@@ -0,0 +1,10 @@
+@inherits TestComponentBase
+
+<SnapshotTest Description="Verify HTML format of Literal">
+	<TestInput>
+		<Literal Text="This is normal text" />
+	</TestInput>
+	<ExpectedOutput>
+		This is normal text
+	</ExpectedOutput>
+</SnapshotTest>

src/BlazorWebFormsComponents.Test/Literal/HtmlEncoded.razor

@@ -0,0 +1,14 @@
+@inherits TestComponentBase
+
+@{
+		var renderedText = "<b>This is encoded text</b>";
+}
+
+<SnapshotTest Description="Verify HTML format of Literal is encoded">
+	<TestInput>
+		<Literal Text="<b>This is encoded text</b>" />
+	</TestInput>
+	<ExpectedOutput>
+		@((MarkupString)renderedText)
+	</ExpectedOutput>
+</SnapshotTest>

src/BlazorWebFormsComponents.Test/Literal/HtmlNotEncoded.razor

@@ -0,0 +1,10 @@
+@inherits TestComponentBase
+
+<SnapshotTest Description="Verify HTML format of Literal is not encoded">
+	<TestInput>
+		<Literal Text="<b>This is bold text</b>" />
+	</TestInput>
+	<ExpectedOutput>
+		<b>This is bold text</b>
+	</ExpectedOutput>
+</SnapshotTest>

src/BlazorWebFormsComponents/Enums/LiteralMode.cs

@@ -0,0 +1,9 @@
+namespace BlazorWebFormsComponents.Enums
+{
+	public enum LiteralMode
+	{
+		Transform = 0,
+		PassThrough = 1,
+		Encode = 2
+	}
+}

src/BlazorWebFormsComponents/Literal.razor

@@ -0,0 +1,15 @@
+@using System.Net
+@using BlazorWebFormsComponents.Enums
+
+@inherits BaseWebFormsComponent
+
+@functions {
+	public string RenderedText => Mode == LiteralMode.Encode
+		? WebUtility.HtmlEncode(Text)
+		: Text;
+}
+
+@if (Visible)
+{
+	@((MarkupString)RenderedText)
+}

src/BlazorWebFormsComponents/Literal.razor.cs

@@ -0,0 +1,15 @@
+using BlazorWebFormsComponents.Enums;
+using BlazorWebFormsComponents.Interfaces;
+using Microsoft.AspNetCore.Components;
+
+namespace BlazorWebFormsComponents
+{
+  public partial class Literal : BaseWebFormsComponent, ITextComponent
+	{
+		[Parameter]
+		public LiteralMode Mode { get; set; }
+
+		[Parameter]
+		public string Text { get; set; }
+	}
+}