In this tutorial, i will be teaching you how to create a mini javascript framework. Now its not going to be anywere near as feature rich as other frameworks such as mootools and jquery but its a start.
Step 1 : Create the files
index.htm, Our html file
framework.js, Our javascript file
Step 2 : Populate the index.htm file
Ok first things first, lets get some html code into our index file.
GeSHi (html4strict):
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
</head>
</body>
</html>
Created by GeSHI 1.0.7.20
The above code is pretty self explanatory.
Now, add the link to our javascript file inbetween the head tags
GeSHi (html4strict):
<script type="text/javascript" src="framework.js"></script>
Created by GeSHI 1.0.7.20
Next thing to do, add some functions from the frame work we will create. Add this after the first script tags
GeSHi (html4strict):
<!--
window.onload = function() {
Framework.Effects.add("box", 'blink', function() {
// Functions here
});
Framework.Effects.start();
}
//-->
</script>
Created by GeSHI 1.0.7.20
Explanation of the above:
window.onload = function() { }
This tells the browser to run the code inside the function after the page has fully loaded.
Framework.Effects.add("box", 'blink', function() {
// Functions here
});
This is a function that we will create. It has three parameters, object id, effect type and function.
The first parameter should be a string of the id for the object we want to put the effect on.
The second parameter is the effect type. For this tutorial, there will only be one effect, "blink".
The third and final parameter is the function. Here you put what ever code you want to run when ever the effect starts.
Framework.Effects.start();
This is another framework function that we will create. All it does is tell the browser to start the effects.
Step 3 : The framework itself
This is the longest step in the tutorial so pay attention.
In this step, open up framework.js as this is the file we will be editing.
Firstly, we have to create our framework object. Put this code at the top of the page:
GeSHi (javascript):
var Framework = new Object();
Created by GeSHI 1.0.7.20
This just tells the browser that the variable Framework is an object.
Next, we create our first sub-object: Styles
Put this code after the framework variable.
GeSHi (javascript):
Framework.Styles = {
add: function(obj, styles) {
for (style in styles) {
obj.style[styles[style][0]] = styles[style][1];
}
},
rem: function(obj, styles) {
for (style in styles) {
obj.style[styles[style][0]] = null;
}
},
get: function(obj, style) {
return obj.style[style];
}
};
Created by GeSHI 1.0.7.20
Now to explain it all.
Framework.Styles = {};
This creates the Styles object in the Framework object.
add: function(obj, styles) {
for (style in styles) {
obj.style[styles[style][0]] = styles[style][1];
}
},
This is the first function in our styles object. It takes two parameters, a html object and an array.
The object is simply:
... document.getElementById('objid') ...
The array format is like so:
Array {
Array {
'styletype',
'styles'
}
}
The styletype would be a css attribute like color and the styles would be a value like #ff0000
for (style in styles) {
obj.style[styles[style][0]] = styles[style][1];
}
This creates a simple for loop. It works in the same way as a PHP foreach loop.
PHP
GeSHi (php):
foreach ($styles as $style) {}
Created by GeSHI 1.0.7.20
Javascript
GeSHi (javascript):
for (style in styles) {}
Created by GeSHI 1.0.7.20
As you can see its almost identical.
obj.style[styles[style][0]] = styles[style][1];
This gets the objects styles and then edits the styletype with the styles.
If coding this literally, it would be:
obj.style.color = "#ff0000";
rem: function(obj, styles) {
for (style in styles) {
obj.style[styles[style][0]] = null;
}
},
This does exactly the same thing except each styletype in the array is removed from the object.
get: function(obj, style) {
return obj.style[style];
}
Byfar the simplest function in the Styles object, this just gets the object, the style specified and returns the styles contents.
Example usage:
var object = document.getElementById("box");
// Setting the styles using the previous add function
Framework.Styles.add(object, [
['color', '#ff0000']
]);
alert(Framework.Styles.get(object, 'color'));
// Will alert, you guessed it, #ff0000
The Effects Object
Now we are going to create the main effects object. This is the part the tutorial has been building up to.
Here is the beast in all its glory:
GeSHi (javascript):
Framework.Effects = {
effects: [],
timers: [],
add: function(obj, type, func) {
Framework.Effects.effects.push([type, obj, func]);
},
blink: function(obj, func) {
var obj = document.getElementById(obj);
setInterval(function() {
if (Framework.Styles.get(obj, 'visibility') == 'hidden') {
Framework.Styles.add(obj, [['visibility', 'visible']]);
} else {
Framework.Styles.add(obj, [['visibility', 'hidden']]);
}
func();
}, 500);
},
start: function() {
for (effect in Framework.Effects.effects) {
var effect = Framework.Effects.effects[effect];
Framework.Effects.timers[effect[0] + effect[1]] = false;
switch (effect[0]) {
case 'blink':
Framework.Effects.blink(effect[1], effect[2]);
break;
}
}
}
};
Created by GeSHI 1.0.7.20
Confusing huh? Well not to worry, I shall explain it all. Before I do, add that code under the Styles object.
Now lets explain it.
Framework.Effects = {};
This creates another object just like the Styles object.
effects: [],
timers: [],
These are two empty arrays. Yes, thats right, arrays. You can define arrays in two ways in javascript:
var array = new Array();
or
var array = [];
Guess which one I use.
add: function(obj, type, func) {
Framework.Effects.effects.push([type, obj, func]);
},
Remember when we used the add function on the HTML page? Well this is the function that gets called.
Quik Recap:
GeSHi (javascript):
// This is what we wrote on the HTML page
Framework.Effects.add("box", 'blink', function() {
// Functions here
});
Created by GeSHI 1.0.7.20
Now the first parameter is a STRING not an Object like the functions in the Styles object. There is a reason for this but I will not explain it in this tutorial.
The second parameter is the effect type. Also a string.
The third is the function. Now if left empty, nothing will run when the effect blink is run. If there is code in it, it will be run every time the blink effect is run.
Framework.Effects.effects.push([type, obj, func]);
This just pushes a new array into the effects array we defined earlier. It contains the effect type, object id and function.
blink: function(obj, func) {
var obj = document.getElementById(obj);
setInterval(function() {
if (Framework.Styles.get(obj, 'visibility') == 'hidden') {
Framework.Styles.add(obj, [['visibility', 'visible']]);
} else {
Framework.Styles.add(obj, [['visibility', 'hidden']]);
}
func();
}, 500);
},
Here we go. Our first effect in the mini framework. It takes two parameters, object id and function.
var obj = document.getElementById(obj);
This creates a new variable called obj which contains the object of the id given.
setInterval(function() {
if (Framework.Styles.get(obj, 'visibility') == 'hidden') {
Framework.Styles.add(obj, [['visibility', 'visible']]);
} else {
Framework.Styles.add(obj, [['visibility', 'hidden']]);
}
func();
}, 500);
This is the most important part of our blink effect even though its very simple.
The first part is to create an interval. Some of you may know it as setTimeout. setInterval is the samething but I prefere using it. This interval is set to run at every 500 milliseconds or every half second in simple terms.
if (Framework.Styles.get(obj, 'visibility') == 'hidden') {
Framework.Styles.add(obj, [['visibility', 'visible']]);
} else {
Framework.Styles.add(obj, [['visibility', 'hidden']]);
}
Here we make use of some functions we created in the Styles object. The if statement uses the get function in the Styles object to check the value of the objects visibility style.
If its hidden, use the add function to make the visibility visible else make it hidden again. This will just loop over and over so you get the blink effect.
func();
Now this is the function that we put as the third parameter on the index page. Remember?
Quik Recap:
GeSHi (javascript):
// This is what we wrote on the HTML page
Framework.Effects.add("box", 'blink', function() {
// This is the third parameter
// Functions here
});
Created by GeSHI 1.0.7.20
Because it was passed through a variable, to run the function inside, all we have to do is put brackets at the end. Neat huh?
start: function() {
for (effect in Framework.Effects.effects) {
var effect = Framework.Effects.effects[effect];
Framework.Effects.timers[effect[0] + effect[1]] = false;
switch (effect[0]) {
case 'blink':
Framework.Effects.blink(effect[1], effect[2]);
break;
}
}
}
Yay, the final function in the Effects frame work. I am happy because its 2:45am and I am very tired.
Now we create a function called start. We ran it once on the index page.
Quik Recap:
GeSHi (javascript):
window.onload = function() {
Framework.Effects.add("box", 'blink', function(){});
// Here we go
Framework.Effects.start();
}
Created by GeSHI 1.0.7.20
This function makes it all work. It goes through the effects array we looked at in the add function, gets the effect type and sends the appropriate information to the appropriate effects functions.
for (effect in Framework.Effects.effects) {
var effect = Framework.Effects.effects[effect];
Framework.Effects.timers[effect[0] + effect[1]] = false;
switch (effect[0]) {
case 'blink':
Framework.Effects.blink(effect[1], effect[2]);
break;
}
}
Here we have another for loop. Same type as the one I explained earlier.
Quik Recap:
PHP
foreach ($styles as $style) {}
Javascript
for (style in styles) {}
This for loop gets all the effect arrays in the effects variable.
var effect = Framework.Effects.effects[effect];
The effect variable now contains this iterations array contents.
Framework.Effects.timers[effect[0] + effect[1]] = false;
Because this is not needed in this framework for this tutorial, I will not explain it. Leave it in there though as it will be needed for future parts to this tutorial.
switch (effect[0]) {
case 'blink':
Framework.Effects.blink(effect[1], effect[2]);
break;
}
Here we have a simple switch statement. Works in the same way as a PHP switch statement. For those of you who dont know what a switch statement is, think of it like this:
switch (variable) {
case "a":
alert("a");
break;
case "b":
alert("b");
break;
case "c":
alert("c");
break;
default:
alert("Unknown letter");
break;
}
IS
if (variable == "a") {
alert("a");
} else if (variable == "b") {
alert("b");
} else if (variable == "c") {
alert("c");
} else {
alert("Unknown letter");
}
The switch statement simply gets the effect type and sends the object id and function to the particular effect.
And there you have it. An introduction to a simple javascript mini effects framework. I hope you have learned alot from this tutorial.