Markdown中R语言DT包筛选器不显示设置范围/值但筛选正常

在R Markdown文档中使用R语言DT包创建交互式表格，开启顶部列筛选功能后出现以下现象：

• 筛选逻辑可正常运行：支持设置数值列的筛选范围、选择分组列需要展示的内容
• 筛选输入控件显示异常：输入字段不会展示对应的范围值或选项名称，仅因子变量绑定的多选框可正常显示内容

datatable(
  DTdata,
  rownames = FALSE,
  filter = "top",
  colnames = str_replace_all(colnames(DTdata), "_", " ")
)

代码中调用str_replace_all是为了替换列名中的下划线，优化阅读体验；经多场景测试，无论是否添加这段列名替换逻辑，上述异常表现完全一致。

按优先级逐一排查即可：

1. 升级DT包到最新正式版本，版本兼容问题是该异常的最常见诱因

install.packages("DT")

2. 检查传入表格的列类型是否正确：DT会根据列类型自动匹配筛选控件的渲染逻辑，若数值列被错误识别为字符型、分类列未转为因子型，就会出现控件无提示文本的问题。可在渲染表格前显式转换列类型：

library(dplyr)
DTdata <- DTdata |>
  # 数值类列统一转为numeric格式
  mutate(across(where(is.double) | where(is.integer), as.numeric)) |>
  # 需要做多选筛选的分类列统一转为factor格式
  mutate(across(c(填入需要转因子的列名), as.factor))

3. 排查R Markdown渲染配置与自定义资源冲突：
   • 优先使用默认自包含HTML模式渲染测试，避免静态资源路径加载失败导致控件渲染不全，YAML配置参考如下：

   output:
     html_document:
       self_contained: true
   

   • 若文档加载了自定义CSS，可临时移除自定义样式后测试，部分样式规则会将筛选控件的提示文本设为与背景同色，造成“内容不显示”的假象。

内容的提问来源于stack exchange，提问作者Bálint L. Tóth