html_tags 0.1.183

data/lib/html_tags/individual_tags/head.rb

@@ -0,0 +1,47 @@
+#!/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.head
+  # ========================================================================= #
+  def self.head(
+      i = '',
+      &block
+    )
+    if block_given?
+      return HtmlTags.add(
+        opening_tag(__method__)+i+yield+close(__method__)
+      )
+    else # Simplified variant.
+      result = HtmlTags.add(
+        opening_tag(__method__)
+      ).dup
+      if i and !i.empty?
+        result << i
+        result << '</head>'
+      end
+      return result
+    end
+  end
+
+  # ========================================================================= #
+  # === head
+  #
+  # This will create an opening tag.
+  # ========================================================================= #
+  def head(i = '', &block)
+    HtmlTags.head(i, &block)
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.head 'Testing ...'
+end

data/lib/html_tags/individual_tags/header.rb

@@ -0,0 +1,54 @@
+#!/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.header
+  #
+  # Usage example:
+  #
+  #   HtmlTags.header('<h1>APP NAME</h1><nav></nav>') => '<header><h1>APP NAME</h1><nav></nav></header>'
+  #
+  # ========================================================================= #
+  def self.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}\n"+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === header
+  # ========================================================================= #
+  def header(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      &block
+    )
+    ::HtmlTags.header(i, css_class, the_id, css_style, &block)
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.header('<h1>APP NAME</h1><nav></nav>')
+end

data/lib/html_tags/individual_tags/hgroup.rb

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

data/lib/html_tags/individual_tags/html.rb

@@ -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

@@ -0,0 +1,47 @@
+#!/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.i
+  # ========================================================================= #
+  def self.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
+
+  # ========================================================================= #
+  # === i
+  # ========================================================================= #
+  def i(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      &block
+    )
+    return HtmlTags.i(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.i('foobar')
+end

data/lib/html_tags/individual_tags/iframe.rb

@@ -0,0 +1,131 @@
+#!/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.iframe
+  #
+  # The <iframe> tag specifies an inline frame. This can then be embedded
+  # in a webpage, for instance.
+  #
+  # It is recommended to always include a title attribute for the
+  # <iframe>. This is used by screen readers to read out what
+  # the content of the <iframe> is.
+  #
+  # This method should yield a String such as:
+  #
+  #   <iframe src="https://www.foobar.com" title="Testing"></iframe>
+  #
+  # Usage example:
+  #
+  #   x = HtmlTags.iframe(text: 'Move the mouse cursor here.', css_class: 'glow_on_hover')
+  #
+  # ========================================================================= #
+  def self.iframe(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = '',
+      &block
+    )
+    the_opening_tag = nil
+    source_target = ''.dup
+    # ======================================================================= #
+    # === 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
+      # ===================================================================== #
+      # === :src
+      # ===================================================================== #
+      if i.has_key? :src
+        source_target = i.delete(:src).to_s
+      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)
+    end
+    if source_target and !source_target.empty?
+      the_opening_tag.sub!(/iframe /, 'iframe src="'+source_target+'" ')
+    end
+    return HtmlTags.add(
+      the_opening_tag+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === iframe
+  # ========================================================================= #
+  def iframe(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = '',
+      &block
+    )
+    ::HtmlTags.iframe(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript,
+      &block
+    )
+  end
+   
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.iframe {{
+     src:      'www.foobar.com',
+     css_class: 'bblack2 pad5px marl1em'
+    }}
+end

data/lib/html_tags/individual_tags/img.rb

@@ -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 for this HTML tag 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; self.instance_eval { alias image img } # === HtmlTags.image
+
+  # ========================================================================= #
+  # === 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

@@ -0,0 +1,96 @@
+#!/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.input
+  #
+  # Take note that the input to this method can include fairly complex
+  # variants, as shown by the following example:
+  #
+  #   HtmlTags.input(type: :submit, value: 'Create Article')
+  #
+  # Here 'Create Article' will be the text that is shown as content of
+  # the input-tag.
+  # ========================================================================= #
+  def self.input(
+      css_class       = '',
+      the_id          = '',
+      css_style       = '',
+      javascript_code = '',
+      &block
+    )
+    string = ''.dup
+    if css_class.is_a? Hash
+      _ = css_class
+      # ===================================================================== #
+      # === :type
+      # ===================================================================== #
+      if _.has_key? :type
+        string << 'type="'+css_class.delete(:type).to_s+'" '
+      end
+      # ===================================================================== #
+      # === :value
+      #
+      # The "value" is actually the content of the input-tag.
+      # ===================================================================== #
+      if _.has_key? :value
+        string << 'value="'+css_class.delete(:value).to_s+'" '
+      end
+      # ===================================================================== #
+      # === :javascript
+      # ===================================================================== #
+      if _.has_key? :javascript
+        javascript_code = css_class.delete(:javascript)
+      end
+      # ===================================================================== #
+      # === :css_class
+      #
+      # This must come last, as it may modify the css_class variable.
+      # ===================================================================== #
+      if _.has_key? :css_class
+        css_class = css_class.delete(:css_class)
+      end
+    end
+    full_tag = opening_tag(
+      __method__,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code,
+      &block
+    )
+    full_tag[ full_tag.rindex('>'), 0] = " #{string.rstrip}" unless string.empty?
+    return HtmlTags.add(full_tag).strip
+  end; self.instance_eval { alias entry input } # === HtmlTags.entry
+
+  # ========================================================================= #
+  # === input
+  # ========================================================================= #
+  def input(
+      css_class       = '',
+      the_id          = '',
+      css_style       = '',
+      javascript_code = '',
+      &block
+    )
+    return HtmlTags.input(
+      css_class,
+      the_id,
+      css_style,
+      javascript_code
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  include HtmlTags
+  e HtmlTags.input(type: :submit, value: 'Create Article')
+end