govuk components

Ruby on Rails的Gov.uk组件

该宝石为gov.uk设计系统提供了一套可重复使用的组件。它旨在为gov.uk发布组件库提供轻巧的替代品，并使用GitHub的ViewComponent Framework构建。

它旨在以一种对Rails Developers更加熟悉的方式来实现原始Nunjucks宏的功能。优先于HTML的字符串，每个组件仅是一个红宝石对象，一切都是可继承且无法润湿的。

文档

该宝石带有完整的指南，涵盖了日常使用的大多数方面，以及代码和输出示例。指南中的示例（以及指南本身）是使用组件构建的，因此它将始终是最新的。

包括什么？

该库中的所有非格式组件都作为视图组件实现。表单组件由gov.uk表单构建器实现。

提供的组件是：

• 手风琴
• 返回链接
• 面包屑
• 饼干横幅
• 细节
• 退出此页面
• 页脚
• 标题
• 插图文字
• 通知横幅
• 控制板
• 分页
• 相横幅
• 部分中断
• 开始按钮
• 摘要列表
• 选项卡
• 表
• 标签
• 任务列表
• 警告文字

该库还提供了用于创建链接，按钮，跳过链接以及回到顶部链接的帮助者。

替代语法

所有组件都可以通过两种方式渲染：

• 直接使用Rails的#render方法：

    <%= render GovukComponent::WarningTextComponent.new do %>
      A serious warning
    <% end %>

• 通过助手包装器：

    <%= govuk_warning_text do %>
      A serious warning
    <% end %> 

  助手的命名约定为govuk_ ，然后在Snake Case中的组件名称。您可以在GovukComponentsHelper中查看完整列表。

示例使用

该库允许使用Rails的render方法或通过提供的助手渲染组件。在这里，我们将使用govuk_tabs渲染三个选项卡的部分：

 <%= govuk_tabs(title: 'Days of the week') do |component| %>
  <% component.with_tab(label: 'Monday') do %>
    < p > Monday’s child is fair of face </ p >
  <% end %>

  <% component . with_tab ( label : 'Tuesday' ) do %>
    < p > Tuesday’s child is full of grace </ p >
  <% end %>

  <% component . with_tab ( label : 'Wednesday' ) do %>
    < p > Wednesday’s child is full of woe </ p >
  <% end %>
<% end %>

这是渲染选项卡：

有关用法的示例，请参见“指南”页面。

设置

将此行添加到您的config/application.rb ：

 require "govuk/components" 

使用此库的服务

• 申请教师培训
• 查找研究生培训
• 获得技术帮助
• 发布教师培训课程
• 注册训练者的老师
• 教职位

叉子

• betagouvsystèmede Design del'état视图组件

安装

将此行添加到您的应用程序的gemfile：

 gem 'govuk-components'

然后执行：

bundle

或自行安装：

gem install govuk-components

贡献

最欢迎错误报告和功能请求，请提出问题或提交拉动请求。

目前，我们正在使用Govuk皮棉来确保代码符合gov.uk指南。请确保任何PRS也遵守此标准。

为了帮助保持日志清洁和整洁，请配置Git以使用您的全名：

git config --global user.name " Julius Hibbert " 

执照

根据MIT许可证的条款，该宝石可作为开源。