bulma-phlex 0.5.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b94a61e80c3da2fb0b776323e40e381322aab22eb9e6fa9493d495d21df8f30
-  data.tar.gz: 8650e8b839631a6e642eb0e04ca33178f67006cdb848144d33f1e32359242653
+  metadata.gz: 5caa2176372f45d0002153e7a4272e79bd3ae01eb530e58c16a29864a3e90c09
+  data.tar.gz: 4ed606f6cb03296a7c0c52eccbe2e31bb2c7eb1c0e2fbbaef1510f8ad8f7d48f
 SHA512:
-  metadata.gz: b7dfa409bfa0380dfa15ca8a2d2e0a58b904fb3e75415a497c15e0276f7422a4e5425044421b99545a3decfedaa7dc8f76b342a2addcb56020165aca309671d6
-  data.tar.gz: 7096d053b2c05c2da6ec7306bc4b4fe469d2e8ce4ab5fbf924b756c0b4962831e496e6d2c03ea3ea8ce6f5b46f5ce67cc950a8575fbda17a53537435eb208ceb
+  metadata.gz: 2d3173c063bb8fc27fa653b34a2f4a57d6b653c313361d1bd1661d13feb760a31e5f8a102407a4024c5e48671031ae5d1b11b6d3414d38b17a3d43d38b2c3918
+  data.tar.gz: 9ec45c90c5060eb1d812d939ae03687c1027ed49c3959bf3f8855216c4e331c7ebb221f4a46903022a0a0d753cebab4a9ff0465528b5dfa424ce37e9b6b7340e

data/README.md

@@ -75,9 +75,18 @@ Bulma::Card() do |card|
   card.content do
     "This is some card content"
   end
+  card.footer_link("View", "/view", target: "_blank")
+  card.footer_link("Edit", "/edit", class: "has-text-primary")
 end
 ```
 
+**Arguments for `footer_link`:**
+
+- text: the link text
+- href: passed to the anchor's `href` attribute
+- Any additional HTML attributes can be passed as keyword arguments.
+
+
 #### Rails Feature: Turbo Frame Content
 
 When the `turbo-rails` and `phlex-rails` gems are installed, the Card component also provides method `turbo_frame_content`, which allows the content to be deferred to a turbo frame. The method accepts the same parameters as [the Turbo Rails helper method `turbo_frame_tag`](https://github.com/hotwired/turbo-rails?tab=readme-ov-file#decompose-with-turbo-frames), with the addition of the following two attributes:
@@ -146,7 +155,7 @@ end
 The [NavigationBar](https://bulma.io/documentation/components/navbar/) component provides a responsive navigation header with support for branding, navigation links, and dropdown menus.
 
 ```ruby
-Bulma::NavigationBar() do |navbar|
+Bulma::NavigationBar(classes: "is-primary") do |navbar|
   navbar.brand_item "My App", "/"
 
   navbar.left do |menu|
@@ -167,6 +176,14 @@ Bulma::NavigationBar() do |navbar|
 end
 ```
 
+**Constructor Keyword Arguments:**
+
+- `classes`: Additional classes to be added to the `nav` element, such as "is-primary" or "has-shadow".
+- `container`: When true, wraps the content in a Bulma container. To set a constraint, such as "is-max-desktop", pass that string instead of true. (defaults to false)
+
+> [!NOTE]  
+> Adding a container will limit the width of the Navigation Bar content according to Bulma's container rules. The background color of the navbar will still span the full width of the viewport.
+
 ### Pagination
 
 The [Pagination](https://bulma.io/documentation/components/pagination/) component provides navigation controls for paginated content, including previous/next links, page number links, and a summary of items being displayed.
@@ -243,7 +260,7 @@ The icon column is intended to show a boolean flag: a yes / no or an on / off. W
 
 - name: content for the `th` element
 - `icon_class` (keyword): the icon to show (defaults to the Font Awesome check mark: "fas fa-check")
- 
+
 ```ruby
   table.conditional_icon("Completed?", &:complete)
   table.conditional_icon("Approved?", icon_class: "fas fa-thumbs-up") { |row| row.status == "Approved" }

data/lib/bulma_phlex/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BulmaPhlex
-  VERSION = "0.5.1"
+  VERSION = "0.7.0"
 end

data/lib/components/bulma/card.rb

@@ -16,6 +16,8 @@ module Components
     #   card.content do
     #     "This is some card content"
     #   end
+    #   card.footer_link("View", "/view", target: "_blank")
+    #   card.footer_link("Edit", "/edit", class: "has-text-primary")
     # end
     # ```
     #
@@ -26,18 +28,54 @@ module Components
     # as its content. This allows for dynamic loading of card content.
     class Card < Components::Bulma::Base
       def view_template(&)
-        div(class: "card", &)
+        vanish(&)
+
+        div(class: "card") do
+          card_header
+          card_content
+          card_footer
+        end
       end
 
       def head(title, classes: nil)
-        header(class: "card-header #{classes}") do
-          p(class: "card-header-title") { plain title }
+        @header_title = title
+        @header_classes = classes
+      end
+
+      def content(&block)
+        @card_content = block
+      end
+
+      def footer_link(text, href, **html_attributes)
+        (@footer_items ||= []) << [text, href, html_attributes]
+      end
+
+      private
+
+      def card_header
+        return if @header_title.nil?
+
+        header(class: "card-header #{@header_classes}") do
+          p(class: "card-header-title") { plain @header_title }
         end
       end
 
-      def content(&)
+      def card_content
+        return if @card_content.nil?
+
         div(class: "card-content") do
-          div(class: "content", &)
+          div(class: "content") { @card_content.call }
+        end
+      end
+
+      def card_footer
+        return if @footer_items.nil? || @footer_items.empty?
+
+        footer(class: "card-footer") do
+          @footer_items.each do |text, href, html_attributes|
+            html_attributes[:class] = [html_attributes[:class], "card-footer-item"].compact.join(" ")
+            a(href:, **html_attributes) { text }
+          end
         end
       end
     end

data/lib/components/bulma/navigation_bar.rb

@@ -36,7 +36,9 @@ module Components
     # ```
     #
     class NavigationBar < Components::Bulma::Base
-      def initialize
+      def initialize(container: false, classes: "")
+        @container = container
+        @classes = classes
         @brand = []
         @left = []
         @right = []
@@ -45,11 +47,11 @@ module Components
       def view_template(&)
         vanish(&)
 
-        nav(class: "navbar is-light block",
+        nav(class: "navbar #{@classes}".rstrip,
             role: "navigation",
             aria_label: "main navigation",
             data: { controller: "bulma--navigation-bar" }) do
-          div(class: "container") do
+          optional_container do
             div(class: "navbar-brand") do
               @brand.each(&:call)
 
@@ -90,6 +92,17 @@ module Components
       def right(&block)
         @right << block
       end
+
+      private
+
+      def optional_container(&)
+        if @container
+          constraint = @container if @container.is_a?(String) || @container.is_a?(Symbol)
+          div(class: "container #{constraint}".rstrip, &)
+        else
+          yield
+        end
+      end
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bulma-phlex
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Todd Kummer