ant-design-blazor/components/core/Base/AntInputComponentBase.cs

using Microsoft.AspNetCore.Components;
using Microsoft.AspNetCore.Components.Forms;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Linq.Expressions;
using System.Threading.Tasks;

namespace AntDesign
{
    /// <summary>
    /// Base class for any input control that optionally supports an <see cref="EditContext"/>.
    /// </summary>
    /// <typeparam name="T">the natural type of the input's value</typeparam>
    public abstract class AntInputComponentBase<T> : AntDomComponentBase
    {
        private T _value;

        [Parameter]
        public T Value
        {
            get => _value;
            set
            {
                if (!EqualityComparer<T>.Default.Equals(value, _value))
                {
                    _value = value;
                    ValueChanged.InvokeAsync(value);
                    NotifyFieldChanged();
                }
            }
        }

        /// <summary>
        /// When contained within an <see cref="EditContext"/> disables this control's
        /// participation in validation checking.  This means that this control will not
        /// reflect the validation state of the underlying data binding.
        /// </summary>
        [Parameter]
        public bool ValidationDisabled { get; set; }

        [Parameter]
        public EventCallback<T> ValueChanged { get; set; }

        // This is like InputBase from Microsoft.AspNetCore.Components.Forms,
        // except that it treats [CascadingParameter] EditContext as optional.

        private bool _hasSetInitialEditContext;

        [CascadingParameter]
        EditContext CascadedEditContext { get; set; }

        /// <summary>
        /// Gets the associated <see cref="Microsoft.AspNetCore.Components.Forms.EditContext"/>.
        /// </summary>
        protected EditContext EditContext { get; private set; }

        /// <summary>
        /// Gets the <see cref="FieldIdentifier"/> for the bound value.
        /// </summary>
        protected FieldIdentifier FieldIdentifier { get; private set; }

        /// <summary>
        /// Gets a string that indicates the status of the field being edited. This will include
        /// some combination of "modified", "valid", or "invalid", depending on the status of the field.
        /// </summary>
        protected string FieldClass => EditContext?.FieldCssClass(FieldIdentifier) ?? string.Empty;

        /// <summary>
        /// Should be invoked by whenever a bound value is changed, such
        /// as right after the value's corresponding <i>ValueChanged</i>
        /// EventCallback is invoked.
        /// </summary>
        protected void NotifyFieldChanged()
        {
            EditContext?.NotifyFieldChanged(FieldIdentifier);
        }

        /// <summary>
        /// Gets or sets an expression that identifies the bound value.
        /// </summary>
        [Parameter]
        public Expression<Func<T>> ValueExpression { get; set; }

        /// <inheritdoc />
        public override Task SetParametersAsync(ParameterView parameters)
        {
            parameters.SetParameterProperties(this);

            if (!ValidationDisabled)
            {
                if (!_hasSetInitialEditContext)
                {
                    // This is the first run -- could put this logic in OnInit, but nice
                    // to avoid forcing people who override OnInitialized to call base.OnInitialized()

                    EditContext = CascadedEditContext;
                    if (EditContext != null)
                    {
                        if (ValueExpression == null)
                        {
                            throw new InvalidOperationException($"{GetType()} requires a value for the 'ValueExpression' " +
                                                                $"parameter. Normally this is provided automatically when using 'bind-Value'.");
                        }

                        FieldIdentifier = FieldIdentifier.Create(ValueExpression);
                    }

                    _hasSetInitialEditContext = true;
                }
                else if (CascadedEditContext != EditContext)
                {
                    // Not the first run

                    // We don't support changing EditContext because it's messy to be clearing up state and event
                    // handlers for the previous one, and there's no strong use case. If a strong use case
                    // emerges, we can consider changing this.
                    throw new InvalidOperationException($"{GetType()} does not support changing the " +
                                                        $"{nameof(EditContext)} dynamically.");
                }
            }

            // For derived components, retain the usual lifecycle with OnInitialized/OnParametersSet/etc.
            return base.SetParametersAsync(ParameterView.Empty);
        }
    }
}