active_html_tags 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 20be1d0b49a3501924cc532bce80310d2f3f2cbd9815ebdaf4c513fbb14bb6a4
+  data.tar.gz: 87cc98938f77d8188c7a6ccf6d20a98004c50f920913a884b8698cfb0f422a77
+SHA512:
+  metadata.gz: 24ea23e08946c99c4f51ee570f5887487ca3a14819d36dee12bc04ebd619b2ee68a53c3f0c708f84d27b81de92bbd9d56332e556d7d1b5f6f452e5e0f4fd59e4
+  data.tar.gz: 42aaf129a568fa6ed1fbd58771410e895a9d9384b68ab342929156a3b6f0455acf558da27b592ea152100336c475667f6a9ae509187071caed14ea3fc4f2bdef

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2021 Fabian
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,142 @@
+# ActiveHtmlTags
+
+A simple helper to simplify the generation of html by bringing `content_tag` to the next level.
+
+# Getting started
+
+Add the gem to your Gemfile. For the last officially released gem:
+
+```ruby
+gem 'active_html_tags'
+```
+
+Now you should be able to use any html tag as a ruby method in your views.
+
+# Usage
+
+ActiveHtmlTags is a helper to use any kind of HTML tag as a direct method instead of passing it to `content_tag`. At the same time it allows for multiple arguments to be given and for smarter options.
+
+```ruby
+# In any view using ApplicationHelper, for example in app/views/___/___.html.erb or app/views/layouts/application.html.erb
+
+<%= h1 "This is pretty awesome" %>
+<%= content_tag :h1, "compared to this" %>
+```
+
+The name mappings from html tags to method names are 1:1. Therefore you can create constructs like these:
+```ruby
+<%= div do %>
+  <%= table do %>
+    <%= tr do %>
+      <%= th "but it doesn't stop here" %>
+      <%= td do %>
+         you can make such nice tables
+      <% end %>
+    <% end %>
+    <%= tr(th("very dense tables?"), td(:yes)) %>
+  <% end %>
+
+  <%= table tr(th("complete tables?"), td(:yes)) %>
+<% end %>
+```
+
+A list of all HTML available and usable tags can be found on [w3schools - TAGs](https://www.w3schools.com/TAGs/)
+
+### Unlimited arguments
+
+Additionally the `content_tag` method signature has been improved slightly. Now it supports a list of arguments
+```ruby
+<%= h1 "This is pretty awesome", "because you can add as much as you want", small("and what you want") %>
+vs
+<%= content_tag :h1, safe_join(["this is", "not very", "sexy", content_tag(:small, "or readable")], " ") %>
+```
+
+### Advanced options for style
+
+Have you ever wondered why this happens with css? Now you don't have run into this anymore, arrays and hashes are first class citizens in ActiveHtmlTags.
+
+```ruby
+<%= span "this text is actually green", style: {color: :green}%>
+# <span style="color: green">this text is actually green</span>
+vs
+<%= content_tag :span, "this text is sadly not green", style: {color: :green}%>
+# <span style="{color: :green}">this text is sadly not green</span>
+```
+
+This allows for more complex scenarios
+```ruby
+<%= base_style = {"background-color" => "blue"} # Place this somewhere nicely to allow for compositon. %>
+
+<%= span "this text is actually green on blue", style: base_style.merge({color: :green}) %>
+# <span style="background-color: blue ; color: green">this text is actually green on blue</span>
+```
+
+Of course arrays are loved too.
+```ruby
+<% base_style = ["background-color: blue"]%>
+
+<%= span "this text is actually green on blue", style: base_style + ["color: green"] %>
+# <span style="background-color: blue ; color: green">this text is actually green on blue</span>
+```
+
+Boht arrays and hashes are joined using ` ; `
+
+### Advanced options for javascript
+
+Options will be joined using ` ; ` in case of html attributes who require javascript. A reference of these is also available here: [w3schools - HTML Attribute Reference](https://www.w3schools.com/tags/ref_attributes.asp)
+```ruby
+<%= span "don't click me", onclick: ["1 + 1", "2 + 2"] %>
+# <span onclick="1 + 1 ; 2 + 2">don't click me</span>
+```
+
+Only the values will be shown in case of hashes. This allows easier code re-use and overwriting.
+```ruby
+<%= span "don't click me", onclick: {base: "1 + 1", feature: "2 + 2"} %>
+# <span onclick="1 + 1 ; 2 + 2">don't click me</span>
+```
+
+### Advanced options for class and all other attributes
+
+In all other cases, arrays and hash values will be joined using spaces ` `. A reference of all html attributes is also available here: [w3schools - HTML Attribute Reference](https://www.w3schools.com/tags/ref_attributes.asp)
+
+```ruby
+<% current_color = good_or_bad ? "btn-primary" : "btn-default" %>
+<% current_size = nice_or_cool ? "btn-lg" : "btn-sm" %>
+<%= span "a nice bootstrap button", class: ["btn", current_state, current_size] %>
+# <span class="btn btn-primary btn-lg">a nice boostrap button</span>
+```
+
+In case of hashes, you can override values easier.
+```ruby
+<% base_button = {base: :btn, color: "btn-primary"} %>
+
+<%= span "a nice bootstrap button", class: base_button) %>
+# <span class="btn btn-primary">a nice boostrap button</span>
+
+<%= span "a nice bootstrap button", class: base_button.merge({color: "btn-danger"}) %>
+# <span class="btn btn-danger">a nice boostrap button</span>
+```
+
+## Installation
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'active_html_tags'
+```
+
+And then execute:
+```bash
+$ bundle
+```
+
+Or install it yourself as:
+```bash
+$ gem install active_html_tags
+```
+
+## Contributing
+
+Feel free to create a merge request in case of bugs, features and more.
+
+## License
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,13 @@
+require "bundler/setup"
+
+require "bundler/gem_tasks"
+
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+task default: :test

data/lib/active_html_tags/railtie.rb

@@ -0,0 +1,4 @@
+module ActiveHtmlTags
+  class Railtie < ::Rails::Railtie
+  end
+end

data/lib/active_html_tags/version.rb

@@ -0,0 +1,3 @@
+module ActiveHtmlTags
+  VERSION = '0.1.0'
+end

data/lib/active_html_tags.rb

@@ -0,0 +1,342 @@
+require "active_html_tags/version"
+require "active_html_tags/railtie"
+
+module ActiveHtmlTags
+  HTML_TAGS = [
+    :a,
+    :abbr,
+    :acronym,
+    :address,
+    :applet,
+    :area,
+    :article,
+    :aside,
+    :audio,
+    :b,
+    :base,
+    :basefont,
+    :bb,
+    :bdo,
+    :big,
+    :blockquote,
+    :body,
+    :button,
+    :canvas,
+    :caption,
+    :center,
+    :cite,
+    :code,
+    :col,
+    :colgroup,
+    :command,
+    :datagrid,
+    :datalist,
+    :dd,
+    :del,
+    :details,
+    :dfn,
+    :dialog,
+    :dir,
+    :div,
+    :dl,
+    :dt,
+    :em,
+    :embed,
+    :eventsource,
+    :fieldset,
+    :figcaption,
+    :figure,
+    :font,
+    :footer,
+    :form,
+    :frame,
+    :frameset,
+    :h1,
+    :h2,
+    :h3,
+    :h4,
+    :h5,
+    :h6,
+    :head,
+    :header,
+    :hgroup,
+    :html,
+    :i,
+    :iframe,
+    :img,
+    :input,
+    :ins,
+    :isindex,
+    :kbd,
+    :keygen,
+    :label,
+    :legend,
+    :li,
+    :link,
+    :map,
+    :mark,
+    :menu,
+    :meta,
+    :meter,
+    :nav,
+    :noframes,
+    :noscript,
+    :object,
+    :ol,
+    :optgroup,
+    :option,
+    :output,
+    :p,
+    :param,
+    :pre,
+    :progress,
+    :q,
+    :rp,
+    :rt,
+    :ruby,
+    :s,
+    :samp,
+    :script,
+    :section,
+    :select,
+    :small,
+    :source,
+    :span,
+    :strike,
+    :strong,
+    :style,
+    :sub,
+    :sup,
+    :table,
+    :tbody,
+    :td,
+    :textarea,
+    :tfoot,
+    :th,
+    :thead,
+    :time,
+    :title,
+    :tr,
+    :track,
+    :tt,
+    :u,
+    :ul,
+    :var,
+    :video,
+    :wbr,
+    :hr,
+    :br,
+    # :"!--...--",
+    # :"!doctype",
+  ]
+
+  HTML_ATTRIBUTES = {
+    accept: :default,
+    #accept-charset: :default,
+    accept_charset: :default,
+    accesskey: :default,
+    action: :default,
+    align: :default,
+    alt: :default,
+    async: :js,
+    autocomplete: :default,
+    autofocus: :default,
+    autoplay: :default,
+    bgcolor: :default,
+    border: :default,
+    charset: :default,
+    checked: :default,
+    cite: :default,
+    class: :default,
+    color: :default,
+    cols: :default,
+    colspan: :default,
+    content: :default,
+    contenteditable: :default,
+    controls: :default,
+    coords: :default,
+    data: :default,
+    #data-*: :default,
+    datetime: :default,
+    default: :default,
+    defer: :js,
+    dir: :default,
+    dirname: :default,
+    disabled: :default,
+    download: :default,
+    draggable: :default,
+    enctype: :default,
+    for: :default,
+    form: :default,
+    formaction: :default,
+    headers: :default,
+    height: :default,
+    hidden: :default,
+    high: :default,
+    href: :default,
+    hreflang: :default,
+    #http-equiv: :default,
+    http_equiv: :default,
+    id: :default,
+    ismap: :default,
+    kind: :default,
+    label: :default,
+    lang: :default,
+    list: :default,
+    loop: :default,
+    low: :default,
+    max: :default,
+    maxlength: :default,
+    media: :default,
+    method: :default,
+    min: :default,
+    multiple: :default,
+    muted: :default,
+    name: :default,
+    novalidate: :default,
+    onabort: :js,
+    onafterprint: :js,
+    onbeforeprint: :js,
+    onbeforeunload: :js,
+    onblur: :js,
+    oncanplay: :js,
+    oncanplaythrough: :js,
+    onchange: :js,
+    onclick: :js,
+    oncontextmenu: :js,
+    oncopy: :js,
+    oncuechange: :js,
+    oncut: :js,
+    ondblclick: :js,
+    ondrag: :js,
+    ondragend: :js,
+    ondragenter: :js,
+    ondragleave: :js,
+    ondragover: :js,
+    ondragstart: :js,
+    ondrop: :js,
+    ondurationchange: :js,
+    onemptied: :js,
+    onended: :js,
+    onerror: :js,
+    onfocus: :js,
+    onhashchange: :js,
+    oninput: :js,
+    oninvalid: :js,
+    onkeydown: :js,
+    onkeypress: :js,
+    onkeyup: :js,
+    onload: :js,
+    onloadeddata: :js,
+    onloadedmetadata: :js,
+    onloadstart: :js,
+    onmousedown: :js,
+    onmousemove: :js,
+    onmouseout: :js,
+    onmouseover: :js,
+    onmouseup: :js,
+    onmousewheel: :js,
+    onoffline: :js,
+    ononline: :js,
+    onpagehide: :js,
+    onpageshow: :js,
+    onpaste: :js,
+    onpause: :js,
+    onplay: :js,
+    onplaying: :js,
+    onpopstate: :js,
+    onprogress: :js,
+    onratechange: :js,
+    onreset: :js,
+    onresize: :js,
+    onscroll: :js,
+    onsearch: :js,
+    onseeked: :js,
+    onseeking: :js,
+    onselect: :js,
+    onstalled: :js,
+    onstorage: :js,
+    onsubmit: :js,
+    onsuspend: :js,
+    ontimeupdate: :js,
+    ontoggle: :js,
+    onunload: :js,
+    onvolumechange: :js,
+    onwaiting: :js,
+    onwheel: :js,
+    open: :default,
+    optimum: :default,
+    pattern: :default,
+    placeholder: :default,
+    poster: :default,
+    preload: :default,
+    readonly: :default,
+    rel: :default,
+    required: :default,
+    reversed: :default,
+    rows: :default,
+    rowspan: :default,
+    sandbox: :default,
+    scope: :default,
+    selected: :default,
+    shape: :default,
+    size: :default,
+    sizes: :default,
+    span: :default,
+    spellcheck: :default,
+    src: :default,
+    srcdoc: :default,
+    srclang: :default,
+    srcset: :default,
+    start: :default,
+    step: :default,
+    style: :style,
+    tabindex: :default,
+    target: :default,
+    title: :default,
+    translate: :default,
+    type: :default,
+    usemap: :default,
+    value: :default,
+    width: :default,
+    wrap: :default,
+  }
+
+  HTML_TAGS.each do |tagname|
+    define_method tagname do  |*args, safe_join_with: " ", **opts, &blk|
+      opts.each do |key,value|
+        case HTML_ATTRIBUTES[key]
+        when :default
+          case opts[key]
+          when nil, String #fastpath
+          when Hash
+            opts = opts.merge(key => safe_join(opts[key].values, " "))
+          when Array
+            opts = opts.merge(key => safe_join(opts[key].map(&:to_s), " "))
+          end
+        when :style
+          case opts[:style]
+          when nil, String #fastpath
+          when Hash
+            opts = opts.merge(style: safe_join(opts[:style].map {|key,value| safe_join([key, value], ": ")}, " ; "))
+          when Array
+            opts = opts.merge(style: safe_join(opts[:style].map(&:to_s), " ; "))
+          end
+        when :js
+          case opts[key]
+          when nil, String # fastpath
+          when Hash
+            opts = opts.merge(key => safe_join(opts[key].values.flatten, " ; "))
+          when Array
+            opts = opts.merge(key => safe_join(opts[key].flatten.map(&:to_s), " ; "))
+          end 
+        end
+      end
+      content_tag(tagname, safe_join(args.flatten, safe_join_with), **opts, &blk)
+    end
+  end
+end
+
+ActiveSupport.on_load(:action_controller) do
+  ActionController::Base.helper ActiveHtmlTags
+end

data/lib/tasks/active_html_tags_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :active_html_tags do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: active_html_tags
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Fabian stillhart
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2021-10-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 6.1.4.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 6.1.4.1
+description: Annoyed to write content_tag(:span, 'LOL')? Just use the new helpers
+  as follows span('lol') to avoid writing to much code while having the safety of
+  rails.
+email:
+- fabian_stillhart@hotmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- lib/active_html_tags.rb
+- lib/active_html_tags/railtie.rb
+- lib/active_html_tags/version.rb
+- lib/tasks/active_html_tags_tasks.rake
+homepage: https://github.com/stillhart/active_html_tags
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/stillhart/active_html_tags
+  source_code_uri: https://github.com/stillhart/active_html_tags
+  changelog_uri: https://github.com/stillhart/active_html_tags
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.3
+signing_key: 
+specification_version: 4
+summary: A simple helper to bring content_tag to the next level
+test_files: []