lrss3 db4a6fc3b9 XChart P20d:外部访问的两条入口补上(Tool<T>/Element<T>),权威分工写进规范 §27
他问的是"能不能直接拿到圆柱渲染器,改属性就自动更新"。答案分两半:
**入口早就有**(`chart.ToolManager.FindTool<ChartToolCylinder>()`),**自动置脏这半没有**——
第二半已由前两笔补齐(P20a 抽象脏位协议、P20b 132 个旋钮全部设了就生效)。
这一笔补第一半的手感,并把"谁覆盖谁"这件事写成文字。

- `XChartBase.Tool<T>(toolName = null)`:`FindTool<T>` 的空安全简写。
  为什么不直接让他写 `ToolManager.FindTool<T>()`——工具管理器还没建时那句抛 NRE,
  而"图里现在有没有这一类"是现场状态,调用方要问得出"没有"这个答案(答 null,不抛)。
  同类多条按名字点,名字就是 `ElementNameFor(i)` 那一个(面板上元素行印的也是它)。
- `XChartBase.Element<T>()`:按类型取表里第一份配置,走 `XChartElementTable.FirstOfKind`——
  "哪一条是这一类"只许有这一个答法(默认元素去重、面板、外部读配置共用)。

规范 §27 里最要紧的是 **27.3 那条会咬人的分工**:配置是作者数据、工具是它的投影。
外部写进工具的值活到下一次 `ReapplyElements()` / `RebuildElements()`(面板动任一字段、
增删/停用元素、脚本重载、进 Play、`ResetRender()` 都走这条),那一次把配置整份重灌进工具
⇒ 外部的写被静默覆盖。要活得过重建就得写配置,而**配置的公开写入口这一轮没开**(字段仍是
private;面板走 SerializedProperty 本来就不需要公开属性)——这条如实记在 27.6,是下一步。

顺手把 §25.9 那两条"还没做的"改成已被 §26 做掉(旧话写着"现在还是直线段""等逐顶点双色",
而这两条本轮之前就已经实现了)——对外文档按最新实现校准,不留过期主张。

判据:新源码门 dirty_gate.py(P20b 那笔已交)终态 knobs=132 takesEffect=132 findings=0、
七支变异各红在自己点名的断言上;本笔改的是 `XChartBase`(不在门覆盖里),
由离线编译门覆盖:runtime + player + editor + 3 支对照 GATE PASSED,chain_p20d.txt rc=0。
CHANGELOG 补 P20 一行。观感归他现场判(Ctrl+R 后的验收四条写在 27.7)。
2026-10-26 09:07:28 +08:00
2026-08-18 14:00:28 +08:00
2025-07-14 16:50:06 +08:00
2025-07-14 16:50:06 +08:00
2025-07-14 16:50:06 +08:00
2026-07-09 17:25:16 +08:00
2025-07-14 16:50:06 +08:00
2025-08-05 10:52:35 +08:00
2025-07-14 16:50:06 +08:00
2025-07-14 16:50:06 +08:00
2025-07-14 16:50:06 +08:00
2025-07-14 16:50:06 +08:00
2025-07-14 16:50:06 +08:00

Xeric UI Action Vessel

提供一些unity上常见UI容器用法。

容器类说明

泛型界面容器

使用ObjectVessel<T>来声名一个可以呈现在界面上的属性,其中,泛型可以用于在Unity界面上约束目标类型。

这个类不建议进行封装,封装后会失去在Inspector界面上的泛型约束功能。

翻页管理器

提供一个FlipPageComponentManager类,其继承于XericFlipPageIndexVesselBase。
实现一种基于翻页逻辑的数据虚拟化结构管理器。
父级实现了基础翻页逻辑,而子类实现在此基础上的组件交互逻辑,使用时,需要继承于FlipPageComponentManager再实现数据层功能。
比如下面是一个通过翻页管理器控制Xchart.UITable内数据翻页的基础实例:

public class MeasuringPointPageManager : FlipPageComponentManager
{
    public UITable Table; // 表格呈现

    // 页面数据对象
    public class PageMeasuringPointInfo : PageComponentInfo
    {
        // 页面数据对象里包含多个内容数据对象,并会由于数据的增加自动增加页面。
    }
    // 内容数据对象
    public class ItemMeasuringPointInfo : ItemComponentInfo
    {
        public string RiskSourceName = "数据内容";
        // 单个数据条目内容的数据在此定义。
    }

    // 当翻页时,处理翻页数据
    public override void FlipPage(int pageIndex, bool forceRefresh = false)
    {
        base.FlipPage(pageIndex, forceRefresh);

        Table.ClearData();
        var page = Currentpage as PageMeasuringPointInfo;
        foreach (var item in page.itemInfos)
        {
            AddTableRowData(page.pageNumber, item as ItemMeasuringPointInfo);
        }
    }
    // 直接添加一个空数据对象到表格中
    [HorizontalGroup("数据"), Button("添加测试项目")]
    private void AddItem()
    {
        AddItem(new ItemMeasuringPointInfo(),
            () => AddPageLast(new PageMeasuringPointInfo()));
    }
    // 定义一下如何将数据处理为表格格式
    public void AddTableRowData(int pageOffset, ItemMeasuringPointInfo info)
    {
        Table.AddRow(
            (pageOffset + Table.data.Count).ToString(),
            info.RiskSourceName);
    }

}
S
Description
Xeric界面容器
Readme MIT
16 MiB
Languages
C# 98.1%
ShaderLab 1.9%