Tech School

User Tools

Site Tools

Trace: • javascript • javascript
en:web_development:lists:javascript

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision 		Previous revision
en:web_development:lists:javascript [2021/11/30 07:38]
mag created 		en:web_development:lists:javascript [2023/08/16 09:33] (current)
Line 1: Line 1:
-====== Web Development Lesson 2 - Lists ======+====== Web Development Lesson 3 - Lists ======
 ===== Javascript Lists ===== ===== Javascript Lists =====
 +==== Objectives ====
 +In this exercise you will use an array to store a list of items, use a for loop to repeat a block of code, and use an if statement to run different instructions based on user input.
 ==== Setup ==== ==== Setup ====
-  * We'll use the first file you created in this lesson called 'lists.html', so open that file in Visual Studio Code.+  * We'll use the first file you created in this lesson called '[[https://techschool.murraygunn.id.au/webdev/classes/lists/3/lists.html|lists.html]]', so open that file in Visual Studio Code.
   * Create a file called 'lists.js' in the same directory.   * Create a file called 'lists.js' in the same directory.
   * We'll also return to [[https://jsfiddle.net|jsfiddle]] to try out a few things.   * We'll also return to [[https://jsfiddle.net|jsfiddle]] to try out a few things.
Line 8: Line 10:
  
 ==== External Scripts ==== ==== External Scripts ====
-  * Just as we created an entry in <html><head></html> to link to the external style sheet, we need to tell the browser where to find our javascript file.+  * We'll start in Visual Studio Code. 
 +  * Just as we created an entry in <html><head></html> to link to the external style sheet, we need to tell the browser where to find our javascript code.
   * Create a new line in <html><head></html> and type 'script', then select 'script:src'.   * Create a new line in <html><head></html> and type 'script', then select 'script:src'.
   * Type the name of our javascript file 'lists.js' into the <html> src </html> attribute.   * Type the name of our javascript file 'lists.js' into the <html> src </html> attribute.
Line 26: Line 29:
   * I've included names of 4 Colombian football players, but there are many more. Feel free to add any others you know using the same format.   * I've included names of 4 Colombian football players, but there are many more. Feel free to add any others you know using the same format.
   * I've written each of the names on a separate line to make it clear. This is good practice, but it's not essential - you can string them all on the same line as long as you separate the items with a <html> , </html>.   * I've written each of the names on a separate line to make it clear. This is good practice, but it's not essential - you can string them all on the same line as long as you separate the items with a <html> , </html>.
-  * We now need to take the names in this array and print them on the screen as a list. For this we'll use a 'for loop', but before we try that on this list, let's take a look at how 'for loops' work.+ 
 +==== Referencing Array Elements ==== 
 +  * To display these items, we need to be able to reference them. 
 +  * You've seen how to do this before. In the previous lesson, we accessed elements with specific tags using <html>document.getElementsByTagName('span')[2]</html>. <html>document.getElementsByTagName('span')</html> is an array (a list) of all elements with the tag <html>span</html>. <html> [2] </html> means that we access the 3rd item in the list. Remember that the first item is <html> [0] </html>. 
 +  * We can see this more easily in jsfiddle. 
 +  * Create a simple array in the Javascript panel as follows. 
 +<code>cars = ['Ferrari', 'Porsche', 'Lamborghini'];</code> 
 +  * Here, the array is simple enough that I've left it on a single line. 
 +  * Now, let's display the first element in the list on our page. 
 +<code>document.body.innerHTML = cars[0];</code> 
 +  * Run the code and see that it displays 'ferrari', the first item. 
 +  * Try changing the number inside the <html> [] </html> and check the results to be sure you understand how it works. 
 +  * Using this technique, we can display the results of our list in our Visual Studio page. 
 +  * Open 'lists.html' and add an unordered list just before the closing <html></body></html> tag. 
 +<code>  <h2>Players</h2> 
 +  <ol></ol> 
 +</body></code> 
 +  * We'll use this to display our Javascript array. 
 +  * After the players list in 'lists.js', add the following code to generate our list code. 
 +<code>playerList = ""; 
 +playerList += "<li>" + players[0] + "</li>"; 
 +playerList += "<li>" + players[1] + "</li>"; 
 +playerList += "<li>" + players[2] + "</li>"; 
 +playerList += "<li>" + players[3] + "</li>";</code> 
 +  * Can you see how this works? We're building a string with all our list items, one on each line. Each has the opening and closing list ags with the list item in between. 
 +  * Next we need to display the string we've created. 
 +<code>document.getElementsByTagName('ol')[2].innerHTML = playerList;</code> 
 +  * This looks for the 3rd <html><ol></html> tag and inserts the list string there. 
 +  * If you run the code now, it probably won't work because the Javascript code executes before the HTML code has finished loading (ie the 3rd <html><ol></html> tag doesn't exist when the code runs). To avoid this, we need to wrap the display command inside a function that only runs when the page is fully loaded. 
 +<code>window.onload = function() { 
 +  document.getElementsByTagName('ol')[2].innerHTML = playerList; 
 +}</code> 
 +  * <html>window</html>, like <html>document</html> identifies the whole page. 
 +  * <html> .onload </html> triggers when the HTML code has finished loading. 
 +  * When this is true, the browser will run the <html>function</html> containing all the code between <html> {} </html>. 
 +  * You don't need to remember or understand all this completely, but you should be able to recognise this pattern and be able to apply it when necessary. We'll use it often during the course so you become familiar with it. 
 +  * The code should work now when you run it, but if you've added all 16 players, listing them all would take more work. And some lists (like the list of products on MercadoLibre) have thousands of entries. 
 +  * We can save ourselves a lot of time by writing a 'for loop' that will run through all entries and create the string dynamically.
  
 ==== For Loops ==== ==== For Loops ====
-  * This will be easier to see in [[https://jsfiddle.net|jsfiddle]] so open that page. +  * The name ‘for loop’ will seem strange if you’re new to programming. It essentially means that ‘for’ each item in the list, we will ‘loop’ through a given block of code. ie. we’re going to apply the same code (add the item to our string) to every player. 
-  * Type the following code into the Javascript section.+  * Let’s go back to jsfiddle to see how this works. 
 +  * Type the following code into the Javascript section below the cars array.
 <code>for (i = 0; i < 10; i++) { <code>for (i = 0; i < 10; i++) {
 }</code> }</code>
Line 37: Line 78:
   * For each of these, by convention, we'll use a variable <html> i </html>, short for 'iterator'.   * For each of these, by convention, we'll use a variable <html> i </html>, short for 'iterator'.
   * <html>i = 0</html> means that the first time we run the code, the variable <html> i </html> will have a value of zero.   * <html>i = 0</html> means that the first time we run the code, the variable <html> i </html> will have a value of zero.
-  * We'll run the code as long as <html>i < 10</html>.+  * We'll run the code as long as <html>i < 10</html> is true.
   * Finally, <html>i++</html> is the same as <html>i = i + 1</html> so each time we loop through the code, we'll increment the variable <html> i </html>. So it will run with a value of i incrementing from 0 to 9.   * Finally, <html>i++</html> is the same as <html>i = i + 1</html> so each time we loop through the code, we'll increment the variable <html> i </html>. So it will run with a value of i incrementing from 0 to 9.
   * Let's see this in action by adding an 'alert' to display the value of <html> i </html>.   * Let's see this in action by adding an 'alert' to display the value of <html> i </html>.
Line 62: Line 103:
 ==== Iterating Arrays ==== ==== Iterating Arrays ====
   * So now that you understand how for loops work, we can apply it to an array.   * So now that you understand how for loops work, we can apply it to an array.
-  * Below your existing Javascript code in jsfiddle, add the following code. +  * Open your jsfiddle tab again. 
-<code>cars = ['ferrari', 'porsche', 'lamborghini'];</code>+  * Let's edit the for loop you have already. 
 +<code>var text = ""; 
 +for (i = 0; i < 10; i++) { 
 + text += cars[i] + "<br />"; 
 +} 
 +document.body.innerHTML = text;</code> 
 +  * To differentiate the two lists, let's change the name of the new list to carList. 
 +<code>var carList = ""; 
 +for (i = 0; i < 10; i++) { 
 + carList += cars[i] + "<br />"; 
 +} 
 +document.body.innerHTML = carList;</code> 
 +  * In the for loop, the starting condition <html> i = 0 </html> and iterating statement <html> i++ </html> are still valid, but we need to adjust the continuing condition to stop at 3 items. 
 +<code>var carList = ""; 
 +for (i = 0; i < 3; i++) { 
 +  carList += cars[i] + "<br />"; 
 +} 
 +document.body.innerHTML = carList;</code> 
 +  * If you run his now, it should show all 3 cars, one on each line. 
 +  * Now have a go at applying this yourself to the list of players in Visual Studio Code. 
 +  * Here's my version. 
 +<code>players = ['David Ospina Ramirez', 
 +           'Johan Andres Mojica Palacio', 
 +           'Gustavo Leonardo Cuellar Gallego', 
 +           'Duvan Esteban Zapata Banguera']; 
 + 
 +window.onload = function () { 
 +  playerList = ""; 
 +  for (i = 0; i < 4; i++) { 
 +    playerList += "<li>" + players[i] + "</li>"; 
 +  } 
 +  document.getElementsByTagName('ol')[2].innerHTML = playerList; 
 +}</code> 
 +  * Did you have something similar? 
 +  * If you added more players, you won't be using the number 4. Or if you did, you won't see the whole list. 
 +  * In fact, if you pull a list from a database, which we'll do much later in the course, you likely won't know how many items are in the ilst. What do you do then? 
 +  * Thankfully, Javascript can count the number items in an array for you using <html> .length </html>. 
 +  * Let's see how this works in jsfiddle. 
 +  * Add an alert to your Javascript code. 
 +<code>alert("cars has " + cars.length + " items.");</code> 
 +  * Run that and check that it does what you think it should. 
 +  * So we can change our continuing condition for the list of players as follows. 
 +<code>for(i = 0; i < players.length; i++) {</code> 
 +  * Run it now and see that it shows exactly as many players as you have in your list. 
 +  * Congratulations on creating a list using Javascript. 
 + 
 +==== Conditional Statements ==== 
 +  * Sometimes the action you take will depend on some other factor - user input, previous actions or information from a database for example. 
 +  * The simplest of these is the 'if statement'. 
 +  * Let's jump back to jsfiddle to see how this works. Delete all the Javascript you have there at the moment. 
 +  * Enter the following code into the Javascript panel. 
 +<code>var x = 2; 
 +if (x == 2) { 
 + alert 'the condition is true'; 
 +}</code> 
 +  * The basic structure of this code is <html>if (condition) { code to execute if true }</html>. 
 +  * We have a condition inside the <html> () </html>, and only if that condition is true do we run the code inside <html> {} </html>. 
 +  * In this case, our condition is <html> x == 2 </html>, which checks the value of <html> x </html> and the value of <html> 2 </html>. If the value of <html> x </html> is 2, then it will run the code displaying an alert. 
 +  * Since we've just defined <html> x = 2 </html> (first line), this condition is true and the alert will be displayed. Try it now. 
 +  * Now change the value of <html> x </html> to 5 (or anything but 2) and run the code again. 
 +  * Nothing is displayed. Let's add a message if it fails too. 
 +<code>var x = 2; 
 +if (x == 2) { 
 + alert 'the condition is true'; 
 +} else { 
 + alert 'the condition is false'; 
 +}</code> 
 +  * Here, we have added <html>else</html> with code that will run if the condition is not met. Run the code again with the wrong value of <html> x </html> and see the new statement. 
 +  * Now, let's apply that to our checklist in 'lists.html' using Visual Studio Code. 
 +  * If the user checks a checkbox, we will make the associated text grey. If they uncheck it, we'll make the text black again. 
 +  * Add an attribute to each of the list items to call a Javascript function. 
 +<code>        <li><input type="checkbox" name="flour" onchange="toggleCheckbox('flour')">100g flour</li> 
 +        <li><input type="checkbox" name="eggs" onchange="toggleCheckbox('eggs')">2 eggs</li> 
 +        <li><input type="checkbox" name="milk" onchange="toggleCheckbox('milk')">300ml milk</li></code> 
 +  * <html>onchange=""</html> will trigger whenever there is a change to the element - in this case when the checkbox is checked or unchecked. When triggered it will run the Javascript code between the <html>""</html>. 
 +  * We will call our Javascript function 'toggleCheckbox' and pass the function the name of the checkbox element so the function will know which line to update. 
 +  * Now, save 'lists.html' and open 'lists.js'. 
 +  * Add our function below the existing code. 
 +<code>function toggleCheckbox(item) { 
 +}</code> 
 +  * First we define the code as a 'function' using <html>function</html> which means it will only run when specifically called. In this case we'll call it by clicking the checkbox, but it could also be called from other code. 
 +  * Next, we name the function 'toggleCheckbox'. 
 +  * Then we assign the information passed by the <html>onChange</html> attribute (the name of the checkbox) to the variable called <html>item</html>. 
 +  * Finally, we have <html> {} </html> ready to contain our code to be run. 
 +  * To make things a bit easier, we'll find the actual checkbox using the name, and assign that to a variable. Copy the following code inside the <html> {} </html>. 
 +<code>  cb = document.getElementsByName(item)[0];</code> 
 +  * We've called our checkbox 'cb'. 
 +  * This time we're finding our element by name instead of tag so we use <html>.getElementsByName</html>. Then we choose the first in the list (<html>[0]</html>). 
 +  * Now we can add our condition. 
 +<code>  if (cb.checked) { 
 +  } else { 
 +  }</code> 
 +  * If our checkbox 'cb' is checked, then we'll run some code to make the text grey, otherwise we'll run code to make it black. 
 +  * The text isn't part of our checkbox, so we need to find the element it belongs to, which in this case is the parent element (our <html><input></html> element is directly inside our <html><li></html> element) so we use <html>.parentElement</html>. 
 +  * The full code is then as follows. 
 +<code>function toggleCheckbox (item) { 
 +    cb = document.getElementsByName(item)[0]; 
 +    if (cb.checked) { 
 +        cb.parentElement.style.color = "gray"; 
 +    } else { 
 +        cb.parentElement.style.color = "black"; 
 +    } 
 +}</code> 
 +  * Run that and try it out for yourself. 
 + 
 +==== Final Code ==== 
 +  * [[https://jsfiddle.net/maganthro/t3bq247f/13/|jsfiddle]] 
 +  * [[https://techschool.murraygunn.id.au/webdev/classes/lists/4/es.php|lists.html]] 
 +  * [[https://techschool.murraygunn.id.au/webdev/classes/lists/4/listsjs.php|lists.js]] 
 +  * [[https://techschool.murraygunn.id.au/webdev/classes/lists/4/lists.html|final result]] 
 + 
 +[[en:web_development:lists:exercise|Next: Exercises]]
en/web_development/lists/javascript.1638286709.txt.gz · Last modified: 2023/08/16 09:33 (external edit)

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki