9 | {% include toc.html %}
10 |
11 |
12 |
16 |
13 | {{ content }}
14 |
15 | , which is mapped to `para`. 40 | 41 | JavaScript can be included by using `script { raw ... }` 42 | 43 | To include text that is not immediately part of a tag use `text_node`. 44 | 45 | ### Components 46 | 47 | Arbre DSL can be extended by defining new tags composed of other, simpler tags. 48 | This provides a simpler alternative to nesting partials. 49 | The recommended approach is to subclass Arbre::Component and implement a new builder method. 50 | 51 | The builder_method defines the method that will be called to build this component 52 | when using the DSL. The arguments passed into the builder_method will be passed 53 | into the #build method for you. 54 | 55 | For example: 56 | 57 | ```ruby 58 | class Panel < Arbre::Component 59 | builder_method :panel 60 | 61 | def build(title, attributes = {}) 62 | super(attributes) 63 | 64 | h3(title, class: "panel-title") 65 | end 66 | end 67 | ``` 68 | 69 | By default, components are `div` tags. This can be overridden by redefining the `tag_name` method. 70 | 71 | Several examples of Arbre components are [included in Active Admin](https://activeadmin.info/12-arbre-components.html) 72 | 73 | ### Contexts 74 | 75 | An [Arbre::Context](http://www.rubydoc.info/gems/arbre/Arbre/Context) is an object in which Arbre DSL is interpreted, providing a root for the Ruby DOM that can be [searched and manipulated](http://www.rubydoc.info/gems/arbre/Arbre/Element). A context is automatically provided when a `.arb` template or partial is loaded. Contexts can be used when developing or testing a component. Contexts are rendered by calling to_s. 76 | 77 | ```ruby 78 | html = Arbre::Context.new do 79 | panel "Hello World", class: "panel", id: "my-panel" do 80 | span "Inside the panel" 81 | text_node "Plain text" 82 | end 83 | end 84 | 85 | puts html.to_s # => 86 | ``` 87 | 88 | ```html 89 |
Hello from a partial
78 |Hello from an erb partial
88 |Hello from an erb partial
2 | -------------------------------------------------------------------------------- /spec/spec_helper.rb: -------------------------------------------------------------------------------- 1 | # frozen_string_literal: true 2 | 3 | if ENV.fetch('COVERAGE', false) 4 | require 'simplecov' 5 | require 'simplecov-cobertura' 6 | SimpleCov.start do 7 | add_filter %r{^/spec/} 8 | minimum_coverage 90 9 | maximum_coverage_drop 0.2 10 | formatter SimpleCov::Formatter::CoberturaFormatter 11 | end 12 | end 13 | 14 | require 'support/bundle' 15 | require 'combustion' 16 | require 'arbre' 17 | 18 | def arbre(&block) 19 | Arbre::Context.new assigns, helpers, &block 20 | end 21 | -------------------------------------------------------------------------------- /spec/support/bundle.rb: -------------------------------------------------------------------------------- 1 | # frozen_string_literal: true 2 | $LOAD_PATH.unshift(File.expand_path("../../", __FILE__)) 3 | 4 | require "bundler" 5 | Bundler.setup 6 | --------------------------------------------------------------------------------