XChart P26a:文本槽位复用时恢复默认——"被写过的属性"必须全部出现在恢复清单里

存量缺陷,不是新功能带来的:XChartTextSlotFactory.Acquire() 只给**新建**那件设默认
(text/换行/对齐/anchor/pivot),从 m_Free 里 Pop 出来的那件只 SetActive(true)。
而元素每帧往槽位上写的远不止这些——轴线就写六样:

    label.text / fontSize / color / rectTransform.sizeDelta / anchoredPosition / localEulerAngles
                                                              (ChartToolAxis.cs:469-474)

⇒ 一件被上一个元素改成 14 号字、蓝色、矩形 90×24、还转了 30°,还回池子再发给别的元素时,
**这些值会带着走**:新元素只写它自己关心的那几样,剩下的沿用上一轮的。症状是"标签换个顺序就变大/歪了",
而画面上完全看不出是谁写的——典型的"同一件事两处存"(上一轮的残留也是"两处")。

落法:工厂里抽 public static ResetToDefaults(TMP_Text),**默认值只在这里定义一次**,
新建与复用**两条路径都调它**(复用路径那句是关键)。清单按"被写了什么"来定,不靠记忆:
新门 .ximage-gate/slot_reset_gate.py 两条主张——
  A 所有元素往槽位上写的属性 ⊆ 恢复清单(读数:files scanned=53 slot writes=14 distinct=7 reset lines=16);
  B 恢复函数确实在**两条获取路径**上被调用(只在"新建"分支调=一条绿谎,门直接判 FAIL)。
三支变异各红在自己点名的那条:S1 从清单里删掉 fontSize、S2 让轴线多写一个 overflowMode(门当场点名)、
S3 把复用路径那句调用删掉(B 主张两个分支同报 False)。正本 PASS、三支全红。

顺带记一条 TMP 版本事实(离线编译门先替我撞的):这版 TextMeshProUGUI 的 outlineWidth 是 **float**、
并且没有 enableOutline 开关 ⇒ 归零宽度就是不描边。我按新版文档写了 Vector2.zero 和 tmp.enableOutline,
CS0029 + CS1061 两条在门里就红了,没进他的编辑器(这条正是"写编辑器侧代码前先核 API 存在"的又一次兑现)。

覆盖不到的:这一句不改"上不上屏"(那是 P23/P25 的填充跳板),也不证明元素写得对——
它只保证"没写的属性不会带着上一轮的值"。真上屏与观感照旧归他现场判。
This commit is contained in:
2026-10-26 19:10:43 +08:00
parent f9c758b01c
commit dc4e5445ad
2 changed files with 45 additions and 7 deletions
+44 -7
View File
@@ -32,6 +32,47 @@ namespace XericUI.XChart.Pools
/// <summary>池里闲置的槽位数(调试判据用:调度收敛后应当等于"曾经发落过又还回来的")</summary>
public int FreeCount => m_Free.Count;
/// <summary>
/// 槽位的<b>默认状态</b>只在这里定义一次。新建那件走它,<b>从空闲表里拿回来的那件也必须走它</b>——
/// 只在新建分支设默认的话,复用件会带着上一轮的字号、颜色、矩形和旋转走(轴线每帧写
/// <c>text/fontSize/color/sizeDelta/anchoredPosition/localEulerAngles</c> 这六样,别的需求也一样),
/// 症状是"标签的元素换了个顺序显示,字就莫名变大/歪了",而这种错在画面上完全看不出来是谁写的。
/// </summary>
public static void ResetToDefaults(TMP_Text slot)
{
if (!IsAlive(slot)) return;
var tmp = slot as TextMeshProUGUI;
if (tmp != null)
{
tmp.text = string.Empty;
tmp.fontSize = k_DefaultFontSize;
tmp.color = k_DefaultColor;
tmp.fontStyle = FontStyles.Normal;
tmp.enableWordWrapping = false;
tmp.characterSpacing = 0f;
tmp.lineSpacing = 0f;
// 这版 TMP 的 outlineWidth 是 float(不是 Vector2),也没有 enableOutline 开关:
// 宽度归零就是不描边
tmp.outlineWidth = 0f;
tmp.alignment = TextAlignmentOptions.Center;
}
var rect = slot.rectTransform;
rect.anchorMin = k_DefaultAnchor;
rect.anchorMax = k_DefaultAnchor;
rect.pivot = k_DefaultPivot;
rect.sizeDelta = k_DefaultSize;
rect.anchoredPosition = Vector2.zero;
rect.localEulerAngles = Vector3.zero;
}
private const float k_DefaultFontSize = 14f;
private static readonly Color k_DefaultColor = Color.white;
private static readonly Vector2 k_DefaultAnchor = new Vector2(0.5f, 0.5f);
private static readonly Vector2 k_DefaultPivot = new Vector2(0.5f, 0.5f);
private static readonly Vector2 k_DefaultSize = new Vector2(0f, 0f);
public TMP_Text Acquire()
{
var poolRoot = EnsurePoolRoot();
@@ -42,6 +83,8 @@ namespace XericUI.XChart.Pools
TMP_Text slot = m_Free.Pop();
// 空闲表里也可能有域重载留下的僵尸件:验不过就当场销毁,别发出去
if (!IsAlive(slot)) { DestroySlot(slot); continue; }
// 复用的件先擦回默认——这一句是这条路径上唯一的保证,别指望各元素"自己都会写全"
ResetToDefaults(slot);
slot.gameObject.SetActive(true);
return slot;
}
@@ -52,13 +95,7 @@ namespace XericUI.XChart.Pools
go.hideFlags = XChartBase.CurrentFlags;
var tmp = go.AddComponent<TextMeshProUGUI>();
tmp.text = string.Empty;
tmp.enableWordWrapping = false;
tmp.alignment = TextAlignmentOptions.Center;
var rect = tmp.rectTransform;
rect.anchorMin = new Vector2(0.5f, 0.5f);
rect.anchorMax = new Vector2(0.5f, 0.5f);
rect.pivot = new Vector2(0.5f, 0.5f);
ResetToDefaults(tmp);
return tmp;
}