RubyGems - rmobio - Versions diffs - 1.1.13 → 1.1.14 - Mend

rmobio 1.1.13 → 1.1.14

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.

Files changed (504) hide show

data/lib/rmobio/rxml/xforms_transformer.rb CHANGED Viewed

@@ -115,6 +115,7 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
         @view_buffer << '<style xmlns="http://www.mobio.com/ext" src="' << style << '"/>' if style
         @view_buffer << "\n<body style=\"body\">"
         yield doc
+        @view_buffer << '<m:footer style="footer" />'
         @view_buffer << "</body>"
       end
       #Produce a text string. The text displayed can be the _txt_ argument if there's
@@ -398,12 +399,13 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
       end
       #There's no link widget in Mobio client so use a button widget to provide
-      #the same feature for html link. If href is provided and there's no call block,
-      #<xf:load> will be used to invoke the 'href' url. Otherwise, the call block
+      #the same feature for html link. If url is provided and there's no call block,
+      #<xf:load> will be used to invoke the url. Otherwise, the call block
       #will be executed and template can provide specifal action using the action tag.
       #or view_tag.
       #Default event type is ev:event="DOMActivate" for the button.
-      #1. href:  the http get url when user press the button
+      #1. url:  the http get url when user press the button, only valid if there's\
+      #no call block
       #2. txt:   label displayed on the button
       #==== Options
       ##* <tt>:xstyle</tt> -- specifies xforms style attributes like height, width, style, \
@@ -425,7 +427,7 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
       #     <xf:toggle case="page2" ev:event="DOMActivate"/>
       #   </m:button>
       #
-      def link(doc, href, txt="", options={}, &block)
+      def link(doc, url, txt="", options={}, &block)
         @view_buffer << "\n<m:button"
         if options[:xstyle]
           @view_buffer << ' ' << options[:xstyle]
@@ -438,11 +440,57 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
         if block
           yield doc
         else
-          @view_buffer << '<xf:load ev:event="DOMActivate" resource="' << href << '"/>'
+          @view_buffer << '<xf:load ev:event="DOMActivate" resource="' << url << '"/>'
         end
         @view_buffer << '</m:button>'
       end
+      #Create button control. If there's no call block,
+      #<xf:load> will be used to invoke the url. Otherwise, the call block
+      #will be executed and template can provide specifal action using any of
+      #the action tags or view_tag.
+      #Default event type is ev:event="DOMActivate" for the button.
+      #1. url:  the http get url when user press the button, only valid if there's\
+      #no call block
+      #2. label:   label displayed on the button
+      #==== Options
+      ##* <tt>:xstyle</tt> -- specifies xforms style attributes like height, width, style, \
+      #etc. as string.
+      #
+      #==== Examples
+      #* Simple link:
+      #   @xml.link(body, "http://m.twitter.com", "Twitter")
+      #generate the following xforms:
+      #   <m:button height="1ex"><m:label>Twitter</m:label>
+      #     <xf:load ev:event="DOMActivate" resource="http://m.twitter.com"/>
+      #   </m:button>
+      #* Customize action:
+      #   @xml.link(body, "http://m.twitter.com", "Twitter")  do |link|
+      #     @xml.view_tag(link, '<xf:toggle case="page2" ev:event="DOMActivate"/>')
+      #   end
+      #generates the following xforms:
+      #   <m:button height="1ex"><m:label>Twitter</m:label>
+      #     <xf:toggle case="page2" ev:event="DOMActivate"/>
+      #   </m:button>
+      #
+      def button(doc, url, label, options={}, &block)
+        @view_buffer << "\n<m:button"
+        if options[:xstyle]
+          @view_buffer << ' ' << options[:xstyle]
+        else
+          @view_buffer << " height=\"1ex\""
+        end
+        @view_buffer << '><m:label>' << label << '</m:label>'
+        # If no action provided, use <xf:load> to load the url
+        if block
+          yield doc
+        else
+          @view_buffer << '<xf:load ev:event="DOMActivate" resource="' << url << '"/>'
+        end
+        @view_buffer << '</m:button>'
+      end
       #Output arbitray stuff in the model buffer. A workaround for any special xforms
       #tags that are not supported yet in the transformer.
       def model_tag(doc, txt)
@@ -621,8 +669,6 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
         @view_buffer << "<m:tab #{xstyle}>"
         yield doc
         @view_buffer << '</m:tab>'
-        #                        <case id="second" label="Price"
-        #                              style="tab">
       end
       #Create swtich case control, similar to Tab control but without the tab UI.
@@ -660,10 +706,16 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
       #See the document and examples in tab and switch tag.
       #1. id: the case reference id
       #2. label: what is displayed in the tab header (only needed in tab case)
-      #3. xstyle: the xforms style string for the case (only needed in tab case)
-      #
+      #3. xstyle: the xforms style string for the case (only needed in tab case).\
+      #if not defined, default style="tab" will be applied.
       def xcase(doc, id, label=nil, xstyle=nil)
-        @view_buffer << "<m:case id=\"#{id}\" label=\"#{label}\" #{xstyle}>"
+        @view_buffer << "<m:case id=\"#{id}\" label=\"#{label}\""
+        if xstyle
+          @view_buffer << " #{xstyle}"
+        else
+          @view_buffer << ' style="tab"'
+        end
+        @view_buffer << '>'
         yield doc
         @view_buffer << '</m:case>'
       end
@@ -737,12 +789,12 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
       #     <m:label>Close</m:label>
       #   </m:softkey>
       #  </m:menu>
-      def softkey(doc, position="1", label="", refid=nil)
+      def softkey(doc, position="1", label="", refid=nil, &block)
         @view_buffer << "<m:softkey position=\"#{position}\"><m:label>#{label}</m:label>"
         # If we have a refid, setup a popup for the child menus; otherwise, execute
         # the proc to take action.
-        if refid.nil?
+        if refid.nil? and block
           yield doc
         else
           @view_buffer << "<m:show-popup refid=\"#{refid}\" ev:event=\"DOMActivate\" />"
@@ -826,6 +878,100 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
         @view_buffer << "<xf:load resource=\"#{resource}\" ev:event=\"DOMActivate\"/>"
       end
+      #Create syscall control. Refer to mobio client user manual for details usage
+      #of sysacll.
+      #1. name: the name of the syscall function. The client supports "click2call",
+      #"sendSMS", "audio-playback" and "video-playback" functions.
+      #2. address: specifify the value for param tag in syscall
+      #3. address_ref: specify the xpath for the address param tag in syscall
+      #4. message: specifify the value for param tag in syscall
+      #5. message_ref: specifify the xpath for the message param tag in syscall
+      #==== Examples
+      #* Create a button that plays an audio file, the url for the audio file should\
+      #be defined using an instance tag.
+      #     @xml.button(body,"", "btn1") do |btn|
+      #       @xml.syscall(btn, "audio-playback", nil, "instance('audios')/items/item[1]")
+      #     end
+      #generates the following:
+      #     <m:button height="1ex">
+      #       <m:label>btn1</m:label>
+      #       <m:syscall name="audio-playback" ev:event="DOMActivate">
+      #         <m:param name="address" ref="instance('audios')/items/item[1]"/>
+      #       </m:syscall>
+      #     </m:button>
+      #When user selects the button 'btn1', the audio file will be loaded and played.
+      #
+      #* Create a button that places a phone call:
+      #     @xml.instance_tag(body, "phone") do |x|
+      #       @xml.number("tel:5551212")
+      #     end
+      #     @xml.button(body,"", "btn1") do |btn|
+      #       @xml.syscall(btn, "click2call", nil, "instance('phone')/number")
+      #     end
+      #
+      #     @xml.button(body,"", "btn2") do |btn|
+      #       @xml.syscall(btn, "click2call", "tel:5551212")
+      #     end
+      #generates the following:
+      #
+      #In model
+      #     <xf:instance id="phone">
+      #       <data xmlns="">
+      #         <number>tel:5551212</number>
+      #       </data>
+      #     </xf:instance>
+      #
+      #In view
+      #     <m:button height="1ex">
+      #       <m:label>btn1</m:label>
+      #       <m:syscall name="click2call" ev:event="DOMActivate">
+      #         <m:param name="address" ref="instance('phone')/number"/>
+      #       </m:syscall>
+      #     </m:button>
+      #     <m:button height="1ex">
+      #       <m:label>btn2</m:label>
+      #       <m:syscall name="click2call" ev:event="DOMActivate">
+      #         <m:param name="address">tel:5551212</m:param>
+      #       </m:syscall>
+      #     </m:button>
+      #When user selects the button "btn1" or "btn2", it places a phone call to the number.
+      #The syscall for btn1 uses the phone number from instance data.
+      def syscall(doc, name, address=nil, address_ref=nil, message=nil, message_ref=nil)
+        @view_buffer << "<m:syscall name=\"#{name}\" ev:event=\"DOMActivate\">"
+        @view_buffer << "<m:param name=\"address\">#{address}</m:param>" if address
+        @view_buffer << "<m:param name=\"address\" ref=\"#{address_ref}\"/>" if address_ref
+        @view_buffer << "<m:param name=\"message\">#{message}</m:param>" if message
+        @view_buffer << "<m:param name=\"message\" ref=\"#{message_ref}\"/>" if message_ref
+        @view_buffer << '</m:syscall>'
+      end
+      #Create exit control to exit the client.
+      #==== Examples
+      #     @xml.softkey(body, "1", "exit") do |soft1|
+      #       @xml.exit_tag(soft1)
+      #     end
+      #generates a left softkey that exits the client:
+      #     <m:softkey position="1">
+      #       <m:label>exit</m:label>
+      #       <m:exit ev:event="DOMActivate"/>
+      #     </m:softkey>
+      def exit_tag(doc)
+        @view_buffer << "<m:exit ev:event=\"DOMActivate\"/>"
+      end
+      #Create back control to go back to previous page.
+      #==== Examples
+      #     @xml.softkey(body, "3", "back") do |soft1|
+      #       @xml.back_tag(soft1)
+      #     end
+      #generates a right softkey that go back to previous page:
+      #     <m:softkey position="3">
+      #       <m:label>back</m:label>
+      #       <m:back ev:event="DOMActivate"/>
+      #     </m:softkey>
+      def back_tag(doc)
+        @view_buffer << "<m:back ev:event=\"DOMActivate\"/>"
+      end
       #Override builder method_missing method to send output to model buffer so we
       #can create arbitrary xml tags in the model. Typically combine with instance_tag
       #to create model instance that can be used in any of the action tag (link, submit_tag, etc.)
@@ -918,12 +1064,13 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
         lightBlue = "#CADBDB";
         brown = "#89613A";
         turqoise = "#89B0B0";
-        @model_buffer << "<m:class name=\"body\"><m:background-color value=\"#ffffff\"/><m:scrollbar-track-color value=\"#{turqoise}\"/><m:scrollbar-slider-color value=\"#003366\" /></m:class>"
+        @model_buffer << "<m:class name=\"body\"><m:background-color value=\"#{lightBlue}\"/><m:scrollbar-track-color value=\"#{turqoise}\"/><m:scrollbar-slider-color value=\"#003366\" /></m:class>"
+        @model_buffer << "<m:class name=\"footer\"><m:background-color value=\"#{lightBlue}\"/></m:class>"
         @model_buffer << '<m:class name="white"><m:font-color value="#ffffff"/></m:class>'
         @model_buffer << '<m:class name="white:focused"><m:font-color value="#0"/></m:class>'
         @model_buffer <<
           '<class name="label">
             <font-color value="#000000" />
@@ -949,6 +1096,8 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
         <m:background-color value="#FFFFFF" />
         <m:font-color value="#000000" />
         <m:font-weight value="bold" />
+        <m:border value="1"/>
+        <m:border-color value="#006633"/>
     </m:class> '
         @model_buffer <<
           '<m:class name="bold">