Group Input Example

Location: examples/webapp/group/

This example demonstrates the <group> input type for organizing inputs into collapsible sections. A group of groups renders as a tabbed interface.

tool.xml

<?xml version="1.0"?>
<run>
<tool>
  <title>group (rappture2web)</title>
  <command>python3 @tool/group.py @driver</command>
</tool>
<input>
  <group id="tabs">
    <group id="models">
      <about><label>Models</label></about>
      <boolean id="recomb">
        <about><label>Recombination Model</label></about>
        <default>on</default>
      </boolean>
      <group id="tau">
        <about>
          <label>Minority carrier lifetimes</label>
          <layout>horizontal</layout>
        </about>
        <number id="taun">
          <about><label>For electrons</label></about>
          <default>1e-6</default>
        </number>
        <number id="taup">
          <about><label>For holes</label></about>
          <default>1e-6</default>
        </number>
      </group>
    </group>
    <group id="ambient">
      <about><label>Ambient</label></about>
      <number id="temp">
        <about><label>Temperature</label></about>
        <units>K</units>
        <default>300K</default>
      </number>
      <group id="loc">
        <about>
          <layout>sentence:Location = (${lat},${long})</layout>
        </about>
        <number id="lat">
          <about><label>Latitude</label></about>
          <default>40.42</default>
        </number>
        <number id="long">
          <about><label>Longitude</label></about>
          <default>-86.91</default>
        </number>
      </group>
    </group>
  </group>
</input>
</run>

Key concepts

  • Tabs: A group of groups (tabs > models + ambient) renders as a tabbed interface.

  • Horizontal layout: <layout>horizontal</layout> arranges child inputs side by side.

  • Sentence layout: <layout>sentence:Location = (${lat},${long})</layout> renders inputs inline within a sentence template.

Running

rappture2web examples/webapp/group/