html_tags 0.1.183

data/lib/html_tags/individual_tags/ins.rb

@@ -0,0 +1,102 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags 
+
+  require 'html_tags/closing_tag/closing_tag.rb'
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.ins
+  # ========================================================================= #
+  def self.ins(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = '',
+      &block
+    )
+    the_opening_tag = nil
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      if i.is_a?(String) and i.empty?
+        i = { text: i }
+        i.update(yielded)
+      end
+    end
+    if i.is_a? Hash
+      # ===================================================================== #
+      # === :css_class
+      # ===================================================================== #
+      if i.has_key? :css_class
+        css_class = i.delete(:css_class)
+      end
+      # ===================================================================== #
+      # === :id
+      # ===================================================================== #
+      if i.has_key? :id
+        the_id = i.delete(:id)
+      # ===================================================================== #
+      # === :the_id
+      # ===================================================================== #
+      elsif i.has_key? :the_id
+        the_id = i.delete(:the_id)
+      end
+      # ===================================================================== #
+      # === :text
+      #
+      # This should come last as it nullifies the variable i.
+      # ===================================================================== #
+      if i.has_key? :text
+        i = i.delete(:text).to_s
+      end
+    end
+    # ======================================================================= #
+    # === the_opening_tag
+    #
+    # We have to get a reference to the opening tag early on, so that we
+    # can add e. g. "onClick" to it.
+    # ======================================================================= #
+    if the_opening_tag.nil?
+      the_opening_tag = opening_tag(__method__, css_class, the_id, css_style, javascript) { :no_newline }
+    end
+    return HtmlTags.add(
+      the_opening_tag+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === ins
+  # ========================================================================= #
+  def ins(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = '',
+      &block
+    )
+    ::HtmlTags.ins(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript,
+      &block
+    )
+  end
+   
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e 'This cat '+HtmlTags.ins('abc def ghi')+' is a super cat.'
+end

data/lib/html_tags/individual_tags/kbd.rb

@@ -0,0 +1,109 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.kbd
+  # ========================================================================= #
+  def self.kbd(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    # ======================================================================= #
+    # === Handle Hashes first
+    # ======================================================================= #
+    if css_class.is_a? Hash
+      # ===================================================================== #
+      # === :css_style
+      # ===================================================================== #
+      if css_class.has_key? :css_style
+        css_style = css_class.delete(:css_style)
+        if css_class.is_a?(Hash) and css_class.empty?
+          css_class = ''
+        end
+      end
+    end
+    if i.is_a? Hash
+      # ===================================================================== #
+      # Next support elements such as:
+      #   kbd(css_class: 'default') {
+      # ===================================================================== #
+      if i.has_key? :css_class
+        css_class = i.delete(:css_class)
+      end
+      # ===================================================================== #
+      # === :id
+      # ===================================================================== #
+      if i.has_key? :id
+        the_id = i.delete(:id)
+      end
+      # ===================================================================== #
+      # === :css_style
+      # ===================================================================== #
+      if i.has_key? :css_style
+        css_style = i.delete(:css_style)
+      end
+      i = '' # For now, we remove this.
+    end
+    content = i.to_s.dup
+    unless content.end_with?('%')
+      if content =~ /\d+/
+        content << '%'
+      end
+    end
+    if block_given?
+      content << yield.to_s
+    end
+    # ======================================================================= #
+    # Looks better with a newline, in my opinion:
+    # ======================================================================= #
+    content << "\n" unless content.end_with? "\n"
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style, optional_javascript)+
+      content+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === kbd
+  #
+  # This method will make a html <kbd> tag.
+  #
+  # Invocation example:
+  #
+  #   HtmlTags.kbd(i = '', css_class = '', the_id = '', css_style = '')
+  # 
+  # ========================================================================= #
+  def kbd(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = nil
+    )
+    return HtmlTags.kbd(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.kbd('Ctrl C')
+end

data/lib/html_tags/individual_tags/keygen.rb

@@ -0,0 +1,90 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# The <keygen> tag is typically found in the <form> tag.
+# =========================================================================== #
+# require 'html_tags/individual_tags/keygen.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.keygen
+  # ========================================================================= #
+  def self.keygen(
+      i                   = {},
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    # ======================================================================= #
+    # === Handle Hashes first
+    # ======================================================================= #
+    if css_class.is_a? Hash
+      # ===================================================================== #
+      # === :css_style
+      # ===================================================================== #
+      if css_class.has_key? :css_style
+        css_style = css_class.delete(:css_style)
+        if css_class.is_a?(Hash) and css_class.empty?
+          css_class = ''
+        end
+      end
+    end
+    _ = opening_tag(__method__, css_class, the_id, css_style, optional_javascript).dup
+    # ======================================================================= #
+    # === Handle Hashes next for the i (input) argument:
+    # ======================================================================= #
+    if i.is_a? Hash
+      # ===================================================================== #
+      # === :name
+      # ===================================================================== #
+      if i.has_key? :name
+        _[-2,0] = ' name="'+i[:name]+'"'
+      end
+      # ===================================================================== #
+      # === :keytype
+      # ===================================================================== #
+      if i.has_key? :keytype
+        _[-2,0] = ' keytype="'+i[:keytype]+'"'
+      end
+    end
+    # ======================================================================= #
+    # <keygen> does not have a closing tag.
+    # ======================================================================= #
+    return HtmlTags.add(_)
+  end
+
+  # ========================================================================= #
+  # === keygen
+  # ========================================================================= #
+  def keygen(
+      i                   = {},
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    return HtmlTags.keygen(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.keygen(name: 'rsaPublicKey', keytype: 'RSA') 
+# <keygen name="rsaPublicKey" keytype="RSA">
+end

data/lib/html_tags/individual_tags/label.rb

@@ -0,0 +1,77 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.label
+  #
+  # The html <label> tag is useful to specify text before an <input>
+  # field.
+  #
+  # The <label> tag defines a label for an <input> element.
+  #
+  # The <label> element does not render as anything special for the
+  # user. However, it provides a usability improvement for mouse
+  # users, because if the user clicks on the text within the <label>
+  # element, it toggles the control.
+  #
+  # The "for" attribute of the <label> tag should be equal to the id
+  # attribute of the related element to bind them together.
+  #
+  # This may be best explained through an example:
+  #
+  #   <label for="male">Male</label>
+  #   <input type="radio" name="sex" id="male" value="male">
+  #
+  # Documentation can be seen here:
+  #
+  #   https://www.w3schools.com/tags/tag_label.asp
+  #
+  # ========================================================================= #
+  def self.label(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = ''
+    )
+    start = opening_tag(__method__, css_class, the_id, css_style)
+    for_label = i.to_s.downcase.strip # Right now the for-label is deduced from the input.
+    start[-2,0] = ' for="'+for_label+'"' # -2 because we also have a trailing newline.
+    return HtmlTags.add(
+      start+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === label
+  # ========================================================================= #
+  def label(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = nil
+    )
+    return HtmlTags.label(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.label('My savings', css_style: 'text-align: right')
+end

data/lib/html_tags/individual_tags/legend.rb

@@ -0,0 +1,48 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.legend
+  # ========================================================================= #
+  def self.legend(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = ''
+    )
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style)+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === legend
+  # ========================================================================= #
+  def legend(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = ''
+    )
+    return HtmlTags.legend(
+      i,
+      css_class,
+      the_id,
+      css_style
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.legend('My savings', css_style: 'text-align: right')
+end

data/lib/html_tags/individual_tags/li.rb

@@ -0,0 +1,74 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.li                                                  (li tag)
+  #
+  # This is essentially a HTML representation for the <li> tag.
+  #
+  # The first input argument to this method will constitute the content
+  # of said <li> tag. Note that the block form to li {} can also be
+  # used for content, so use whichever way you prefer.
+  # ========================================================================= #
+  def self.li(
+      i                   = '', # <- This is the content.
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    if i.is_a? Hash
+      # === :css_class
+      if i.has_key? :css_class
+        css_class = i.delete(:css_class)
+      end
+      i = ''
+    end
+    i = i.to_s.dup # And avoid frozen-errors.
+    # ======================================================================= #
+    # Blocks will be assumed to be used for the first argument, `i`.
+    # ======================================================================= #
+    if block_given?
+      i << yield.to_s
+    end
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style, optional_javascript)+
+      i+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === li
+  # ========================================================================= #
+  def li(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    return HtmlTags.li(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      optional_javascript,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.li('My savings')
+end

data/lib/html_tags/individual_tags/link.rb

@@ -0,0 +1,58 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/link.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.link
+  #
+  # The job of this method is to create a String such as:
+  #
+  #   <link rel="stylesheet" href="styles.css">
+  #
+  # Note that normally the link-HTML tag comes in between the <head> tag.
+  #
+  # The second argument, `rel`, can be any of the following:
+  #
+  #   alternate, author, dns-prefetch, help, icon, license, next, pingback,
+  #   preconnect, prefetch, preload, prerender, prev, search, stylesheet
+  #
+  # The default is 'stylesheet', as that is the most commonly used variant
+  # for the <link> tag.
+  # ========================================================================= #
+  def self.link(
+      href   = '',
+      rel    = 'stylesheet'
+    )
+    _ = opening_tag(__method__).dup
+    if rel
+      _[-2,0] = ' rel="'+rel+'"' 
+    end
+    if href
+      _[-2,0] = ' href="'+href+'"' 
+    end
+    return HtmlTags.add(_)
+  end
+
+  # ========================================================================= #
+  # === link
+  # ========================================================================= #
+  def link(
+      href   = '',
+      rel    = ''
+    )
+    return HtmlTags.link(href, rel)
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.link('styles.css','stylesheet')
+end # <link rel="stylesheet" href="styles.css">

data/lib/html_tags/individual_tags/main.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  # ========================================================================= #
+  # === main
+  #
+  # Usage example:
+  #
+  #   HtmlTags.main('<h1>APP NAME</h1><nav></nav>') => '<header><h1>APP NAME</h1><nav></nav></header>'
+  #
+  # ========================================================================= #
+  def main(
+      i = '', css_class = '', the_id = '', css_style = '', &block
+    )
+    content = i.to_s
+    if block_given?
+      content = content.to_s+yield.to_s
+    end
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style)+
+      content+
+      close(__method__)
+    )
+  end
+
+end

data/lib/html_tags/individual_tags/map.rb

@@ -0,0 +1,95 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# See this API reference:
+#
+#   https://www.w3schools.com/TagS/tag_map.asp
+#
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.map                                                (map tag)
+  #
+  # An example for the usage of the map-HTML tag goes like this:
+  #
+  #   <map name="workmap">
+  #   </map>
+  #
+  # ========================================================================= #
+  def self.map(
+      i                   = '', # <- This is the content.
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    if i.is_a? Hash
+      # ===================================================================== #
+      # === :css_class
+      # ===================================================================== #
+      if i.has_key? :css_class
+        css_class = i.delete(:css_class)
+      end
+      i = ''
+    end
+    i = i.to_s.dup # And avoid frozen-errors.
+    start = opening_tag(__method__, css_class, the_id, css_style, optional_javascript)
+    # ======================================================================= #
+    # Blocks will be assumed to be used for the first argument, `i`.
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      if yielded.is_a? Hash
+        # =================================================================== #
+        # === :name
+        # =================================================================== #
+        if yielded.has_key? :name
+          start[-2,0] = ' name="'+yielded.delete(:name)+'"'
+        end
+      end
+    end
+    return HtmlTags.add(
+      start+
+      i+
+      "\n"+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === map
+  # ========================================================================= #
+  def map(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    return HtmlTags.map(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      optional_javascript,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.map('<area shape="rect" coords="34,44,270,350" alt="Computer" href="computer.htm">
+  <area shape="rect" coords="290,172,333,250" alt="Phone" href="phone.htm">
+  <area shape="circle" coords="337,300,44" alt="Cup of coffee" href="coffee.htm">') {{
+    name: 'workmap'
+  }}
+end