Extension development

• Outline
• File formatting
• Extension example
• Meta data
• Extension API
• FAQ
• Changes
• Schedule

Extensions are developed using JavaScript. The scripting used is very similar to the Greasemonkey script specifications so if you have developed Greasemonkey scripts in the past you should find the specifications very easy to understand.

Extensions are made using one JavaScript source file. The encoding used is UTF-8. Please set the name as *.slex.js. When a *.slex.js link is opened in the application, an installation dialog is displayed.

// ==UserScript==
// @name            Sample extension
// @namespace       http://fenrir-inc.com
// @author          fenrir_dev
// @description     This is a sample extension.
// @description     Inserts current date to fenrir-inc.com pages.
// @icon            http://extensions.fenrir-inc.com/sample/icon.png
// @include         http://*.fenrir-inc.com/*
// @exclude         http://*.fenrir-inc.com/*/dev/*
// @exclude         http://*.fenrir-inc.com/*/admin/*
// @version         0.2.1
// @history         0.2.1 Fixed some bugs.
// @history         0.2   Improved something.
// @history         0.2   Fixed something.
// @history         0.1   Initial version.
// @require         jquery
// ==/UserScript==

var str_date = " Date: ";
switch(SLEX_locale) {
  case "ja":
    str_date = " 日付: ";
    break;
}

$("body").prepend('
'+str_date + new Date()+'
');

Meta data is the data used to define the information in the application itself of the name and author.

// ==UserScript==

to

// ==/UserScript==

Comment blocks surrounding with the above are interpreted as meta data.

Formatting of each line of meta data is done like below.

<More than 0 blank characters>//<More than 0 blank characters><Meta data name><More than 1 blank characters><Meta data value>

Meta data list

List of script functions

Values that can be specified for @android-version

You can specify the following values.

• 2.1
• 2.2
• 2.2.1
• 2.2.2
• 2.2.3
• 2.3
• 2.3.3
• 2.3.4
• 2.3.5
• 2.3.6
• 2.3.7
• 3.0
• 3.1
• 3.2
• 3.2.1
• 3.2.2
• 4.0.1
• 4.0.2
• 4.0.3

As an example, if you want to specify operations for just Android 2.3.x, the following meta data should be specified.

// @android-version 2.3
// @android-version 2.3.3
// @android-version 2.3.4
// @android-version 2.3.5
// @android-version 2.3.6
// @android-version 2.3.7

Version number restrictions

Version are displayed using strings delimited by dots. A maximum of 4 numbers can be used within the range of [0, 65525].

Example:

• 1
• 1.0
• 2.20.2
• 43.21.0.1234

Extension API can be used from JavaScript of extensions using function groups of applications.

SLEX_showNotification(text, [, callback])

Display a notification on the top bar.
"@require api-notification" is required to use. (Sleipnir Mobile for Android 2.12 or later)

Example:

function myCallback() {
  alert('callback');
}
SLEX_showNotification('notification', myCallback);

SLEX_addStyle(str)

Adds CSS.
"@require api" is required to use.

Example:

SLEX_addStyle('body{font-size:24px;color:#000;} a:hover{text-decoration:underline;}');

SLEX_httpGet(url [, data])

Load data from server using HTTP GET request, and return as string. null is returned when an error occurs. There are no cross-domain restrictions.
"@require api" is required to use.

• url: URL to which the request is sent.
• data: Parameter to be sent to the server.

Example:

SLEX_httpGet('http://en.wikipedia.org/wiki/Special:Search', {'search': 'android', 'go': 'Go'});

SLEX_httpPost(url [, data])

Load data from server using HTTP POST request, and return as string. null is returned when an error occurs. There are no cross-domain restrictions.
"@require api" is required to use.

• url: URL to which the request is sent.
• data: Parameter to be sent to the server.

Example:

SLEX_httpPost('http://www.sleipnirstart.com/', {'keywd': 'aaa', 'eng': 'fs'});

SLEX_download(url [, filename])

Files are downloaded using the downloader of the application.
"@require api" is required to use.

• url: URL to download.
• filename: File name to download. Changed to a suitable name when omitted.

Example:

SLEX_download("http://fenrir-inc.com/", "index.html");

SLEX_shareUrl(url)

Open URL in another application using intent.
"@require api" is required to use.

• url: URL to open.

Example:

SLEX_shareUri('http://m.sleipnirstart.com/');

SLEX_shareText(text [, subject])

Send text to different application using intent.
"@require api" is required to use.

• text: Text to send.
• subject: Subject to send. Can be omitted.

Example:

SLEX_shareText('content', 'title');

SLEX_locale

The current locale value string variable. Takes the value below.
"@require api" is required to use.

• "en"
• "ja"

Example:

var str_msg = "Message";
switch( SLEX_locale ) {
    case "ja":
        str_msg = "メッセージ";
        break;
}

• When is an extension executed?

  After a page is fully loaded. (Usually executed in the following order: DOMReady > window.onload > extension.)

• 2012-7-23
  • Added a possible value for meta data @require: api-notification
  • Added an Extension API: SLEX_showNotification
• 2012-2-21
  • Added meta data: @android-version
  • Removed meta data: @author:ja
  • Added support to set meta data: @require to xpath