Feature that override built-in cells

Author: Haruma-K

Assets/UnityDebugSheet/Runtime/Core/Scripts/DebugSheet.cs

@@ -296,7 +296,8 @@ private AsyncProcessHandle PushPage(Type pageType, string prefabName, bool playA
                     debugPage.SetTitle(titleOverride);
 
                 var prefabContainer = debugPage.GetComponent<PrefabContainer>();
-                prefabContainer.Prefabs.AddRange(_cellPrefabs);
+                foreach (var cellPrefab in _cellPrefabs)
+                    prefabContainer.AddPrefab(cellPrefab);
 
                 onLoad?.Invoke((x.pageId, debugPage));
             }, loadAsync: false);

Assets/UnityDebugSheet/Runtime/Core/Scripts/PrefabContainer.cs

@@ -1,29 +1,34 @@
 using System;
 using System.Collections.Generic;
-using System.Linq;
 using UnityEngine;
 
 namespace UnityDebugSheet.Runtime.Core.Scripts
 {
     public sealed class PrefabContainer : MonoBehaviour
     {
+        // For Inspector
         [SerializeField] private List<GameObject> _prefabs = new List<GameObject>();
 
-        private readonly Dictionary<string, GameObject> _prefabNames = new Dictionary<string, GameObject>();
+        private readonly Dictionary<string, GameObject> _nameToPrefabMap = new Dictionary<string, GameObject>();
 
-        public List<GameObject> Prefabs => _prefabs;
-
-        public GameObject GetPrefab(string prefabName)
+        private void Awake()
         {
-            if (_prefabNames.TryGetValue(prefabName, out var prefab))
-                return prefab;
+            foreach (var prefab in _prefabs)
+                AddPrefab(prefab);
+        }
 
-            prefab = _prefabs.FirstOrDefault(x => x.name.Equals(prefabName, StringComparison.Ordinal));
+        public void AddPrefab(GameObject prefab)
+        {
+            // Add prefab to the map.
+            // If the same name prefab is already added, it will be overwritten.
+            _nameToPrefabMap[prefab.name] = prefab;
+        }
 
-            if (prefab == null)
-                throw new ArgumentException($"Prefab \"{prefabName}\" is not found.");
+        public GameObject GetPrefab(string prefabName)
+        {
+            if (!_nameToPrefabMap.TryGetValue(prefabName, out var prefab))
+                throw new ArgumentException($"Prefab '{prefabName}' is not found.");
 
-            _prefabNames.Add(prefabName, prefab);
             return prefab;
         }
 
@@ -41,4 +46,4 @@ public bool TryGetPrefab(string prefabName, out GameObject prefab)
             }
         }
     }
-}
+}

README.md

@@ -456,6 +456,13 @@ Next, set this cell to **Cell Prefabs** on the **Debug Sheet**.
 All that remains is to add this cell to the page.
 Please refer to [the demo scene of the custom cells](Assets/Demo/03_CustomCells/Scenes/CustomCellsDemo.unity) for the actual implementation.
 
+### Extending Built-in Cell Prefabs
+You can extend built-in cell prefabs such as LabelCell and ButtonCell by following the steps below:
+
+1. Create a Prefab Variant of the built-in Prefab and make any desired modifications.
+2. Ensure the name of this Prefab is the same as the original Prefab.
+3. Set this Prefab in the **Cell Prefabs** of the **Debug Sheet** component.
+
 ## Advanced Usage
 
 ### Use async methods instead of coroutines

README_JA.md

@@ -572,7 +572,14 @@ debugSheet.PushPage<DebugPage>(true, pageId: "MyPageId");
 ```
 
 なお、まとめて戻る際にスキップされるページについては、遷移前後のライフサイクルイベントは呼ばれず、破棄前のイベントだけ呼ばれます。  
-またスキップされるページの遷移アニメーションは再生されません。  
+またスキップされるページの遷移アニメーションは再生されません。
+
+### 組み込みセルPrefabを拡張する
+LabelCell や ButtonCell などの組み込みセルのPrefabは以下の手順で拡張することができます。
+
+1. 組み込みPrefabのPrefabバリアントを作成し、任意の変更を加える
+2. このとき、Prefabの名前は元のPrefabと同じにする
+3. このPrefabを **Debug Sheet** コンポーネントの **Cell Prefabs** に設定する
 
 ## 拡張パッケージ
 Unity Debug Sheet はどんなアプリケーションでも汎用的に使う機能を拡張パッケージとして提供しています。