RubyGems - html_tags - Versions diffs - 0.1.120 - Mend

html_tags 0.1.120

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of html_tags might be problematic. Click here for more details.

Files changed (86) hide show

checksums.yaml +7 -0
data/README.md +110 -0
data/USAGE.md +17 -0
data/doc/README.gen +69 -0
data/html_tags.gemspec +53 -0
data/lib/html_tags/array_registered_html_tags.rb +125 -0
data/lib/html_tags/autoinclude.rb +2 -0
data/lib/html_tags/autoinclude_base_module.rb +7 -0
data/lib/html_tags/base/README.md +3 -0
data/lib/html_tags/base/base.rb +11 -0
data/lib/html_tags/base/base_module.rb +224 -0
data/lib/html_tags/base/prototype.rb +19 -0
data/lib/html_tags/checks.rb +58 -0
data/lib/html_tags/closing_tag/closing_tag.rb +76 -0
data/lib/html_tags/constants/array_strip_newlines.rb +14 -0
data/lib/html_tags/constants/misc.rb +21 -0
data/lib/html_tags/constants.rb +26 -0
data/lib/html_tags/html_closing_tags.rb +36 -0
data/lib/html_tags/html_comment.rb +29 -0
data/lib/html_tags/html_tags.rb +131 -0
data/lib/html_tags/html_tags_constants.rb +14 -0
data/lib/html_tags/individual_tags/a.rb +524 -0
data/lib/html_tags/individual_tags/abbr.rb +44 -0
data/lib/html_tags/individual_tags/audio.rb +32 -0
data/lib/html_tags/individual_tags/b.rb +22 -0
data/lib/html_tags/individual_tags/blockquote.rb +19 -0
data/lib/html_tags/individual_tags/body.rb +19 -0
data/lib/html_tags/individual_tags/br.rb +28 -0
data/lib/html_tags/individual_tags/button.rb +30 -0
data/lib/html_tags/individual_tags/canvas.rb +19 -0
data/lib/html_tags/individual_tags/details.rb +69 -0
data/lib/html_tags/individual_tags/div.rb +51 -0
data/lib/html_tags/individual_tags/figure.rb +39 -0
data/lib/html_tags/individual_tags/footer.rb +26 -0
data/lib/html_tags/individual_tags/form.rb +93 -0
data/lib/html_tags/individual_tags/h1.rb +36 -0
data/lib/html_tags/individual_tags/h2.rb +42 -0
data/lib/html_tags/individual_tags/h3.rb +73 -0
data/lib/html_tags/individual_tags/h4.rb +36 -0
data/lib/html_tags/individual_tags/h5.rb +36 -0
data/lib/html_tags/individual_tags/h6.rb +40 -0
data/lib/html_tags/individual_tags/head.rb +36 -0
data/lib/html_tags/individual_tags/header.rb +29 -0
data/lib/html_tags/individual_tags/html.rb +61 -0
data/lib/html_tags/individual_tags/i.rb +14 -0
data/lib/html_tags/individual_tags/img.rb +135 -0
data/lib/html_tags/individual_tags/input.rb +32 -0
data/lib/html_tags/individual_tags/label.rb +43 -0
data/lib/html_tags/individual_tags/legend.rb +14 -0
data/lib/html_tags/individual_tags/li.rb +44 -0
data/lib/html_tags/individual_tags/main.rb +29 -0
data/lib/html_tags/individual_tags/nav.rb +14 -0
data/lib/html_tags/individual_tags/object.rb +18 -0
data/lib/html_tags/individual_tags/ol.rb +50 -0
data/lib/html_tags/individual_tags/p.rb +50 -0
data/lib/html_tags/individual_tags/pre.rb +16 -0
data/lib/html_tags/individual_tags/span.rb +60 -0
data/lib/html_tags/individual_tags/strong.rb +17 -0
data/lib/html_tags/individual_tags/style.rb +29 -0
data/lib/html_tags/individual_tags/table.rb +33 -0
data/lib/html_tags/individual_tags/tbody.rb +19 -0
data/lib/html_tags/individual_tags/td.rb +24 -0
data/lib/html_tags/individual_tags/textarea.rb +46 -0
data/lib/html_tags/individual_tags/th.rb +14 -0
data/lib/html_tags/individual_tags/thead.rb +14 -0
data/lib/html_tags/individual_tags/title.rb +18 -0
data/lib/html_tags/individual_tags/tr.rb +20 -0
data/lib/html_tags/individual_tags/ul.rb +23 -0
data/lib/html_tags/individual_tags/video.rb +54 -0
data/lib/html_tags/module.rb +5 -0
data/lib/html_tags/opening_tag/opening_tag.rb +288 -0
data/lib/html_tags/project/project_base_directory.rb +23 -0
data/lib/html_tags/requires/require_the_html_tags_project.rb +9 -0
data/lib/html_tags/requires/require_the_img_tag.rb +7 -0
data/lib/html_tags/shared.rb +23 -0
data/lib/html_tags/stag.rb +54 -0
data/lib/html_tags/toplevel_methods/add.rb +22 -0
data/lib/html_tags/toplevel_methods/full_output.rb +33 -0
data/lib/html_tags/toplevel_methods/newline_or_empty.rb +21 -0
data/lib/html_tags/toplevel_methods/strip_newlines.rb +27 -0
data/lib/html_tags/version/version.rb +17 -0
data/lib/html_tags/yaml/valid_tags_in_a_head_tag.yml +16 -0
data/lib/html_tags.rb +5 -0
data/test/testing_html_tags.rb +158 -0
data/test/testing_the_a_tag.rb +113 -0
metadata +141 -0

data/lib/html_tags/individual_tags/header.rb ADDED Viewed

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+  # ========================================================================= #
+  # === header
+  #
+  # Usage example:
+  #
+  #   HtmlTags.header('<h1>APP NAME</h1><nav></nav>') => '<header><h1>APP NAME</h1><nav></nav></header>'
+  #
+  # ========================================================================= #
+  def header(
+      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/html.rb ADDED Viewed

@@ -0,0 +1,61 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+  # ========================================================================= #
+  # === html
+  #
+  # A <html> tag in HTML5 may have some attributes such as:
+  #
+  #   <html lang="en">
+  #
+  # See http://www.w3schools.com/tags/ref_language_codes.asp for more
+  # information pertaining to the <html> tag.
+  #
+  # For now, we will use lang="en" all the time.
+  #
+  # To test this standalone, try:
+  #
+  #   HtmlTags.html
+  #
+  # ========================================================================= #
+  def html(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      &block
+    )
+    opening = HtmlTags.open_html # Delegate to the method below.
+    _ = ''.dup
+    if block_given?
+      yielded = yield
+      case yielded
+      when :use_unicode_as_encoding
+        opening << "<meta charset=\"UTF-8\">\n"
+      else
+        _ << yielded
+      end
+    end
+    return HtmlTags.add(
+      opening+
+      i.to_s+
+      _.to_s+
+      close(__method__)
+    )
+  end
+  # ========================================================================= #
+  # === HtmlTags.open_html
+  #
+  # We will automatically append lang="en" to the tag.
+  # ========================================================================= #
+  def self.open_html
+    opening = opening_tag(:html)
+    opening[-2,0] = ' lang="en"'
+    opening
+  end
+end

data/lib/html_tags/individual_tags/i.rb ADDED Viewed

@@ -0,0 +1,14 @@
+module HtmlTags
+  # ========================================================================= #
+  # === i
+  # ========================================================================= #
+  def i(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
+end

data/lib/html_tags/individual_tags/img.rb ADDED Viewed

@@ -0,0 +1,135 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/img.rb'
+# =========================================================================== #
+module HtmlTags
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+  require 'html_tags/toplevel_methods/newline_or_empty.rb'
+  # ========================================================================= #
+  # === HtmlTags.img
+  #
+  # The img() method creates an <img> tag.
+  #
+  # Documentation can be found at:
+  #
+  #   https://www.w3schools.com/tags/tag_img.asp
+  #   https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img
+  #
+  # The "end result" will be a String such as this here:
+  #
+  #   <img src="foo.png" alt="Some image">
+  #
+  # Note that we make use of the block variant, by specifying a hash which
+  # has a :src attribute.
+  #
+  # If the first argument to this method is a Hash then that Hash will
+  # be checked for certain keys, such as :src or :css_class
+  #
+  # If the argument called the_id is a symbol such as
+  # :infer_the_id_from_the_filename then it will be evaluated in a
+  # special manner.
+  # ========================================================================= #
+  def self.img(
+      i         = 'foo.png',
+      css_class = '',
+      the_id    = '',
+      css_style = ''
+    )
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      # ===================================================================== #
+      # === Handle Hashes given via block syntax next
+      # ===================================================================== #
+      if yielded.is_a? Hash
+        if i.is_a? String
+          i = { src: i } # Add this string as the :src key in that case.
+          i.update(yielded)
+        end
+      end
+    end
+    if i.is_a? Hash
+      # ===================================================================== #
+      # === :css_style
+      # ===================================================================== #
+      if i.has_key? :css_style
+        css_style = i.delete(:css_style)
+      end
+      # ===================================================================== #
+      # === :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
+      # ===================================================================== #
+      # === :src
+      #
+      # This entry point should come last, that is, after other checks were
+      # already done. The reason for this is due to the deliberate
+      # self-assignment being done here.
+      # ===================================================================== #
+      if i.has_key? :src
+        i = i.delete(:src)
+      end
+    end
+    case the_id # case tag
+    # ======================================================================= #
+    # === :drag_infer_the_id_from_the_filename
+    # ======================================================================= #
+    when :drag_infer_the_id_from_the_filename,
+         :drag
+      the_id = 'drag_'+File.basename(i).
+               sub(/#{File.extname(i)}/,'')
+    # ======================================================================= #
+    # === :infer_the_id_from_the_filename
+    # ======================================================================= #
+    when :infer_the_id_from_the_filename
+      the_id = File.basename(i).
+               sub(/#{File.extname(i)}/,'')
+    end
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style) {{ src: i }}+
+      HtmlTags.newline_or_empty.to_s # i.to_s # Disabled adding the content. <img> tags do not have any content.
+    )
+  end
+  # ========================================================================= #
+  # === img
+  # ========================================================================= #
+  def img(
+      i         = 'foo.png',
+      css_class = '',
+      the_id    = '',
+      css_style = ''
+    )
+    HtmlTags.img(i, css_class, the_id, css_style)
+  end
+end
+if __FILE__ == $PROGRAM_NAME
+  # You could also include HtmlTags, then just use img() directly.
+  # include HtmlTags
+  puts HtmlTags.img(
+    "studium/MASTER.png",
+    css_style: 'margin-left:6px'
+  )
+end

data/lib/html_tags/individual_tags/input.rb ADDED Viewed

@@ -0,0 +1,32 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+  # ========================================================================= #
+  # === input
+  #
+  # Do note that input can include complex variants, such as the
+  # following:
+  #
+  #   input(type: :submit, value: 'Create Article')
+  #
+  # ========================================================================= #
+  def input(
+      i = '', css_class = '', the_id = '', css_style = '', &block
+    )
+    block = nil
+    if i.is_a? Hash
+      block = i.dup
+      i = ''
+    end
+    the_open_tag = opening_tag(
+      __method__, css_class, the_id, css_style
+    ) { block }
+    return HtmlTags.add(
+      the_open_tag.strip
+    )
+  end
+end

data/lib/html_tags/individual_tags/label.rb ADDED Viewed

@@ -0,0 +1,43 @@
+module 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:
+  #   http://www.w3schools.com/tags/tag_label.asp
+  # ========================================================================= #
+  def 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
+end

data/lib/html_tags/individual_tags/legend.rb ADDED Viewed

@@ -0,0 +1,14 @@
+module HtmlTags
+  # ========================================================================= #
+  # === legend
+  # ========================================================================= #
+  def 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
+end

data/lib/html_tags/individual_tags/li.rb ADDED Viewed

@@ -0,0 +1,44 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module 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 li(
+      i                   = '', # <- This is the content.
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    if i.is_a? Hash
+      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
+end

data/lib/html_tags/individual_tags/main.rb ADDED Viewed

@@ -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/nav.rb ADDED Viewed

@@ -0,0 +1,14 @@
+module HtmlTags
+  # ========================================================================= #
+  # === nav
+  # ========================================================================= #
+  def nav(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
+end

data/lib/html_tags/individual_tags/object.rb ADDED Viewed

@@ -0,0 +1,18 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+  # ========================================================================= #
+  # === object
+  # ========================================================================= #
+  def object(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
+end

data/lib/html_tags/individual_tags/ol.rb ADDED Viewed

@@ -0,0 +1,50 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+  # ========================================================================= #
+  # === ol                                                           (ol tag)
+  #
+  # This is essentially a HTML representation for the <ol> tag.
+  #
+  # The <ol> tag defines an ordered list. An ordered list can be
+  # either numerical or it can be alphabetical.
+  #
+  # The <li> tag can be used to define list items.
+  #
+  # Documentation for the <ol> tag can be seen here:
+  #
+  #   https://www.w3schools.com/tags/tag_ol.asp
+  #
+  # ========================================================================= #
+  def ol(
+      i                   = '', # <- This is the content.
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    if i.is_a? Hash
+      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
+end

data/lib/html_tags/individual_tags/p.rb ADDED Viewed

@@ -0,0 +1,50 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/p.rb'
+# =========================================================================== #
+module HtmlTags
+  # ========================================================================= #
+  # === HtmlTags.p
+  #
+  # This method can be used to create the html <p> tag.
+  # ========================================================================= #
+  def self.p(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = ''
+    )
+    if i.is_a? Hash
+      # ===================================================================== #
+      # === Handle entries such as p(css_style: 'padding:2em')
+      # ===================================================================== #
+      if i.has_key? :css_style
+        css_style = i.delete(:css_style)
+        i = '' if i.empty?
+      end
+      if i.is_a?(Hash) and i.has_key?(:css_class)
+        css_class = i.delete(:css_class)
+        i = '' if i.empty?
+      end
+    end
+    result = opening_tag(__method__, css_class, the_id, css_style).dup
+    if block_given?
+      result << yield.to_s
+    end
+    result << i.to_s+close(__method__).to_s
+    return HtmlTags.add(result)
+  end
+  # ========================================================================= #
+  # === p
+  # ========================================================================= #
+  def p(
+      i = '', css_class = '', the_id = '', css_style = ''
+    )
+    HtmlTags.p(i, css_class, the_id, css_style)
+  end
+end

data/lib/html_tags/individual_tags/pre.rb ADDED Viewed

@@ -0,0 +1,16 @@
+module HtmlTags
+  # ========================================================================= #
+  # === pre
+  # ========================================================================= #
+  def pre(
+      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
+end

data/lib/html_tags/individual_tags/span.rb ADDED Viewed

@@ -0,0 +1,60 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+  # ========================================================================= #
+  # === span
+  #
+  # This method will generate HTML <span> tags.
+  #
+  # It will first invoke the method called opening_tag(), then add
+  # the content that was given to it (the first parameter), and then
+  # close the whole tag via the close() method.
+  #
+  # Do note that you can eliminate newlines by invoking the method
+  # in something like this, via :strip:
+  #
+  #   HtmlTags.span('Hello world!','s1') { :strip }
+  #   HtmlTags.span(i, css_class: 'bord1px', css_style: 'margin-left: 1em')
+  #
+  # ========================================================================= #
+  def span(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = '',
+      &block
+    )
+    i = i.to_s
+    start_the_method = opening_tag(
+                         __method__,
+                         css_class,
+                         the_id,
+                         css_style,
+                         javascript
+                       )
+    close_the_method = close(__method__)
+    if block_given?
+      yielded = yield
+      case yielded
+      when :strip
+        # Unfreeze, if frozen:
+        i = i.dup if i.frozen?
+        close_the_method = close_the_method.dup if close_the_method.frozen?
+        start_the_method = start_the_method.dup if start_the_method.frozen?
+        i.strip!
+        close_the_method.strip!
+        start_the_method.strip!
+      end
+    end
+    return HtmlTags.add(
+      start_the_method+
+      i+
+      close_the_method
+    )
+  end; alias s2 span
+end

data/lib/html_tags/individual_tags/strong.rb ADDED Viewed

@@ -0,0 +1,17 @@
+module HtmlTags
+  # ========================================================================= #
+  # === strong
+  #
+  # For most purposes, this can be treated as the old (pre-html5) bold
+  # html tag.
+  # ========================================================================= #
+  def strong(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
+end

data/lib/html_tags/individual_tags/style.rb ADDED Viewed

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+  # ========================================================================= #
+  # === style
+  #
+  # We first call the opening_tag() method, then add the content,
+  # and then close the whole thing again via close().
+  #
+  # This is essentially a way to add CSS style to a HTML-page.
+  # ========================================================================= #
+  def style(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = ''
+    )
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style, javascript)+
+      i.to_s+
+      close(__method__)
+    )
+  end
+end