View Source

h2. Overview
_Since 4.0_
_Until 4.2_

{warning}As of January of 2017 the BridgeIt project has been [deprecated|http://www.icesoft.org/blog/the-future-of-bridgeit/]. As a result, this component has been removed from ICEfaces as of the 4.2 release.{warning}


The mobi:sms component renders a button that launches the Bridgeit application on the user's device to send an SMS message.

h2. Getting Started

For best results, add to the page a field to enter the telephone number to send the SMS to and another field to enter the message itself. These fields can be either plain HTML elements or ACE components such as {{ace:textEntry}} and {{ace:textArea}}. Make sure you give an id to them, then, add the mobi:sms tag and reference these fields by their ids in the {{numberInputId}} and {{messageInputId}} attributes.

{code:xml}
<label for="smsNumber">Phone Number: </label>
<input type="text" id="smsNumber" />
<br />
<label for="smsMessage" style="vertical-align: top;">Message: </label>
<textarea id="smsMessage" />
<br />
<mobi:sms id="smsButton" messageInputId="smsMessage" numberInputId="smsNumber" buttonLabel="Send SMS"/>
{code}

h2. Attributes

{tip:title=TagLib Documentation}This section covers attributes involved in the typical use-cases for this component. For reference, the complete taglib documentation for this component is available [here|http://res.icesoft.org/docs/v4_latest/mobi/tld/].{tip}

{panel}
The *buttonLabel* specifies the label of the button.
{panel}

{panel}
The *numberInputId* specifies the id of the field that contains the number to send the SMS to.
{panel}

{panel}
The *messageInputId* specifies the id of the field that contains the message to send.
{panel}

h2. Event Listeners

None.

h2. Client Behavior Events

None.

h2. JavaScript API

None.

h2. Keyboard Support

Standard keyboard actions for HTML buttons are supported, such as tabindex and pressing the enter or space keys to activate the button.

h2. Known Issues

None.

h2. Additional Resources


h4. Sample Applications

This component appears in the following ICEfaces sample applications:

* *[ICEfaces Mobile Showcase|http://icefaces-showcase.icesoft.org/showcase-mobile.jsf]*

h4. Tutorials

This component appears in the following ICEfaces tutorials:

*None*