Dear ImGui Tables为何给子控件ID路径插额外ID？自定义控件如何实现原生ID冲突

现象描述 #

在原生ImGui中，两个使用相同ID的DragFloat控件会触发ID冲突，修改其中一个时另一个也同步更新，这是预期行为：

// ID冲突，符合预期行为
static float value1;
static float value2;

ImGui::DragFloat("##drag-float", &value1);  // 完整ID路径：.../##drag-float
ImGui::DragFloat("##drag-float", &value2);  // 完整ID路径：.../##drag-float

但将DragFloat放入两次调用的同名BeginTable中时，却未出现预期的ID冲突：

// 无ID冲突，不符合预期行为
static float table_value1;
static float table_value2;

if (ImGui::BeginTable("table", 1)) {
    ImGui::TableNextRow();
    ImGui::TableSetColumnIndex(0);
    ImGui::DragFloat("##drag-float", &table_value1); // 完整ID路径：.../table/##drag-float
    ImGui::EndTable();
}
if (ImGui::BeginTable("table", 1)) {
    ImGui::TableNextRow();
    ImGui::TableSetColumnIndex(0);
    ImGui::DragFloat("##drag-float", &table_value2);  // 完整ID路径：.../table/0x8CD5DC7A [override]/##drag-float
    ImGui::EndTable();
}

此时ImGui会在table ID与DragFloat ID之间插入类似0x8CD5DC7A [override]的额外ID。

用户希望创建基于ImGui Tables API的自定义包装控件，同时支持ImGui原生的label规则（含##时显示前缀、ID为完整字符串；含###时显示前缀、ID为后缀），但当前Table的额外ID导致相同ID的自定义控件无法触发ID冲突：

void WrapperWidget(const std::string& label, float& value) {
    std::pair<std::string, std::string> label_id_pair = extractLabelAndId(label);

    ImGui::PushID(label_id_pair.second.c_str());

    ImGui::Text(label_id_pair.first.c_str());
    ImGui::SameLine();

    if (ImGui::BeginTable("table", 1)) {
        ImGui::TableNextRow();
        ImGui::TableSetColumnIndex(0);
        ImGui::DragFloat("##drag-float", &value);  // 完整ID路径：.../table/0x8CD5DC7A [override]/##drag-float
        ImGui::EndTable();
    }

    ImGui::PopID();
}

static float value1;
static float value2;
WrapperWidget("WrapDrag1###ID", value1);
WrapperWidget("WrapDrag2###ID", value2);  // 本应与前一个控件ID相同

问题 #

1. Dear ImGui Tables为何会插入该额外ID？
2. 如何让自定义包装控件实现原生ImGui的ID冲突行为？

1. 为什么ImGui Tables会插入额外ID？ #

ImGui Tables内部会自动生成一个实例ID（即你看到的0x8CD5DC7A [override]），目的是区分同一ID下的多个独立Table实例。

当你多次调用BeginTable使用同一个ID时，ImGui默认认为你在创建多个不同的Table控件，而非同一个控件的重复渲染。为了避免这些Table内部的子控件ID冲突，它会自动插入一个全局唯一的实例ID作为ID路径的一部分，确保每个Table内部的控件都有独立的ID空间。

这个机制是Tables组件特有的，用于支持动态创建、销毁多个同名Table的场景，比如在列表中循环创建Table时不会出现内部控件ID混乱。

2. 如何让自定义包装控件实现原生ID冲突行为？ #

要让自定义控件触发预期的ID冲突，需要禁用Table的自动实例ID生成，强制让多个Table共享同一个ID空间。可以通过以下两种方式实现：

方式一：使用ImGuiTableFlags_NoKeepAliveID标志 #

在调用BeginTable时添加ImGuiTableFlags_NoKeepAliveID标志，告诉ImGui不要为这个Table生成独立的实例ID：

void WrapperWidget(const std::string& label, float& value) {
    std::pair<std::string, std::string> label_id_pair = extractLabelAndId(label);

    ImGui::PushID(label_id_pair.second.c_str());

    ImGui::Text(label_id_pair.first.c_str());
    ImGui::SameLine();

    // 添加NoKeepAliveID标志，禁用自动实例ID
    if (ImGui::BeginTable("table", 1, ImGuiTableFlags_NoKeepAliveID)) {
        ImGui::TableNextRow();
        ImGui::TableSetColumnIndex(0);
        ImGui::DragFloat("##drag-float", &value);  // 完整ID路径：.../table/##drag-float
        ImGui::EndTable();
    }

    ImGui::PopID();
}

此时，两个WrapperWidget调用中的Table会共享同一个ID路径，内部的DragFloat就会触发预期的ID冲突。

方式二：手动控制Table的ID #

如果需要更精细的控制，可以手动为Table指定与外层一致的ID，替代自动生成的实例ID。比如直接使用PushID传入的ID作为Table的ID：

void WrapperWidget(const std::string& label, float& value) {
    std::pair<std::string, std::string> label_id_pair = extractLabelAndId(label);
    const char* widget_id = label_id_pair.second.c_str();

    ImGui::PushID(widget_id);

    ImGui::Text(label_id_pair.first.c_str());
    ImGui::SameLine();

    // 使用widget_id作为Table的ID，确保多个实例共享同一ID空间
    if (ImGui::BeginTable(widget_id, 1)) {
        ImGui::TableNextRow();
        ImGui::TableSetColumnIndex(0);
        ImGui::DragFloat("##drag-float", &value);  // 完整ID路径：.../[widget_id]/##drag-float
        ImGui::EndTable();
    }

    ImGui::PopID();
}

这种方式下，Table的ID与外层PushID的ID一致，内部控件的ID路径完全相同，自然会触发ID冲突。

注意：禁用Table的自动实例ID后，如果你在同一个ID路径下创建多个Table，它们的状态（比如列宽、排序）会共享，这是符合原生ImGui ID冲突的预期行为的。

内容的提问来源于stack exchange，提问作者roniabusayeed