cyberweb 0.4.174

data/lib/cyberweb/html_tags/select.rb

@@ -0,0 +1,100 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/html_tags/select.rb'
+# Cyberweb.select
+# =========================================================================== #
+module Cyberweb
+
+  # ========================================================================= #
+  # === Cyberweb.select                                       (selection tag)
+  #
+  # This method makes a <select> tag.
+  #
+  # In raw HTML, this may look like so:
+  #
+  #   <select>
+  #     <option value="volvo">Volvo</option>
+  #     <option value="saab">Saab</option>
+  #     <option value="opel">Opel</option>
+  #     <option value="audi">Audi</option>
+  #   </select>
+  #
+  # It is recommended to use a name="" label for the <select> tag,
+  # such as in:
+  #
+  # For documentation, see this link:
+  #
+  #   https://www.w3schools.com/tags/tryit.asp?filename=tryhtml_select
+  #
+  # ========================================================================= #
+  def self.select(
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = ''
+    )
+    n
+    the_tag = string_tag(
+      :select,
+      css_class,
+      the_id,
+      css_style,
+      javascript
+    )
+    n
+    string_that_is_to_be_displayed = ''.dup
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      # ===================================================================== #
+      # === And now, we will handle Hashes:
+      # ===================================================================== #
+      if yielded.is_a? Hash
+        # =================================================================== #
+        # === :dataset_to_use
+        # =================================================================== #
+        if yielded.has_key? :dataset_to_use
+          yielded[:dataset_to_use].each {|content|
+            # =============================================================== #
+            # Append this onto the content-string next:
+            # =============================================================== #
+            string_that_is_to_be_displayed <<
+              "<option value=\"#{content.downcase}\">#{content}</option>\n"
+          }
+        end
+        # =================================================================== #
+        # === :css_class
+        # =================================================================== #
+        if yielded.has_key? :css_class
+          the_tag[-2,0] = ' class="'+yielded.delete(:css_class)+'"'
+        end
+         # =================================================================== #
+        # === :name
+        # =================================================================== #
+        if yielded.has_key? :name
+          the_tag[-2,0] = ' name="'+yielded.delete(:name)+'"'
+        end
+      end
+    end
+    # ======================================================================= #
+    # Next display our <select> tag:
+    # ======================================================================= #
+    ee the_tag
+    ee string_that_is_to_be_displayed
+    ee sclose(:select)
+  end; self.instance_eval { alias selection select } # === Cyberweb.selection
+
+  # ========================================================================= #
+  # === select
+  # ========================================================================= #
+  def select(
+      a = '', b = '', c = '', d = '', &block
+    )
+    ::Cyberweb.select(a, b, c, d, &block)
+  end; alias selection select # === selection
+
+end

data/lib/cyberweb/html_tags/span.rb

@@ -0,0 +1,338 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/html_tags/span.rb'
+# =========================================================================== #
+module Cyberweb
+
+  require 'cyberweb/web_base/web_base.rb'
+  require 'cyberweb/toplevel_methods/close.rb'
+  require 'cyberweb/toplevel_methods/css.rb'
+  require 'cyberweb/toplevel_methods/string_content.rb'
+  require 'cyberweb/toplevel_methods/tag.rb'
+
+  # ========================================================================= #
+  # === Span
+  # ========================================================================= #
+  class Span < WebBase
+
+    # ======================================================================= #
+    # === @span_css_class
+    # ======================================================================= #
+    @span_css_class = nil
+
+    # ======================================================================= #
+    # === Cyberweb::Span.set_css_class
+    # ======================================================================= #
+    def self.set_css_class(i = DEFAULT_CSS_CLASS)
+      @span_css_class = i
+    end
+
+    # ======================================================================= #
+    # === Cyberweb::Span.to_s
+    # ======================================================================= #
+    def self.to_s
+      @span_css_class
+    end
+
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.string_s                                      (string_s tag)
+  #
+  # This method returns the string of a tag.
+  #
+  # You can use that string lateron in your ruby programs. The difference
+  # towards string_tag and this method here is that string_s also gives
+  # back the content, whereas string_tag only gives back the complete
+  # <tag> in question. We will use string_tag in this method here.
+  #
+  # Usage example to call string_s indirectly:
+  #
+  #   Cyberweb.string_s(text,'h4',css_class, the_id, css_style, javascript = ''); n
+  #   Cyberweb.string_s("Hello world!", 'span', '','','margin-left:0.92em; padding-left:6px')
+  #
+  # ========================================================================= #
+  def self.string_s(
+      content         = '', # This variable keeps track of the text to be displayed.
+      which_tag       = 'span',
+      css_class       = '',
+      the_id          = '',
+      css_style       = '',
+      javascript_code = '',
+      &block
+    )
+    append_a_newline = true
+    # ======================================================================= #
+    # === Handle Hashes given to the_id variable
+    # ======================================================================= #
+    if the_id.is_a? Hash
+      if the_id.has_key? :style
+        css_style = the_id.delete(:style)
+        the_id = ''
+      end
+    end
+    the_id = the_id.to_s.dup
+    # ======================================================================= #
+    # Work on the css_class next.
+    # ======================================================================= #
+    if css_class.is_a? Hash
+      if css_class.has_key? :style
+        css_style = css_class.delete(:style)
+        css_class = ''
+      end
+      if css_class.has_key? :id
+        the_id = css_class.delete :id
+        css_class = ''
+      end
+    end
+    if css_style.is_a? Hash
+      # === :style
+      if css_style.has_key? :style
+        css_style = css_style.delete(:style)
+        css_style = ''
+      end
+    end
+    css_class = css_class.to_s.chomp.strip.dup # Sanitize to be on the safe side.
+    # ======================================================================= #
+    # Handle some Macros next:
+    # ======================================================================= #
+    css_class = sanitize_for_colours(css_class)
+    # ======================================================================= #
+    # Checking for Fixnum arguments.
+    # ======================================================================= #
+    if which_tag.is_a? Integer
+      case which_tag
+      when 1   then which_tag = 'div'
+      when 2   then which_tag = 'p'
+      when 3   then which_tag = 'span'
+      when 4   then which_tag = 'h1'
+      when 5   then which_tag = 'h2'
+      when 6   then which_tag = 'h3'
+      when 7   then which_tag = 'h4'
+      when 8   then which_tag = 'h5'
+      when 9   then which_tag = 'h6'
+      when 's' then which_tag = 'span'
+      end
+    end
+    _ = ''.dup
+    # ======================================================================= #
+    # Here follow all types that are not Fixnum Shortcuts, like 'span'
+    # ======================================================================= #
+    which_tag = which_tag.to_s.chomp
+    # ======================================================================= #
+    # Register this tag as the one last in use.
+    # ======================================================================= #
+    set_last_tag_used(which_tag)
+    which_tag = which_tag.to_s.dup
+    if block_given?
+      case yield
+      when :no_newline
+        append_a_newline = false
+      else
+      end
+    end
+    # ======================================================================= #
+    # Open the tag next.
+    # ======================================================================= #
+    html_tag_string = HtmlTags.stag(
+      which_tag,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code,
+      &block
+    )
+    _ << html_tag_string
+    # ======================================================================= #
+    # Add content of the span-tag, through string_content().
+    # ======================================================================= #
+    _ << string_content(content.to_s.dup)
+    _ = _.to_s.dup
+    # ======================================================================= #
+    # === Append the closing tag next
+    #
+    # We will append the closing-tag next.
+    # ======================================================================= #
+    append_this_string = string_close(which_tag.to_s.dup, &block)
+    _ << append_this_string.to_s.dup
+    _ << NL.to_s.dup if append_a_newline
+    return _.to_s.dup
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.string_span
+  #
+  # This method will ultimately yield a <span> tag, a String object.
+  #
+  # Currently two aliases exist to this method; one of these two,
+  # which is Cyberweb.span(), may be subject to change or removal
+  # at a later time - but it may also stay. I have not decided yet.
+  #
+  # I recommend to use the more verbose variant called
+  # Cyberweb.string_span() but if you want to, you can also use
+  # Cyberweb.span(); do so at your own risk, though.
+  # ========================================================================= #
+  def self.string_span(
+      content    = '',
+      css_class  = Span.to_s,
+      the_id     = '', 
+      css_style  = '',
+      javascript = '',
+      &block
+    )
+    ::Cyberweb.string_s(
+      content, 'span',
+      css_class, the_id, css_style,
+      javascript,
+      &block
+    )
+  end; self.instance_eval { alias string_s2 string_span } # === Cyberweb.string_s2
+       self.instance_eval { alias span      string_span } # === Cyberweb.span
+
+  # ========================================================================= #
+  # === Cyberweb.string_ebr
+  # ========================================================================= #
+  def self.string_ebr(
+      content    = '',
+      css_class  = Span.to_s,
+      the_id     = '', 
+      css_style  = '',
+      javascript = '',
+      &block
+    )
+    return Cyberweb.string_span(
+      content,
+      css_class,
+      the_id, 
+      css_style,
+      javascript,
+      &block
+    )+"<br>\n"
+  end
+
+  # ========================================================================= #
+  # === s                                                             (s tag)
+  #
+  # s is short for a <span> tag.
+  #
+  # Historically it was used for <span> tags, but lateron it was shortened
+  # to become a generic "s" named method. This is a VERY important method.
+  #
+  # With it, you can specify arbitrary html tags.
+  #
+  # It will be often-used. sbr or string_s is an alternative to it.
+  #
+  # You may also use numbers rather than a specific tag, though I
+  # discourage using numbers because they are less readable IMHO.
+  # Anyway, here are the codes for these numbers:
+  #
+  #   <b>1</b> is div, <b>2</b> is paragraph, <b>3</b> is span, 
+  #   <b>4</b> is header1,<b>5</b> h2, <b>6</b> h3, 
+  #   <b>7</b> h4, <b>8</b> h5, <b>9</b> h6
+  #
+  # s is like S() in my old php scripts, so we could do something like:
+  #
+  #   <span class="s2em">YEah</span>
+  #
+  # Some specific usage example for this method:
+  #
+  #   x.s 'Content','h5','s1em','border:1px solid blue','SoomeId'
+  #   x.s 'Content','h5','s1em','border:1px solid blue','SoomeId'
+  #   s 'here comes text','div','marl1em','div_id','padding:2px'
+  #
+  # ========================================================================= #
+  def s(
+      content   = '',
+      which_tag = 'span',
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      optional_javascript_code = ''
+    )
+    # ======================================================================= #
+    # Delegate towards the string_s() method next, which resides in the
+    # ======================================================================= #
+    # same file here.
+    string_result = string_s(
+      content, 
+      which_tag,
+      css_class, the_id, css_style,
+      optional_javascript_code
+    )
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :editable
+      # ===================================================================== #
+      when :editable
+        position = string_result.index('>') # Finds the first position.
+        string_result[position,0] = ' contenteditable="true"'
+      end
+    end
+    ee string_result
+  end
+
+  # ========================================================================= #
+  # === span
+  #
+  # We will simply output through the string_span() method here.
+  # ========================================================================= #
+  def span(
+      content = '',   css_class = Span.to_s, the_id = '', 
+      css_style = '', javascript = ''
+    )
+    ee string_span(content, css_class,
+       the_id, css_style, javascript) { yield if block_given? }
+  end; alias espan span # === espan
+
+  # ========================================================================= #
+  # === cspan
+  # ========================================================================= #
+  def cspan
+    eclose :span
+  end
+
+  # ========================================================================= #
+  # === string_span
+  # ========================================================================= #
+  def string_span(
+      a = '', b = Span.to_s, c = '', d = '', e = ''
+    )
+    ::Cyberweb.string_span(a, b, c, d, e)
+  end
+
+  # ========================================================================= #
+  # === string_s
+  #
+  # This was disabled in May 2021. Not sure whether we will re-enable it
+  # again one day or not. For now this is simply commented.
+  # ========================================================================= #
+  # def string_s(
+  #     content   = '',
+  #     which_tag = 'span',
+  #     css_class = '',
+  #     the_id    = '',
+  #     css_style = '',
+  #     javascript_code = ''
+  #   )
+  #   ::Cyberweb.string_s(
+  #     content,
+  #     which_tag,
+  #     css_class,
+  #     the_id,
+  #     css_style,
+  #     javascript_code
+  #   ) 
+  # end; alias string_s2 string_s # === string_s2
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  require 'colours/colours_e_autoinclude.rb'
+  e 'Setting to the new css class padl1em:'
+  Cyberweb::Span.set_css_class 'padl1em'
+  puts Cyberweb::Span
+end

data/lib/cyberweb/html_tags/strong.rb

@@ -0,0 +1,39 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module Cyberweb
+
+  # ========================================================================= #
+  # === Cyberweb.strong
+  #
+  # This method makes a <strong> tag. It has no special css-class.
+  #
+  # For documentation, you could use this link:
+  #
+  #   https://www.quackit.com/html_5/tags/html_strong_tag.cfm
+  #
+  # ========================================================================= #
+  def self.strong(
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = ''
+    )
+    tag :strong, css_class, the_id, css_style, javascript; n
+    if block_given?
+      yield
+      ee sclose(:strong)
+    end
+  end
+
+  # ========================================================================= #
+  # === strong
+  # ========================================================================= #
+  def strong(
+      a = '', b = '', c = '', d = ''
+    )
+    ::Cyberweb.strong(a, b, c, d)
+  end
+
+end