cyberweb 0.4.174 → 0.5.225

data/lib/cyberweb/web_object/input_related_functionality.rb

@@ -1,414 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'cyberweb/web_object/input_related_functionality.rb'
-# =========================================================================== #
-require 'cyberweb/base/base.rb'
-
-module Cyberweb
-
-class WebObject < Base # === Cyberweb::WebObject
-
-  require 'cyberweb/html_tags/input.rb'
-
-  # ========================================================================= #
-  # === input_field
-  #
-  # Usage example:
-  #
-  #   input_field('','bblack1 pad8px')
-  #
-  # ========================================================================= #
-  def input_field(
-      default_value = '',         # (1) default value
-      css_class     = Input.to_s, # (2) css class
-      name_to_use   = '',         # (3) name to use
-      css_style     = '',         # (4) css style
-      accesskey     = '',         # (5) accesskey
-      my_javascript = '',         # (6) javascript
-      id            = nil,        # (7) id
-      hash          = {}          # (8) an additional hash
-    )
-    input(
-      :text,
-      default_value,
-      css_class,
-      name_to_use,        
-      css_style,        
-      accesskey,        
-      my_javascript,        
-      id,       
-      hash
-    )
-  end; alias input_entry input_field # === input_entry
-
-  # ========================================================================= #
-  # === input                                                     (input tag)
-  #
-  # HTML defines the following input-types:
-  #
-  #   <input type="text">      Displays a single-line text input field
-  #   <input type="radio">     Displays a radio button (for selecting one of many choices)
-  #   <input type="checkbox">  Displays a checkbox (for selecting zero or more of many choices)
-  #   <input type="submit">    Displays a submit button (for submitting the form)
-  #   <input type="button">    Displays a clickable button
-  #
-  # A button would look like this:
-  #
-  #   button = input(:button)
-  #
-  # A form may look like this:
-  #
-  #   input_submit css_class: 'bblack1'
-  #
-  # ========================================================================= #
-  def input(
-      type          = :submit,    # (1) type
-      default_value = '',         # (2) default value
-      css_class     = Input.to_s, # (3) css class
-      name_to_use   = '',         # (4) name to use
-      css_style     = '',         # (5) css style
-      accesskey     = '',         # (6) accesskey
-      my_javascript = '',         # (7) javascript
-      id            = nil,        # (8) id
-      hash          = {},         # (9) an additional hash
-      &block
-    )
-    _ = ''.dup
-    # ======================================================================= #
-    # First, let's start to assemble our main string that we will return.
-    # This must come before we handle anything else.
-    # ======================================================================= #
-    _ << '<input'
-    # ======================================================================= #
-    # === Handle blocks next, if given
-    #
-    # Check for block-supplied to the method. Note that this must come
-    # before the call to return_css_class(), as the blocks passed into
-    # this method may also modify the css-class in use.
-    # ======================================================================= #
-    if block_given?
-      yielded = yield # yield the block here.
-      case yielded
-      # ===================================================================== #
-      # === :select_on_click
-      # ===================================================================== #
-      when :select_on_click
-        my_javascript = :select_on_click
-      else
-        if yielded.is_a? Hash
-          # ================================================================= #
-          # === :css_class
-          #
-          # Handle situations like the following:
-          #
-          #   input_submit {{ css_class: 'bblack1' }}
-          #
-          # ================================================================= #
-          if yielded.has_key? :css_class
-            css_class = yielded.delete(:css_class)
-          end
-          # ================================================================= #
-          # === :javascript_function
-          #
-          # This variant is for invoking a javascript-function.
-          #
-          # A simple example for this is the following:
-          #
-          #   javascript_function: 'msg("hello_world")'
-          #
-          # ================================================================= #
-          if yielded.has_key? :javascript_function
-            string = yielded.delete(:javascript_function).dup
-            if string.include? '(' # Assume something like: msg("hello_world")
-              splitted = string.split('(')
-              function_to_call = splitted.first.to_s
-              argument_to_use  = splitted[1 .. -1].join('(').
-                                 delete('()').to_s.delete('"')
-              case function_to_call
-              when 'msg'
-                _ << '  onclick="window.alert(\''+argument_to_use+'\');"'
-              end
-            end
-          # ================================================================= #
-          # === :on_click_event
-          # ================================================================= #
-          elsif yielded.has_key? :on_click_event
-            _ << ' onclick="'+yielded.delete(:on_click_event).to_s+'()"'
-          end
-          # ================================================================= #
-          # === :text
-          #
-          # Handle situations like the following:
-          #
-          #   input_submit {{ text: 'submit' }}
-          #
-          # ================================================================= #
-          if yielded.has_key? :text
-            default_value = yielded.delete(:text)
-          end
-        end
-      end
-    end
-    # ======================================================================= #
-    # === Handle Hashes next
-    #
-    # Second, let's check if the second argument is a hash.
-    # ======================================================================= #
-    if default_value.is_a? Hash
-      # ===================================================================== #
-      # === :css_class
-      # ===================================================================== #
-      if default_value.has_key? :css_class
-        css_class = default_value.delete(:css_class)
-      end
-      # ===================================================================== #
-      # === :accesskey
-      # ===================================================================== #
-      if default_value.has_key? :accesskey
-        accesskey = default_value[:accesskey]
-      end
-      # ===================================================================== #
-      # === :id
-      # ===================================================================== #
-      if default_value.has_key? :id
-        id = default_value[:id]
-      end
-      # ===================================================================== #
-      # === :name
-      # ===================================================================== #
-      if default_value.has_key? :name
-        name_to_use = default_value.delete(:name)
-      end
-      # ===================================================================== #
-      # === :text
-      # ===================================================================== #
-      if default_value.has_key? :text
-        default_value = default_value.delete(:text)
-      end
-      if default_value.is_a?(Hash) and default_value.empty?
-        default_value = 'Submit'
-      end
-    end
-    case type.to_sym # case tag
-    # ======================================================================= #
-    # === :datetime
-    # ======================================================================= #
-    when :datetime
-      _ << ' type="datetime-local"'
-    # ======================================================================= #
-    # === :month
-    # ======================================================================= # 
-    when :month
-      _ << ' type="month"'
-    # ======================================================================= #
-    # === :week
-    # ======================================================================= #
-    when :week
-      _ << ' type="week"'
-    # ======================================================================= #
-    # === :image
-    # ======================================================================= #
-    when :image, :img, :i
-      _ << ' type="image"'
-    # ======================================================================= #
-    # === :button
-    # ======================================================================= #
-    when :button,      :b
-      _ << ' type="button"'
-    # ======================================================================= #
-    # === :hidden
-    # ======================================================================= #
-    when :hidden,      :h
-      _ << ' type="hidden"'
-    # ======================================================================= #
-    # === :submit
-    # ======================================================================= #
-    when :submit,      :s
-      _ << ' type="submit"'
-    # ======================================================================= #
-    # === :reset
-    # ======================================================================= #
-    when :reset,       :r
-      _ << ' type="reset"'
-    # ======================================================================= #
-    # === :text
-    # ======================================================================= #
-    when :text, :field, :default, :t
-      _ << ' type="text"'
-    # ======================================================================= #
-    # === :file
-    # ======================================================================= #
-    when :file, :file_uploads, :upload, :file_dialogue,
-         :f, :file_handle  # File uploads are handled here.
-      _ << ' type="file"'
-      id = 'input_file_upload' if id.nil?
-    else
-      _ = type.to_s+' was not found ...'+NL
-    end
-    # ======================================================================= #
-    # Next, handle Symbol input given to css_class.
-    #
-    # This can be a Symbol such as:
-    #
-    #   :select_on_click
-    #
-    # or such as:
-    #
-    #   :focus_with_deepskyblue_background
-    #
-    # ======================================================================= #
-    if css_class.is_a? Symbol
-      case css_class # case tag
-      when :select_on_click
-        css_class = Input.to_s
-        if my_javascript.empty? # If it is empty then we can populate it.
-          my_javascript = :select_on_click
-        end
-      else
-        # =================================================================== #
-        # The next line will handle cases such as:
-        #   :focus_with_yellow_background
-        # =================================================================== #
-        if css_class.to_s.start_with? 'focus_with'
-          # ================================================================= #
-          # Delegate towards class InputFocus next.
-          # ================================================================= #
-          input_focus = ::Cyberweb::InputFocus.new(css_class)
-          add_css_style input_focus.string?
-          css_class = input_focus.css_class?.dup
-          # ================================================================= #
-          # Keep in mind that the user may have set a default value for
-          # a css class, via Input.set_css_class(). If this is the case
-          # then we have to honour this setting and will simply append it.
-          # ================================================================= #
-          unless Input.to_s.empty?
-            css_class << N+Input.to_s.dup
-          end
-        end
-      end
-    end
-    _ = _.dup if _.frozen?
-    _ << css_class_or_no_class(css_class.to_s)
-    _ << css_style_or_no_style(css_style)
-
-    if name_to_use.is_a? Symbol # This is copy/paste of the above.
-      case name_to_use
-      when :select_on_click
-        name_to_use = ''
-        if my_javascript.empty? # If it is empty then we can populate it.
-          my_javascript = :select_on_click
-        end
-      end
-    end
-    _ << return_the_name(name_to_use) unless name_to_use.to_s.empty?
-    _ << return_accesskey(accesskey)
-    if id
-      if id.is_a? String
-        _ << ' id="'+id.to_s+'"'
-      end
-    end
-    my_javascript = sanitize_javascript(my_javascript)
-    _ << " #{my_javascript}" unless my_javascript.empty?
-    if default_value.is_a? Hash
-      if default_value.has_key? :value
-        _ << ' value="'+default_value[:value].to_s+'"'
-      end
-    else
-      unless _.include?('value') 
-        unless default_value.to_s.empty? # then add our default value
-          _ << ' value="'+default_value.to_s+'"'
-        end
-      end
-    end
-    # ======================================================================= #
-    # Next handle a possible hash-argument here.
-    # ======================================================================= #
-    if hash.is_a? Hash
-      _ << ' size="'+hash[:size].to_s+'"' if hash[:size]
-      _ << ' maxlength="'+hash[:max_length].to_s+'"' if hash[:max_length]
-    end
-    _ << ' />'+NL
-    addnl(
-      _
-    )
-  end
-
-  # ========================================================================= #
-  # === form                                                       (form tag)
-  #
-  # Usage example:
-  #
-  #   form 'SELF', :post, 'mars2em'
-  #
-  # ========================================================================= #
-  def form(
-      action         = 'SELF',    # (1) action
-      method_form    = Form.mode, # (2) method form, such as :get or :post
-      css_class      = Form.to_s, # (3) css class
-      the_id         = '',        # (4) the id
-      css_style      = '',        # (5) css style
-      accept_charset = nil,       # (6) charset
-      enctype        = nil
-    )
-    if action.is_a? Hash
-      if action.has_key? :action
-        _ = action[:action]
-        case _
-        when :self
-          action = return_program_name
-        end
-      end
-    end
-    case action
-    when /SELF/i
-      action = return_program_name
-    end
-    _ = '<form'.dup
-    _ << ' action="'+action.to_s+'"'
-    _ << ' method="'+method_form.to_s+'"'
-    _ << css_class_or_no_class(css_class.to_s).to_s
-    _ << id_or_no_id(the_id.to_s).to_s
-    _ << css_style_or_no_style(css_style)
-    _ << ">\n" # Close the <form> tag here.
-    addnl(_)
-    if block_given?
-      yield
-      cform
-    end
-  end
-
-  # ========================================================================= #
-  # === input_submit
-  #
-  # This is essentially a submit-button, in HTML.
-  #
-  # The first argument is the text that should be used for that button.
-  # ========================================================================= #
-  def input_submit(
-      default_value = '',
-      css_class     = Input.to_s,
-      name_to_use   = '',
-      css_style     = '',
-      accesskey     = '',
-      my_javascript = '',
-      id            = nil,
-      hash          = {},
-      &block
-    )
-    input(
-      :submit,
-      default_value,
-      css_class,
-      name_to_use,
-      css_style,
-      accesskey,
-      my_javascript,
-      id,
-      hash,
-      &block
-    )
-  end
-
-end; end

data/lib/cyberweb/web_object/languages.rb

@@ -1,172 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# The typical layout of a .html page should be similar to this:
-#
-#   <!DOCTYPE html>
-#   <html lang="en">
-#   <head>
-#   <meta charset="utf-8"/>
-#
-# =========================================================================== #
-# require 'cyberweb/web_object/languages.rb'
-# =========================================================================== #
-require 'cyberweb/base/base.rb'
-
-module Cyberweb
-
-class WebObject < Base # === Cyberweb::WebObject
-
-  # ========================================================================= #
-  # === german
-  # ========================================================================= #
-  def german(i = nil, &block)
-    add_doctype_then_html_start_tag_then_head_tag_then_charset
-    german_trinity
-    if i
-      set_title(i)
-    end
-    handle_these_calls(&block)
-    close_html_after_making_sure_that_the_body_tag_exists
-  end
-
-  # ========================================================================= #
-  # === english                                                 (english tag)
-  # ========================================================================= #
-  def english(i = nil, &block)
-    add_doctype_then_html_start_tag_then_head_tag_then_charset
-    english_trinity
-    if i
-      set_title(i)
-    end
-    handle_these_calls(&block)
-    close_html_after_making_sure_that_the_body_tag_exists
-  end
-
-  # ========================================================================= #
-  # === language
-  #
-  # You can use this method to specify a certain language in order to
-  # use for the given web page. I tend to use this to remind myself
-  # in which language I shall write a web-page in, e. g. usually
-  # either in german, or more commonly these days, in english.
-  #
-  # Invocation example:
-  #
-  #   language :english
-  #
-  # ========================================================================= #
-  def language(
-      which_language = nil
-    )
-    case which_language
-    # ======================================================================= #
-    # === eng
-    # ======================================================================= #
-    when 'eng','e','en','default'
-      which_language = 'english'
-    # ======================================================================= #
-    # === ger
-    # ======================================================================= #
-    when 'ger','g','ge','german','deutsch'
-      which_language = 'german'
-    end
-    @internal_hash[:language] = which_language.to_s # Will be kept as a String.
-  end
-
-  # ========================================================================= #
-  # === german_unicode_and_jquery
-  #
-  # This convenience method will enable german language layout for a
-  # webpage, jquery-drag-and-drop support, as well as declare that
-  # the page at hand uses unicode characters (and thus needs support
-  # for unicode).
-  # ========================================================================= #
-  def german_unicode_and_jquery
-    do_use_jquery
-    german_trinity
-  end; alias german_unicode_jquery         german_unicode_and_jquery # === german_unicode_jquery
-       alias use_jquery_german_and_unicode german_unicode_and_jquery # === german_unicode_and_jquery
-
-  # ========================================================================= #
-  # === english_unicode_and_jquery
-  # ========================================================================= #
-  def english_unicode_and_jquery
-    do_use_jquery
-    english_trinity
-  end
-
-  # ========================================================================= #
-  # === german_unicode
-  # ========================================================================= #
-  def german_unicode
-    use_german
-    use_unicode
-  end
-
-  # ========================================================================= #
-  # === use_english
-  # ========================================================================= #
-  def use_english # An easier shortcut.
-    language :english
-  end; alias do_use_english use_english # === english
-
-  # ========================================================================= #
-  # === german_trinity
-  #
-  # This variant specifically does NOT force the use of jquery since as
-  # of May 2021. If you want to force jquery, use the method
-  # called german_unicode_and_jquery() instead.
-  #
-  # Strictly speaking the word "trinity" is thus no longer correct, but
-  # for the time being it will be retained.
-  # ========================================================================= #
-  def german_trinity
-    german_unicode # This bundles "use_german" and "use_unicode".
-    add_html_comment("\nThis website is making use of german.\n")
-    add_relevant_meta_entries(:ignore_checks)
-  end; alias use_unicode_german_and_jquery german_trinity # === use_unicode_german_and_jquery
-       alias trinity_german                german_trinity # === trinity_german
-       alias trinity                       german_trinity # === trinity
-
-  # ========================================================================= #
-  # === use_german
-  #
-  # This is an easier shortcut to designate that the current webpage
-  # makes use of the german language as part of its content primarily.
-  # ========================================================================= #
-  def use_german # An easier shortcut.
-    language :german
-  end
-
-  # ========================================================================= #
-  # === english_trinity
-  # ========================================================================= #
-  def english_trinity
-    do_use_english
-    use_unicode
-    add_html_comment("\nThis website is making use of english.\n")
-    add_relevant_meta_entries(:ignore_checks)
-  end; alias use_english_trinity english_trinity # === use_english_trinity
-       alias english_trinity     english_trinity # === english_trinity
-
-  # ========================================================================= #
-  # === add_doctype_then_html_start_tag_then_head_tag_then_charset
-  #
-  # This must add a string-chain like:
-  #
-  #   <!DOCTYPE html>
-  #   <html lang="en">
-  #   <head>
-  #   <meta charset="utf-8"/>
-  #
-  # ========================================================================= #
-  def add_doctype_then_html_start_tag_then_head_tag_then_charset
-    add(DOCTYPE_HTML5)
-    add(Cyberweb.return_html_start) # html lang.
-    add(Cyberweb.return_head_start)
-    add(Cyberweb.return_utf_charset)
-  end
-
-end; end