rmobio 1.1.25 → 1.1.26

data/lib/rmobio/doc/rdoc-style.css

@@ -0,0 +1,208 @@
+
+body {
+    font-family: Verdana,Arial,Helvetica,sans-serif;
+    font-size:   90%;
+    margin: 0;
+    margin-left: 40px;
+    padding: 0;
+    background: white;
+}
+
+h1,h2,h3,h4 { margin: 0; color: #efefef; background: transparent; }
+h1 { font-size: 150%; }
+h2,h3,h4 { margin-top: 1em; }
+
+a { background: #eef; color: #039; text-decoration: none; }
+a:hover { background: #039; color: #eef; }
+
+/* Override the base stylesheet's Anchor inside a table cell */
+td > a {
+  background: transparent;
+  color: #039;
+  text-decoration: none;
+}
+
+/* and inside a section title */
+.section-title > a {
+  background: transparent;
+  color: #eee;
+  text-decoration: none;
+}
+
+/* === Structural elements =================================== */
+
+div#index {
+    margin: 0;
+    margin-left: -40px;
+    padding: 0;
+    font-size: 90%;
+}
+
+
+div#index a {
+    margin-left: 0.7em;
+}
+
+div#index .section-bar {
+   margin-left: 0px;
+   padding-left: 0.7em;
+   background: #ccc;
+   font-size: small;
+}
+
+
+div#classHeader, div#fileHeader {
+    width: auto;
+    color: white;
+    padding: 0.5em 1.5em 0.5em 1.5em;
+    margin: 0;
+    margin-left: -40px;
+    border-bottom: 3px solid #006;
+}
+
+div#classHeader a, div#fileHeader a {
+    background: inherit;
+    color: white;
+}
+
+div#classHeader td, div#fileHeader td {
+    background: inherit;
+    color: white;
+}
+
+
+div#fileHeader {
+    background: #057;
+}
+
+div#classHeader {
+    background: #048;
+}
+
+
+.class-name-in-header {
+  font-size:  180%;
+  font-weight: bold;
+}
+
+
+div#bodyContent {
+    padding: 0 1.5em 0 1.5em;
+}
+
+div#description {
+    padding: 0.5em 1.5em;
+    background: #efefef;
+    border: 1px dotted #999;
+}
+
+div#description h1,h2,h3,h4,h5,h6 {
+    color: #125;;
+    background: transparent;
+}
+
+div#validator-badges {
+    text-align: center;
+}
+div#validator-badges img { border: 0; }
+
+div#copyright {
+    color: #333;
+    background: #efefef;
+    font: 0.75em sans-serif;
+    margin-top: 5em;
+    margin-bottom: 0;
+    padding: 0.5em 2em;
+}
+
+
+/* === Classes =================================== */
+
+table.header-table {
+    color: white;
+    font-size: small;
+}
+
+.type-note {
+    font-size: small;
+    color: #DEDEDE;
+}
+
+.xxsection-bar {
+    background: #eee;
+    color: #333;
+    padding: 3px;
+}
+
+.section-bar {
+   color: #333;
+   border-bottom: 1px solid #999;
+    margin-left: -20px;
+}
+
+
+.section-title {
+    background: #79a;
+    color: #eee;
+    padding: 3px;
+    margin-top: 2em;
+    margin-left: -30px;
+    border: 1px solid #999;
+}
+
+.top-aligned-row {  vertical-align: top }
+.bottom-aligned-row { vertical-align: bottom }
+
+/* --- Context section classes ----------------------- */
+
+.context-row { }
+.context-item-name { font-family: monospace; font-weight: bold; color: black; }
+.context-item-value { font-size: small; color: #448; }
+.context-item-desc { color: #333; padding-left: 2em; }
+
+/* --- Method classes -------------------------- */
+.method-detail {
+    background: #efefef;
+    padding: 0;
+    margin-top: 0.5em;
+    margin-bottom: 1em;
+    border: 1px dotted #ccc;
+}
+.method-heading {
+  color: black;
+  background: #ccc;
+  border-bottom: 1px solid #666;
+  padding: 0.2em 0.5em 0 0.5em;
+}
+.method-signature { color: black; background: inherit; }
+.method-name { font-weight: bold; }
+.method-args { font-style: italic; }
+.method-description { padding: 0 0.5em 0 0.5em; }
+
+/* --- Source code sections -------------------- */
+
+a.source-toggle { font-size: 90%; }
+div.method-source-code {
+    background: #262626;
+    color: #ffdead;
+    margin: 1em;
+    padding: 0.5em;
+    border: 1px dashed #999;
+    overflow: hidden;
+}
+
+div.method-source-code pre { color: #ffdead; overflow: hidden; }
+
+/* --- Ruby keyword styles --------------------- */
+
+.standalone-code { background: #221111; color: #ffdead; overflow: hidden; }
+
+.ruby-constant  { color: #7fffd4; background: transparent; }
+.ruby-keyword { color: #00ffff; background: transparent; }
+.ruby-ivar    { color: #eedd82; background: transparent; }
+.ruby-operator  { color: #00ffee; background: transparent; }
+.ruby-identifier { color: #ffdead; background: transparent; }
+.ruby-node    { color: #ffa07a; background: transparent; }
+.ruby-comment { color: #b22222; font-weight: bold; background: transparent; }
+.ruby-regexp  { color: #ffa07a; background: transparent; }
+.ruby-value   { color: #7fffd4; background: transparent; }

data/lib/rmobio/rxml/base_transformer.rb

@@ -298,35 +298,36 @@ The above code generates the following xhtml in Firefox:
         yield doc 
       end
       #Create table tag
-      #1. style:  html styles
-      #2. xstyle: xforms styles
-      def table(doc, style="", xstyle="")  
-        doc << "\n<table #{style}>"
+      #==== Options
+      #* <tt>:style</tt> -- specifies html, xhtml style attributes as a string
+      #* <tt>:xstyle</tt> -- specifies xforms style attributes as a string 
+      def table(doc, options={})  
+        doc << "\n<table #{options[:style]}>"
         yield doc 
         doc << '</table>'
       end
-      def row(doc, id=nil, nodeset=nil, style="", xstyle="")  
-        doc << "<tr #{style}>"
+      def row(doc, id=nil, nodeset=nil, options={})  
+        doc << "<tr #{options[:style]}>"
         yield doc 
         doc << '</tr>'
       end 
-      def row_list(doc, id=nil, style="", xstyle="") 
-        doc << "<tr #{style}>"
+      def row_list(doc, id=nil, options={}) 
+        doc << "<tr #{options[:style]}>"
         yield doc 
         doc << '</tr>'
       end
-      def itemset(doc, id, nodeset, style="", xstyle="") 
+      def itemset(doc, id, nodeset, options={}) 
         yield doc  
       end 
-      def itemlist(doc, id, style=nil, xstyle=nil)  
+      def itemlist(doc, id, options={})  
         yield doc  
       end 
-      def cell(doc, style=nil, xstyle=nil) 
-        doc << "<td #{style}>" 
+      def cell(doc, options={}) 
+        doc << "<td #{options[:style]}>" 
         yield doc
         doc << '</td>'
       end 
-      def list(doc, style=nil, xstyle=nil)   
+      def list(doc, options={})   
         yield doc  
       end 
       # The following tags are only supported by xforms client  

data/lib/rmobio/rxml/xforms_transformer.rb

@@ -49,7 +49,7 @@ The above code generates the following xforms for Mobio runner:
         xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
 	xmlns:ev="http://www.w3.org/2001/xml-events">
    <head>
-   <model></model></head>
+   <xf:model></xf:model></head>
 
    <body style="body">
    <m:image height="5ex" width="100%">http://localhost:3000/images/rails.png</m:image>
@@ -74,12 +74,12 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
 	xmlns:ev="http://www.w3.org/2001/xml-events">'  
     
         @model_buffer = '<head>' 
-        @model_buffer << "\n<model>"
+        @model_buffer << "\n<xf:model>"
         
         # basic_styles
         yield xml 
  
-        @model_buffer << "</model></head>\n" 
+        @model_buffer << "</xf:model></head>\n" 
         xml << @model_buffer << @view_buffer  
         xml << "</html>" 
         @view_buffer = ""
@@ -157,7 +157,7 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
       #     <m:output height="1ex" ref="instance('txt1')/images/id"/>
       #* Text widget displays string from a pre defined instance in a relative path:
       #   @xml.itemset(list, 'tb1', "instance('audios')/items/item") do |row|
-      #    @xml.cell(row) do |cell|
+      #    @xml.cell(row)do |cell|
       #     @xml.text(cell, "", :xpath=>'@name')
       #    end
       #   end
@@ -618,7 +618,24 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
       #       <email id ="2" date="4/2" read="0" check="" from="admin@foo.com">Meeting reminder</email>
       #       <email id ="3" date="4/2" read="1" check="" from="customerservice@amazon.com">Your account activities</email>
       #     </data>  
-      #     
+      #
+      #* Create an instance with multiple layers:
+      #   
+      #   @xml.instance_tag(body, "photos") do |x|
+      #     @xml.items do |y|
+      #       @xml.item("image1")
+      #       @xml.item("image2")
+      #     end
+      #   end 
+      #generates the following instance in xforms model:
+      #   <xf:instance id="photos">
+      #     <data xmlns="">
+      #       <items>
+      #         <item>image1</item>
+      #         <item>image2</item>
+      #       </items>
+      #     </data>
+      #     </xf:instance>
       def instance_tag(doc, id, src=nil, &block)
         if src.nil?
           @model_buffer << "\n<xf:instance id=\"#{id}\"><data xmlns=\"\">"
@@ -640,43 +657,111 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
         yield doc
         @view_buffer << "</m:hstack>"
       end
-      #Create grid control, similar to table in html
-      #1. style:  html styles
-      #2. xstyle: xforms styles
-      def table(doc, style="", xstyle="") 
-        @view_buffer << "\n<m:grid #{xstyle}>"
+      #Create grid control, similar to table in html. 
+      #==== Options
+      #* <tt>:style</tt> -- specifies html, xhtml style attributes as a string
+      #* <tt>:xstyle</tt> -- specifies xforms style attributes as a string 
+      #==== Examples 
+      #   Create photos instance:
+      #   @xml.instance_tag(body, "photos") do |x|
+      #     @xml.items do |y|
+      #       @xml.item("image1", :val=>'1')
+      #       @xml.item("image2", :val=>'2')
+      #     end
+      #   end 
+      #   
+      #   Create grid widget:
+      #   @xml.table(body) do |tbl|
+      #     @xml.row(tbl, "mylist", "instance('photos')/items/item", :xstyle=>'col="auto"') do |row|
+      #       @xml.cell(row) do |td| 
+      #         @xml.text(td, "", :xpath=>'.')  
+      #         @xml.text(td, "", :xpath=>'@val') 
+      #       end  
+      #     end  
+      #   end  
+      #Generates the following xforms:
+      #In the model:
+      #   <xf:instance id="photos">
+      #     <data xmlns="">
+      #       <items><item val="1">image1</item><item val="2">image2</item></items>
+      #     </data>
+      #     </xf:instance>  
+      #
+      #In the view:
+      #     <m:grid>
+      #       <m:rowset id="mylist" nodeset="instance('photos')/items/item"  col="auto">
+      #         <m:item>
+      #           <m:output height="1ex" ref="."/>
+      #           <m:output height="1ex" ref="@val"/>
+      #         </m:item>
+      #       </m:rowset>
+      #     </m:grid>
+      #The UI is a table with 2 columns and 2 rows of text data.
+      def table(doc, options={}) 
+        @view_buffer << "\n<m:grid #{options[:xstyle]}>"
         yield doc 
         @view_buffer << '</m:grid>'
       end 
-      def row(doc, id, nodeset, style=nil, xstyle='col="auto"') 
-        @view_buffer << "<m:rowset id=\"#{id}\" nodeset=\"#{nodeset}\" #{xstyle}>"
+      #Create grid rowset control, similar to <tr> in html. 
+      #1. id - the widget id
+      #2. nodeset - the xpath to the instance data
+      #==== Options
+      #* <tt>:style</tt> -- specifies html, xhtml style attributes as a string
+      #* <tt>:xstyle</tt> -- specifies xforms style attributes as a string 
+      def row(doc, id=nil, nodeset=nil, options={}) 
+        @view_buffer << "<m:rowset id=\"#{id}\" nodeset=\"#{nodeset}\" "
+        options[:xstyle] = 'col="auto"' if #{options[:xstyle]}.nil?
+        @view_buffer << " #{options[:xstyle]}>"
         yield doc 
         @view_buffer << '</m:rowset>'
       end 
-      def row_list(doc, id, style="", xstyle="")
-        @view_buffer << "<m:rowlist id=\"#{id}\" #{xstyle}>"
+      #Create grid rowlist control. similar to <tr> in html.
+      #1. id - the widget id 
+      #==== Options
+      #* <tt>:style</tt> -- specifies html, xhtml style attributes as a string
+      #* <tt>:xstyle</tt> -- specifies xforms style attributes as a string 
+      def row_list(doc, id, options={})
+        @view_buffer << "<m:rowlist id=\"#{id}\" #{options[:xstyle]}>"
         yield doc 
         @view_buffer << '</m:rowlist>'
       end
-      
-      def itemset(doc, id, nodeset, style="", xstyle="")
-        @view_buffer << "<m:itemset id=\"#{id}\" nodeset=\"#{nodeset}\" #{xstyle}>"
+      #Create <m:itemset> control which takes a nodeset attribute and iterates  
+      #items in the nodese
+      #1. id - the widget id 
+      #2. nodset - the xpath to the instance data
+      #==== Options
+      #* <tt>:style</tt> -- specifies html, xhtml style attributes as a string
+      #* <tt>:xstyle</tt> -- specifies xforms style attributes as a string 
+      def itemset(doc, id, nodeset, options={})
+        @view_buffer << "<m:itemset id=\"#{id}\" nodeset=\"#{nodeset}\" #{options[:xstyle]}>"
         yield doc 
         @view_buffer << '</m:itemset>'
       end 
-      def itemlist(doc, id, style=nil, xstyle=nil) 
-        @view_buffer << "<m:itemlist id=\"#{id}\" #{xstyle}>"
+      #Create <m:itemlist> control with static data.
+      #1. id - the widget id  
+      #==== Options
+      #* <tt>:style</tt> -- specifies html, xhtml style attributes as a string
+      #* <tt>:xstyle</tt> -- specifies xforms style attributes as a string 
+      def itemlist(doc, id, options={}) 
+        @view_buffer << "<m:itemlist id=\"#{id}\" #{options[:xstyle]}>"
         yield doc 
         @view_buffer << '</m:itemlist>'
       end 
-      def cell(doc, style=nil, xstyle='style="item"')  
-        @view_buffer << "<m:item #{xstyle}>"
+      #Create <m:item> control.
+      #==== Options
+      #* <tt>:style</tt> -- specifies html, xhtml style attributes as a string
+      #* <tt>:xstyle</tt> -- specifies xforms style attributes as a string 
+      def cell(doc, options={})  
+        @view_buffer << "<m:item #{options[:xstyle]}>"
         yield doc
         @view_buffer << '</m:item>'
       end  
-      #Create slist control.  
-      def list(doc, style=nil, xstyle='style="slist"')  
-        @view_buffer << "\n<m:slist #{xstyle}>"
+      #Create <m:slist> control.  
+      #==== Options
+      #* <tt>:style</tt> -- specifies html, xhtml style attributes as a string
+      #* <tt>:xstyle</tt> -- specifies xforms style attributes as a string 
+      def list(doc, options={})  
+        @view_buffer << "<m:slist #{options[:xstyle]}>"
         yield doc 
         @view_buffer << '</m:slist>'
       end 
@@ -809,18 +894,18 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
       #     <m:output style="option">Options</m:output>
       #   </m:hstack>
       #   <m:itemlist height="0" style="menu"> 
-      #     <m:item style="optionmenu" height="1ex" accesskey="1">
+      #     <m:item height="1ex" accesskey="1">
       #       <m:output style="label">move1</m:output>
       #       <xf:load resource="foo1.xml" ev:event="DOMActivate"/>
       #     </m:item>
-      #     <m:item style="optionmenu" height="1ex" accesskey="2">
+      #     <m:item height="1ex" accesskey="2">
       #       <m:output style="label">move2</m:output>
       #       <xf:load resource="foo2.xml" ev:event="DOMActivate"/>
       #     </m:item>
-      #     <m:item style="optionmenu" height="1ex" accesskey="3">
+      #     <m:item height="1ex" accesskey="3">
       #       <m:output style="label">move3</m:output>
       #     </m:item>
-      #     <m:item style="optionmenu" height="1ex" accesskey="0">
+      #     <m:item height="1ex" accesskey="0">
       #       <m:output style="label">exit</m:output>
       #       <m:exit ev:event="DOMActivate"/>
       #     </m:item>
@@ -850,15 +935,15 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
       #2. label: what is displayed on the title of the popup window. Default label \
       #is "Options".
       #3. xstyle: the xforms style string for the popup window. If xstyle is not \
-      #specified, default style string "width='40%' style='popup-menu'" is used. 
+      #specified, default style string "width='40%'" is used. 
       #==== Examples
       #Refer to softkey examples
       def menus(doc, id, label="Options", xstyle=nil) 
         @view_buffer << "<m:menu id=\"#{id}\" height=\"0\""
         if xstyle
-          @view_buffer << " #{xstyle}>"
+          @view_buffer << " #{xstyle}>" if xstyle
         else
-          @view_buffer << " width=\"40%\" style=\"popup-menu\">"
+          @view_buffer << " width=\"40%\">"
         end
          
         @view_buffer << "<m:hstack height=\"1ex\" style=\"title\"><m:icon>jar://img/option.png</m:icon>"
@@ -879,8 +964,7 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
       #is "Options".
       #2. accesskey: A short cut key (0-9) that is assigned to this menu item. If \
       #not specified, it is asssinged a number sequentially.
-      #3. xstyle: the xforms style string for the menu item. If xstyle is not \
-      #specified, default style string "style='optionmenu'" is used. 
+      #3. xstyle: the xforms style string for the menu item.  
       #==== Examples
       #Refer to softkey examples 
       def menu(doc, label, accesskey=nil, xstyle=nil, &block) 
@@ -890,12 +974,8 @@ A rails icon and some text will be displayed on Mobio runner when you load the r
         else 
           @view_buffer << "#{@accesskey+=1}"
         end 
+        @view_buffer << " style=\"#{xstyle}\"" if xstyle
         @view_buffer << "\">"
-        if xstyle 
-          @view_buffer << " style=\"#{xstyle}\""
-        else
-          @view_buffer << " style=\"optionmenu\""
-        end  
         @view_buffer << "<m:output style=\"label\">" << label << "</m:output>"
         if block
           yield doc