is it possible to submit a form with a carriage return?

i am trying to put a single textfield (for doing search) on my app's home page and have it so when i "hit return" the form gets submitted. to start with i am not entirely sure what "return" means? with other apps i have that are like this when i touch inside the text field and the keyboard is brought up; the "return" key is replaced with a "Search" key; which submits the form. in ripple, i assume this is simply hitting CR on the keyboard.

to get the form i create a simple function as:

function mymodule_search_form(form, form_state) {
  form.elements.search_terms = {
    title:'search',
    type:'textfield',
  };
  
  return form;  
}

and then in my page callback and page show functions for my home page i have this:

function mymodule_home_page() {
  try {
    return {
      'search_form': {
        'markup': '<div id="search-form">xxx</div>'  
      }
    };
  }
  catch (error) { console.log('placemarks_accueil_page - ' + error); }
}

function mymodule_home_pageshow() {
    $('#search-form').html(drupalgap_get_form('placemarks_search_form'));
}

this works fine (placement on the page is odd; but can be fixed with css) but when i type something in the textfield and submit the app crashes with no output to console (i get a wsod). i have a _submit function for the form but it is never hit.

any ideas? perhaps this is just not possible?