README.md

IconicLabel

Iconic label widget implements k0sukey/TiIconicFont library for Titanium Alloy.

How to Use

• Download and deploy the widget under app/widgets/net.hoyohoyo.iconiclabel.
• Download .js libraries from TiIconicFont to app/widgets/net.hoyohoyo.iconiclabel/lib/.
• Download font (.ttf) files to under app/assets/fonts/.
• Add the widget as a dependency to your app/config.json file like so:

	…
	"dependencies": {
		"net.hoyohoyo.iconiclabel": "1.3"
	}

• Use the widget in a view with Widget tag like so:

<Widget id="symbol" src="net.hoyohoyo.iconiclabel" />

• Set style in a tss file like so: (You can use just like Ti.UI.Label.)

'#symbol': {
	top: '100dp',
	left: '10dp',
	right: '10dp',
	font: {fontFamily: 'FontAwesome', fontSize: '22dp'},
	icon: 'play'
}

Advanced Usage Example

• Using multiple icons.

'#symbol': {
	icon: ['fastBackward', 'play', 'fastForward']
}

• Binding a callback function to change icons.

$.symbol.on('click', function(e) {
	if ($.symbol.getIcon() === 'play') {
		$.symbol.setIcon('pause');
	} else {
		$.symbol.setIcon('play');
	}
});

• Confirm current icon name

Ti.API.info($.symbol.getIcon());

• Changing a font after deployment

setTimeout(function() {
	$.symbol.setFont({fontFamily: 'LigatureSymbols', fontSize: '24dp'});
}, 10000);

• Changing a number of properties at once

$.symbol.applyProperties({
	font: {fontFamily: 'LigatureSymbols', fontSize: '24dp'},
	icon: 'smile'
});

Environment

OS

• iOS
• Android

Fonts

• Font Awesome
• Ligature Symbols
• SS Pika

Credits

TiIconicFont

https://github.com/k0sukey/TiIconicFont

Thanks for the nice library.

Font Awesome

http://fortawesome.github.com/Font-Awesome

Version 2.0 of the Font Awesome font, CSS, and LESS files are licensed under CC BY 3.0: http://creativecommons.org/licenses/by/3.0/ A mention of 'Font Awesome - http://fortawesome.github.com/Font-Awesome' in human-readable source code is considered acceptable attribution (most common on the web). If human readable source code is not available to the end user, a mention in an 'About' or 'Credits' screen is considered acceptable (most common in desktop or mobile software).

Ligature Symbols

http://kudakurage.com/ligature_symbols/

You can get Ligature Symbols for free. This Font is licensed under the SIL Open Font License for download and using. Ligature Symbols has broad support for the modern browser (Chrome, Safari, Firefox, iOS - Mobile Safari, Android Browser).