From 40157298b613a1c6a16fed98652ca21c296fb3f8 Mon Sep 17 00:00:00 2001
From: Dimo Dimov <961014+dimodi@users.noreply.github.com>
Date: Fri, 25 Oct 2024 11:23:24 +0300
Subject: [PATCH] docs(Grid|TreeList): Document hidden columns' editability

---
 components/grid/editing/popup.md     | 26 ++++++++++++++++++++------
 components/treelist/editing/popup.md |  6 +++++-
 2 files changed, 25 insertions(+), 7 deletions(-)

diff --git a/components/grid/editing/popup.md b/components/grid/editing/popup.md
index 798c85364..0078eb37a 100644
--- a/components/grid/editing/popup.md
+++ b/components/grid/editing/popup.md
@@ -36,7 +36,7 @@ The Popup editing mode supports [validation]({%slug common-features/input-valida
 ````CSHTML
 @using System.ComponentModel.DataAnnotations
 
-<strong>Editing is cancelled for the first two records.</strong>
+<strong>Editing is cancelled for the fifth item conditionally.</strong>
 
 <TelerikGrid Data=@MyData EditMode="@GridEditMode.Popup" Pageable="true" Height="500px"
              OnUpdate="@UpdateHandler" OnEdit="@EditHandler" OnDelete="@DeleteHandler" OnCreate="@CreateHandler" OnCancel="@CancelHandler">
@@ -44,8 +44,10 @@ The Popup editing mode supports [validation]({%slug common-features/input-valida
         <GridCommandButton Command="Add" Icon="@SvgIcon.Plus">Add Employee</GridCommandButton>
     </GridToolBarTemplate>
     <GridColumns>
-        <GridColumn Field=@nameof(SampleData.ID) Title="ID" Editable="false" />
-        <GridColumn Field=@nameof(SampleData.Name) Title="Name" />
+        <GridColumn Field=@nameof(SampleData.ID) Title="ID" Editable="false" Width="80px" />
+        <GridColumn Field=@nameof(SampleData.FirstName) Title="First Name" />
+        <GridColumn Field=@nameof(SampleData.MiddleName) Title="Middle Name" Visible="false" />
+        <GridColumn Field=@nameof(SampleData.LastName) Title="Last Name" />
         <GridCommandColumn>
             <GridCommandButton Command="Edit" Icon="@SvgIcon.Pencil">Edit</GridCommandButton>
             <GridCommandButton Command="Delete" Icon="@SvgIcon.Trash">Delete</GridCommandButton>
@@ -120,8 +122,14 @@ The Popup editing mode supports [validation]({%slug common-features/input-valida
     {
         public int ID { get; set; }
 
-        [Required(ErrorMessage = "The employee must have a name")]
-        public string Name { get; set; }
+        [Required]
+        public string FirstName { get; set; }
+
+        [Required]
+        public string MiddleName { get; set; }
+
+        [Required]
+        public string LastName { get; set; }
     }
 
     public List<SampleData> MyData { get; set; }
@@ -157,7 +165,9 @@ The Popup editing mode supports [validation]({%slug common-features/input-valida
                     _data.Add(new SampleData()
                     {
                         ID = i,
-                        Name = "Name " + i.ToString()
+                        FirstName = "First " + i.ToString(),
+                        MiddleName = "Middle " + i.ToString(),
+                        LastName = "Last " + i.ToString(),
                     });
                 }
             }
@@ -188,6 +198,10 @@ The Popup editing mode supports [validation]({%slug common-features/input-valida
 
 The Grid exposes options to customize the edit popup and its form. Define the desired configuration in the `GridPopupEditSettings` and `GridPopupEditFormSettings` tags under the `GridSettings` tag.
 
+### Editability of Hidden Columns
+
+Staring from version 7.0, the Grid allows users to edit [hidden columns]({%slug grid-columns-visible%}) by default. To disable editing of a hidden column, set `Editable="false"` to the respective `<GridColumn>` tag.
+
 ### Popup Customization
 
 The `GridPopupEditSettings` nested tag exposes the following parameters to allow popup customization:
diff --git a/components/treelist/editing/popup.md b/components/treelist/editing/popup.md
index 14b56c3b9..f5b6a2a30 100644
--- a/components/treelist/editing/popup.md
+++ b/components/treelist/editing/popup.md
@@ -65,7 +65,7 @@ Editing is cancelled for the first record.
         <TreeListColumn Field="Name" Expandable="true" Width="320px" />
         <TreeListColumn Field="Id" Editable="false" Width="120px" />
         <TreeListColumn Field="EmailAddress" Width="220px" />
-        <TreeListColumn Field="HireDate" Width="220px" />
+        <TreeListColumn Field="HireDate" Width="220px" Visible="false" />
     </TreeListColumns>
 </TelerikTreeList>
 
@@ -319,6 +319,10 @@ Editing is cancelled for the first record.
 
 The TreeList exposes options to customize the edit popup and its form. You can define your desired configuration in the `TreeListPopupEditSettings` and `TreeListPopupEditFormSettings` tags under the `TreeListSettings` tag.
 
+### Editability of Hidden Columns
+
+Staring from version 7.0, the TreeList allows users to edit [hidden columns]({%slug treelist-columns-visible%}) by default. To disable editing of a hidden column, set `Editable="false"` to the respective `<TreeListColumn>` tag.
+
 ### Popup Customization
 
 The `TreeListPopupEditSettings` nested tag exposes the following parameters to allow popup customization: