From 0d1063b13a39f421c3b0e39f31c1d1e5dbf3b230 Mon Sep 17 00:00:00 2001
From: AnnulusGames <annulusgames@gmail.com>
Date: Wed, 21 Feb 2024 09:58:39 +0900
Subject: [PATCH 1/5] Change: add CreateListViewFromSettingsAttribute

---
 .../Editor/Elements/PropertyListView.cs       | 36 +++++++------------
 .../Alchemy/Editor/Internal/GUIHelper.cs      | 17 +++++++++
 2 files changed, 29 insertions(+), 24 deletions(-)

diff --git a/Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs b/Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs
index b72ec5e..0f8ce0a 100644
--- a/Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs
+++ b/Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs
@@ -18,31 +18,19 @@ public PropertyListView(SerializedProperty property, int depth)
 
             var settings = property.GetAttribute<ListViewSettingsAttribute>(true);
 
-            var listView = new ListView
+            var listView = GUIHelper.CreateListViewFromSettingsAttribute(settings);
+            listView.headerTitle = ObjectNames.NicifyVariableName(property.displayName);
+            listView.bindItem = (element, index) =>
             {
-                reorderable = settings == null ? true : settings.Reorderable,
-                reorderMode = settings == null ? ListViewReorderMode.Animated : settings.ReorderMode,
-                showBorder = settings == null ? true : settings.ShowBorder,
-                showFoldoutHeader = settings == null ? true : settings.ShowFoldoutHeader,
-                showBoundCollectionSize = settings == null ? true : (settings.ShowFoldoutHeader && settings.ShowBoundCollectionSize),
-                selectionType = settings == null ? SelectionType.Multiple : settings.SelectionType,
-                headerTitle = ObjectNames.NicifyVariableName(property.displayName),
-                showAddRemoveFooter = settings == null ? true : settings.ShowAddRemoveFooter,
-                fixedItemHeight = 20f,
-                virtualizationMethod = CollectionVirtualizationMethod.DynamicHeight,
-                showAlternatingRowBackgrounds = settings == null ? AlternatingRowBackground.None : settings.ShowAlternatingRowBackgrounds,
-                bindItem = (element, index) =>
-                {
-                    var arrayElement = property.GetArrayElementAtIndex(index);
-                    var e = new AlchemyPropertyField(arrayElement, property.GetPropertyType(true), depth + 1, true);
-                    element.Add(e);
-                    element.Bind(arrayElement.serializedObject);
-                },
-                unbindItem = (element, index) =>
-                {
-                    element.Clear();
-                    element.Unbind();
-                }
+                var arrayElement = property.GetArrayElementAtIndex(index);
+                var e = new AlchemyPropertyField(arrayElement, property.GetPropertyType(true), depth + 1, true);
+                element.Add(e);
+                element.Bind(arrayElement.serializedObject);
+            };
+            listView.unbindItem = (element, index) =>
+            {
+                element.Clear();
+                element.Unbind();
             };
 
             var label = listView.Q<Label>();
diff --git a/Alchemy/Assets/Alchemy/Editor/Internal/GUIHelper.cs b/Alchemy/Assets/Alchemy/Editor/Internal/GUIHelper.cs
index 3b51149..d1a2b21 100644
--- a/Alchemy/Assets/Alchemy/Editor/Internal/GUIHelper.cs
+++ b/Alchemy/Assets/Alchemy/Editor/Internal/GUIHelper.cs
@@ -51,6 +51,23 @@ public static ListView CreateDefaultListView(string label)
             };
         }
 
+        public static ListView CreateListViewFromSettingsAttribute(ListViewSettingsAttribute settings)
+        {
+            return new ListView
+            {
+                reorderable = settings == null ? true : settings.Reorderable,
+                reorderMode = settings == null ? ListViewReorderMode.Animated : settings.ReorderMode,
+                showBorder = settings == null ? true : settings.ShowBorder,
+                showFoldoutHeader = settings == null ? true : settings.ShowFoldoutHeader,
+                showBoundCollectionSize = settings == null ? true : (settings.ShowFoldoutHeader && settings.ShowBoundCollectionSize),
+                selectionType = settings == null ? SelectionType.Multiple : settings.SelectionType,
+                showAddRemoveFooter = settings == null ? true : settings.ShowAddRemoveFooter,
+                fixedItemHeight = 20f,
+                virtualizationMethod = CollectionVirtualizationMethod.DynamicHeight,
+                showAlternatingRowBackgrounds = settings == null ? AlternatingRowBackground.None : settings.ShowAlternatingRowBackgrounds,
+            };
+        }
+
         public static PropertyField CreateObjectPropertyField(SerializedProperty property, Type type)
         {
             Assert.IsTrue(property.propertyType == SerializedPropertyType.ObjectReference);

From 18ccff10cbae9866c0dc73ffb9d3dbc6f4333edf Mon Sep 17 00:00:00 2001
From: AnnulusGames <annulusgames@gmail.com>
Date: Wed, 21 Feb 2024 10:01:29 +0900
Subject: [PATCH 2/5] Change: CreateListViewFromSettingsAttribute ->
 CreateListViewFromFieldInfo

---
 Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs | 2 +-
 Alchemy/Assets/Alchemy/Editor/Internal/GUIHelper.cs        | 6 ++++--
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs b/Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs
index 0f8ce0a..c6786bc 100644
--- a/Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs
+++ b/Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs
@@ -18,7 +18,7 @@ public PropertyListView(SerializedProperty property, int depth)
 
             var settings = property.GetAttribute<ListViewSettingsAttribute>(true);
 
-            var listView = GUIHelper.CreateListViewFromSettingsAttribute(settings);
+            var listView = GUIHelper.CreateListViewFromFieldInfo(property.GetFieldInfo());
             listView.headerTitle = ObjectNames.NicifyVariableName(property.displayName);
             listView.bindItem = (element, index) =>
             {
diff --git a/Alchemy/Assets/Alchemy/Editor/Internal/GUIHelper.cs b/Alchemy/Assets/Alchemy/Editor/Internal/GUIHelper.cs
index d1a2b21..5d74a1b 100644
--- a/Alchemy/Assets/Alchemy/Editor/Internal/GUIHelper.cs
+++ b/Alchemy/Assets/Alchemy/Editor/Internal/GUIHelper.cs
@@ -1,10 +1,11 @@
+using System;
+using System.Reflection;
 using UnityEditor;
 using UnityEditor.UIElements;
 using UnityEngine;
 using UnityEngine.UIElements;
 using UnityEngine.Assertions;
 using Alchemy.Inspector;
-using System;
 
 namespace Alchemy.Editor
 {
@@ -51,8 +52,9 @@ public static ListView CreateDefaultListView(string label)
             };
         }
 
-        public static ListView CreateListViewFromSettingsAttribute(ListViewSettingsAttribute settings)
+        public static ListView CreateListViewFromFieldInfo(FieldInfo fieldInfo)
         {
+            var settings = fieldInfo.GetCustomAttribute<ListViewSettingsAttribute>();
             return new ListView
             {
                 reorderable = settings == null ? true : settings.Reorderable,

From 806a0430323feb841648fef005f1b453a8756213 Mon Sep 17 00:00:00 2001
From: AnnulusGames <annulusgames@gmail.com>
Date: Wed, 21 Feb 2024 11:56:54 +0900
Subject: [PATCH 3/5] Add: ListViewChangedAttribute

---
 .../Editor/Elements/PropertyListView.cs       | 13 +++++-
 .../Alchemy/Editor/Internal/GUIHelper.cs      | 46 ++++++++++++++++++-
 .../Editor/Internal/ReflectionHelper.cs       |  2 +-
 .../Internal/SerializedPropertyExtensions.cs  | 25 ++++++++++
 .../Runtime/Inspector/InspectorAttributes.cs  | 15 ++++++
 Alchemy/Assets/Tests/OnListViewChangedTest.cs | 40 ++++++++++++++++
 .../Tests/OnListViewChangedTest.cs.meta       | 11 +++++
 7 files changed, 147 insertions(+), 5 deletions(-)
 create mode 100644 Alchemy/Assets/Tests/OnListViewChangedTest.cs
 create mode 100644 Alchemy/Assets/Tests/OnListViewChangedTest.cs.meta

diff --git a/Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs b/Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs
index c6786bc..75c4357 100644
--- a/Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs
+++ b/Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs
@@ -16,9 +16,10 @@ public PropertyListView(SerializedProperty property, int depth)
         {
             Assert.IsTrue(property.isArray);
 
-            var settings = property.GetAttribute<ListViewSettingsAttribute>(true);
+            var parentObj = property.GetDeclaredObject();
+            var events = property.GetAttribute<OnListViewChangedAttribute>(true);
 
-            var listView = GUIHelper.CreateListViewFromFieldInfo(property.GetFieldInfo());
+            var listView = GUIHelper.CreateListViewFromFieldInfo(parentObj, property.GetFieldInfo());
             listView.headerTitle = ObjectNames.NicifyVariableName(property.displayName);
             listView.bindItem = (element, index) =>
             {
@@ -26,11 +27,19 @@ public PropertyListView(SerializedProperty property, int depth)
                 var e = new AlchemyPropertyField(arrayElement, property.GetPropertyType(true), depth + 1, true);
                 element.Add(e);
                 element.Bind(arrayElement.serializedObject);
+                e.TrackPropertyValue(arrayElement, x =>
+                {
+                    ReflectionHelper.Invoke(parentObj, events.OnItemChanged, new object[] { index, x.GetValue<object>() });
+                });
+
+                ReflectionHelper.Invoke(parentObj, events.OnBindItem, new object[] { index });
             };
             listView.unbindItem = (element, index) =>
             {
                 element.Clear();
                 element.Unbind();
+
+                ReflectionHelper.Invoke(parentObj, events.OnUnbindItem, new object[] { index });
             };
 
             var label = listView.Q<Label>();
diff --git a/Alchemy/Assets/Alchemy/Editor/Internal/GUIHelper.cs b/Alchemy/Assets/Alchemy/Editor/Internal/GUIHelper.cs
index 5d74a1b..70c9649 100644
--- a/Alchemy/Assets/Alchemy/Editor/Internal/GUIHelper.cs
+++ b/Alchemy/Assets/Alchemy/Editor/Internal/GUIHelper.cs
@@ -52,10 +52,10 @@ public static ListView CreateDefaultListView(string label)
             };
         }
 
-        public static ListView CreateListViewFromFieldInfo(FieldInfo fieldInfo)
+        public static ListView CreateListViewFromFieldInfo(object target, FieldInfo fieldInfo)
         {
             var settings = fieldInfo.GetCustomAttribute<ListViewSettingsAttribute>();
-            return new ListView
+            var listView = new ListView
             {
                 reorderable = settings == null ? true : settings.Reorderable,
                 reorderMode = settings == null ? ListViewReorderMode.Animated : settings.ReorderMode,
@@ -68,6 +68,48 @@ public static ListView CreateListViewFromFieldInfo(FieldInfo fieldInfo)
                 virtualizationMethod = CollectionVirtualizationMethod.DynamicHeight,
                 showAlternatingRowBackgrounds = settings == null ? AlternatingRowBackground.None : settings.ShowAlternatingRowBackgrounds,
             };
+
+            var events = fieldInfo.GetCustomAttribute<OnListViewChangedAttribute>();
+            if (events != null)
+            {
+                listView.itemsAdded += indices =>
+                {
+                    if (events.OnItemsAdded == null) return;
+                    ReflectionHelper.Invoke(target, events.OnItemsAdded, new object[] { indices });
+                };
+                listView.itemsRemoved += indices =>
+                {
+                    if (events.OnItemsRemoved == null) return;
+                    ReflectionHelper.Invoke(target, events.OnItemsRemoved, new object[] { indices });
+                };
+                listView.itemsChosen += items =>
+                {
+                    if (events.OnItemsChosen == null) return;
+                    ReflectionHelper.Invoke(target, events.OnItemsChosen, new object[] { items });
+                };
+                listView.itemIndexChanged += (before, after) =>
+                {
+                    if (events.OnItemIndexChanged == null) return;
+                    ReflectionHelper.Invoke(target, events.OnItemIndexChanged, new object[] { before, after });
+                };
+                listView.selectionChanged += items =>
+                {
+                    if (events.OnSelectionChanged == null) return;
+                    ReflectionHelper.Invoke(target, events.OnSelectionChanged, new object[] { items });
+                };
+                listView.selectedIndicesChanged += indices =>
+                {
+                    if (events.OnSelectedIndicesChanged== null) return;
+                    ReflectionHelper.Invoke(target, events.OnSelectedIndicesChanged, new object[] { indices });
+                };
+                listView.itemsSourceChanged += () =>
+                {
+                    if (events.OnItemsSourceChanged == null) return;
+                    ReflectionHelper.Invoke(target, events.OnItemsSourceChanged, null);
+                };
+            }
+
+            return listView;
         }
 
         public static PropertyField CreateObjectPropertyField(SerializedProperty property, Type type)
diff --git a/Alchemy/Assets/Alchemy/Editor/Internal/ReflectionHelper.cs b/Alchemy/Assets/Alchemy/Editor/Internal/ReflectionHelper.cs
index a68f7de..b399d8c 100644
--- a/Alchemy/Assets/Alchemy/Editor/Internal/ReflectionHelper.cs
+++ b/Alchemy/Assets/Alchemy/Editor/Internal/ReflectionHelper.cs
@@ -262,7 +262,7 @@ public static object Invoke(object target, string name, params object[] paramete
         {
             if (target == null) return false;
             Type type = target.GetType();
-            BindingFlags bindingAttr = BindingFlags.NonPublic | BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static;
+            BindingFlags bindingAttr = BindingFlags.NonPublic | BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static | BindingFlags.DeclaredOnly;
 
             while (type != null)
             {
diff --git a/Alchemy/Assets/Alchemy/Editor/Internal/SerializedPropertyExtensions.cs b/Alchemy/Assets/Alchemy/Editor/Internal/SerializedPropertyExtensions.cs
index 978f399..5f55e6d 100644
--- a/Alchemy/Assets/Alchemy/Editor/Internal/SerializedPropertyExtensions.cs
+++ b/Alchemy/Assets/Alchemy/Editor/Internal/SerializedPropertyExtensions.cs
@@ -227,6 +227,31 @@ public static object GetParentObject(this SerializedProperty property)
             return obj;
         }
 
+
+        public static object GetDeclaredObject(this SerializedProperty property)
+        {
+            if (property == null) return null;
+
+            var path = property.propertyPath.Replace(".Array.data[", "[");
+            object obj = property.serializedObject.targetObject;
+            var elements = path.Split('.');
+            for (int i = 0; i < elements.Length - 1; i++)
+            {
+                var element = elements[i];
+                if (element.Contains("["))
+                {
+                    var elementName = element[..element.IndexOf("[")];
+                    var index = Convert.ToInt32(element[element.IndexOf("[")..].Replace("[", "").Replace("]", ""));
+                    obj = ReflectionHelper.GetValue(obj, elementName, index);
+                }
+                else
+                {
+                    obj = ReflectionHelper.GetValue(obj, element);
+                }
+            }
+            return obj;
+        }
+
         static T GetFieldOrPropertyValue<T>(string fieldName, object obj, bool includeAllBases = false, BindingFlags bindings = BindingFlags.Instance | BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic)
         {
             var field = obj.GetType().GetField(fieldName, bindings);
diff --git a/Alchemy/Assets/Alchemy/Runtime/Inspector/InspectorAttributes.cs b/Alchemy/Assets/Alchemy/Runtime/Inspector/InspectorAttributes.cs
index 6af7d9d..90c759a 100644
--- a/Alchemy/Assets/Alchemy/Runtime/Inspector/InspectorAttributes.cs
+++ b/Alchemy/Assets/Alchemy/Runtime/Inspector/InspectorAttributes.cs
@@ -217,4 +217,19 @@ public sealed class ListViewSettingsAttribute : Attribute
         public bool Reorderable { get; set; } = true;
         public ListViewReorderMode ReorderMode { get; set; } = ListViewReorderMode.Animated;
     }
+
+    [AttributeUsage(AttributeTargets.Field)]
+    public sealed class OnListViewChangedAttribute : Attribute
+    {
+        public string OnItemChanged { get; set; }
+        public string OnItemIndexChanged { get; set; }
+        public string OnItemsAdded { get; set; }
+        public string OnItemsRemoved { get; set; }
+        public string OnItemsChosen { get; set; }
+        public string OnItemsSourceChanged { get; set; }
+        public string OnSelectionChanged { get; set; }
+        public string OnSelectedIndicesChanged { get; set; }
+        public string OnBindItem { get; set; }
+        public string OnUnbindItem { get; set; }
+    }
 }
\ No newline at end of file
diff --git a/Alchemy/Assets/Tests/OnListViewChangedTest.cs b/Alchemy/Assets/Tests/OnListViewChangedTest.cs
new file mode 100644
index 0000000..249aad0
--- /dev/null
+++ b/Alchemy/Assets/Tests/OnListViewChangedTest.cs
@@ -0,0 +1,40 @@
+using System.Collections.Generic;
+using UnityEngine;
+using Alchemy.Inspector;
+
+public class OnListViewChangedTest : MonoBehaviour
+{
+    [OnListViewChanged(
+        OnItemChanged = nameof(OnItemChanged),
+        OnItemsAdded = nameof(OnItemsAdded),
+        OnItemsRemoved = nameof(OnItemsRemoved),
+        OnSelectedIndicesChanged = nameof(OnSelectedIndicesChanged),
+        OnItemIndexChanged = nameof(OnItemIndexChanged))
+    ]
+    public int[] array;
+
+    void OnItemChanged(int index, int item)
+    {
+        Debug.Log($"Changed: [{index}] -> {item}");
+    }
+
+    void OnItemsAdded(IEnumerable<int> indices)
+    {
+        Debug.Log($"Added: [{string.Join(',', indices)}]");
+    }
+
+    void OnItemsRemoved(IEnumerable<int> indices)
+    {
+        Debug.Log($"Removed: [{string.Join(',', indices)}]");
+    }
+
+    void OnSelectedIndicesChanged(IEnumerable<int> indices)
+    {
+        Debug.Log($"Selected: [{string.Join(',', indices)}]");
+    }
+
+    void OnItemIndexChanged(int before, int after)
+    {
+        Debug.Log($"Index Changed: [{before} -> {after}]");
+    }
+}
diff --git a/Alchemy/Assets/Tests/OnListViewChangedTest.cs.meta b/Alchemy/Assets/Tests/OnListViewChangedTest.cs.meta
new file mode 100644
index 0000000..4355f29
--- /dev/null
+++ b/Alchemy/Assets/Tests/OnListViewChangedTest.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: d611398f16e414b16ba99c1193a8dfa0
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

From 99346cddb08426d3a7e841d8c7c6b605ffd75aeb Mon Sep 17 00:00:00 2001
From: AnnulusGames <annulusgames@gmail.com>
Date: Wed, 21 Feb 2024 12:17:35 +0900
Subject: [PATCH 4/5] Remove: OnBindItem and OnUnbindItem

---
 Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs    | 4 ----
 .../Assets/Alchemy/Runtime/Inspector/InspectorAttributes.cs   | 2 --
 2 files changed, 6 deletions(-)

diff --git a/Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs b/Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs
index 75c4357..361ab9d 100644
--- a/Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs
+++ b/Alchemy/Assets/Alchemy/Editor/Elements/PropertyListView.cs
@@ -31,15 +31,11 @@ public PropertyListView(SerializedProperty property, int depth)
                 {
                     ReflectionHelper.Invoke(parentObj, events.OnItemChanged, new object[] { index, x.GetValue<object>() });
                 });
-
-                ReflectionHelper.Invoke(parentObj, events.OnBindItem, new object[] { index });
             };
             listView.unbindItem = (element, index) =>
             {
                 element.Clear();
                 element.Unbind();
-
-                ReflectionHelper.Invoke(parentObj, events.OnUnbindItem, new object[] { index });
             };
 
             var label = listView.Q<Label>();
diff --git a/Alchemy/Assets/Alchemy/Runtime/Inspector/InspectorAttributes.cs b/Alchemy/Assets/Alchemy/Runtime/Inspector/InspectorAttributes.cs
index 90c759a..0479176 100644
--- a/Alchemy/Assets/Alchemy/Runtime/Inspector/InspectorAttributes.cs
+++ b/Alchemy/Assets/Alchemy/Runtime/Inspector/InspectorAttributes.cs
@@ -229,7 +229,5 @@ public sealed class OnListViewChangedAttribute : Attribute
         public string OnItemsSourceChanged { get; set; }
         public string OnSelectionChanged { get; set; }
         public string OnSelectedIndicesChanged { get; set; }
-        public string OnBindItem { get; set; }
-        public string OnUnbindItem { get; set; }
     }
 }
\ No newline at end of file

From 5f62a111dee0760ab65afb5a8b54cd2f6808f20a Mon Sep 17 00:00:00 2001
From: AnnulusGames <annulusgames@gmail.com>
Date: Wed, 21 Feb 2024 12:24:06 +0900
Subject: [PATCH 5/5] Add: docs

---
 .../en/attributes/on-list-view-changed.md     | 53 +++++++++++++++++++
 docs/articles/en/toc.yml                      |  2 +
 .../ja/attributes/on-list-view-changed.md     | 53 +++++++++++++++++++
 docs/articles/ja/toc.yml                      |  2 +
 4 files changed, 110 insertions(+)
 create mode 100644 docs/articles/en/attributes/on-list-view-changed.md
 create mode 100644 docs/articles/ja/attributes/on-list-view-changed.md

diff --git a/docs/articles/en/attributes/on-list-view-changed.md b/docs/articles/en/attributes/on-list-view-changed.md
new file mode 100644
index 0000000..071a2cb
--- /dev/null
+++ b/docs/articles/en/attributes/on-list-view-changed.md
@@ -0,0 +1,53 @@
+# On List View Changed Attribute
+
+Detects changes in collections and invokes methods accordingly. Refer to Unity's [ListView documentation](https://docs.unity3d.com/ScriptReference/UIElements.ListView.html) for details on each event.
+
+> [!WARNING]
+> Ensure that the types of arguments for each event exactly match the arguments listed below (or the ListView event arguments). Failure to match will result in errors and the method won't execute.
+
+```cs 
+[OnListViewChanged(
+    OnItemChanged = nameof(OnItemChanged),
+    OnItemsAdded = nameof(OnItemsAdded),
+    OnItemsRemoved = nameof(OnItemsRemoved),
+    OnSelectedIndicesChanged = nameof(OnSelectedIndicesChanged),
+    OnItemIndexChanged = nameof(OnItemIndexChanged))
+]
+public float[] array;
+
+void OnItemChanged(int index, float item)
+{
+    Debug.Log($"Changed: [{index}] -> {item}");
+}
+
+void OnItemsAdded(IEnumerable<int> indices)
+{
+    Debug.Log($"Added: [{string.Join(',', indices)}]");
+}
+
+void OnItemsRemoved(IEnumerable<int> indices)
+{
+    Debug.Log($"Removed: [{string.Join(',', indices)}]");
+}
+
+void OnSelectedIndicesChanged(IEnumerable<int> indices)
+{
+    Debug.Log($"Selected: [{string.Join(',', indices)}]");
+}
+
+void OnItemIndexChanged(int before, int after)
+{
+    Debug.Log($"Index Changed: [{before} -> {after}]");
+}
+```
+
+| Parameter | Description |
+| - | - |
+| OnItemChanged | Name of the method called when an item's value changes `(int index, T value)` |
+| OnItemIndexChanged | Name of the method called when an item's index changes `(int before, int after)` |
+| OnItemsAdded | Name of the method called when items are added `(IEnumerable<int> indices)` |
+| OnItemsRemoved | Name of the method called when items are removed `(IEnumerable<int> indices)` |
+| OnItemsChosen | Name of the method called when items are chosen by pressing Enter or double-clicking `(IEnumerable<object> items)` |
+| OnItemsSourceChanged | Name of the method called when the original collection changes, such as its count `(no arguments)` |
+| OnSelectionChanged  | Name of the method called when the selected items change `(IEnumerable<object> items)` |
+| OnSelectedIndicesChanged  | Name of the method called when the selected indices change `(IEnumerable<int> indices)` |
diff --git a/docs/articles/en/toc.yml b/docs/articles/en/toc.yml
index f6dd75a..f724391 100644
--- a/docs/articles/en/toc.yml
+++ b/docs/articles/en/toc.yml
@@ -82,6 +82,8 @@
     href: attributes/on-inspector-disable.md
   - name: On Inspector Enable
     href: attributes/on-inspector-enable.md
+  - name: On List View Changed
+    href: attributes/on-list-view-changed.md
   - name: On Value Changed
     href: attributes/on-value-changed.md
     
diff --git a/docs/articles/ja/attributes/on-list-view-changed.md b/docs/articles/ja/attributes/on-list-view-changed.md
new file mode 100644
index 0000000..753db15
--- /dev/null
+++ b/docs/articles/ja/attributes/on-list-view-changed.md
@@ -0,0 +1,53 @@
+# On List View Changed Attribute
+
+コレクションの変更を検知してメソッドを呼び出します。各イベントの詳細はUnityの[ListViewのドキュメント](https://docs.unity3d.com/ScriptReference/UIElements.ListView.html)を参照してください。
+
+> [!WARNING]
+> 各イベントの引数の型が、下の表に示した引数(またはListViewのイベントの引数)と完全に一致していることを確認してください。一致しない場合、メソッドを実行できずエラーが発生します。
+
+```cs 
+[OnListViewChanged(
+    OnItemChanged = nameof(OnItemChanged),
+    OnItemsAdded = nameof(OnItemsAdded),
+    OnItemsRemoved = nameof(OnItemsRemoved),
+    OnSelectedIndicesChanged = nameof(OnSelectedIndicesChanged),
+    OnItemIndexChanged = nameof(OnItemIndexChanged))
+]
+public float[] array;
+
+void OnItemChanged(int index, float item)
+{
+    Debug.Log($"Changed: [{index}] -> {item}");
+}
+
+void OnItemsAdded(IEnumerable<int> indices)
+{
+    Debug.Log($"Added: [{string.Join(',', indices)}]");
+}
+
+void OnItemsRemoved(IEnumerable<int> indices)
+{
+    Debug.Log($"Removed: [{string.Join(',', indices)}]");
+}
+
+void OnSelectedIndicesChanged(IEnumerable<int> indices)
+{
+    Debug.Log($"Selected: [{string.Join(',', indices)}]");
+}
+
+void OnItemIndexChanged(int before, int after)
+{
+    Debug.Log($"Index Changed: [{before} -> {after}]");
+}
+```
+
+| パラメータ | 説明 |
+| - | - |
+| OnItemChanged | 要素の値を変更した際に呼ばれるメソッドの名前 `(int index, T value)` |
+| OnItemIndexChanged | 要素のindexが変更された際に呼ばれるメソッドの名前 `(int before, int after)` |
+| OnItemsAdded | 要素が追加された際に呼ばれるメソッドの名前 `(IEnumerable<int> indices)` |
+| OnItemsRemoved | 要素が削除された際に呼ばれるメソッドの名前 `(IEnumerable<int> indices)` |
+| OnItemsChosen | 要素がEnterキーやダブルクリックで選択された際に呼ばれるメソッドの名前 `(IEnumerable<object> items)` |
+| OnItemsSourceChanged | 要素の個数など、元のコレクションが変更された際に呼ばれるメソッドの名前 `(引数なし)` |
+| OnSelectionChanged  | 選択中の要素が変更された際に呼ばれるメソッドの名前 `(IEnumerable<object> items)` |
+| OnSelectedIndicesChanged  | 選択中のindexが変更された際に呼ばれるメソッドの名前 `(IEnumerable<int> indices)` |
diff --git a/docs/articles/ja/toc.yml b/docs/articles/ja/toc.yml
index 58b3324..d962254 100644
--- a/docs/articles/ja/toc.yml
+++ b/docs/articles/ja/toc.yml
@@ -82,6 +82,8 @@
     href: attributes/on-inspector-disable.md
   - name: On Inspector Enable
     href: attributes/on-inspector-enable.md
+  - name: On List View Changed
+    href: attributes/on-list-view-changed.md
   - name: On Value Changed
     href: attributes/on-value-changed.md