ITADN
rstudio/bslib
README.md
以下内容由 AI 翻译,如有问题请点此提交 issue 反馈

bslib

CRAN
status bslib status
badge R build
status

The bslib R 包为 ShinyR Markdown 提供了一个基于 Bootstrap 的现代 UI 工具包。它支持:

  • 创建令人愉悦且可定制的 Shiny 仪表板
    • 底层 UI 组件(例如 卡片数值 框侧边栏、 等)也设计为可在其他上下文中使用(例如在 R Markdown 中)。
  • 自定义 主题 设置 Shiny 应用和 R Markdown 文档。
    • 应用甚至可以实时交互式地设置主题。
  • 使用现代版本的 Bootstrap 和 Bootswatch
    • Shiny 和 R Markdown 目前默认使用 Bootstrap 3,并且 可能会继续这样做以维护向后兼容性。

安装

按以下方式从 CRAN 安装 bslib 包:

install.packages("bslib")

示例

查看 {bslib} 功能的最快方法是在控制台中运行 bslib::bs_theme_preview()。这将启动一个演示应用, 其中包含 {bslib}{shiny} UI 组件,以及一个 叠加在应用上的主题设置小部件(bslib::bs_themer())。请参阅 实时 主题设置 以了解更多信息。

An animation showing bslib theming app. As the user changes the Bootswatch theme and Bootstrap settings, the app's appearance changes in real-time.

入门

由于 {bslib} 涵盖了广泛的应用场景,因此有许多入门 文章,每篇都专注于特定的兴趣点:

获取帮助

获取 bslib 帮助的两个主要途径是:

  • RStudio 社区 是一个友好的地方, 可以提出任何问题(创建主题时请务必添加 bslib 标签)。

  • Stack Overflow 是 常见 bslib 问题答案的绝佳来源。一旦你创建了一个可复现的示例 来说明你的问题,它也是一个获取帮助的绝佳场所。如果你 提问,请使用标签 [r][bslib]。如果你使用的是 Shiny 运行时,请添加标签 [bslib]

行为准则

请注意,bslib 项目发布时附带了贡献者行为 准则。 通过为该项目做出贡献,你同意遵守其条款。