PAYATHON 2026

shiny selectizeInput 使用颜色和符号时如何消除 undefined?

排障赵师傅

在 options$render 中补上 item 渲染函数,使用与现有 option 相同的颜色和符号 HTML,就能修复选择框里的 undefined。

option 控制下拉列表中候选项的显示,item 控制选中后输入框中的显示。只配置 option,选中项的显示方式不会改变。

为什么下拉列表正常,选择框却显示 undefined?

原代码中的 render.option 读取了 item.name 和 item.color,所以下拉列表能正常显示。

选中项没有配置 render.item,仍按默认逻辑渲染。Shiny 默认将 labelField 设为 "label",但 seldata 只有 value、name 和 color,没有 label 字段,因此读取到的标签是 undefined。具体可见 Shiny 的输入绑定源码。

返回值由 valueField 决定,因此即使显示异常,input$main_color 仍能返回正确的值。

如何修改代码?

保留现有的 render.option,添加相同内容的 render.item,并显式指定字段映射:

  • valueField = "value":使用 value 列作为返回值。
  • labelField = "name":使用 name 列作为标签字段。
  • searchField = c("name", "value"):允许通过符号或对应代码搜索。

完整示例:

library(shiny)

seldata <- data.frame(
  value = c("NT", "S", "H", "D", "C"),
  name = c("NT", "♠", "♥", "♦", "♣"),
  color = c("#00F", "#000", "#F00", "#F00", "#000"),
  stringsAsFactors = FALSE
)

ui <- fluidPage(
  selectizeInput(
    inputId = "main_color",
    label = NULL,
    choices = NULL
  ),
  verbatimTextOutput("selected_value")
)

server <- function(input, output, session) {
  updateSelectizeInput(
    session,
    inputId = "main_color",
    choices = seldata,
    selected = "NT",
    server = TRUE,
    options = list(
      valueField = "value",
      labelField = "name",
      searchField = c("name", "value"),
      render = I("{
        option: function(item, escape) {
          return '<div><span style=\"color:' +
            escape(item.color) + '\">' +
            escape(item.name) + '</span></div>';
        },
        item: function(item, escape) {
          return '<div><span style=\"color:' +
            escape(item.color) + '\">' +
            escape(item.name) + '</span></div>';
        }
      }")
    )
  )

  output$selected_value <- renderPrint({
    input$main_color
  })
}

shinyApp(ui, server)

选择红心后,选择框应显示红色的 ♥,下方输出的返回值为 "H"。渲染函数控制显示内容,valueField 控制返回值。

需要注意什么?

只设置 labelField = "name",也能解决标签字段缺失导致的 undefined,但默认选中项只显示文字或符号。要保留颜色,还需要配置 render.item。Selectize 文档说明了 option 和 item 各自的职责。

保留 render 外层的 I(),Shiny 会将其中的字符串作为 JavaScript 代码处理,参见 updateSelectizeInput() 参数说明。

这里保留 server = TRUE,以便将数据框中的多个字段传给渲染函数。Shiny 的服务端 Selectize 示例也采用了这种方式。

拼接 HTML 时继续使用 escape()。示例中的颜色是固定的十六进制值;如果颜色来自外部输入,还需要限制允许使用的颜色格式,因为 HTML 转义不会验证 CSS 值。

备注:内容仅供参考。