view_component-contrib 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ade40aaa2e5db43b72e6ee1de31978639bd057aef496e2aa5885296b67d58ac4
-  data.tar.gz: ab518d6378b41e51fe978a50b00e22bd7e6e03231a8e93c1d1f3d1ad707f0ea4
+  metadata.gz: 3dfe8a56d9d79e6fbb11442811f68a9cdc7980c4dcbe00fdeba825a11d5124c7
+  data.tar.gz: 4ec650eab3f6c6b11ba79f598ecb79f34a3f900b44e1b6e53b55d08a9501f7aa
 SHA512:
-  metadata.gz: 15b64d686c8dd5d871c1c5b3c07adbbfa9fd4f538130df0ab4bda67cdf88f4109db386f6f311e3392a005860ea0e06115f18e1112fa536bab034ee3264acf79e
-  data.tar.gz: 32a4e8f9106866b0f49808a5b5250023d08a001ac3b1c66c66cb7971820046679570040b70e98ebdc56ad7113ce87945b59112156a3c5a941f1b022d1bc6c0bb
+  metadata.gz: 6a3f375f7e61f7b29ff6379caf4dec9d89a98226ca6c0c2bf55349e1ee3e28a6b6076840fe29a937b1700bc65546c6d946b575cc5337208a7ae49e555a75f3dc
+  data.tar.gz: e129b0af8c6f11b979bd202e9761f2acb5dc267e895ad010043eac3a028f9a5312a3c552bfc49cac4fa173abf48b07578fc017ea126162ee017739b8de1a3207

data/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 ## master
 
+## 0.1.5 (2023-11-02)
+
+- Support content blocks in `#render_component` and `#render_with`. ([@palkan][])
+
+```ruby
+class MyComponent::Preview
+  def default
+    # Now you can pass a block to render_component to render it inside the component:
+    render_component(kind: "info") do
+      "Welcome!"
+    end
+  end
+end
+```
+
+- Support implicit components in `#render_component` helper. ([@palkan][])
+
+```ruby
+class MyComponent::Preview
+  def default
+    # Before
+    render_component(MyComponent::Component.new(foo: "bar"))
+  end
+
+  # After
+  def default
+    render_component(foo: "bar")
+  end
+end
+```
+
 ## 0.1.4 (2023-04-30)
 
 - Fix compatibility with new errors classes in view_component.

data/README.md

@@ -47,6 +47,9 @@ bundle exec rails g view_component -h
 **Why adding a custom generator to the project instead of bundling it into the gem?** The generator could only be useful if it fits
 your project needs. The more control you have over the generator the better. Thus, the best way is to make the generator a part of a project.
 
+> [!IMPORTANT]
+> If your application has the `lib/` folder in the autoload paths, make sure you ignored the generated `lib/generators` folder. In Rails 7.1+, you can do this via adding `generators` the `config.autoload_lib` call's `ignore` option. Before, you can use `Rails.autoloaders.main.ignore(...)`.
+
 ## Organizing components, or sidecar pattern extended
 
 ViewComponent provides different ways to organize your components: putting everyhing (Ruby files, templates, etc.) into `app/components` folder or using a _sidecar_ directory for everything but the `.rb` file itself. The first approach could easily result in a directory bloat; the second is better though there is a room for improvement: we can move `.rb` files into sidecar folders as well. Then, we can get rid of the _noisy_ `_component` suffixes. Finally, we can also put previews there (since storing them within the test folder is a little bit confusing):
@@ -156,6 +159,14 @@ class Banner::Preview < ApplicationViewComponentPreview
   def default
     # This will use `absolute w-full` for the container class
     render_component Banner::Component.new(text: "Welcome!")
+
+    # or even shorter
+    render_component(text: "Welcome!")
+
+    # you can also pass a content block
+    render_component(kind: :notice) do
+      "Some content"
+    end
   end
 
   def mobile
@@ -434,6 +445,20 @@ class FlashAlert::Component < ApplicationViewComponent
 end
 ```
 
+## Supporting `.with_collection`
+
+The `.with_collection` method from ViewComponent expects a component class to have the "Component" suffix to correctly infer the parameter name. Since we're using a different naming convention, we need to specify the collection parameter name explicitly. For example:
+
+```ruby
+class PostCard::Component < ApplicationViewComponent
+  with_collection_parameter :post
+
+  option :post
+end
+```
+
+You can add this to following line to your component generator (unless it's already added): `with_collection_parameter :<%= singular_name %>` to always explicitly provide the collection parameter name.
+
 ## Wrapped components
 
 Sometimes we need to wrap a component into a custom HTML container (for positioning or whatever). By default, such wrapping doesn't play well with the `#render?` method because if we don't need a component, we don't need a wrapper.

data/app/views/view_component_contrib/preview.html.erb

@@ -1,6 +1,10 @@
 <div class="<%= container_class %>">
   <%- if component -%>
-    <%= render component %>
+    <%- if local_assigns[:content_block] -%>
+      <%= render component, &content_block %>
+    <% else %>
+      <%= render component %>
+    <% end %>
   <%- else -%>
   Failed to infer a component from the preview: <%= error %>
   <%- end -%>

data/lib/view_component_contrib/preview/base.rb

@@ -60,8 +60,14 @@ module ViewComponentContrib
       end
 
       # Shortcut for render_with_template(locals: {component: ...})
-      def render_component(component)
-        render_with(component: component)
+      def render_component(component_or_props = nil, &block)
+        component = if component_or_props.is_a?(::ViewComponent::Base)
+          component_or_props
+        else
+          self.class.name.sub(/Preview$/, "Component").constantize.new(**(component_or_props || {}))
+        end
+
+        render_with(component: component, content_block: block)
       end
     end
   end

data/lib/view_component_contrib/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ViewComponentContrib # :nodoc:all
-  VERSION = "0.1.4"
+  VERSION = "0.1.5"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: view_component-contrib
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Vladimir Dementyev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-04-30 00:00:00.000000000 Z
+date: 2023-11-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: view_component
@@ -25,7 +25,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: ruby-next
+  name: ruby-next-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -184,7 +184,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.8
+rubygems_version: 3.4.20
 signing_key:
 specification_version: 4
 summary: A collection of extensions and developer tools for ViewComponent