|
|
Tigra Scroller PRO is professional cross browser JavaScript widget for web sites that scrolls text or html in the box. Script offers great browsers compatibility and most complete feature set. Moving content saves the space on the page and attracts visitor's attention. Script is ideal for displaying long lists like hot news, events, slide shows, ads etc.
* - Netscape 4.x and Opera browsers don't support external files content scrolling. Alternative content can be provided for those browsers.
** - Transition effects are supported by Internet Explorer v5.0+ only.
Tigra Scroller PRO can work with any browser capable of generic DHTML.
Here is a table of the application compatibility:
| ||||||||||||||||||||
Tigra Scroller PRO script consists of several files. This makes script maintenance easier and reduces network load.
Default distribution package contains:
Where ? and * are wildcards for single character and substring respectively.
There is no naming or location requirements for data being scrolled. Configuration and script files can also be located anywhere in the site hierarchy, but they should remain in same directory and naming convention should be carefully followed. To rename or move default script directory modify Tscroll_path_to_files variable in scroll.js file:
// set correct path to Tigra Scroller PRO files var TScroll_path_to_files = 'tsp_files/'
Script files should be attached to HTML document with appropriate tags in header:
<head> <!-- some header data --> <script language="javascript" src="tsp_files/scroll.js"></script> <script language="javascript" src="tsp_files/scroll.tpl0.js"></script> <link rel="stylesheet" href="tsp_files/scroll0.css"> </head>
The size of a scrolling area, positioning and sources of internal control images (pause, resume, next, previous, up, down) are specified by a scroller layout setting structure - JavaScript structure to be supplied as a first parameter to a scroller constructor function. By default scroller layout setting structure is declared in Tscr_LOOK? variable* of scroll.tpl?.js file.
Below is a table of keys supported in scroller layout setting structure:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
A declaration of scroller layout setting structure can look like the following:
Tscr_LOOK0 = {
// scroller box size: [width, height]**
'size' : [400, 100],
//style for item cell
's_i':'TScrItem1',
//style for scroller's body
's_b':'TScrBody1',
//style for scroller's
's_m':'TScrBack1',
// image for 'pause' icon (autoscroll mode only)
// [left, top, width, height, sorce_file, mouseover_sorce_file]**
'pa' : [360, 80, 16, 16],
// image for 'resume' icon (autoscroll mode only)
// [left, top, width, height, sorce_file, mouseover_sorce_file]**
're' : [360, 80, 16, 16],
// image for 'next item' icon (autoscroll mode only)
// [left, top, width, height, sorce_file, mouseover_sorce_file]**
'nx' : [380, 80, 16, 16],
// image for 'previous item' icon (autoscroll mode only)
// [left, top, width, height, sorce_file, mouseover_sorce_file]**
'pr' : [340, 80, 16, 16],
// image for 'scrolling items backward' icon (on-demand mode only)
// [left, top, width, height, sorce_file, mouseover_sorce_file]**
'up': [280, 4, 16, 16, 'tsp_files/aup.gif', 'tsp_files/mup.gif'],
// image for 'scrolling items forward' icon (on-demand mode only)
// [left, top, width, height, sorce_file, mouseover_sorce_file]**
'dn': [280, 205, 16, 16, 'tsp_files/adn.gif', 'tsp_files/mdn.gif'],
// the size of gap between the items**
'distance': 10,
},
* - ? in files name and variables name corresponds to scroller index developer can assign to have several independent scroller configurations
** - Sizing and positioning parameters are specified in pixels
The second parameter of ones to be passed to the scroller constructor call is a scroller options (behavior settings) structure. It supports the following keys:
| ||||||||||||||||||||||||||||||||||||||||||||||
Default location of scroller options structure is Tscr_BEHAVE? variable, scroll.tpl?.js file.
Sample scroller options structure declaration:
Tscr_BEHAVE0 = {
// autoscroll - true, on-demand - false
'auto': true,
// vertical - true, horizontal - false
'vertical': true,
// scrolling speed, pixels per 50 milliseconds;
// for auto mode use negative value to reverse scrolling direction
'speed': 3,
// visible on mouse over - true, always visible - false
'hide_buttons': true
},
Content that is scrolled is blocks of HTML code that can be described directly in the configuration files or can be picked from external files.
Below is the list of supported keys with descriptions:
| ||||||||||||||||||||||||||||||||||||||||||||||
These items are listed in scroll.tpl?.js with Tscr_ITEMS? variable:
Tscr_ITEMS0 = [
{
// external file
'file': 's0_data/cont1.html',
'content': '',
// pause in seconds before the item
'pause_b': 2,
// pause in seconds after the item
'pause_a': 1,
// transition effect for the item [index, duration]
'transition': 'revealTrans(TRANSITION=12,DURATION=0.5)'
},
{
'file' : '',
// direct content
'content' : '<img src="clouds.gif" height="225" width="300">',
'pause_b' : 0.5,
'pause_a' : 0,
'transition': 'revealTrans(TRANSITION=5,DURATION=0.5)'
}
]
Notes:
revealTrans(TRANSITION=0,DURATION=t) - Box in.
revealTrans(TRANSITION=1,DURATION=t) - Box out.
revealTrans(TRANSITION=2,DURATION=t) - Circle in.
revealTrans(TRANSITION=3,DURATION=t) - Circle out.
revealTrans(TRANSITION=4,DURATION=t) - Wipe up.
revealTrans(TRANSITION=5,DURATION=t) - Wipe down.
revealTrans(TRANSITION=6,DURATION=t) - Wipe right.
revealTrans(TRANSITION=7,DURATION=t) - Wipe left.
revealTrans(TRANSITION=8,DURATION=t) - Vertical blinds.
revealTrans(TRANSITION=9,DURATION=t) - Horizontal blinds.
revealTrans(TRANSITION=10,DURATION=t) - Checkerboard across.
revealTrans(TRANSITION=11,DURATION=t) - Checkerboard down.
revealTrans(TRANSITION=12,DURATION=t) - Random dissolve.
revealTrans(TRANSITION=13,DURATION=t) - Split vertical in.
revealTrans(TRANSITION=14,DURATION=t) - Split vertical out.
revealTrans(TRANSITION=15,DURATION=t) - Split horizontal in.
revealTrans(TRANSITION=16,DURATION=t) - Split horizontal out.
revealTrans(TRANSITION=17,DURATION=t) - Strips left down.
revealTrans(TRANSITION=18,DURATION=t) - Strips left up.
revealTrans(TRANSITION=19,DURATION=t) - Strips right down.
revealTrans(TRANSITION=20,DURATION=t) - Strips right up.
revealTrans(TRANSITION=21,DURATION=t) - Random bars horizontal.
revealTrans(TRANSITION=22,DURATION=t) - Random bars vertical.
revealTrans(TRANSITION=23,DURATION=t) - Random of all above.
blendTrans(DURATION=t) - Blending effect.
progid:DXImageTransform.Microsoft.Wheel(DURATION=t,spokes=5)
progid:DXImageTransform.Microsoft.Barn(DURATION=t,orientation=horizontal)
progid:DXImageTransform.Microsoft.Blinds(DURATION=t,bands=5)
progid:DXImageTransform.Microsoft.CheckerBoard(DURATION=t)
progid:DXImageTransform.Microsoft.Fade(DURATION=t)
progid:DXImageTransform.Microsoft.GradientWipe(DURATION=t,wipeStyle=0)
progid:DXImageTransform.Microsoft.Iris(DURATION=t,irisStyle=STAR)
progid:DXImageTransform.Microsoft.Iris(DURATION=t,irisStyle=CIRCLE)
progid:DXImageTransform.Microsoft.Pixelate(DURATION=t,maxSquare=40)
progid:DXImageTransform.Microsoft.Wheel(DURATION=t,spokes=5)
progid:DXImageTransform.Microsoft.RandomDissolve(DURATION=t)
progid:DXImageTransform.Microsoft.Spiral(DURATION=t)
progid:DXImageTransform.Microsoft.Stretch(DURATION=t,stretchStyle=push)
progid:DXImageTransform.Microsoft.Strips(DURATION=t,motion=rightdown)
Some visual aspects of the Tigra Scroller PRO can be set with CSS. Find below CSS classes which names could be assigned to Tigra Scroller PRO elements:
/* scroller background - TABLE */
.TScrBack0 {
background-color: white;
}
/* style to be applied to all items' bodies TD or SPAN (NS4.x) */
.TScrItemBody0 {
font-family: Verdana;
font-size: 11px;
text-align: justify;
padding: 5px;
}
Note:
Stylesheets of external files (if any) are ignored
Script initialization block creates scroller instance. It can be called within table cell or any other relatively positioned HTML element. Initialization function has to be called with three parameters - Tscr_LOOK?, Tscr_BEHAVE? and Tscr_ITEMS?. Those are configuration structures defined in scroll.tpl?.js file. Any number of scroller instances can be created on the page and each can be configured independently by passing different or partially different sets of configuration structures.
<script language="JavaScript"> <!-- // new TScroll_init (Tscr_LOOK0, Tscr_BEHAVE0, Tscr_ITEMS0); // --> </script>
Tigra Scroller PRO provides API that allows to control scroller boxes behavior by the customer's client side scripts. To access property or call the method desired scroller object must be selected from the global scroller collection - TScroll[]. Note that indexes are zero-based.
Below is the list of available properties and methods with usage examples:
property step - controls the speed of the scroller (pixels per 50 milliseconds), can be assigned negative value.
<script language="JavaScript"> <!-- // reverse scrolling direction for the first scroller TScroll[0].step = -TScroll[0].step; // --> </script>
method sleep(delay) - pauses scrolling for delay seconds. Positive integer or floating point values are accepted.
<script language="JavaScript"> <!-- // stop second scroller for 3 seconds TScroll[1].sleep(3); // --> </script>
method stop(priority) - stops scrolling and defines priority level* required to start scrolling again.
<script language="JavaScript"> <!-- // stop first scroller so it can't be unlocked on mouseout TScroll[0].stop(2); // --> </script>
method move(priority) - starts scrolling if the priority level* is high enough. If started then resets priority level to 0.
<script language="JavaScript"> <!-- // start first scrolling even if it was previously locked TScroll[0].move(2); // --> </script>
method click_pass(direction) - switches scroller to next/previous item. Positive direction values switches scroller to the next item, otherwise to the previous item.
<script language="JavaScript"> <!-- //jump to the next scrolling item TScroll[0].click_pass(1); // --> </script>
method jump_to(n) - switches scroller to item with index n (zero based indexes are used).
<script language="JavaScript"> <!-- //jump to the item with 0 index TScroll[1].jump_to(0); // --> </script>
* - priority level is positive integer value defined when scroller stops.
Notes:
You can assign different external names to scrollers for better external controls usage.
For example:
var myScroll = new TScroll_init (Tscr_LOOK0, Tscr_BEHAVE0, Tscr_ITEMS0); myScroll.move(2);
Note: scroller internal name (i.e. if scroller is controled from its own item) is always S, regardless of how it is named by constructor call:
S.move(2)
One Regular Tigra Scroller PRO script license gives the right to use one copy of the script (files: tsp_files/scroll.js, tsp_files/scroll.dom.js, tsp_files/scroll.nn4.js)
within single domain boundaries.
| Demo of Licensing Cases: | |||||||||||||
|
To finalize registration process owner of the script license should provide SoftComplex Inc. with domain name which license is associated with.
Developer license gives the right to include unlimited number of Tigra Scroller PRO instances in the products of license owner. Such kind of license is obtained automatically by those who have 9 or more regular licenses.
We offer 50% discount for the script starting from second license. To take advantage of this discount use the link sent with every order confirmation message.
Same discount initially applies to educational and religious organizations.
As owner of the Tigra Scroller PRO license You are allowed to configure the script in any possible way for use in Internet (public), Intranet (corporate) or offline application, however You are strictly NOT allowed (unless specifically authorized by SoftComplex.com) to:
You are entitled to free product upgrades and technical support for at least one year from the date of purchase. Technical support includes answers to script related questions via e-mail and/or Internet instant messaging services. Full scroller customization services are provided on customer's request at additional charge.
Should you violate these Terms and Conditions or any other rights of SoftComplex Inc., SoftComplex Inc. reserves the right to pursue any and all legal and equitable remedies against you without limitation.