govuk components
Version 5.7.1
توفر هذه الأحجار الكريمة مجموعة من المكونات القابلة لإعادة الاستخدام لنظام تصميم Gov.uk. يهدف إلى توفير بديل خفيف الوزن لمكتبة مكونات النشر Gov.uk وهو مصمم باستخدام إطار عمل Github's ViewComponent.
ويهدف إلى تنفيذ الوظائف من وحدات ماكرو نونجوكس الأصلية بطريقة ستشعر بمزيد من الدرجة لمطوري القضبان. تُفضل الكتل على سلاسل HTML ، أسفل السطح ، يكون كل مكون مجرد كائن روبي ، كل شيء قابل للوراثة وموارثة.
يأتي GEM مع دليل كامل يغطي معظم جوانب الاستخدام اليومي ، إلى جانب أمثلة الكود والإخراج. تم تصميم الأمثلة الواردة في الدليل (والدليل نفسه) باستخدام المكونات ، لذلك سيكون دائمًا محدثًا.
يتم تنفيذ جميع المكونات غير النمطية من نظام تصميم Gov.uk من قبل هذه المكتبة باعتبارها ViewComponents. يتم تنفيذ مكونات النماذج بواسطة منشئ نموذج Gov.uk.
المكونات المقدمة هي:
توفر هذه المكتبة أيضًا مساعدين لإنشاء الروابط والأزرار وتخطي الروابط والعودة إلى الروابط العليا.
يمكن تقديم جميع المكونات بطريقتين:
باستخدام طريقة #Render ' #render :
<%= render GovukComponent::WarningTextComponent.new do %>
A serious warning
<% end %>عبر غلاف المساعد:
<%= govuk_warning_text do %>
A serious warning
<% end %> اتفاقية التسمية للمساعدين هي govuk_ متبوعًا باسم المكون في حالة الأفعى. يمكنك رؤية القائمة الكاملة في GovukComponentShelper.
تتيح هذه المكتبة تقديم المكونات باستخدام طريقة render Rails أو عبر المساعدين المقدمين. سنستخدم هنا 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" أضف هذا السطر إلى Gemfile في التطبيق الخاص بك:
gem 'govuk-components'ثم تنفذ:
bundleأو تثبيته بنفسك على النحو التالي:
gem install govuk-componentsيتم الترحيب بتقارير الأخطاء وطلبات الميزات ، يرجى إثارة مشكلة أو إرسال طلب سحب.
نحن حاليًا نستخدم Govuk Lint لضمان تلبية الكود إرشادات Gov.uk. يرجى التأكد من أن أي PRS يلتزم أيضًا بهذا المعيار.
للمساعدة في الحفاظ على السجلات نظيفة ومرتبة ، يرجى تكوين git لاستخدام اسمك الكامل:
git config --global user.name " Julius Hibbert " الجوهرة متوفرة كمصدر مفتوح بموجب شروط ترخيص معهد ماساتشوستس للتكنولوجيا.
