internal static void TextAreaHelper(
HtmlHelper htmlHelper, XcstWriter output, ModelMetadata metadata, string name, IDictionary <string, object> rowsAndColumns,
HtmlAttribs?htmlAttributes, string?innerHtmlPrefix = null)
{
string fullName = htmlHelper.ViewData.TemplateInfo.GetFullHtmlFieldName(name);
if (String.IsNullOrEmpty(fullName))
{
throw new ArgumentNullException(nameof(name));
}
output.WriteStartElement("textarea");
HtmlAttributeHelper.WriteId(fullName, output);
output.WriteAttributeString("name", fullName);
HtmlAttributeHelper.WriteAttributes(rowsAndColumns, output);
bool explicitRowsAndCols = rowsAndColumns != implicitRowsAndColumns;
// If there are any errors for a named field, we add the css attribute.
string?cssClass = (htmlHelper.ViewData.ModelState.TryGetValue(fullName, out ModelState modelState) &&
modelState.Errors.Count > 0) ? HtmlHelper.ValidationInputCssClassName : null;
HtmlAttributeHelper.WriteClass(cssClass, htmlAttributes, output);
HtmlAttributeHelper.WriteAttributes(htmlHelper.GetUnobtrusiveValidationAttributes(name, metadata), output);
// name cannnot be overridden, and class was already written
// explicit rows and cols cannot be overridden
HtmlAttributeHelper.WriteAttributes(
htmlAttributes,
output,
excludeFn: n => n == "name" || n == "class" || (explicitRowsAndCols && (n == "rows" || n == "cols")));
string?value;
if (modelState?.Value != null)
{
value = modelState.Value.AttemptedValue;
}
else if (metadata.Model != null)
{
value = Convert.ToString(metadata.Model, CultureInfo.CurrentCulture);
}
else
{
value = String.Empty;
}
// The first newline is always trimmed when a TextArea is rendered, so we add an extra one
// in case the value being rendered is something like "\r\nHello".
output.WriteString((innerHtmlPrefix ?? Environment.NewLine) + value);
output.WriteEndElement();
}
internal static void LabelHelper(
HtmlHelper html, XcstWriter output, ModelMetadata metadata, string expression, string?labelText = null, HtmlAttribs?htmlAttributes = null)
{
string htmlFieldName = expression;
string resolvedLabelText = labelText
?? metadata.DisplayName
?? metadata.PropertyName
?? htmlFieldName.Split('.').Last();
if (String.IsNullOrEmpty(resolvedLabelText))
{
return;
}
string fullFieldName = html.ViewData.TemplateInfo.GetFullHtmlFieldName(htmlFieldName);
output.WriteStartElement("label");
output.WriteAttributeString("for", TagBuilder.CreateSanitizedId(fullFieldName));
HtmlAttributeHelper.WriteAttributes(htmlAttributes, output);
output.WriteString(resolvedLabelText);
output.WriteEndElement();
}
static void SelectInternal(
HtmlHelper htmlHelper, XcstWriter output, ModelMetadata?metadata, string?optionLabel, string name, IEnumerable <SelectListItem>?selectList,
bool allowMultiple, HtmlAttribs?htmlAttributes)
{
ViewDataDictionary viewData = htmlHelper.ViewData;
string fullName = viewData.TemplateInfo.GetFullHtmlFieldName(name);
if (String.IsNullOrEmpty(fullName))
{
throw new ArgumentNullException(nameof(name));
}
bool usedViewData = false;
// If we got a null selectList, try to use ViewData to get the list of items.
if (selectList is null)
{
selectList = GetSelectData(htmlHelper, name);
usedViewData = true;
}
object?defaultValue = (allowMultiple) ?
htmlHelper.GetModelStateValue(fullName, typeof(string[]))
: htmlHelper.GetModelStateValue(fullName, typeof(string));
// If we haven't already used ViewData to get the entire list of items then we need to
// use the ViewData-supplied value before using the parameter-supplied value.
if (defaultValue is null)
{
if (metadata is null)
{
if (!usedViewData &&
!String.IsNullOrEmpty(name))
{
defaultValue = viewData.Eval(name);
}
}
else
{
defaultValue = metadata.Model;
}
}
if (defaultValue != null)
{
selectList = GetSelectListWithDefaultValue(selectList, defaultValue, allowMultiple);
}
output.WriteStartElement("select");
HtmlAttributeHelper.WriteId(fullName, output);
output.WriteAttributeString("name", fullName);
HtmlAttributeHelper.WriteBoolean("multiple", allowMultiple, output);
// If there are any errors for a named field, we add the css attribute.
string?cssClass = (viewData.ModelState.TryGetValue(fullName, out ModelState modelState) &&
modelState.Errors.Count > 0) ? HtmlHelper.ValidationInputCssClassName : null;
var validationAttribs = htmlHelper.GetUnobtrusiveValidationAttributes(
name, metadata
#if !ASPNETMVC
, excludeMinMaxLength: !allowMultiple
#endif
);
HtmlAttributeHelper.WriteClass(cssClass, htmlAttributes, output);
HtmlAttributeHelper.WriteAttributes(validationAttribs, output);
// name cannnot be overridden, and class was already written
HtmlAttributeHelper.WriteAttributes(htmlAttributes, output, excludeFn: n => n == "name" || n == "class");
WriteOptions(optionLabel, selectList, output);
output.WriteEndElement(); // </select>
}
internal static void ValidationMessageHelper(
HtmlHelper htmlHelper, XcstWriter output, ModelMetadata modelMetadata, string expression, string?validationMessage,
HtmlAttribs?htmlAttributes, string?tag)
{
ViewDataDictionary viewData = htmlHelper.ViewData;
string modelName = viewData.TemplateInfo.GetFullHtmlFieldName(expression);
FormContext?formContext = htmlHelper.ViewContext.GetFormContextForClientValidation();
if (!viewData.ModelState.ContainsKey(modelName) &&
formContext is null)
{
return;
}
ModelState? modelState = viewData.ModelState[modelName];
ModelErrorCollection?modelErrors = modelState?.Errors;
ModelError?modelError = (modelErrors is null || modelErrors.Count == 0) ? null
: (modelErrors.FirstOrDefault(m => !String.IsNullOrEmpty(m.ErrorMessage)) ?? modelErrors[0]);
if (modelError is null &&
formContext is null)
{
return;
}
if (String.IsNullOrEmpty(tag))
{
tag = htmlHelper.ViewContext.ValidationMessageElement;
}
string validationClass = (modelError != null) ?
HtmlHelper.ValidationMessageCssClassName
: HtmlHelper.ValidationMessageValidCssClassName;
output.WriteStartElement(tag !);
HtmlAttributeHelper.WriteClass(validationClass, htmlAttributes, output);
if (formContext != null)
{
bool replaceValidationMessageContents = String.IsNullOrEmpty(validationMessage);
if (htmlHelper.ViewContext.UnobtrusiveJavaScriptEnabled)
{
output.WriteAttributeString("data-valmsg-for", modelName);
output.WriteAttributeString("data-valmsg-replace", replaceValidationMessageContents.ToString().ToLowerInvariant());
}
}
// class was already written
HtmlAttributeHelper.WriteAttributes(htmlAttributes, output, excludeFn: n => n == "class");
if (!String.IsNullOrEmpty(validationMessage))
{
output.WriteString(validationMessage);
}
else if (modelError != null)
{
output.WriteString(GetUserErrorMessageOrDefault(modelError, modelState));
}
output.WriteEndElement();
}
public static void ValidationSummary(
HtmlHelper htmlHelper, XcstWriter output, bool includePropertyErrors = false, string?message = null, HtmlAttribs?htmlAttributes = null,
string?headingTag = null)
{
if (htmlHelper is null)
{
throw new ArgumentNullException(nameof(htmlHelper));
}
FormContext?formContext = htmlHelper.ViewContext.GetFormContextForClientValidation();
if (htmlHelper.ViewData.ModelState.IsValid)
{
if (formContext is null)
{
// No client side validation
return;
}
// TODO: This isn't really about unobtrusive; can we fix up non-unobtrusive to get rid of this, too?
if (htmlHelper.ViewContext.UnobtrusiveJavaScriptEnabled &&
!includePropertyErrors)
{
// No client-side updates
return;
}
}
string validationClass = (htmlHelper.ViewData.ModelState.IsValid) ?
HtmlHelper.ValidationSummaryValidCssClassName
: HtmlHelper.ValidationSummaryCssClassName;
output.WriteStartElement("div");
HtmlAttributeHelper.WriteClass(validationClass, htmlAttributes, output);
if (formContext != null)
{
if (htmlHelper.ViewContext.UnobtrusiveJavaScriptEnabled)
{
if (includePropertyErrors)
{
// Only put errors in the validation summary if they're supposed to be included there
output.WriteAttributeString("data-valmsg-summary", "true");
}
}
}
// class was already written
HtmlAttributeHelper.WriteAttributes(htmlAttributes, output, excludeFn: n => n == "class");
if (!String.IsNullOrEmpty(message))
{
if (String.IsNullOrEmpty(headingTag))
{
headingTag = htmlHelper.ViewContext.ValidationSummaryMessageElement;
}
output.WriteStartElement(headingTag !);
output.WriteString(message);
output.WriteEndElement();
}
output.WriteStartElement("ul");
bool empty = true;
IEnumerable <ModelState> modelStates = GetModelStateList(htmlHelper, includePropertyErrors);
foreach (ModelState modelState in modelStates)
{
foreach (ModelError modelError in modelState.Errors)
{
string?errorText = GetUserErrorMessageOrDefault(modelError, modelState: null);
if (!String.IsNullOrEmpty(errorText))
{
empty = false;
output.WriteStartElement("li");
output.WriteString(errorText);
output.WriteEndElement();
}
}
}
if (empty)
{
output.WriteStartElement("li");
output.WriteAttributeString("style", "display:none");
output.WriteEndElement();
}
output.WriteEndElement(); // </ul>
output.WriteEndElement(); // </div>
}