Add info on has_many association extra option (#255)

* Add info on has_many association extra option * Update docs * Add a gif * Use new gif * Update docs/3.0/associations/has_many.md Co-authored-by: Paul Bob <[email protected]> * Use new gif --------- Co-authored-by: Paul Bob <[email protected]>
avo-hq · Aug 6, 2024 · 63ca8b3 · 63ca8b3
1 parent 790c99a
commit 63ca8b3
Show file tree

Hide file tree

Showing 2 changed files with 17 additions and 0 deletions.
diff --git a/docs/3.0/associations/has_many.md b/docs/3.0/associations/has_many.md
@@ -43,6 +43,23 @@ field :members,
   as: :has_many,
   through: :memberships
 ```
+<Option name="`attach_fields`">
+
+<VersionReq version="3.11" />
+
+If you have extra fields defined in the through table and would like to display them when attaching use the `attach_fields` option.
+
+```ruby{4,5,6}
+field :patrons,
+  as: :has_many,
+  through: :patronships,
+  attach_fields: -> {
+    field :review, as: :text
+  }
+```
+
+<Image src="/assets/img/3_0/has_many/attach-fields.gif" width="600" height="338" alt="" />
+</Option>
 
 <!-- @include: ./../common/show_on_edit_common.md-->
 <!-- @include: ./../common/scopes_common.md-->

diff --git a/docs/public/assets/img/3_0/has_many/attach-fields.gif b/docs/public/assets/img/3_0/has_many/attach-fields.gif