RubyGems - rmobio - Versions diffs - 1.1.24 → 1.1.25 - Mend

rmobio 1.1.24 → 1.1.25

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 (520) hide show

data/lib/rmobio/doc/classes/Rmobio/Rxml/XformsTransformer.html DELETED Viewed

@@ -1,1878 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Class: Rmobio::Rxml::XformsTransformer</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-    elemStyle = elem.style;
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-    return true;
-  }
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  // ]]>
-  </script>
-</head>
-<body>
-    <div id="classHeader">
-        <table class="header-table">
-        <tr class="top-aligned-row">
-          <td><strong>Class</strong></td>
-          <td class="class-name-in-header">Rmobio::Rxml::XformsTransformer</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../../../files/rxml/xforms_transformer_rb.html">
-                rxml/xforms_transformer.rb
-                </a>
-        <br />
-            </td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>Parent:</strong></td>
-            <td>
-                BaseTransformer
-            </td>
-        </tr>
-        </table>
-    </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-    <div id="description">
-      <p>
-Provide a transformer to translate rxml document to xforms markup for Mobio
-client. It subclasses BaseTransformer class and overwirtes the tag methods
-to produce the proper xforms markup. To get xforms transformer, pass the
-client type &#8216;xf&#8217; to TransformerFactory get_transformer method:
-</p>
-<pre>
-  require 'rmobio/rxml/transformer_factory'
-  @xml = TransformerFactory.get_transformer('xf')
-</pre>
-<p>
-or call the instance method to get the instance:
-</p>
-<pre>
-  require 'rmobio/rxml/xforms_transformer'
-  @xml = XformsTransformer.instance
-</pre>
-<p>
-Here is an example rxml view that uses the transformer methods to output
-xforms document:
-</p>
-<pre>
- img = {:alt=&gt;&quot;Rails&quot;, :xstyle=&gt;'height=&quot;5ex&quot; width=&quot;100%&quot;'}
- @xml.doctimgype(xml) do |x|
-  @xml.body(x, 'mobio') do|body|
-    @xml.image(body, &quot;img1&quot;, 'http://localhost:3000/images/rails.png',img)
-    @xml.softBr(body)
-    @xml.text(body, 'My test app')
-  end
- end
-</pre>
-<p>
-The above code generates the following xforms for Mobio runner:
-</p>
-<pre>
-    &lt;html id=&quot;root&quot; xmlns=&quot;http://www.w3.org/1999/xhtml&quot;
-        xmlns:xf=&quot;http://www.w3.org/2002/xforms&quot;
-        xmlns:m=&quot;http://www.mobio.com/ext&quot;
-        xmlns:ext=&quot;http://www.mobio.com/ext&quot;
-        xmlns:ev=&quot;http://www.w3.org/2001/xml-events&quot;&gt;
-   &lt;head&gt;
-   &lt;model&gt;&lt;/model&gt;&lt;/head&gt;
-   &lt;body style=&quot;body&quot;&gt;
-   &lt;m:image height=&quot;5ex&quot; width=&quot;100%&quot;&gt;http://localhost:3000/images/rails.png&lt;/m:image&gt;
-   &lt;m:hstack height=&quot;1ex&quot;/&gt;
-   &lt;m:output height=&quot;1ex&quot;&gt;My test app&lt;/m:output&gt;&lt;/body&gt;&lt;/html&gt;
-</pre>
-<p>
-A rails icon and some <a href="XformsTransformer.html#M000003">text</a>
-will be displayed on Mobio runner when you load the rxml page.
-</p>
-    </div>
-   </div>
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-      <div class="name-list">
-      <a href="#M000029">back_tag</a>&nbsp;&nbsp;
-      <a href="#M000002">body</a>&nbsp;&nbsp;
-      <a href="#M000009">button</a>&nbsp;&nbsp;
-      <a href="#M000001">doctype</a>&nbsp;&nbsp;
-      <a href="#M000028">exit_tag</a>&nbsp;&nbsp;
-      <a href="#M000007">form</a>&nbsp;&nbsp;
-      <a href="#M000013">image</a>&nbsp;&nbsp;
-      <a href="#M000005">input</a>&nbsp;&nbsp;
-      <a href="#M000014">instance_tag</a>&nbsp;&nbsp;
-      <a href="#M000008">link</a>&nbsp;&nbsp;
-      <a href="#M000019">list</a>&nbsp;&nbsp;
-      <a href="#M000026">load_tag</a>&nbsp;&nbsp;
-      <a href="#M000025">menu</a>&nbsp;&nbsp;
-      <a href="#M000024">menus</a>&nbsp;&nbsp;
-      <a href="#M000030">method_missing</a>&nbsp;&nbsp;
-      <a href="#M000010">model_tag</a>&nbsp;&nbsp;
-      <a href="#M000012">softBr</a>&nbsp;&nbsp;
-      <a href="#M000023">softkey</a>&nbsp;&nbsp;
-      <a href="#M000006">submit_tag</a>&nbsp;&nbsp;
-      <a href="#M000021">switch</a>&nbsp;&nbsp;
-      <a href="#M000027">syscall</a>&nbsp;&nbsp;
-      <a href="#M000020">tab</a>&nbsp;&nbsp;
-      <a href="#M000015">table</a>&nbsp;&nbsp;
-      <a href="#M000018">table_cell</a>&nbsp;&nbsp;
-      <a href="#M000016">table_row</a>&nbsp;&nbsp;
-      <a href="#M000017">table_row_list</a>&nbsp;&nbsp;
-      <a href="#M000003">text</a>&nbsp;&nbsp;
-      <a href="#M000004">textarea</a>&nbsp;&nbsp;
-      <a href="#M000011">view_tag</a>&nbsp;&nbsp;
-      <a href="#M000022">xcase</a>&nbsp;&nbsp;
-      </div>
-    </div>
-  </div>
-    <!-- if includes -->
-    <div id="includes">
-      <h3 class="section-bar">Included Modules</h3>
-      <div id="includes-list">
-        <span class="include-name">Singleton</span>
-      </div>
-    </div>
-    <div id="section">
-    <!-- if method_list -->
-    <div id="methods">
-      <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000029" class="method-detail">
-        <a name="M000029"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000029.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000029.html');return false;">
-          <span class="method-name">back_tag</span><span class="method-args">(doc)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Create back control to go back to previous page.
-</p>
-<h4>Examples</h4>
-<pre>
-     @xml.softkey(body, &quot;3&quot;, &quot;back&quot;) do |soft1|
-       @xml.back_tag(soft1)
-     end
-</pre>
-<p>
-generates a right <a href="XformsTransformer.html#M000023">softkey</a> that
-go back to previous page:
-</p>
-<pre>
-     &lt;m:softkey position=&quot;3&quot;&gt;
-       &lt;m:label&gt;back&lt;/m:label&gt;
-       &lt;m:back ev:event=&quot;DOMActivate&quot;/&gt;
-     &lt;/m:softkey&gt;
-</pre>
-        </div>
-      </div>
-      <div id="method-M000002" class="method-detail">
-        <a name="M000002"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000002.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000002.html');return false;">
-          <span class="method-name">body</span><span class="method-args">(doc, title=&quot;&quot;, style=nil) {|doc| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Generate xthml head and <a href="XformsTransformer.html#M000002">body</a>
-tag. The title argument is not used for xforms client. The style is
-optional. If style is specified, it will be added to the xforms style tag
-with src attribute:
-</p>
-<p>
-In rxml:
-</p>
-<pre>
-  @xml.body(x, 'mobio', 'default_style.xml')
-</pre>
-<p>
-generates the following xforms markup:
-</p>
-<pre>
-  &lt;style xmlns=&quot;http://www.mobio.com/ext&quot; src=&quot;default_style.xml&quot;/&gt;
-</pre>
-<p>
-Please note, by default when client sees the src attribute, it is expecting
-the response content to be sent as &#8216;application/xml&#8217; not
-&#8216;application/mform&#8217; (for complete xforms document). For the
-styles to work, you will need to handle the url so it sends back the xml
-content with http content-type header set to &#8216;application/xml&#8217;.
-</p>
-<p>
-An easier way to include external styles is to output the styles using
-builder xml (not transformer @xml) variable:
-</p>
-<h4>Examples</h4>
-<pre>
-   @xml.body(x, 'mobio') do |body|
-   xml &lt;&lt; render(:partial=&gt; 'default_style.xml')
-</pre>
-<p>
-The content in the style xml (note, it will be _default_style.xml) will
-then be embeded in the final document.
-</p>
-        </div>
-      </div>
-      <div id="method-M000009" class="method-detail">
-        <a name="M000009"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000009.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000009.html');return false;">
-          <span class="method-name">button</span><span class="method-args">(doc, url, label, options={}) {|doc| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Create <a href="XformsTransformer.html#M000009">button</a> control. If
-there&#8216;s no call block, &lt;xf:load&gt; 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 <a
-href="XformsTransformer.html#M000011">view_tag</a>. Default event type is
-ev:event=&quot;DOMActivate&quot; for the <a
-href="XformsTransformer.html#M000009">button</a>.
-</p>
-<ol>
-<li>url: the http get url when user press the <a
-href="XformsTransformer.html#M000009">button</a>, only valid if
-there&#8216;s no call block
-</li>
-<li>label: label displayed on the <a
-href="XformsTransformer.html#M000009">button</a>
-</li>
-</ol>
-<h4>Options</h4>
-<pre>
- * &lt;tt&gt;:xstyle&lt;/tt&gt; -- specifies xforms style attributes like height, width, style,        #etc. as string.
-</pre>
-<h4>Examples</h4>
-<ul>
-<li>Simple <a href="XformsTransformer.html#M000008">link</a>:
-<pre>
- @xml.link(body, &quot;http://m.twitter.com&quot;, &quot;Twitter&quot;)
-</pre>
-</li>
-</ul>
-<p>
-generate the following xforms:
-</p>
-<pre>
-   &lt;m:button height=&quot;1ex&quot;&gt;&lt;m:label&gt;Twitter&lt;/m:label&gt;
-     &lt;xf:load ev:event=&quot;DOMActivate&quot; resource=&quot;http://m.twitter.com&quot;/&gt;
-   &lt;/m:button&gt;
-</pre>
-<ul>
-<li>Customize action:
-<pre>
- @xml.link(body, &quot;http://m.twitter.com&quot;, &quot;Twitter&quot;)  do |link|
-   @xml.view_tag(link, '&lt;xf:toggle case=&quot;page2&quot; ev:event=&quot;DOMActivate&quot;/&gt;')
- end
-</pre>
-</li>
-</ul>
-<p>
-generates the following xforms:
-</p>
-<pre>
-   &lt;m:button height=&quot;1ex&quot;&gt;&lt;m:label&gt;Twitter&lt;/m:label&gt;
-     &lt;xf:toggle case=&quot;page2&quot; ev:event=&quot;DOMActivate&quot;/&gt;
-   &lt;/m:button&gt;
-</pre>
-        </div>
-      </div>
-      <div id="method-M000001" class="method-detail">
-        <a name="M000001"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000001.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000001.html');return false;">
-          <span class="method-name">doctype</span><span class="method-args">(xml) {|xml| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Generate standdard xforms document header. The model output goes to
-instance variable @model_buffer and view output goes to instance variable
-@view_buffer. Any tag methods in the call block will be directed to either
-view or model buffer (depending on the tag method) and combined to produce
-the final document.
-</p>
-        </div>
-      </div>
-      <div id="method-M000028" class="method-detail">
-        <a name="M000028"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000028.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000028.html');return false;">
-          <span class="method-name">exit_tag</span><span class="method-args">(doc)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Create exit control to exit the client.
-</p>
-<h4>Examples</h4>
-<pre>
-     @xml.softkey(body, &quot;1&quot;, &quot;exit&quot;) do |soft1|
-       @xml.exit_tag(soft1)
-     end
-</pre>
-<p>
-generates a left <a href="XformsTransformer.html#M000023">softkey</a> that
-exits the client:
-</p>
-<pre>
-     &lt;m:softkey position=&quot;1&quot;&gt;
-       &lt;m:label&gt;exit&lt;/m:label&gt;
-       &lt;m:exit ev:event=&quot;DOMActivate&quot;/&gt;
-     &lt;/m:softkey&gt;
-</pre>
-        </div>
-      </div>
-      <div id="method-M000007" class="method-detail">
-        <a name="M000007"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000007.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000007.html');return false;">
-          <span class="method-name">form</span><span class="method-args">(doc, id, action, method) {|doc| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Not supported for xforms client. Just pass the block. Xforsm client should
-use <a href="XformsTransformer.html#M000014">instance_tag</a>, <a
-href="XformsTransformer.html#M000006">submit_tag</a> for <a
-href="XformsTransformer.html#M000007">form</a> submission.
-</p>
-        </div>
-      </div>
-      <div id="method-M000013" class="method-detail">
-        <a name="M000013"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000013.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000013.html');return false;">
-          <span class="method-name">image</span><span class="method-args">(doc, id, src, options={})</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Create <a href="XformsTransformer.html#M000013">image</a> widget. There are
-two types of <a href="XformsTransformer.html#M000013">image</a> control:
-icon and <a href="XformsTransformer.html#M000013">image</a>. See Mobio
-client user manual for details.
-</p>
-<ol>
-<li>id: name of the widget
-</li>
-<li>src: the url of the <a href="XformsTransformer.html#M000013">image</a>
-</li>
-<li>options: all other attributes
-</li>
-</ol>
-<h4>Options</h4>
-<ul>
-<li><tt>:xstyle</tt> &#8212; specifies xforms style attributes like height,
-width, style, etc. as string.
-</li>
-<li><tt>:widget</tt> &#8212; specifies the widget to use, &quot;icon&quot; or
-&quot;<a href="XformsTransformer.html#M000013">image</a>&quot;. Default is
-&lt;<a href="XformsTransformer.html#M000013">image</a>&gt;.
-</li>
-<li><tt>:xpath</tt> &#8212; specifies the xpath for the instance data that
-contains the <a href="XformsTransformer.html#M000013">image</a> url.
-It&#8216;s only used when id attribute is specified.
-</li>
-</ul>
-<h4>Examples (</h4>
-<ul>
-<li>Create a simple <a href="XformsTransformer.html#M000013">image</a> control
-Note, define the style options outside the <a
-href="XformsTransformer.html#M000001">doctype</a> block):
-<pre>
-  img = {:alt=&gt;&quot;Rails&quot;, :xstyle=&gt;'height=&quot;5ex&quot; width=&quot;100%&quot;'}
-  @xml.doctype(xml) do |x|
-    @xml.body(x, 'mobio', 'default_style.xml') do|body|
-      @xml.image(body, &quot;img1&quot;, 'http://localhost:3000/images/rails.png',img)
-    end
-  end
-</pre>
-</li>
-</ul>
-<p>
-generates the following xforms:
-</p>
-<pre>
-    &lt;m:image height=&quot;5ex&quot; width=&quot;100%&quot;&gt;http://localhost:3000/images/rails.png&lt;/m:image&gt;
-</pre>
-<p>
-The <a href="XformsTransformer.html#M000013">image</a> will be scaled to 5
-character high on the screen when the page is loaded.
-</p>
-<ul>
-<li>This example creates an icon widget which takes the <a
-href="XformsTransformer.html#M000013">image</a> url from an instance
-variable:
-<pre>
-  @xml.image(body, &quot;img1&quot;, 'http://localhost:3000/images/rails.png',
-     {:xstyle=&gt;'height=&quot;3ex&quot; width=&quot;20em&quot;',
-      :xpath=&gt;&quot;images/url&quot;,
-      :widget=&gt;&quot;icon&quot;})
-</pre>
-</li>
-</ul>
-<p>
-generates the following xforms:
-</p>
-<pre>
-    &lt;m:icon height=&quot;3ex&quot; width=&quot;20em&quot; ref=&quot;instance('img1')/images/url&quot;&gt;&lt;/m:icon&gt;
-</pre>
-<p>
-The icon takes the url from an instance named &quot;img1&quot; with xpath
-/images/url. The instance data has to be defined for the <a
-href="XformsTransformer.html#M000013">image</a> to be displayed.
-</p>
-        </div>
-      </div>
-      <div id="method-M000005" class="method-detail">
-        <a name="M000005"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000005.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000005.html');return false;">
-          <span class="method-name">input</span><span class="method-args">(doc, id, value, type, options={})</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Create user <a href="XformsTransformer.html#M000005">input</a> field.
-</p>
-<ol>
-<li>id: The instance id that will be associated with this <a
-href="XformsTransformer.html#M000005">input</a> field. An instance data
-will be created automatically in the model if options[:xpath] is not
-specified. The instance is created with only one tag: &#8216;txt&#8217;.
-</li>
-<li>value: initial value that will be displayed when ui is loaded
-</li>
-<li>type: not used for xforms client
-</li>
-</ol>
-<h4>Options</h4>
-<ul>
-<li><tt>:xstyle</tt> &#8212; specifies xforms style attributes as a string
-</li>
-<li><tt>:xpath</tt> &#8212; specifies the xpath of the <a
-href="XformsTransformer.html#M000005">input</a> data in the model
-</li>
-</ul>
-<h4>Examples</h4>
-<ul>
-<li>Create a simple <a href="XformsTransformer.html#M000005">input</a> box:
-<pre>
- @xml.input(body, &quot;name&quot;, &quot;john&quot;, &quot;text&quot;)
-</pre>
-</li>
-</ul>
-<p>
-generates the following xforms:
-</p>
-<p>
-In Model section of the <a href="XformsTransformer.html#M000007">form</a>:
-</p>
-<pre>
-   &lt;xf:instance id=&quot;name&quot;&gt;
-     &lt;data xmlns=&quot;&quot;&gt;&lt;txt&gt;john&lt;/txt&gt;&lt;/data&gt;
-   &lt;/xf:instance&gt;
-</pre>
-<p>
-In View section of the <a href="XformsTransformer.html#M000007">form</a>:
-</p>
-<pre>
-   &lt;m:input  height=&quot;1ex&quot; ref=&quot;instance('name')/txt&quot;/&gt;
-</pre>
-<p>
-Notice the instance data is created automatically because the rxml tag
-didn&#8216;t specify the :xpath argument. Mobio runner will display an <a
-href="XformsTransformer.html#M000005">input</a> box with default value
-&quot;john&quot; in the box when the page is launched. User can edit the
-string in the box and the value will be assinged to the model
-instance(&#8216;name&#8217;)/txt.
-</p>
-<ul>
-<li>The next example shows how to create an <a
-href="XformsTransformer.html#M000005">input</a> tag with predefined
-instance data:
-</li>
-</ul>
-<p>
-Note, create the options hash before the beginning of the document)
-</p>
-<pre>
- options = {
-   :style=&gt; 'style=&quot;white&quot;',
-   :xstyle=&gt;'maxlength=&quot;10&quot; style=&quot;white&quot;',
-   :xpath=&gt;&quot;images/id&quot;}
-    @xml.doctype(xml) do |x|
-      @xml.body(x, 'mobio', 'default_style.xml') do|body|
-        @xml.input(body, &quot;img&quot;, &quot;&quot;, &quot;text&quot;, options)
-      end
-    end
-</pre>
-<p>
-The above rxml generates only the view part in the xforms:
-</p>
-<pre>
-   &lt;m:input maxlength=&quot;10&quot; style=&quot;white&quot; height=&quot;1ex&quot; ref=&quot;instance('img')/images/id/&gt;
-</pre>
-<p>
-It assumes you already defined an instance &#8216;img&#8217; in the model
-with tag /images/id. If the instance data is not defined, you will see a
-blank <a href="XformsTransformer.html#M000005">input</a> box but you
-can&#8216;t move focus to the box and you can&#8216;t enter any <a
-href="XformsTransformer.html#M000003">text</a>. If the instance model is
-defined, the <a href="XformsTransformer.html#M000005">input</a> box will
-come up blank and user can only enter up to 10 characters (defined in
-maxlength attribute) in the field.
-</p>
-        </div>
-      </div>
-      <div id="method-M000014" class="method-detail">
-        <a name="M000014"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000014.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000014.html');return false;">
-          <span class="method-name">instance_tag</span><span class="method-args">(doc, id, src=nil) {|doc| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Create an instance in the model
-</p>
-<ol>
-<li>id: the name of the instance that will be created
-</li>
-<li>src: the src of the instance data. If src is specified, the call block
-</li>
-</ol>
-<p>
-will not be executed.
-</p>
-<h4>Examples</h4>
-<ul>
-<li>Create a blank instance:
-<pre>
-   @xml.instance_tag(body, &quot;foo&quot;)
-</pre>
-</li>
-</ul>
-<p>
-generates the following xforms in the model:
-</p>
-<pre>
-     &lt;xf:instance id=&quot;foo&quot;&gt;&lt;data xmlns=&quot;&quot;&gt;&lt;/data&gt;&lt;/xf:instance&gt;
-</pre>
-<ul>
-<li>Combine <a href="XformsTransformer.html#M000014">instance_tag</a> with any
-xml tag to create a useful instance model:
-<pre>
-  @xml.instance_tag(body, &quot;name&quot;) do |y|
-    @xml.fname
-    @xml.lname(&quot;Doe&quot;)
-    @xml.info(&quot;Basic&quot;, :zip=&gt;&quot;95014&quot;, :phone=&gt;&quot;415-1111111&quot;)
-  end
-</pre>
-</li>
-</ul>
-<p>
-generates the instance data in the model:
-</p>
-<pre>
-    &lt;xf:instance id=&quot;name&quot;&gt;
-      &lt;data xmlns=&quot;&quot;&gt;
-        &lt;fname/&gt;
-        &lt;lname&gt;Doe&lt;/lname&gt;
-        &lt;info phone=&quot;415-1111111&quot; zip=&quot;95014&quot;&gt;Basic&lt;/info&gt;
-      &lt;/data&gt;
-    &lt;/xf:instance&gt;
-</pre>
-<ul>
-<li>Create an instance from a src url. The src url should return the instance
-data with HTTP content-type set to &#8216;application/xml&#8217;. The
-instance data is RELOADED every time the page is requested no matter
-it&#8216;s cached or not. This is useful when you want the whole xforms UI
-cached but a small set of instance data be refreshed every time user
-reloads the page.
-<pre>
-  @xml.instance_tag(body, &quot;&quot;, &quot;get_data&quot;)
-</pre>
-</li>
-</ul>
-<p>
-The rxml generates the following xforms in the model:
-</p>
-<pre>
-    &lt;xf:instance id=&quot;emails&quot; src=&quot;get_data&quot;/&gt;
-</pre>
-<p>
-and the template for url &quot;get_data&quot; returns this: (note the
-content-type header)
-</p>
-<pre>
-     &lt;% headers['Content-Type']='application/xml' %&gt;
-     &lt;data xmlns=&quot;&quot;&gt;
-       &lt;email id =&quot;1&quot; date=&quot;4/3&quot; read=&quot;0&quot; check=&quot;&quot; from=&quot;richard H.&quot;&gt;Lunch?&lt;/email&gt;
-       &lt;email id =&quot;2&quot; date=&quot;4/2&quot; read=&quot;0&quot; check=&quot;&quot; from=&quot;admin@foo.com&quot;&gt;Meeting reminder&lt;/email&gt;
-       &lt;email id =&quot;3&quot; date=&quot;4/2&quot; read=&quot;1&quot; check=&quot;&quot; from=&quot;customerservice@amazon.com&quot;&gt;Your account activities&lt;/email&gt;
-     &lt;/data&gt;
-</pre>
-        </div>
-      </div>
-      <div id="method-M000008" class="method-detail">
-        <a name="M000008"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000008.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000008.html');return false;">
-          <span class="method-name">link</span><span class="method-args">(doc, url, txt=&quot;&quot;, options={}) {|doc| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-There&#8216;s no <a href="XformsTransformer.html#M000008">link</a> widget
-in Mobio client so use a <a
-href="XformsTransformer.html#M000009">button</a> widget to provide the same
-feature for html <a href="XformsTransformer.html#M000008">link</a>. If url
-is provided and there&#8216;s no call block, &lt;xf:load&gt; 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 <a
-href="XformsTransformer.html#M000011">view_tag</a>. Default event type is
-ev:event=&quot;DOMActivate&quot; for the <a
-href="XformsTransformer.html#M000009">button</a>.
-</p>
-<ol>
-<li>url: the http get url when user press the <a
-href="XformsTransformer.html#M000009">button</a>, only valid if
-there&#8216;s no call block
-</li>
-<li>txt: label displayed on the <a
-href="XformsTransformer.html#M000009">button</a>
-</li>
-</ol>
-<h4>Options</h4>
-<pre>
- * &lt;tt&gt;:xstyle&lt;/tt&gt; -- specifies xforms style attributes like height, width, style,        #etc. as string.
-</pre>
-<h4>Examples</h4>
-<ul>
-<li>Simple <a href="XformsTransformer.html#M000008">link</a>:
-<pre>
- @xml.link(body, &quot;http://m.twitter.com&quot;, &quot;Twitter&quot;)
-</pre>
-</li>
-</ul>
-<p>
-generate the following xforms:
-</p>
-<pre>
-   &lt;m:button height=&quot;1ex&quot;&gt;&lt;m:label&gt;Twitter&lt;/m:label&gt;
-     &lt;xf:load ev:event=&quot;DOMActivate&quot; resource=&quot;http://m.twitter.com&quot;/&gt;
-   &lt;/m:button&gt;
-</pre>
-<ul>
-<li>Customize action:
-<pre>
- @xml.link(body, &quot;http://m.twitter.com&quot;, &quot;Twitter&quot;)  do |link|
-   @xml.view_tag(link, '&lt;xf:toggle case=&quot;page2&quot; ev:event=&quot;DOMActivate&quot;/&gt;')
- end
-</pre>
-</li>
-</ul>
-<p>
-generates the following xforms:
-</p>
-<pre>
-   &lt;m:button height=&quot;1ex&quot;&gt;&lt;m:label&gt;Twitter&lt;/m:label&gt;
-     &lt;xf:toggle case=&quot;page2&quot; ev:event=&quot;DOMActivate&quot;/&gt;
-   &lt;/m:button&gt;
-</pre>
-        </div>
-      </div>
-      <div id="method-M000019" class="method-detail">
-        <a name="M000019"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000019.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000019.html');return false;">
-          <span class="method-name">list</span><span class="method-args">(doc, style=&quot;&quot;, xstyle=&quot;&quot;) {|doc| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Create slist control. To be implemented
-</p>
-        </div>
-      </div>
-      <div id="method-M000026" class="method-detail">
-        <a name="M000026"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000026.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000026.html');return false;">
-          <span class="method-name">load_tag</span><span class="method-args">(doc, resource)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Create &lt;xf:load&gt; control to do a HTTP get for a new <a
-href="XformsTransformer.html#M000007">form</a>. Default event is
-&quot;DOMActivate&quot;.
-</p>
-<ol>
-<li>resource: the resource url that will be loaded.
-</li>
-</ol>
-<h4>Examples</h4>
-<pre>
- @xml.softkey(body, &quot;1&quot;, &quot;GO&quot;) do |soft1|
-   @xml.load_tag(soft1, &quot;foo2.xml&quot;)
- end
-</pre>
-<p>
-generates the following:
-</p>
-<pre>
-  &lt;m:softkey position=&quot;1&quot;&gt;
-   &lt;m:label&gt;GO&lt;/m:label&gt;
-   &lt;xf:load resource=&quot;foo2.xml&quot; ev:event=&quot;DOMActivate&quot;/&gt;
-  &lt;/m:softkey&gt;
-</pre>
-        </div>
-      </div>
-      <div id="method-M000025" class="method-detail">
-        <a name="M000025"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000025.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000025.html');return false;">
-          <span class="method-name">menu</span><span class="method-args">(doc, label, accesskey=nil, xstyle=nil) {|doc| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Create an action item in a popup <a
-href="XformsTransformer.html#M000025">menu</a>.
-</p>
-<ol>
-<li>label: what is displayed on the title of the popup window. Default label is
-&quot;Options&quot;.
-</li>
-<li>accesskey: A short cut key (0-9) that is assigned to this <a
-href="XformsTransformer.html#M000025">menu</a> item. If not specified, it
-is asssinged a number sequentially.
-</li>
-<li>xstyle: the xforms style string for the <a
-href="XformsTransformer.html#M000025">menu</a> item. If xstyle is not
-specified, default style string &quot;style=&#8216;optionmenu&#8217;&quot;
-is used.
-</li>
-</ol>
-<h4>Examples</h4>
-<p>
-Refer to <a href="XformsTransformer.html#M000023">softkey</a> examples
-</p>
-        </div>
-      </div>
-      <div id="method-M000024" class="method-detail">
-        <a name="M000024"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000024.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000024.html');return false;">
-          <span class="method-name">menus</span><span class="method-args">(doc, id, label=&quot;Options&quot;, xstyle=nil) {|doc| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-A holders for a popup <a href="XformsTransformer.html#M000025">menu</a>.
-</p>
-<ol>
-<li>id: the widget&#8216;s reference id. The id is used by <a
-href="XformsTransformer.html#M000023">softkey</a> to trigger the popup
-action.
-</li>
-<li>label: what is displayed on the title of the popup window. Default label is
-&quot;Options&quot;.
-</li>
-<li>xstyle: the xforms style string for the popup window. If xstyle is not
-specified, default style string &quot;width=&#8216;40%&#8217;
-style=&#8216;popup-<a
-href="XformsTransformer.html#M000025">menu</a>&#8217;&quot; is used.
-</li>
-</ol>
-<h4>Examples</h4>
-<p>
-Refer to <a href="XformsTransformer.html#M000023">softkey</a> examples
-</p>
-        </div>
-      </div>
-      <div id="method-M000030" class="method-detail">
-        <a name="M000030"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000030.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000030.html');return false;">
-          <span class="method-name">method_missing</span><span class="method-args">(sym, *options, &amp;block)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Override builder <a
-href="XformsTransformer.html#M000030">method_missing</a> method to send
-output to model buffer so we can create arbitrary xml tags in the model.
-Typically combine with <a
-href="XformsTransformer.html#M000014">instance_tag</a> to create model
-instance that can be used in any of the action tag (<a
-href="XformsTransformer.html#M000008">link</a>, <a
-href="XformsTransformer.html#M000006">submit_tag</a>, etc.)
-</p>
-<h4>Examples</h4>
-<pre>
-    @xml.instance_tag(body, &quot;user&quot;) do |y|
-      @xml.fname
-      @xml.lname(&quot;Doe&quot;)
-      @xml.info(&quot;Basic&quot;, :zip=&gt;&quot;95014&quot;, :phone=&gt;&quot;415-1111111&quot;)
-    end
-</pre>
-<p>
-generates an instance data in the model:
-</p>
-<pre>
-    &lt;xf:instance id=&quot;user&quot;&gt;
-      &lt;data xmlns=&quot;&quot;&gt;
-        &lt;fname/&gt;
-        &lt;lname&gt;Doe&lt;/lname&gt;
-        &lt;info phone=&quot;415-1111111&quot; zip=&quot;95014&quot;&gt;Basic&lt;/info&gt;
-      &lt;/data&gt;
-    &lt;/xf:instance&gt;
-</pre>
-        </div>
-      </div>
-      <div id="method-M000010" class="method-detail">
-        <a name="M000010"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000010.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000010.html');return false;">
-          <span class="method-name">model_tag</span><span class="method-args">(doc, txt)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Output arbitray stuff in the model buffer. A workaround for any special
-xforms tags that are not supported yet in the transformer.
-</p>
-        </div>
-      </div>
-      <div id="method-M000012" class="method-detail">
-        <a name="M000012"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000012.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000012.html');return false;">
-          <span class="method-name">softBr</span><span class="method-args">(doc)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Line break
-</p>
-        </div>
-      </div>
-      <div id="method-M000023" class="method-detail">
-        <a name="M000023"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000023.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000023.html');return false;">
-          <span class="method-name">softkey</span><span class="method-args">(doc, position=&quot;1&quot;, label=&quot;&quot;, refid=nil) {|doc| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Create a <a href="XformsTransformer.html#M000023">softkey</a> <a
-href="XformsTransformer.html#M000025">menu</a>.
-</p>
-<ol>
-<li>position: &quot;1&quot; for left <a
-href="XformsTransformer.html#M000023">softkey</a> and &quot;3&quot; for
-right <a href="XformsTransformer.html#M000023">softkey</a>
-</li>
-<li>label: what is displayed in the <a
-href="XformsTransformer.html#M000020">tab</a> header (only needed in <a
-href="XformsTransformer.html#M000020">tab</a> case)
-</li>
-<li>xstyle: the xforms style string for the case (only needed in <a
-href="XformsTransformer.html#M000020">tab</a> case)
-</li>
-</ol>
-<h4>Examples</h4>
-<ul>
-<li>Softkey with a load action. The left <a
-href="XformsTransformer.html#M000023">softkey</a> is created with label
-&quot;GO&quot; and will load page foo2.xml when the <a
-href="XformsTransformer.html#M000023">softkey</a> is pressed.
-</li>
-</ul>
-<pre>
- @xml.softkey(body, &quot;1&quot;, &quot;GO&quot;) do |soft1|
-   @xml.load_tag(soft1, &quot;foo2.xml&quot;)
- end
-</pre>
-<p>
-generates the following:
-</p>
-<pre>
-  &lt;m:softkey position=&quot;1&quot;&gt;
-   &lt;m:label&gt;GO&lt;/m:label&gt;
-   &lt;xf:load resource=&quot;foo2.xml&quot; ev:event=&quot;DOMActivate&quot;/&gt;
-  &lt;/m:softkey&gt;
-</pre>
-<ul>
-<li>Softkey that pops up an Options <a
-href="XformsTransformer.html#M000025">menu</a>. When right <a
-href="XformsTransformer.html#M000023">softkey</a> is pressed, a popup <a
-href="XformsTransformer.html#M000025">menu</a> &quot;Options&quot; will
-display 4 <a href="XformsTransformer.html#M000025">menu</a> items. The
-first 3 <a href="XformsTransformer.html#M000025">menu</a> items are
-assigned a default accesskey. The last <a
-href="XformsTransformer.html#M000025">menu</a> item defines its own access
-key &quot;0&quot; which is reserved for exit action.
-</li>
-</ul>
-<pre>
- @xml.softkey(body, &quot;3&quot;, &quot;Options&quot;, &quot;menu1&quot;)
-   @xml.menus(body, &quot;menu1&quot;, &quot;Options&quot;) do |menus|
-     @xml.menu(menus, &quot;move1&quot;) do |item|
-       @xml.load_tag(item, &quot;foo1.xml&quot;)
-     end
-     @xml.menu(menus, &quot;move2&quot;) do |item|
-       @xml.load_tag(item, 'foo2.xml')
-     end
-     @xml.menu(menus, &quot;move3&quot;)
-     @xml.menu(menus, &quot;exit&quot;, &quot;0&quot;) do |item|
-       @xml.view_tag(item, '&lt;m:exit ev:event=&quot;DOMActivate&quot;/&gt;')
-     end
-   end
- end
-</pre>
-<p>
-genereates the following:
-</p>
-<pre>
-  &lt;m:softkey position=&quot;3&quot;&gt;
-   &lt;m:label&gt;Options&lt;/m:label&gt;
-   &lt;m:show-popup refid=&quot;menu1&quot; ev:event=&quot;DOMActivate&quot; /&gt;
-  &lt;/m:softkey&gt;
-  &lt;m:menu id=&quot;menu1&quot; height=&quot;0&quot; width=&quot;40%&quot; style=&quot;popup-menu&quot;&gt;
-   &lt;m:hstack height=&quot;1ex&quot; style=&quot;title&quot;&gt;&lt;m:icon&gt;jar://img/option.png&lt;/m:icon&gt;
-     &lt;m:output style=&quot;option&quot;&gt;Options&lt;/m:output&gt;
-   &lt;/m:hstack&gt;
-   &lt;m:itemlist height=&quot;0&quot; style=&quot;menu&quot;&gt;
-     &lt;m:item style=&quot;optionmenu&quot; height=&quot;1ex&quot; accesskey=&quot;1&quot;&gt;
-       &lt;m:output style=&quot;label&quot;&gt;move1&lt;/m:output&gt;
-       &lt;xf:load resource=&quot;foo1.xml&quot; ev:event=&quot;DOMActivate&quot;/&gt;
-     &lt;/m:item&gt;
-     &lt;m:item style=&quot;optionmenu&quot; height=&quot;1ex&quot; accesskey=&quot;2&quot;&gt;
-       &lt;m:output style=&quot;label&quot;&gt;move2&lt;/m:output&gt;
-       &lt;xf:load resource=&quot;foo2.xml&quot; ev:event=&quot;DOMActivate&quot;/&gt;
-     &lt;/m:item&gt;
-     &lt;m:item style=&quot;optionmenu&quot; height=&quot;1ex&quot; accesskey=&quot;3&quot;&gt;
-       &lt;m:output style=&quot;label&quot;&gt;move3&lt;/m:output&gt;
-     &lt;/m:item&gt;
-     &lt;m:item style=&quot;optionmenu&quot; height=&quot;1ex&quot; accesskey=&quot;0&quot;&gt;
-       &lt;m:output style=&quot;label&quot;&gt;exit&lt;/m:output&gt;
-       &lt;m:exit ev:event=&quot;DOMActivate&quot;/&gt;
-     &lt;/m:item&gt;
-   &lt;/m:itemlist&gt;
-   &lt;m:softkey position=&quot;3&quot;/&gt;
-   &lt;m:softkey position=&quot;1&quot;&gt;
-     &lt;m:hide-popup ev:event=&quot;DOMActivate&quot; refid=&quot;menu1&quot; /&gt;
-     &lt;m:label&gt;Close&lt;/m:label&gt;
-   &lt;/m:softkey&gt;
-  &lt;/m:menu&gt;
-</pre>
-        </div>
-      </div>
-      <div id="method-M000006" class="method-detail">
-        <a name="M000006"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000006.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000006.html');return false;">
-          <span class="method-name">submit_tag</span><span class="method-args">(doc, id, create_instance, options={}) {|doc| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Implement xforms &lt;xf:send&gt; in view buffer and &lt;xf:submission&gt;
-tag in model buffer If argument &#8216;create_instance&#8217; is set to
-true, it will create an &lt;xf:submission&gt; instance based on the
-attributes (see options). Otherwise, it assumes an instance is already
-defined in the model. The <a
-href="XformsTransformer.html#M000006">submit_tag</a> can not act along, it
-has to be associated with a tag with UI (like <a
-href="XformsTransformer.html#M000008">link</a> tag, <a
-href="XformsTransformer.html#M000009">button</a> or <a
-href="XformsTransformer.html#M000025">menu</a> item where user can click
-on).
-</p>
-<ol>
-<li>id: the name of the model instance that contains the submission defintion
-</li>
-<li>create_instance: true or false, create submission model instance or not.
-</li>
-</ol>
-<p>
-If set to true, a new model instance will be created.
-</p>
-<h4>Options</h4>
-<p>
-To create submission model, the following attributes should be specified in
-options:
-</p>
-<ul>
-<li><tt>:action</tt> &#8212; specifies the url for the action
-</li>
-<li><tt>:req_id</tt> &#8212; specifies the instance id to hold the submission
-data
-</li>
-<li><tt>:replace_id</tt> &#8212; if specified, the submission replace attribute
-is set to &quot;instance&quot;; otherwise, the submission replace attribute
-is set to &quot;all&quot;. In case of &quot;all&quot;, the client is
-expecting a complete xforms document in response. If it&#8216;s
-&quot;instance&quot;, only the request_id instance data is updated with the
-response data. Note the response header should be set to
-#&quot;application/xml&quot; instead of &quot;application/xforms&quot; for
-&quot;instance&quot; replace. See Mobio client user manual for defails. #*
-<tt>:event</tt> &#8212; specifies event type to trigger the &lt;xf:send&gt;
-action. If not defined, &quot;DOMActivate&quot; will be used.
-</li>
-</ul>
-<h4>Examples</h4>
-<ul>
-<li>First example demonstrates a submit tag (wrapped in <a
-href="XformsTransformer.html#M000008">link</a> widget) that creates a
-submit action and submission instance. When user clicks on the <a
-href="XformsTransformer.html#M000008">link</a>, the response will replace
-only the instance data in &quot;results&quot;. The UI doesn&#8216;t change.
-</li>
-</ul>
-<p>
-Create two instances for the submission to hold the request and replace
-data:
-</p>
-<pre>
-    (Request data)
-    @xml.instance_tag(body, &quot;name&quot;) do |y|
-      @xml.fname
-    end
-    (Instance to hold the response data)
-    @xml.instance_tag(body, &quot;results&quot;)
-</pre>
-<p>
-Use <a href="XformsTransformer.html#M000008">link</a> to provide a UI for
-user to activate the submission, specify true for create_instance argument
-so a new submission instance data can be created:
-</p>
-<pre>
-    @xml.link(body, &quot;http://m.twitter.com&quot;, &quot;m.twitter.com&quot;)  do |link|
-      @xml.submit_tag(link, &quot;login&quot;, true,
-       :action=&gt;'login', :req_id=&gt;'name', :replace_id=&gt;'results')
-    end
-</pre>
-<p>
-generates the following xforms:
-</p>
-<p>
-In the model:
-</p>
-<pre>
-    &lt;xf:submission action=&quot;login&quot; method=&quot;post&quot; id=&quot;login&quot; includenamespaceprefixes=&quot;&quot;
-      ref=&quot;instance('name')&quot; replace=&quot;instance&quot; instance=&quot;results&quot;/&gt;
-</pre>
-<p>
-In the view:
-</p>
-<pre>
-     &lt;xf:send submission=&quot;login&quot; ev:event=&quot;DOMActivate&quot;&gt;&lt;/xf:send&gt;
-</pre>
-<ul>
-<li>In this example, we will create a submit tag that creates just the submit
-<a href="XformsTransformer.html#M000009">button</a> # and use an existing
-submission instance to invoke the action. The response # is a complete
-xforms document which replaces the whole UI:
-<pre>
- @xml.link(body, &quot;http://m.twitter.com&quot;, &quot;m.twitter.com&quot;)  do |link|
-   @xml.submit_tag(link, &quot;login&quot;, false,
-     :action=&gt;'login', :req_id=&gt;'name', :replace_id=&gt;'results')
- end
-</pre>
-</li>
-</ul>
-<p>
-generates only a view:
-</p>
-<pre>
-   &lt;xf:send submission=&quot;login&quot; ev:event=&quot;DOMActivate&quot;&gt;&lt;/xf:send&gt;
-</pre>
-<p>
-The submission instance with id &quot;login&quot; must exist for the <a
-href="XformsTransformer.html#M000009">button</a> to work.
-</p>
-        </div>
-      </div>
-      <div id="method-M000021" class="method-detail">
-        <a name="M000021"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000021.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000021.html');return false;">
-          <span class="method-name">switch</span><span class="method-args">(doc) {|doc| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Create swtich case control, similar to Tab control but without the <a
-href="XformsTransformer.html#M000020">tab</a> UI. This tag and <a
-href="XformsTransformer.html#M000022">xcase</a> tag can create muliple <a
-href="XformsTransformer.html#M000021">switch</a> case for xforms client to
-provide multiple UIs in a <a href="XformsTransformer.html#M000007">form</a>
-that can be toggled back and forth using the xf:toggle command. Refer to
-client user manual for the usage.
-</p>
-<h4>Examples</h4>
-<pre>
-  @xml.switch(body) do |tab|
-    @xml.xcase(tab, &quot;b&quot;) do |c1|
-      @xml.text(c1, &quot;hello world!&quot;)
-    end
-    @xml.xcase(tab, &quot;a&quot;) do |xcase|
-      @xml.text(body, &quot;hello world!&quot;)
-    end
- end
-</pre>
-<p>
-generates the following:
-</p>
-<pre>
-  &lt;m:switch&gt;
-    &lt;m:case id=&quot;b&quot; label=&quot;&quot; &gt;
-      &lt;m:output height=&quot;1ex&quot;&gt;hello world!&lt;/m:output&gt;
-    &lt;/m:case&gt;
-    &lt;m:case id=&quot;a&quot; label=&quot;&quot; &gt;
-      &lt;m:output height=&quot;1ex&quot;&gt;hello world!&lt;/m:output&gt;
-    &lt;/m:case&gt;
-  &lt;/m:switch&gt;
-</pre>
-        </div>
-      </div>
-      <div id="method-M000027" class="method-detail">
-        <a name="M000027"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000027.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000027.html');return false;">
-          <span class="method-name">syscall</span><span class="method-args">(doc, name, address=nil, address_ref=nil, message=nil, message_ref=nil)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Create <a href="XformsTransformer.html#M000027">syscall</a> control. Refer
-to mobio client user manual for details usage of sysacll.
-</p>
-<ol>
-<li>name: the name of the <a href="XformsTransformer.html#M000027">syscall</a>
-function. The client supports &quot;click2call&quot;,
-</li>
-</ol>
-<p>
-&quot;sendSMS&quot;, &quot;audio-playback&quot; and
-&quot;video-playback&quot; functions.
-</p>
-<ol>
-<li>address: specifify the value for param tag in <a
-href="XformsTransformer.html#M000027">syscall</a>
-</li>
-<li>address_ref: specify the xpath for the address param tag in <a
-href="XformsTransformer.html#M000027">syscall</a>
-</li>
-<li>message: specifify the value for param tag in <a
-href="XformsTransformer.html#M000027">syscall</a>
-</li>
-<li>message_ref: specifify the xpath for the message param tag in <a
-href="XformsTransformer.html#M000027">syscall</a>
-</li>
-</ol>
-<h4>Examples</h4>
-<ul>
-<li>Create a <a href="XformsTransformer.html#M000009">button</a> that plays an
-audio file, the url for the audio file should be defined using an instance
-tag.
-<pre>
-   @xml.button(body,&quot;&quot;, &quot;btn1&quot;) do |btn|
-     @xml.syscall(btn, &quot;audio-playback&quot;, nil, &quot;instance('audios')/items/item[1]&quot;)
-   end
-</pre>
-</li>
-</ul>
-<p>
-generates the following:
-</p>
-<pre>
-     &lt;m:button height=&quot;1ex&quot;&gt;
-       &lt;m:label&gt;btn1&lt;/m:label&gt;
-       &lt;m:syscall name=&quot;audio-playback&quot; ev:event=&quot;DOMActivate&quot;&gt;
-         &lt;m:param name=&quot;address&quot; ref=&quot;instance('audios')/items/item[1]&quot;/&gt;
-       &lt;/m:syscall&gt;
-     &lt;/m:button&gt;
-</pre>
-<p>
-When user selects the <a href="XformsTransformer.html#M000009">button</a>
-&#8216;btn1&#8217;, the audio file will be loaded and played.
-</p>
-<ul>
-<li>Create a <a href="XformsTransformer.html#M000009">button</a> that places a
-phone call:
-<pre>
-   @xml.instance_tag(body, &quot;phone&quot;) do |x|
-     @xml.number(&quot;tel:5551212&quot;)
-   end
-   @xml.button(body,&quot;&quot;, &quot;btn1&quot;) do |btn|
-     @xml.syscall(btn, &quot;click2call&quot;, nil, &quot;instance('phone')/number&quot;)
-   end
-   @xml.button(body,&quot;&quot;, &quot;btn2&quot;) do |btn|
-     @xml.syscall(btn, &quot;click2call&quot;, &quot;tel:5551212&quot;)
-   end
-</pre>
-</li>
-</ul>
-<p>
-generates the following:
-</p>
-<p>
-In model
-</p>
-<pre>
-     &lt;xf:instance id=&quot;phone&quot;&gt;
-       &lt;data xmlns=&quot;&quot;&gt;
-         &lt;number&gt;tel:5551212&lt;/number&gt;
-       &lt;/data&gt;
-     &lt;/xf:instance&gt;
-</pre>
-<p>
-In view
-</p>
-<pre>
-     &lt;m:button height=&quot;1ex&quot;&gt;
-       &lt;m:label&gt;btn1&lt;/m:label&gt;
-       &lt;m:syscall name=&quot;click2call&quot; ev:event=&quot;DOMActivate&quot;&gt;
-         &lt;m:param name=&quot;address&quot; ref=&quot;instance('phone')/number&quot;/&gt;
-       &lt;/m:syscall&gt;
-     &lt;/m:button&gt;
-     &lt;m:button height=&quot;1ex&quot;&gt;
-       &lt;m:label&gt;btn2&lt;/m:label&gt;
-       &lt;m:syscall name=&quot;click2call&quot; ev:event=&quot;DOMActivate&quot;&gt;
-         &lt;m:param name=&quot;address&quot;&gt;tel:5551212&lt;/m:param&gt;
-       &lt;/m:syscall&gt;
-     &lt;/m:button&gt;
-</pre>
-<p>
-When user selects the <a href="XformsTransformer.html#M000009">button</a>
-&quot;btn1&quot; or &quot;btn2&quot;, it places a phone call to the number.
-The <a href="XformsTransformer.html#M000027">syscall</a> for btn1 uses the
-phone number from instance data.
-</p>
-        </div>
-      </div>
-      <div id="method-M000020" class="method-detail">
-        <a name="M000020"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000020.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000020.html');return false;">
-          <span class="method-name">tab</span><span class="method-args">(doc, xstyle='width=&quot;100%&quot; height=&quot;100%&quot; style=&quot;tabbody&quot;') {|doc| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Create a Tab control
-</p>
-<ol>
-<li>xstyle: the xforms style string. If xstyle is not specified, the default #
-value &#8216;height=&quot;100% width=&quot;100%
-style=&quot;tabbody&quot;&#8217; will be used. You need to # define a style
-class &quot;tabbody&quot; if you want to style the widget. # The tag is
-always followed by several <a
-href="XformsTransformer.html#M000022">xcase</a> tags to create a complete
-UI # for Tabs.
-</li>
-</ol>
-<h4>Examples</h4>
-<p>
-Create a <a href="XformsTransformer.html#M000020">tab</a> control that
-contains 2 case in the <a href="XformsTransformer.html#M000020">tab</a> <a
-href="XformsTransformer.html#M000002">body</a> and header:
-</p>
-<pre>
-  @xml.tab(body) do |tab|
-    @xml.xcase(tab, &quot;first&quot;, &quot;Current Match&quot;, 'style=&quot;tab&quot;') do |xcase|
-      @xml.text(body, &quot;hello world!&quot;)
-    end
-     @xml.xcase(tab, &quot;2nd&quot;, &quot;future&quot;, 'style=&quot;tab&quot;') do |xcase|
-      @xml.text(body, &quot;hello world!&quot;)
-    end
-  end
-</pre>
-<p>
-generates the following xforms in the view:
-</p>
-<pre>
-   &lt;m:tab width=&quot;100%&quot; height=&quot;100%&quot; style=&quot;tabbody&quot;&gt;
-     &lt;m:case id=&quot;first&quot; label=&quot;Current Match&quot; &gt;
-       &lt;m:output height=&quot;1ex&quot;&gt;hello world!&lt;/m:output&gt;
-     &lt;/m:case&gt;
-     &lt;m:case id=&quot;2nd&quot; label=&quot;future&quot; style=&quot;tab&quot;&gt;
-       &lt;m:output height=&quot;1ex&quot;&gt;Second Page&lt;/m:output&gt;
-     &lt;/m:case&gt;
-   &lt;/m:tab&gt;
-</pre>
-        </div>
-      </div>
-      <div id="method-M000015" class="method-detail">
-        <a name="M000015"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000015.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000015.html');return false;">
-          <span class="method-name">table</span><span class="method-args">(doc, style=&quot;&quot;, xstyle=&quot;&quot;) {|doc| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Create grid control, similar to <a
-href="XformsTransformer.html#M000015">table</a> in html
-</p>
-<ol>
-<li>style: html styles
-</li>
-<li>xstyle: xforms styles
-</li>
-</ol>
-        </div>
-      </div>
-      <div id="method-M000018" class="method-detail">
-        <a name="M000018"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000018.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000018.html');return false;">
-          <span class="method-name">table_cell</span><span class="method-args">(doc, style=&quot;&quot;, xstyle=&quot;&quot;) {|doc| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-        </div>
-      </div>
-      <div id="method-M000016" class="method-detail">
-        <a name="M000016"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000016.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000016.html');return false;">
-          <span class="method-name">table_row</span><span class="method-args">(doc, id, nodeset, style=&quot;&quot;, xstyle=&quot;&quot;) {|doc| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-        </div>
-      </div>
-      <div id="method-M000017" class="method-detail">
-        <a name="M000017"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000017.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000017.html');return false;">
-          <span class="method-name">table_row_list</span><span class="method-args">(doc, id, style=&quot;&quot;, xstyle=&quot;&quot;) {|doc| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-        </div>
-      </div>
-      <div id="method-M000003" class="method-detail">
-        <a name="M000003"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000003.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000003.html');return false;">
-          <span class="method-name">text</span><span class="method-args">(doc, txt=&quot;&quot;, options={})</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Produce a <a href="XformsTransformer.html#M000003">text</a> string. The <a
-href="XformsTransformer.html#M000003">text</a> displayed can be the
-<em>txt</em> argument if there&#8216;s no :id and :xpath options or it can
-be the data from model instance specified in :id and :xpath.
-</p>
-<h4>Options</h4>
-<ul>
-<li><tt>:xstyle</tt> &#8212; specifies xforms style attributes like height,
-width, style,\
-</li>
-</ul>
-<p>
-etc. as string.
-</p>
-<ul>
-<li><tt>:id</tt> &#8212; specifies the instance id of string. If :id is
-specified but nso :xpath, the method creates an instance data in
-#@model_buffer with a tag name &quot;<a
-href="XformsTransformer.html#M000003">text</a>&quot; that contains the
-<em>txt</em> string. If :id and :xpath are both specified, the method
-doesn&#8216;t create any model instance, instead, it assumes there&#8216;s
-an instance with the id and xpath already defined and the <a
-href="XformsTransformer.html#M000003">text</a> widget displays the data in
-that xpath.
-</li>
-<li><tt>:xpath</tt> &#8212; specifies the xpath of the <a
-href="XformsTransformer.html#M000003">text</a> string in the instance
-model.
-</li>
-</ul>
-<h4>Examples</h4>
-<ul>
-<li>Text widget displays the string of <em>txt</em> argument without creating
-an instance:
-<pre>
-  @xml.text(body, 'My test', :xstyle=&gt;'style=&quot;white&quot;')
-</pre>
-</li>
-</ul>
-<p>
-generates the following xforms:
-</p>
-<pre>
-    &lt;m:output style=&quot;white&quot;&gt;My test&lt;/m:output&gt;
-</pre>
-<p>
-The outupt is a one line <a href="XformsTransformer.html#M000003">text</a>.
-</p>
-<ul>
-<li>Text widget creates a model instance and displays the string from the new
-instance:
-<pre>
-  @xml.text(body, 'My test',
-   :id=&gt;'txt1',
-   :xstyle=&gt;'style=&quot;white&quot;')
-</pre>
-</li>
-</ul>
-<p>
-generates the following xforms: In model:
-</p>
-<pre>
-     &lt;xf:instance id=&quot;txt1&quot;&gt;&lt;data xmlns=&quot;&quot;&gt;&lt;text&gt;My test&lt;/text&gt;&lt;/data&gt;&lt;/xf:instance&gt;
-</pre>
-<p>
-In view:
-</p>
-<pre>
-     &lt;m:output style=&quot;white&quot; ref=&quot;instance('txt1')/text&quot;/&gt;
-</pre>
-<ul>
-<li>Text widget displays string from a pre defined instance:
-<pre>
-   @xml.text(body, 'My test', :id=&gt;'txt1', :xpath=&gt;'images/id')
-</pre>
-</li>
-</ul>
-<p>
-generates the following xforms:
-</p>
-<pre>
-     &lt;m:output height=&quot;1ex&quot; ref=&quot;instance('txt1')/images/id&quot;/&gt;
-</pre>
-        </div>
-      </div>
-      <div id="method-M000004" class="method-detail">
-        <a name="M000004"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000004.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000004.html');return false;">
-          <span class="method-name">textarea</span><span class="method-args">(doc, txt=&quot;&quot;, options={})</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Produce a textoutput widget (multi line <a
-href="XformsTransformer.html#M000003">text</a> box). The <a
-href="XformsTransformer.html#M000003">text</a> area is read only for xforms
-client.
-</p>
-<h4>Options</h4>
-<ul>
-<li><tt>:xstyle</tt> &#8212; specifies xforms style attributes like height,
-width, style, etc. as string.
-</li>
-<li><tt>:id</tt> &#8212; specifies the instance id of string.
-</li>
-</ul>
-<p>
-If :id is specified but no :xpath, the method creates an instance data in
-@model_buffer with a tag name &quot;<a
-href="XformsTransformer.html#M000003">text</a>&quot; that contains the
-<em>txt</em> string. If :id and :xpath are both specified, the method
-doesn&#8216;t create any model instance, instead, it assumes there&#8216;s
-an instance with the id and xpath already defined and the textoutput widget
-displays the data in that xpath.
-</p>
-<ul>
-<li><tt>:xpath</tt> &#8212; specifies the xpath of the <a
-href="XformsTransformer.html#M000003">text</a> string in the instance
-model.
-</li>
-</ul>
-<h4>Examples</h4>
-<pre>
-    @xml.textarea(body, 'My test', {:xstyle=&gt;'style=&quot;white&quot; height=&quot;2ex&quot;'})
-</pre>
-<p>
-generates the following xforms:
-</p>
-<pre>
-    &lt;m:textoutput style=&quot;white&quot; height=&quot;5ex&quot;&gt;My test&lt;/m:textoutput&gt;
-</pre>
-<p>
-The output is a 5 character high <a
-href="XformsTransformer.html#M000003">text</a> box.
-</p>
-<h4>Examples</h4>
-<ul>
-<li>Text widget displays the string of <em>txt</em> argument without creating
-an instance:
-<pre>
-  @xml.textarea(body, 'My test box', :xstyle=&gt;'height=&quot;3ex&quot;')
-</pre>
-</li>
-</ul>
-<p>
-generates a 3 line <a href="XformsTransformer.html#M000003">text</a> box:
-</p>
-<pre>
-    &lt;m:textoutput height=&quot;3ex&quot;&gt;My test box&lt;/m:textoutput&gt;
-</pre>
-<ul>
-<li>Text widget creates a model instance and displays the string from the new
-instance:
-<pre>
-  @xml.textarea(body, 'My test box',
-   :id=&gt;'txt1', :xstyle=&gt;'height=&quot;3ex&quot;')
-</pre>
-</li>
-</ul>
-<p>
-generates the following xforms: In model:
-</p>
-<pre>
-     &lt;xf:instance id=&quot;txt1&quot;&gt;&lt;data xmlns=&quot;&quot;&gt;&lt;text&gt;My test&lt;/text&gt;&lt;/data&gt;&lt;/xf:instance&gt;
-</pre>
-<p>
-In view:
-</p>
-<pre>
-     &lt;m:textoutput height=&quot;3ex&quot; ref=&quot;instance('txt1')/txt&quot;/&gt;
-</pre>
-<ul>
-<li>Text widget displays string from a pre defined instance:
-<pre>
-   @xml.textarea(body, 'My test', :id=&gt;'txt1', :xpath=&gt;'images/id',
-     :xstyle=&gt;'height=&quot;5ex&quot; width=&quot;50%&quot;')
-</pre>
-</li>
-</ul>
-<p>
-generates the following xforms:
-</p>
-<pre>
-     &lt;m:textoutput height=&quot;5ex&quot; width=&quot;50%&quot; ref=&quot;instance('txt1')/images/id&quot;/&gt;
-</pre>
-        </div>
-      </div>
-      <div id="method-M000011" class="method-detail">
-        <a name="M000011"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000011.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000011.html');return false;">
-          <span class="method-name">view_tag</span><span class="method-args">(doc, txt)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Output arbitray stuff in the view buffer. A workaround for any special
-xforms tags that are not supported yet in the transformer.
-</p>
-        </div>
-      </div>
-      <div id="method-M000022" class="method-detail">
-        <a name="M000022"></a>
-        <div class="method-heading">
-          <a href="XformsTransformer.src/M000022.html" target="Code" class="method-signature"
-            onclick="popupCode('XformsTransformer.src/M000022.html');return false;">
-          <span class="method-name">xcase</span><span class="method-args">(doc, id, label=nil, xstyle=nil) {|doc| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Create a case control. This tag cannot act along. It has to be wrapped in
-either a &quot;<a href="XformsTransformer.html#M000021">switch</a>&quot;
-tag or a &quot;<a href="XformsTransformer.html#M000020">tab</a>&quot; tag.
-See the document and examples in <a
-href="XformsTransformer.html#M000020">tab</a> and <a
-href="XformsTransformer.html#M000021">switch</a> tag.
-</p>
-<ol>
-<li>id: the case reference id
-</li>
-<li>label: what is displayed in the <a
-href="XformsTransformer.html#M000020">tab</a> header (only needed in <a
-href="XformsTransformer.html#M000020">tab</a> case)
-</li>
-<li>xstyle: the xforms style string for the case (only needed in <a
-href="XformsTransformer.html#M000020">tab</a> case). if not defined,
-default style=&quot;<a href="XformsTransformer.html#M000020">tab</a>&quot;
-will be applied.
-</li>
-</ol>
-        </div>
-      </div>
-    </div>
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>