sitewidgets.com -- Source Code for SaeSolved::sitewidgets.com(TM) JavaScript Class Library for Calculators

sitewidgets.com

Home

Calculators

Custom Calculators

Loan

Loan with Graph

Savings

Using Class Library

Class Library Demo

Break-Even

Debt Consolidation

Equity Available

HELOC Consolidation

Income from Savings

Investment Needed

Savings Accrual

Small Business

W-4 Estimator

Contact Us

HyperSubmit -- Search engine submission and optimization -- Boost search engines traffic to your website!

Search our

Support Freaks^TM
Knowledge Base

for answers to your Computer and Internet questions.

Find a

JavaScript
book.

Source Code for SaeSolved::sitewidgets.com™
JavaScript Class Library for Calculators

File: calculator_classes.js

SaeSolved::sitewidgets.com(TM) JavaScript Class Library for
Calculators -- Version 1.23, 20100614
Copyright (C) 2000-2010 by SaeSolved::(TM), http://www.sitewidgets.com.

This Library provides a set of classes for use in building calculators.
It handles the basic input and output issues such as formatting and
data validation. Calculator algorithms need to be incorporated in an
instance of the method OperateOnValues() to create a specific calculator.
An example at the end of this library illustrates how this may be done.

This Library is open source software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public License
(http://www.gnu.org/copyleft/lesser.txt) as published by the Free
Software Foundation; either version 2.1 of the License, or (at your
option) any later version.

In particular you may copy and distribute verbatim copies of the
Library's complete source code as you receive it, in any medium,
provided that you conspicuously and appropriately publish on each
copy an appropriate copyright notice and disclaimer of warranty;
keep intact all the notices that refer to this License and to the
absence of any warranty; and distribute a copy of this License along
with the Library.

This library is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License (http://www.gnu.org/copyleft/lesser.txt)
for more details.

A copy of the GNU Lesser General Public License may be obtained from
the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
Boston, MA 02111-1307, USA.

It is requested, but not required, that you use the statement in the
variable "this.License" in the function Calculator below in a
document.write statement in such a way as to conspicuously and
appropriately publish on each web page where the calculator is used
the hyperlinked credits, copyright notice, and disclaimer of warranty
contained in the variable "this.License."

SaeSolved::(TM) may be contacted at 64 Conway Cove Drive,
Chesterfield, MO 63017-2070, USA; email: webmaster@saesolved.com.

Version change history:
1.23  20100614 Added "onChangeActions" to properties of CalculatorElement.
1.221 20100609 Default style changes. OperateOnValues() set up as a stub method.
1.22  20020613 Allow the arguments of SetLayout() to be sent as an array
                Corrected function Validate for blank and zero characters
1.211 20020607 Corrected function Validate for initial non-numeric characters
1.21  20001120 Added method ValidateSubmit().
                Corrected handling of radio element names.
                Added ability to use form and table styles.
1.2   20000822 Added radio and select elements.
1.18  20000817 Added checkbox element, getArgs, font color.
                Element font family, size, and color
                'inherited' from calculator.
1.11  20000214 Fixed Opera-specific bug in SetLayout(), tidied
                ShowRows(), corrected validation for values between
                plus and and minus one.
1.1   20000212 Added SetLayout(), which gives greater flexibilty to
                calculator layout without having to override ShowRows().
                In addition fields can now be specified as input or
                output and fields not having the type 'text' will be
                ignored for both input and output.
1.02  20000209 Check for unwanted commas and extra decimal points,
                provide for footnotes, individual row background colors
1.01  20000201 Allow customizing of background colors
1.00  20000124 Base release
*/

js_version = 1.1;

function AddElement(obj, indx){
    var ndx = indx;
    if (ndx == null)
        ndx = this.index;
    obj.RowLocn = ndx;
    if (obj.type == 'radio') {
        obj.name = obj.family_name + '_' + ndx;
    }
    this[obj.name] = obj;
    if(obj.BGColor == null)
        obj.BGColor = this.DefaultBGColr[ndx % 2];
    if (this.RowBGColor[ndx] == null)
        this.RowBGColor[ndx] = obj.BGColor;
    if (obj.FontFamily == null)
        obj.FontFamily = this.FontFamily;
    if (obj.FontSize == null)
        obj.FontSize = this.FontSize;
    if (obj.FontColor == null)
        obj.FontColor = this.FontColor;
    if (obj.LabelAlign == null)
        obj.LabelAlign = this.LabelAlign;
    if (obj.ValueAlign == null)
        obj.ValueAlign = this.ValueAlign;
    this.Element[this.index++] = obj;
}

function Calculate() {
    var obj = self.document[this.CalculatorName];
    this.GetValues(obj);
    // method OperateOnValues must be supplied in the implementation
    this.OperateOnValues(obj);
    this.PutValues(obj);
}

function OperateOnValues(obj) {
    // stub only, method OperateOnValues must be supplied in the implementation
}

function ValidateSubmit() {
    var obj = self.document[this.CalculatorName];
    this.GetValues(obj);
    // function ValidateValues must be supplied in the implementation
    if (this.ValidateValues()) {
        obj.submit();
    }
}

function ShowCalculator() {
    this.SetStyles();
    document.write('<form name="' + this.CalculatorName + '" id="' +
        this.CalculatorName + '" target="_self" action="' +
        window.location + '" method="get"' + this.FormStyle + '>\n');
    document.write(this.TableFormat,'\n');
    document.write(this.TitleFormatBegin,'\n',this.CalculatorTitle,
        '\n', this.TitleFormatEnd,'\n');
    this.ShowRows();
    document.write(this.LicenseFormatted, '</table></span>\n</form>');
}

function HelpScreen(){
    alert(this.help);
    return true;
}

function getArgs(){
/*  Based on Example 13-5 in "JavaScript: The Definitive Guide," 3rd ed.,
    by David Flanagan, O'Reilly (1998) p. 245.                            */
    var args = new Object();
    var query = window.location.search.substring(1);
    var pairs = new Array();
    if ((pairs = query.split("&")) == null) pairs = localSplit(query, "&");
    for (var i = 0; i < pairs.length; i++){
        var pos = pairs[i].indexOf('=');
        if (pos == -1) continue;
        var argname = pairs[i].substring(0,pos);
        var value = pairs[i].substring(pos+1);
        args[argname] = unescape(value);
    }
    return args;
}

//  The following is a demo implementation of the above classes
//  which can be uncommented and placed between script tags in an
//  HTML page after including these classes.
/*
    var TextBoxSize    = 7;
    // New Calculator object
    var Demo           = new Calculator('DemoCalculator',
                                        'Demo Calculator', true);
    // First element used in calculator
    var A              = new CalculatorElement('text', 'A', 'A');
    // Some properties of the first element
        A.size         = TextBoxSize;
        A.help         = 'Value for A.';
        A.max_value    = 110;
        A.min_value    = -1234;
    // Second element used in calculator
    var B              = new CalculatorElement('text', 'B', 'B');
    // Some properties of the second element
        B.size         = TextBoxSize;
        B.help         = 'Value for B.';
        B.min_value    = 0;
    // Third element used in calculator
    var C              = new CalculatorElement('text', 'C',
                                                'C = A + B');
    // Some properties of the third element
        C.decimals     = 2;
        C.size         = TextBoxSize;
        C.help         = 'The demo calculation is simply for C ' +
                            '= A + B.';
    // The command element
    var CommandElement = new CalculatorElement('Demo.Calculate()',
                                    'commandElement', 'Calculate');
    // Add the elements to the calculator
    Demo.AddElement(A);
    Demo.AddElement(B);
    Demo.AddElement(C);
    Demo.AddElement(CommandElement);
    // Define the operation(s) that will be done using the elements
    function OperateOnValues(){
        this.C.value = this.A.value + this.B.value;
    }
    // Add this operation to the calculator
    Demo.OperateOnValues = OperateOnValues;
    // -->
    // Display the calculator
    Demo.ShowCalculator();
*/

Links to Amazon.com on this site are in association with Amazon.com's Associates Program.