SuperAPI AI 工具集

build-shiny-module

编程与开发

查看项目

更新于 10-16 03:43

技能介绍

用途:把不断膨胀的 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。