html_tags 0.1.183

data/lib/html_tags/individual_tags/caption.rb

@@ -0,0 +1,107 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# See:
+#
+#   https://www.w3schools.com/tags/tag_caption.asp
+#
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.caption
+  # ========================================================================= #
+  def self.caption(
+      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:
+      #   progress(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
+
+  # ========================================================================= #
+  # === caption
+  # ========================================================================= #
+  def caption(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = nil
+    )
+    return HtmlTags.caption(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.caption('My savings', css_style: 'text-align: right')
+end

data/lib/html_tags/individual_tags/cite.rb

@@ -0,0 +1,78 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/cite.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.cite
+  # ========================================================================= #
+  def self.cite(
+      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
+    content = i.to_s.dup
+    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
+
+  # ========================================================================= #
+  # === cite
+  # ========================================================================= #
+  def cite(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    return HtmlTags.cite(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.cite('The Scream')
+end

data/lib/html_tags/individual_tags/code.rb

@@ -0,0 +1,105 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/code.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.code
+  # ========================================================================= #
+  def self.code(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      &block
+    )
+    # ======================================================================= #
+    # === Handle Hashes as input given
+    # ======================================================================= #
+    if i.is_a? Hash
+      # ===================================================================== #
+      # === :action
+      #
+      # :action is presently not implemented.
+      # ===================================================================== #
+      # if i.has_key? :action
+      # end
+      # ===================================================================== #
+      # === :css_style
+      # ===================================================================== #
+      if i.has_key? :css_style
+        css_style = i.delete(:css_style)
+      end
+    end
+    the_opening_tag = opening_tag(
+      __method__, css_class, the_id, css_style
+    )
+    # ======================================================================= #
+    # Next, add ad-hoc support for "id", "name" and "action".
+    # ======================================================================= #
+    if i.is_a? Hash
+      if i.has_key? :id
+        the_opening_tag[the_opening_tag.index('>'),0] = ' id="'+i.delete(:id).to_s+'"'
+      end
+      if i.has_key? :action
+        the_opening_tag[the_opening_tag.index('>'),0] = ' action="'+i.delete(:action).to_s+'"'
+      end
+      if i.has_key? :name
+        the_opening_tag[the_opening_tag.index('>'),0] = ' name="'+i.delete(:name).to_s+'"'
+      end
+      if i.has_key? :method
+        the_opening_tag[the_opening_tag.index('>'),0] = ' method="'+i.delete(:method).to_s+'"'
+      end
+      # ===================================================================== #
+      # Finally, if that hash is empty, turn it into an empty String.
+      # ===================================================================== #
+      if i.is_a?(Hash) and i.empty?
+        i = ''.dup
+      end
+    end
+    # ======================================================================= #
+    # Past the next step, the variable `i` will be guaranted to be a String.
+    # ======================================================================= # 
+    i = i.to_s
+    if block_given?
+      yielded = "#{yield}"
+      i << yielded
+    end
+    return HtmlTags.add(
+      the_opening_tag+
+      i+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === code
+  # ========================================================================= #
+  def code(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      &block
+    )
+    return HtmlTags.code(
+      i,
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.code('button')
+end

data/lib/html_tags/individual_tags/del.rb

@@ -0,0 +1,112 @@
+#!/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.del
+  #
+  # The <del> tag is used to identify text that has been deleted from
+  # a document but retained to show the history of modifications made
+  # to the document. Pair a <del> element with an <ins> element to
+  # identify the inserted text that replaced the deleted text.
+  #
+  # A complete example for how <del> is normally used follows:
+  #
+  #   <p>My favorite colour is <del>blue</del> <ins>red</ins>.</p>
+  #
+  # ========================================================================= #
+  def self.del(
+      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
+
+  # ========================================================================= #
+  # === del
+  # ========================================================================= #
+  def del(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = '',
+      &block
+    )
+    ::HtmlTags.del(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript,
+      &block
+    )
+  end
+   
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e 'This cat '+HtmlTags.del('abc def ghi')+' is a super cat.'
+end

data/lib/html_tags/individual_tags/details.rb

@@ -0,0 +1,79 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/details.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.details
+  #
+  # More information about this tag can be seen here:
+  #
+  #   https://www.w3schools.com/tags/tag_details.asp
+  #
+  # ========================================================================= #
+  def self.details(
+      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
+    content = i.to_s.dup
+    if block_given?
+      content << yield.to_s
+    end
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style, optional_javascript)+
+      content+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === details
+  # ========================================================================= #
+  def details(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    return HtmlTags.details(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.details('Hey there')
+end

data/lib/html_tags/individual_tags/dialog.rb

@@ -0,0 +1,108 @@
+#!/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.dialog
+  # ========================================================================= #
+  def self.dialog(
+      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:
+      #   dialog(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
+    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
+
+  # ========================================================================= #
+  # === dialog
+  #
+  # This method will make a html <dialog> tag.
+  #
+  # Invocation example:
+  #
+  #   HtmlTags.dialog(i = '', css_class = '', the_id = '', css_style = '')
+  # 
+  # ========================================================================= #
+  def dialog(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = nil
+    )
+    return HtmlTags.dialog(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.dialog('<p>Greetings, one and all!</p>
+    <form method="dialog">
+      <button>OK</button>
+    </form>'
+  )
+end

data/lib/html_tags/individual_tags/div.rb

@@ -0,0 +1,99 @@
+#!/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.div
+  # ========================================================================= #
+  def self.div(
+      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:
+      #   div(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
+    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
+
+  # ========================================================================= #
+  # === div
+  #
+  # This method will make a html <div> tag.
+  #
+  # Invocation example:
+  #
+  #   HtmlTags.div(i = '', css_class = '', the_id = '', css_style = '')
+  # 
+  # ========================================================================= #
+  def div(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = nil
+    )
+    return HtmlTags.div(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code,
+      &block
+    )
+  end
+
+end