govuk components

Ruby on Rails의 Gov.uk 구성 요소

이 보석은 Gov.uk 설계 시스템을위한 재사용 가능한 구성 요소를 제공합니다. Gov.uk Publishing 구성 요소 라이브러리에 대한 가벼운 대안을 제공하기위한 것이며 Github의 ViewComponent 프레임 워크로 구축되었습니다.

Rails 개발자에게 더 친숙하다고 느낄 수있는 원래 Nunjucks 매크로에서 기능을 구현하는 것을 목표로합니다. 표면 아래에서 블록은 HTML의 문자열보다 선호됩니다. 각 구성 요소는 단지 루비 객체 일 뿐이며 모든 것이 상속 될 수 있고 재정의 가능합니다.

선적 서류 비치

보석에는 코드 및 출력 예제와 함께 일상적인 사용의 대부분의 측면을 다루는 전체 가이드가 제공됩니다. 가이드 (및 가이드 자체)의 예제는 구성 요소를 사용하여 구축되므로 항상 최신 상태가됩니다.

포함 된 것은 무엇입니까?

gov.uk 설계 시스템의 모든 비 형식 구성 요소는이 라이브러리에서 ViewComponents로 구현됩니다. 양식 구성 요소는 gov.uk 양식 빌더에 의해 구현됩니다.

제공된 구성 요소는 다음과 같습니다.

• 아코디언
• 뒤로 링크
• 빵 부스러기
• 쿠키 배너
• 세부
• 이 페이지를 종료하십시오
• 보행인
• 헤더
• 삽입 된 텍스트
• 알림 배너
• 패널
• 쪽수 매기기
• 단계 배너
• 섹션 브레이크
• 시작 버튼
• 요약 목록
• 탭
• 테이블
• 태그
• 작업 목록
• 경고 텍스트

이 라이브러리는 또한 링크, 버튼, 링크 건너 뛰기 및 상단 링크로 돌아가는 도우미를 제공합니다.

대체 구문

모든 구성 요소는 두 가지 방식으로 렌더링 할 수 있습니다.

• Rails의 #render 메소드를 직접 사용하여 :

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

• 헬퍼 래퍼를 통해 :

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

  헬퍼를위한 명명 대회는 govuk_ 이며 뱀 케이스에서 구성 요소의 이름이 뒤 따릅니다. 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" 

이 라이브러리를 사용하는 서비스

• 교사 훈련을 신청하십시오
• 대학원 교사 훈련을 찾으십시오
• 기술에 대한 도움을 받으십시오
• 교사 훈련 과정을 게시하십시오
• 연수생 교사를 등록하십시오
• 공석 교육

포크

• Betagouv Système de Design de l 'état보기 구성 요소

설치

이 라인을 응용 프로그램의 보석에 추가하십시오.

 gem 'govuk-components'

그런 다음 실행 :

bundle

또는 직접 설치하십시오.

gem install govuk-components

기여

버그 보고서 및 기능 요청이 가장 환영합니다. 문제를 제기하거나 풀 요청을 제출하십시오.

현재 우리는 코드가 gov.uk 지침을 충족하도록하기 위해 Govuk Lint를 사용하고 있습니다. PR 이이 표준에도 준수하는지 확인하십시오.

통나무를 깨끗하고 깔끔하게 유지하려면 전체 이름을 사용하도록 GIT를 구성하십시오.

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

특허

보석은 MIT 라이센스의 조건에 따라 오픈 소스로 제공됩니다.