philiprehberger-html_builder 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a1603e5f6aca91335bcd511801b9bf397d9dfc1b003f96113991639b5a36133
-  data.tar.gz: 3ec0488c7996705017a7d33cf53a0b1828557b602efbf312d271f5e6b062f99e
+  metadata.gz: c951cd5a9e74ab6642a9181b01235a4a5a63b39015fd05cf5c41ab0157bc6106
+  data.tar.gz: ab129d21a86612912a83f460cd49424b4005ac95fe6f7c8c6471f3f5309a6640
 SHA512:
-  metadata.gz: 7694f0a5189a3f0fb4bfe1eac88edc7ef971ab6d48c21d280eb26d7bbd9d0048728effe37f89c14ec770296def739a12ac2c4d65ecef97502dba9924f3226765
-  data.tar.gz: f156d490b18bf1a1db8010064e0d2fd83887b7928faf24558290844b27189e40aa23132adf8984e9f7481348702df825cd616bba6c4b956884c6c170175c74af
+  metadata.gz: c6ceba75c99ca6620ba8434521b02703cb42d0113f662fe0789928dec1b1e38f4e3057c4fd44495eefd30bd53d08127d6b95daa470e4d67bf15ed56f61e085a9
+  data.tar.gz: c70fd51be8e402a223a7a1114a0f0950dd66267f2cf20506a1437a32905ba3185634a980fa314fd9785c985600a947890e05768b35dccdaabdbb40a395cb0191

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-04-15
+
+### Added
+- `list(items, ordered: false, **attrs, &block)` helper for building `<ul>` or `<ol>` lists from an array of items with optional custom rendering via block
+
 ## [0.4.0] - 2026-04-15
 
 ### Added

data/README.md

@@ -142,6 +142,27 @@ Philiprehberger::HtmlBuilder.build do
 end
 ```
 
+### Lists
+
+Build `<ul>` or `<ol>` lists from an array of items. Items are text-escaped by default. Pass `ordered: true` for an ordered list. Use a block for custom rendering of each item:
+
+```ruby
+Philiprehberger::HtmlBuilder.build do
+  list(%w[Apple Banana Cherry])
+end
+# => '<ul><li>Apple</li><li>Banana</li><li>Cherry</li></ul>'
+
+Philiprehberger::HtmlBuilder.build do
+  list(%w[First Second], ordered: true, class: 'steps')
+end
+# => '<ol class="steps"><li>First</li><li>Second</li></ol>'
+
+Philiprehberger::HtmlBuilder.build do
+  list(%w[Alice Bob]) { |name| strong name }
+end
+# => '<ul><li><strong>Alice</strong></li><li><strong>Bob</strong></li></ul>'
+```
+
 ### CSS Class Helpers
 
 Build conditional CSS class strings from mixed arguments. Strings are included as-is, hash keys are included when their value is truthy:
@@ -274,6 +295,7 @@ Philiprehberger::HtmlBuilder.merge(header, body, footer)
 | `Builder#textarea_field(name, content, label_text:, **attrs)` | Build a label + textarea |
 | `Builder#hidden_field(name, value)` | Generate a hidden input element |
 | `Builder#submit(text, **attrs)` | Generate a submit button (default text "Submit") |
+| `Builder#list(items, ordered:, **attrs, &block)` | Build a `<ul>` or `<ol>` from an array of items |
 | `Builder#class_names(*args)` | Build a conditional CSS class string from strings and hashes |
 | `Builder#cache(key) { ... }` | Cache rendered block output by key; return cached HTML on repeat calls |
 | `Escape.html(value)` | Escape HTML special characters in a string |

data/lib/philiprehberger/html_builder/builder.rb

@@ -216,6 +216,26 @@ module Philiprehberger
         button(text, type: 'submit', **attrs)
       end
 
+      # Build a list (ul or ol) from an array of items
+      #
+      # @param items [Array] the list items
+      # @param ordered [Boolean] use ol instead of ul (default false)
+      # @param attrs [Hash] additional attributes for the list element
+      # @yield [item] optional block for custom rendering of each item
+      # @return [Node]
+      def list(items, ordered: false, **attrs, &block)
+        tag_name = ordered ? :ol : :ul
+        send(tag_name, **attrs) do
+          items.each do |item|
+            if block
+              li { block.call(item) }
+            else
+              li item.to_s
+            end
+          end
+        end
+      end
+
       # Build a space-joined CSS class string from mixed arguments
       #
       # Strings are included as-is. Hash keys are included when their value is truthy.

data/lib/philiprehberger/html_builder/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module HtmlBuilder
-    VERSION = '0.4.0'
+    VERSION = '0.5.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-html_builder
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-15 00:00:00.000000000 Z
+date: 2026-04-16 00:00:00.000000000 Z
 dependencies: []
 description: Build HTML programmatically using a clean tag DSL with nested blocks,
   automatic content escaping, void element support, and attribute hashes.