Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Titanium Module for building preferences / settings views

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 README.md
Octocat-spinner-32 app.js
Octocat-spinner-32 tiprefs.js
README.md

TiPrefs

A module to help build preferences/settings pages quickly allowing you to add Switches, TextInputs etc.

TiPrefs

Currently supported : textinput, switch/bool, choice list - tested on iOS only.

Example:-

Add the module to your project

var prefs = require("tiprefs");

Initialise new preferences window

prefs.init("Settings");

Add a Switch (id is used for the key to save the setting, otherwise failsover to caption)

prefs.addSwitch({
    id : "save",
    caption : "Save on quit"
});

Add a Text input (caption is used as the key as no ID specified)

prefs.addTextInput({
    caption : "username",
    value : "myuser"
});

Add a choice list

prefs.addChoice({
    id : "day_of_week",
    caption : "Day of Week",
    choices : [
              {title : 'Every Monday',value : 1}, 
              {title : 'Every Tuesday',value : 2}, 
              {title : 'Every Wednesday',value : 3}, 
              {title : 'Every Thursday',value : 4}, 
              {title : 'Every Friday',value : 5}, 
              {title : 'Every Saturday',value : 6}, 
              {title : 'Every Sunday',value : 7}
              ]
});

Render it (and it'll create a navigation group container)

prefs.open();

or specify a tabGroup and it'll use that

prefs.open(tabGroup);

You can also add sections

prefs.init("Settings");

    prefs.addSection({
        title: "Section"
    });

prefs.addSwitch({
        id: "SAVE_ON_QUIT",
        caption: "Alarm"
    });

prefs.addSection({
        title: "T10 Accounts"
});

prefs.addTextInput({
        id: "USERNAME",
        caption: "username",
        value: "Anonymous"
});

prefs.closeSection();

prefs.open();

You can retrieve values using the standard Ti properties based on the format

name + "_" + id / caption
name + "_" + id / caption + "_" + value


Ti.App.Properties.getBool("Settings_save");

or for the choice list above

Ti.App.Properties.getBool("Settings_day_of_week_1");

This is WORK IN PROGRESS!

Something went wrong with that request. Please try again.