Highlights

All properties are optional. After opening the draft, the user may have the possibilities to edit the draft from the UI. Of course, it’s also possible to open an empty draft.

• Open: It accepts an options object and a callback. open(options, callback)
• Options:·
  • from: String, // sending email account (iOS only)
  • to: Array, // email addresses for TO field
  • cc: Array, // email addresses for CC field
  • bcc: Array, // email addresses for BCC field
  • attachments: Array, // file paths or base64 data streams
  • subject: String, // subject of the email
  • body: String, // email body
  • isHtml: Boolean  // indicates if the body is HTML or plain text (primarily iOS)

It's possible to specify the email client. If the phone isn´t able to handle the specified scheme it will fallback to the system default. For a specific mail client, just pass its URI scheme on iOS or the package name or alias on Android as the first parameter:

• app: String,  //  “Gmail, mailto, etc..”

Note:

• Only the built-in email app for iOS does support HTML and CSS. Some Android clients support rich formatted text. Use isHtml with caution! It's disabled by default.
• This interface does not guarantee immediate delivery of the corresponding email message.
• The user may cancel the creation of the message, and if the user does choose to send the message, the message is only queued in the Mail application outbox.
• This interface does not provide a way to verify whether emails were actually sent.