用途:把不断膨胀的 Shiny 应用中的可复用组件抽离为独立模块,构建可多处复用的 UI 控件,将复杂响应式逻辑封装在清晰接口之后,并用更小、可测试的单元组合出更大应用。
主要能力:定义模块接口(响应式输入、响应式输出、UI 元素);编写遵循 <name>UI 约定的 UI 函数,首参为 id,顶部创建 ns <- NS(id),所有 inputId/outputId 用 ns() 包裹,返回 tagList();编写遵循 <name>Server 约定的服务端函数,使用 moduleServer(id, function(input, output, session) {...}),动态 UI 用 session$ns,显式 return() 响应式值;将模块接入父应用并捕获返回值;嵌套模块时 UI 用 ns("inner_id")、服务端只用 "inner_id";用最小独立测试应用验证模块。
使用方式:先明确模块接收与返回的契约,再依次创建 UI 函数、服务端函数,然后在父应用 UI 中调用 dataFilterUI("filter1")、在服务端调用 dataFilterServer("filter1", data = raw_data, columns = ...) 并捕获返回的响应式;兄弟模块通过父级传递响应式对象通信,传响应式本身而非其当前值;嵌套模块按上述命名空间规则调用;最后用 shiny::shinyApp 做隔离测试。
适用场景:从增长中的 Shiny 应用抽取可复用组件、构建多处使用的 UI 控件、封装复杂响应式逻辑、由小单元组合大型应用。
限制与注意:renderUI() 内动态 UI 必须用 session$ns;随时间变化的参数须传响应式表达式;UI 与服务端 id 字符串必须一致;父级需要的结果必须 return() 响应式;嵌套模块 UI 与服务端的命名空间写法不可混用。验证清单包括:UI 首参为 id 且使用 NS(id)、所有 ID 经 ns() 包裹、服务端使用 moduleServer、动态 UI 用 session$ns、可多次实例化无 ID 冲突、返回值可被父应用访问、可在最小独立应用中运行。相关技能:scaffold-shiny-app、test-shiny-app、design-shiny-ui、optimize-shiny-performance。