bullet_train-themes-light 1.5.1 → 1.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5406556a62531e9774a94096ca32c05fcaf5cb65d08c6cd58a930f832192529
-  data.tar.gz: d58b25628453a6808437a1b4905bf192e13cfc4926d3ad570cc0b56340db5ef3
+  metadata.gz: 89d8d353ebbebe4d434daa7ce82098c4719caf9cacece1f0a059b3cfb6ae3dc6
+  data.tar.gz: 6723e251304aee89039b63cdbf5d7a06bb3b6d56e59e02a8cef2369b267bb08b
 SHA512:
-  metadata.gz: be6114a7645236ea77d635587a14a9e7aa2f8983c018a720d0a31f491b719f1f9721bedfe2a09456f1d84cc35ecbb59e1cf8b74fe5379e74e4a92c72a7ce73c0
-  data.tar.gz: 53ffafd2d0b9749e64964cadb05efa8aca4b89e0a0c76ad2ad7c845a34b7927fd1f01f11c8098ceed38fb127ff2ad99b7685070ae840139078c5103752deb9c5
+  metadata.gz: d1126a39d7d33624ff8a664389880f028b406bd92151647ae084a14358432513ccb2f73a6bd0f9e9d8767adf30cb8c76b530f3a5014c017bb19c3257bdddca47
+  data.tar.gz: '06670948f0906c2405f0b58893f3ef746d44f7d8e32e8056df27da69b4d14a12bf6247fc18b67af66dd633dee7e8ee349ff4717b2bbb3428d149a62f557f1d50'

data/app/views/showcase/previews/field_partials/_address_field.html.erb

@@ -0,0 +1,22 @@
+<% showcase.description do %>
+  When you're building forms, use Bullet Train's Field Partials for your form fields. They DRY-up all the presentation logic without needing a third-party dependency like Formtastic.
+  <br/>
+  <br/>
+  Read much more about them in the extensive <a href="https://bullettrain.co/docs/field-partials" target="_blank">developer documentation</a>.
+<% end %>
+
+<% form_with model: Scaffolding::CompletelyConcrete::TangibleThing.new, url: "#" do |form| %>
+  <%
+    form.object.address_value = Address.new
+  %>
+
+  <% showcase.sample "Basic" do %>
+    <%= render 'shared/fields/address_field', form: form, method: :address_value %>
+  <% end %>
+<% end %>
+
+<%# To display further options use `showcase.options.x` as options with a block will clear the old options. See `_options.html.erb` for an example. %>
+<% showcase.options do |o| %>
+  <% o.required :form, "Reference to the form object", type: "ActionView::Helpers::FormBuilder" %>
+  <% o.required :method, "Attribute of the model" %>
+<% end %>

data/app/views/showcase/previews/field_partials/_dependent_fields_frame.html.erb

@@ -0,0 +1,45 @@
+<% showcase.description do %>
+  Follows the <a href="/docs/field-partials/dynamic-forms-dependent-fields.md" target="_blank">Dependent Fields Pattern (See developer documentation)</a> to display form fields that depend on the value of another field.
+<% end %>
+
+<% form_with model: Scaffolding::CompletelyConcrete::TangibleThing.new, url: "#" do |form| %>
+  <%
+    form.object.boolean_button_value = false
+  %>
+
+  <% showcase.sample "Basic" do %>
+    <%# here we're wrapping the field to trap the `change` event %>
+    <%= tag.div data: {
+        'controller': "dependable",
+        'action': 'change->dependable#updateDependents',
+        'dependable-dependents-selector-value': "##{form.field_id(:button, :dependent_fields)}"
+      } do %>
+      <%= render "shared/fields/buttons",
+        form: form,
+        method: :boolean_button_value,
+        other_options: { label: "Should I present more fields?" } %>
+    <% end %>
+    
+    <%= render "shared/fields/dependent_fields_frame",
+        id: form.field_id(:button, :dependent_fields),
+        form: form,
+        dependable_fields: [:boolean_button_value] do %>
+
+      <div class="my-3">
+        <% if form.object.boolean_button_value %>
+          <strong>More fields would be shown here.</strong>
+        <% else %>
+          <em>No fields should be shown here.</em>
+        <% end %>
+      </div>
+
+    <% end %>
+  <% end %>
+<% end %>
+
+<%# To display further options use `showcase.options.x` as options with a block will clear the old options. See `_options.html.erb` for an example. %>
+<% showcase.options do |o| %>
+  <% o.required :id, "id of the turbo_frame element" %>
+  <% o.required :form, "Reference to the form object", type: "ActionView::Helpers::FormBuilder" %>
+  <% o.required :dependable_fields, "Attributes of the model for the fields on whose values this frame depends", type: "Array" %>
+<% end %>

data/app/views/showcase/previews/field_partials/attribute_partials/_about_attribute_partials.html.erb

@@ -0,0 +1,15 @@
+<% showcase.description do %>
+  Attribute partials are used to display a single attribute of a model, within an `index` table colum or the resource's `show` screen.
+
+  Read more about them and about the form field partials in the extensive <a href="https://bullettrain.co/docs/field-partials" target="_blank">developer documentation</a>.
+<% end %>
+
+<%= partial.body.optional.yield Scaffolding::CompletelyConcrete::TangibleThing.new %>
+
+
+<%# To display further options use `showcase.options.x` as options with a block will clear the old options. See `_options.html.erb` for an example. %>
+<% showcase.options do |o| %>
+  <% o.required :object, "Reference to the model object", type: "Object" %>
+  <% o.required :attribute, "Attribute of the model" %>
+  <%= partial.options.optional.yield o %>
+<% end %>

data/app/views/showcase/previews/field_partials/attribute_partials/_address.html.erb

@@ -0,0 +1,24 @@
+<%= render "showcase/previews/field_partials/attribute_partials/about_attribute_partials", showcase: showcase do |partial| %>
+  <% partial.body do |object| %>
+    <% object.address_value = Address.new(
+        country_id: 233,
+        address_one: "2800 East Observatory Road",
+        city: "Los Angeles",
+        region_id: 1416,
+        postal_code: "90027"
+      )
+    %>
+
+    <% showcase.sample "Multi-line" do %>
+      <%= render 'shared/attributes/address', object: object, attribute: :address_value %>
+    <% end %>
+
+    <% showcase.sample "One-line" do %>
+      <%= render 'shared/attributes/address', object: object, attribute: :address_value, one_line: true %>
+    <% end %>
+  <% end %>
+
+  <% partial.options do |o| %>
+    <% o.optional :one_line, "Render into a single line", type: "Boolean" %>
+  <% end %>
+<% end %>

data/lib/bullet_train/themes/light/version.rb

@@ -1,7 +1,7 @@
 module BulletTrain
   module Themes
     module Light
-      VERSION = "1.5.1"
+      VERSION = "1.5.2"
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bullet_train-themes-light
 version: !ruby/object:Gem::Version
-  version: 1.5.1
+  version: 1.5.2
 platform: ruby
 authors:
 - Andrew Culver
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-02 00:00:00.000000000 Z
+date: 2023-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: standard
@@ -133,11 +133,13 @@ files:
 - app/javascript/application.light.js
 - app/views/showcase/engine/_head.html.erb
 - app/views/showcase/previews/field_partials/_about_field_partials.erb
+- app/views/showcase/previews/field_partials/_address_field.html.erb
 - app/views/showcase/previews/field_partials/_buttons.html.erb
 - app/views/showcase/previews/field_partials/_cloudinary_image.html.erb
 - app/views/showcase/previews/field_partials/_color_picker.html.erb
 - app/views/showcase/previews/field_partials/_date_and_time_field.html.erb
 - app/views/showcase/previews/field_partials/_date_field.html.erb
+- app/views/showcase/previews/field_partials/_dependent_fields_frame.html.erb
 - app/views/showcase/previews/field_partials/_email_field.html.erb
 - app/views/showcase/previews/field_partials/_emoji_field.html.erb
 - app/views/showcase/previews/field_partials/_file_field.html.erb
@@ -149,6 +151,8 @@ files:
 - app/views/showcase/previews/field_partials/_text_area.html.erb
 - app/views/showcase/previews/field_partials/_text_field.html.erb
 - app/views/showcase/previews/field_partials/_trix_editor.html.erb
+- app/views/showcase/previews/field_partials/attribute_partials/_about_attribute_partials.html.erb
+- app/views/showcase/previews/field_partials/attribute_partials/_address.html.erb
 - app/views/showcase/previews/partials/_alert.html.erb
 - app/views/showcase/previews/partials/_box.html.erb
 - app/views/showcase/previews/partials/_breadcrumb.html.erb