release v2.0.3 (#39)

* Fix version output variable in GitHub Actions workflow for package release

(cherry picked from commit f6b58d0)

* Add OnNullText and OnNullContent parameters to LocalTimeText component

(cherry picked from commit f01e5a9)

* Add OnNullText and OnNullContent parameters to LocalTimeText component usage examples

(cherry picked from commit 61bca99)

Author: arika0093

.github/workflows/release.yaml

@@ -16,7 +16,7 @@ jobs:
   package-build:
     runs-on: ubuntu-latest
     outputs:
-      VERSION: ${{ steps.version.outputs.VERSION }}
+      version: ${{ steps.version.outputs.semver }}
     steps:
       - name: Checkout repository
         uses: actions/checkout@v5
@@ -35,7 +35,7 @@ jobs:
 
       - name: export version to env
         id: version
-        run: echo "VERSION=${{ steps.nbgv.outputs.SemVer2 }}" >> $GITHUB_ENV
+        run: echo "semver=${{ steps.nbgv.outputs.SemVer2 }}" >> "$GITHUB_OUTPUT"
 
       - name: Restore dependencies
         run: dotnet restore --locked-mode
@@ -67,13 +67,13 @@ jobs:
         id: create_release
         uses: softprops/action-gh-release@v2
         with:
-          name: ${{ needs.package-build.outputs.VERSION }}
-          tag_name: ${{ needs.package-build.outputs.VERSION }}
+          name: ${{ needs.package-build.outputs.version }}
+          tag_name: ${{ needs.package-build.outputs.version }}
           target_commitish: ${{ github.ref }}
           generate_release_notes: true
           files: ./artifacts/*.nupkg
           # if hyphen contains in the tag name, it will be prerelease
-          prerelease: ${{ contains(needs.package-build.outputs.VERSION, '-') }}
+          prerelease: ${{ contains(needs.package-build.outputs.version, '-') }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 

docs/API.md

@@ -36,6 +36,8 @@ Displays formatted local time text.
 | `Value` | `DateTimeOffset?` | - | UTC datetime to display |
 | `Format` | `string` | `"yyyy-MM-dd HH:mm:ss"` | Display format string |
 | `DisableTimeElement` | `bool` | `false` | Whether to wrap in `<time>` element |
+| `OnNullText` | `string?` | `null` | Text to display if `Value` is null |
+| `OnNullContent` | `RenderFragment?` | `null` | Content to display if `Value` is null |
 
 ### `LocalTime`
 Provides local time via render fragment with loading and error state support.

example/BlazorLocalTimeSample/Pages/Home.razor

@@ -69,6 +69,16 @@
     <LocalTimeText Value="@DateTime.UtcNow" Format="yyyy-MM-dd HH:mm:ssK" />
 </div>
 
+<p>
+    If you want to specify what to display when the value is null, you can use the <code>OnNullText</code> or <code>OnNullContent</code> parameters.
+</p>
+
+<pre><code class="language-razor">&lt;LocalTimeText Value="@@null" DisableTimeElement OnNullText="No date available" /&gt;</code></pre>
+
+<div class="component-sample">
+    <LocalTimeText Value="@null" DisableTimeElement OnNullText="No date available" />
+</div>
+
 <p>
     Alternatively, you can use the <code>LocalTime</code> component to receive the converted value in the child content:
 </p>

src/BlazorLocalTime/Components/LocalTimeText.razor

@@ -11,3 +11,14 @@
         @FormattedValue
     }
 }
+@if (Value == null)
+{
+    if(OnNullContent != null)
+    {
+        @OnNullContent
+    }
+    else if(OnNullText != null)
+    {
+        @OnNullText
+    }
+}

src/BlazorLocalTime/Components/LocalTimeText.razor.cs

@@ -25,6 +25,18 @@ public sealed partial class LocalTimeText : ComponentBase, IDisposable
     [Parameter]
     public string Format { get; set; } = "yyyy-MM-dd HH:mm:ss";
 
+    /// <summary>
+    /// Gets or sets the text to display when the value is null.
+    /// </summary>
+    [Parameter]
+    public string? OnNullText { get; set; } = null;
+
+    /// <summary>
+    /// Gets or sets the components to display when the value is null.
+    /// </summary>
+    [Parameter]
+    public RenderFragment? OnNullContent { get; set; } = null;
+
     /// <summary>
     /// Gets or sets whether to disable wrapping the output in an HTML &lt;time&gt; element.
     /// When false (default), generates a semantic &lt;time&gt; tag with ISO-8601 datetime attribute for accessibility.

tests/BlazorLocalTimeTest/Approvals/PublicApiCheckTest.Run.approved.txt

@@ -83,6 +83,10 @@
         [Microsoft.AspNetCore.Components.Parameter]
         public string Format { get; set; }
         [Microsoft.AspNetCore.Components.Parameter]
+        public Microsoft.AspNetCore.Components.RenderFragment? OnNullContent { get; set; }
+        [Microsoft.AspNetCore.Components.Parameter]
+        public string? OnNullText { get; set; }
+        [Microsoft.AspNetCore.Components.Parameter]
         public System.DateTimeOffset? Value { get; set; }
         protected override void BuildRenderTree(Microsoft.AspNetCore.Components.Rendering.RenderTreeBuilder @__builder) { }
         public void Dispose() { }

tests/BlazorLocalTimeTest/LocalTimeTextTest.razor

@@ -70,5 +70,47 @@
         // Should render without time element (default behavior)
         cut.MarkupMatches("2023-10-01 21:30:00");
     }
-    
+
+    [Fact]
+    public void TestWithNullNoOptions()
+    {
+        Services.AddLocalTimeMockService();
+
+        DateTimeOffset? dt = null;
+
+        var cut = Render(@<LocalTimeText Value="dt" DisableTimeElement />
+        );
+
+        // Should render nothing
+        cut.MarkupMatches(string.Empty);
+    }
+
+    [Fact]
+    public void TestWithNullWithOptions()
+    {
+        Services.AddLocalTimeMockService();
+
+        DateTimeOffset? dt = null;
+
+        var cut = Render(@<LocalTimeText Value="dt" DisableTimeElement OnNullText="Nothing" />
+        );
+
+        // Should render "Nothing"
+        cut.MarkupMatches("Nothing");
+    }
+
+    [Fact]
+    public void TestWithNullWithOptions2()
+    {
+        Services.AddLocalTimeMockService();
+
+        DateTimeOffset? dt = null;
+
+        var cut = Render(@<LocalTimeText Value="dt" DisableTimeElement><OnNullContent><p>Nothing Value</p></OnNullContent></LocalTimeText>
+        );
+
+        // Should render "Nothing Value"
+        cut.MarkupMatches("<p>Nothing Value</p>");
+    }
+
 }