Add placeholders and standardize validation messages

Updated `CreateContact.razor`, `EditContact.razor`, and `ContactFormDialog.razor` to include `Placeholder` attributes for `MudTextField` components, improving user guidance.

Standardized validation error messages across components and resource files by replacing exclamation marks with periods for consistency.

Added localized placeholder text translations to `.resx` files for English, German, and Chinese. Updated resource files for `Contacts`, `Documents`, `Profile`, `Users`, `PicklistSets`, and `Tenants` modules to reflect these changes.

Introduced a `requirements.md` file documenting placeholder functionality, localization requirements, and naming conventions.

Enhanced usability, accessibility, and maintainability by unifying placeholder key naming conventions and ensuring consistent structure in form components.

Author: neozhu

src/Server.UI/Pages/Contacts/Components/ContactFormDialog.razor

@@ -9,19 +9,19 @@
         <MudForm Model="@_model" @ref="@_contactForm" Validation="@(Validator.ValidateValue(_model))">
             <MudGrid>
                 <MudItem xs="12" md="6"> 
-                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.Name)]" @bind-Value="_model.Name" For="@(() => _model.Name)" Required="true" RequiredError="@L["name is required!"]"></MudTextField>
+                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.Name)]" @bind-Value="_model.Name" For="@(() => _model.Name)" Required="true" RequiredError="@L["name is required."]" Placeholder="@L["Enter contact name"]"></MudTextField>
                 </MudItem> 
 <MudItem xs="12" md="6"> 
-                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.Description)]"  For="@(() => _model.Description)" @bind-Value="_model.Description"></MudTextField>
+                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.Description)]"  For="@(() => _model.Description)" @bind-Value="_model.Description" Placeholder="@L["Enter description"]"></MudTextField>
                 </MudItem> 
 <MudItem xs="12" md="6"> 
-                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.Email)]" @bind-Value="_model.Email" For="@(() => _model.Email)" Required="false" RequiredError="@L["email is required!"]"></MudTextField>
+                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.Email)]" @bind-Value="_model.Email" For="@(() => _model.Email)" Required="false" RequiredError="@L["email is required."]" Placeholder="@L["Enter email address"]"></MudTextField>
                 </MudItem> 
 <MudItem xs="12" md="6"> 
-                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.PhoneNumber)]" @bind-Value="_model.PhoneNumber" For="@(() => _model.PhoneNumber)" Required="false" RequiredError="@L["phone number is required!"]"></MudTextField>
+                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.PhoneNumber)]" @bind-Value="_model.PhoneNumber" For="@(() => _model.PhoneNumber)" Required="false" RequiredError="@L["phone number is required."]" Placeholder="@L["Enter phone number"]"></MudTextField>
                 </MudItem> 
 <MudItem xs="12" md="6"> 
-                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.Country)]" @bind-Value="_model.Country" For="@(() => _model.Country)" Required="false" RequiredError="@L["country is required!"]"></MudTextField>
+                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.Country)]" @bind-Value="_model.Country" For="@(() => _model.Country)" Required="false" RequiredError="@L["country is required."]" Placeholder="@L["Enter country"]"></MudTextField>
                 </MudItem> 
 
             </MudGrid>

src/Server.UI/Pages/Contacts/CreateContact.razor

@@ -20,26 +20,30 @@
             <MudGrid Spacing="2">
                 <MudItem xs="12" md="6">
                     <MudTextField Label="@L[_model.GetMemberDescription(x => x.Name)]" @bind-Value="_model.Name"
-                        For="@(() => _model.Name)" Required="true" RequiredError="@L["name is required!"]">
+                        For="@(() => _model.Name)" Required="true" RequiredError="@L["name is required."]"
+                        Placeholder="@L["Enter contact name"]">
                     </MudTextField>
                 </MudItem>
                 <MudItem xs="12" md="6">
                     <MudTextField Label="@L[_model.GetMemberDescription(x => x.Description)]"
-                        For="@(() => _model.Description)" @bind-Value="_model.Description"></MudTextField>
+                        For="@(() => _model.Description)" @bind-Value="_model.Description"
+                        Placeholder="@L["Enter description"]"></MudTextField>
                 </MudItem>
                 <MudItem xs="12" md="6">
                     <MudTextField Label="@L[_model.GetMemberDescription(x => x.Email)]" @bind-Value="_model.Email"
-                        For="@(() => _model.Email)" Required="false" RequiredError="@L["email is required!"]">
+                        For="@(() => _model.Email)" Required="false" RequiredError="@L["email is required."]"
+                        Placeholder="@L["Enter email address"]">
                     </MudTextField>
                 </MudItem>
                 <MudItem xs="12" md="6">
                     <MudTextField Label="@L[_model.GetMemberDescription(x => x.PhoneNumber)]"
                         @bind-Value="_model.PhoneNumber" For="@(() => _model.PhoneNumber)" Required="false"
-                        RequiredError="@L["phone number is required!"]"></MudTextField>
+                        RequiredError="@L["phone number is required."]" Placeholder="@L["Enter phone number"]"></MudTextField>
                 </MudItem>
                 <MudItem xs="12" md="6">
                     <MudTextField Label="@L[_model.GetMemberDescription(x => x.Country)]" @bind-Value="_model.Country"
-                        For="@(() => _model.Country)" Required="false" RequiredError="@L["country is required!"]">
+                        For="@(() => _model.Country)" Required="false" RequiredError="@L["country is required."]"
+                        Placeholder="@L["Enter country"]">
                     </MudTextField>
                 </MudItem>
 

src/Server.UI/Pages/Contacts/EditContact.razor

@@ -24,19 +24,19 @@
         <MudForm Model="@_model" @ref="@_contactForm" Validation="@(Validator.ValidateValue(_model))">
             <MudGrid Spacing="2">
                 <MudItem xs="12" md="6"> 
-                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.Name)]" @bind-Value="_model.Name" For="@(() => _model.Name)" Required="true" RequiredError="@L["name is required!"]"></MudTextField>
+                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.Name)]" @bind-Value="_model.Name" For="@(() => _model.Name)" Required="true" RequiredError="@L["name is required."]" Placeholder="@L["Enter contact name"]"></MudTextField>
                 </MudItem> 
 <MudItem xs="12" md="6"> 
-                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.Description)]"  For="@(() => _model.Description)" @bind-Value="_model.Description"></MudTextField>
+                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.Description)]"  For="@(() => _model.Description)" @bind-Value="_model.Description" Placeholder="@L["Enter description"]"></MudTextField>
                 </MudItem> 
 <MudItem xs="12" md="6"> 
-                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.Email)]" @bind-Value="_model.Email" For="@(() => _model.Email)" Required="false" RequiredError="@L["email is required!"]"></MudTextField>
+                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.Email)]" @bind-Value="_model.Email" For="@(() => _model.Email)" Required="false" RequiredError="@L["email is required."]" Placeholder="@L["Enter email address"]"></MudTextField>
                 </MudItem> 
 <MudItem xs="12" md="6"> 
-                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.PhoneNumber)]" @bind-Value="_model.PhoneNumber" For="@(() => _model.PhoneNumber)" Required="false" RequiredError="@L["phone number is required!"]"></MudTextField>
+                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.PhoneNumber)]" @bind-Value="_model.PhoneNumber" For="@(() => _model.PhoneNumber)" Required="false" RequiredError="@L["phone number is required."]" Placeholder="@L["Enter phone number"]"></MudTextField>
                 </MudItem> 
 <MudItem xs="12" md="6"> 
-                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.Country)]" @bind-Value="_model.Country" For="@(() => _model.Country)" Required="false" RequiredError="@L["country is required!"]"></MudTextField>
+                        <MudTextField Label="@L[_model.GetMemberDescription(x=>x.Country)]" @bind-Value="_model.Country" For="@(() => _model.Country)" Required="false" RequiredError="@L["country is required."]" Placeholder="@L["Enter country"]"></MudTextField>
                 </MudItem> 
 
             </MudGrid>

src/Server.UI/Pages/Documents/Components/DocumentFormDialog.razor

@@ -13,14 +13,14 @@
                     <MudTextField Label="@L["Title"]" @bind-Value="Model.Title"
                                   For="@(() => Model.Title)"
                                   Required="true"
-                                  RequiredError="@L["Title is required!"]">
+                                  RequiredError="@L["Title is required."]">
                     </MudTextField>
                 </MudItem>
                 <MudItem xs="12" sm="6">
                     <MudSelect Label="@L["Select Document Type"]"
                                For="@(() => Model.DocumentType)"
                                Required="true"
-                               RequiredError="@L["Document type is required!"]"
+                               RequiredError="@L["Document type is required."]"
                                @bind-Value="Model.DocumentType">
                         @foreach (var doctype in Enum.GetValues<DocumentType>())
                         {

src/Server.UI/Pages/Identity/Roles/Components/RoleFormDialog.razor

@@ -15,7 +15,7 @@
                                  Required="true"
                                  For="@(() => Model.Name)"
                                  Validation="@(new Func<string, IEnumerable<string>>(ValidateName))"
-                                 RequiredError="@L["Role name is required!"]"
+                                 RequiredError="@L["Role name is required."]"
                                  MaxLength="50"
                                  Immediate="true">
                     </MudTextField>

src/Server.UI/Pages/PicklistSets/Components/CreatePicklistDialog.razor

@@ -11,7 +11,7 @@
                                    For="@(() => _model.Name)"
                                    Placeholder="@L["Select picklist name"]"
                                    Required="true"
-                                   RequiredError="@L["Name is required!"]">
+                                   RequiredError="@L["Name is required."]">
                     </MudEnumSelect>
                 </MudItem>
                 <MudItem xs="12" md="6">
@@ -25,15 +25,15 @@
                                   For="@(() => _model.Value)"
                                   Placeholder="@L["Enter value"]"
                                   Required="true"
-                                  RequiredError="@L["Value is required!"]">
+                                  RequiredError="@L["Value is required."]">
                     </MudTextField>
                 </MudItem>
                 <MudItem xs="12" md="6">
                     <MudTextField Label="@L[_model.GetMemberDescription(x => x.Text)]" @bind-Value="_model.Text"
                                   For="@(() => _model.Text)"
                                   Placeholder="@L["Enter text"]"
                                   Required="true"
-                                  RequiredError="@L["Text is required!"]">
+                                  RequiredError="@L["Text is required."]">
                     </MudTextField>
                 </MudItem>
 

src/Server.UI/Pages/Products/Components/ProductFormDialog.razor

@@ -23,7 +23,7 @@
                                   For="@(() => _model.Name)"
                                   Placeholder="@L["Enter product name"]"
                                   Required="true"
-                                  RequiredError="@L["product name is required!"]">
+                                  RequiredError="@L["product name is required."]">
                     </MudTextField>
                 </MudItem>
                 <MudItem xs="12">

src/Server.UI/Pages/Tenants/TenantFormDialog.razor

@@ -13,15 +13,15 @@
                                   Required="true"
                                   Placeholder="@L["Auto-generated tenant id"]"
                                   HelperText="@L["This identifier cannot be changed"]"
-                                  RequiredError="@L["Tenant id is required!"]">
+                                  RequiredError="@L["Tenant id is required."]">
                     </MudTextField>
                 </MudItem>
                 <MudItem xs="12">
                     <MudTextField Label="@L[_model.GetMemberDescription(x => x.Name)]" @bind-Value="_model.Name"
                                   For="@(() => _model.Name)"
                                   Placeholder="@L["Enter tenant name"]"
                                   Required="true"
-                                  RequiredError="@L["Tenant name is required!"]">
+                                  RequiredError="@L["Tenant name is required."]">
                     </MudTextField>
                 </MudItem>
                 <MudItem xs="12">

src/Server.UI/Resources/Pages/Contacts/Contacts.de-DE.resx

@@ -36,17 +36,17 @@
   <data name="Create Contact" xml:space="preserve">
     <value>Kontakt erstellen</value>
   </data>
-  <data name="name is required!" xml:space="preserve">
-    <value>Name ist erforderlich!</value>
+  <data name="name is required." xml:space="preserve">
+    <value>Name ist erforderlich.</value>
   </data>
-  <data name="email is required!" xml:space="preserve">
-    <value>E-Mail ist erforderlich!</value>
+  <data name="email is required." xml:space="preserve">
+    <value>E-Mail ist erforderlich.</value>
   </data>
-  <data name="phone number is required!" xml:space="preserve">
-    <value>Telefonnummer ist erforderlich!</value>
+  <data name="phone number is required." xml:space="preserve">
+    <value>Telefonnummer ist erforderlich.</value>
   </data>
-  <data name="country is required!" xml:space="preserve">
-    <value>Land ist erforderlich!</value>
+  <data name="country is required." xml:space="preserve">
+    <value>Land ist erforderlich.</value>
   </data>
   <data name="Id" xml:space="preserve">
     <value>ID</value>
@@ -66,4 +66,19 @@
   <data name="Country" xml:space="preserve">
     <value>Land</value>
   </data>
+  <data name="Enter contact name" xml:space="preserve">
+    <value>Kontaktnamen eingeben</value>
+  </data>
+  <data name="Enter description" xml:space="preserve">
+    <value>Beschreibung eingeben</value>
+  </data>
+  <data name="Enter email address" xml:space="preserve">
+    <value>E-Mail-Adresse eingeben</value>
+  </data>
+  <data name="Enter phone number" xml:space="preserve">
+    <value>Telefonnummer eingeben</value>
+  </data>
+  <data name="Enter country" xml:space="preserve">
+    <value>Land eingeben</value>
+  </data>
 </root>

src/Server.UI/Resources/Pages/Contacts/Contacts.en.resx

@@ -36,17 +36,17 @@
   <data name="Create Contact" xml:space="preserve">
     <value>Create Contact</value>
   </data>
-  <data name="name is required!" xml:space="preserve">
-    <value>name is required!</value>
+  <data name="name is required." xml:space="preserve">
+    <value>name is required.</value>
   </data>
-  <data name="email is required!" xml:space="preserve">
-    <value>email is required!</value>
+  <data name="email is required." xml:space="preserve">
+    <value>email is required.</value>
   </data>
-  <data name="phone number is required!" xml:space="preserve">
-    <value>phone number is required!</value>
+  <data name="phone number is required." xml:space="preserve">
+    <value>phone number is required.</value>
   </data>
-  <data name="country is required!" xml:space="preserve">
-    <value>country is required!</value>
+  <data name="country is required." xml:space="preserve">
+    <value>country is required.</value>
   </data>
   <data name="Id" xml:space="preserve">
     <value>Id</value>
@@ -66,4 +66,19 @@
   <data name="Country" xml:space="preserve">
     <value>Country</value>
   </data>
+  <data name="Enter contact name" xml:space="preserve">
+    <value>Enter contact name</value>
+  </data>
+  <data name="Enter description" xml:space="preserve">
+    <value>Enter description</value>
+  </data>
+  <data name="Enter email address" xml:space="preserve">
+    <value>Enter email address</value>
+  </data>
+  <data name="Enter phone number" xml:space="preserve">
+    <value>Enter phone number</value>
+  </data>
+  <data name="Enter country" xml:space="preserve">
+    <value>Enter country</value>
+  </data>
 </root>