How:Write scripts in JavaScript for Memento: Difference between revisions

Jump to navigation Jump to search
m
no edit summary
mNo edit summary
mNo edit summary
(2 intermediate revisions by the same user not shown)
Line 30: Line 30:
:; 2 * currentWeight: If currentWeight is 23 lbs, then 46 lbs
:; 2 * currentWeight: If currentWeight is 23 lbs, then 46 lbs
:; (hours * 60) + minutes:If hours is 5 and minutes is 10, then 310
:; (hours * 60) + minutes:If hours is 5 and minutes is 10, then 310
==== Conditional execution in JavaScript ====
Deciding to execute one set of statements or another or possibly yet another
based on some condition is referred to as ''conditional execution'' and forms of it
are known as ''alternation''. What one might want to do is:
If something is true, then do these things; otherwise, do those things.
This is referred to as alternation.
if (field("products") == "Orange")
    "Fruit"
else if (field("products") == "Broccoli")
    "Vegetable"
else
    "Empty"
_____
If you read other people's scripts, you might see ...
_____
if (field("products") == "Orange")
    "Fruit";
else if (field("products") == "Broccoli")
    "Vegetable";
else
    "Empty";
_____
That's because Memento tries to keep things simple for us, and semicolons look weird too, and for just an expression, it's not really needed, but when things get more complex, it turns out you need to terminate every statement with a semicolon. That's why professional JavaScript programmers do that. Another similar thing you might see is ...
if (field("products") == "Orange") {
    "Fruit";
}
else if (field("products") == "Broccoli") {
    "Vegetable";
}
else {
    "Empty";
}
The reason for that is that sometimes, when what you're needing to do is a little more complex, you might need to do several things if the produce is an orange, for example, and the way you do that is to use braces at the start & at the end of a block of statements. That's why we call those things blocks. In your case now it's overkill & you don't need it, but it still works if you do, as above.
If you have just a couple more of each type of produce, you can use || which means or. That's or, & for and, you say &&.  If you do a lot of this stuff, it starts to get hard to match up an end parenthesis with its corresponding start parenthesis. In Calculation fields, you have that problem in spades, even with simple stuff (another reason I don't use calc), but it happens in JavaScript too, for somewhat more complex stuff. For example ...
_____
if ((field("products") == "Orange") || (field("products") == "Lemon"))
    "Fruit";
else if ((field("products") == "Broccoli") || (field("products") == "Spinach"))
    "Vegetable";
else
    "Empty";
_____
Repeat the else if line pair as needed.
If you end up doing a lot of them, there's another way to do it that would be more compact & will help with the parentheses ...
_____
// Comment here, to the end of the line, ignored by JavaScript
var produce = field("GrocerySection");  // Replace with your fieldname
switch (expr) {
  case "Orange":
  case "Lemon";
  case "Lime":
  case "Tangerine":
      "Fruit";
      break;
  case "Broccoli":
  case "Brussel sprouts";
  case "Turnips":
  case "Spinach":
      "Vegetable";
      break;
  default:
      "Empty";
}
_____
So, we have one or more cases, then the result, then a command to end the list of cases. I've always thought this (the break) is stupid, but it works, and that's the way they did it, so that's how we have to do it. Then another one or more cases then the result and the break, and on and on. Finally, if it matches none of the kinds of produce, then you can supply the default result by using default in place of case. There can be only one default.
So ...
This message is already quite long, so I won't take you to the next stage of complexity yet, but we use the next form in action scripts a lot & in trigger scripts sometimes too, so if you're interested, give me another shout, and I'll pick up with the next lesson.


==== Sample complex expression script ====
==== Sample complex expression script ====
Line 46: Line 128:


==== Terminology ====
==== Terminology ====
:; Constant:a value that has a string (text) value or a numeric (number) value.
:; Constant: A value that has a string (text) value or a numeric (number) value.
<small>
<small>
::; String literal:"This is a string of textual characters"
::; String literal: <code>"This is a string of textual characters"</code>
::; String constant: Sol or PlanetMars
::; String constant: <code>Sol</code> or <code>PlanetMars</code>&nbsp;&nbsp;&nbsp;&nbsp;// By convention, constants are distinguished from variables by starting with a capital letter
::; Number literal: 123 or 314e-2 or -28.5
::; Number literal: 123 or 314e-2 or -28.5&nbsp;&nbsp;&nbsp;&nbsp;// The middle one is in scientific format
::; Numeric constant: Age or ListPrice
::; Numeric constant: <code>EverestHeight</code> or <code>C**2</code>&nbsp;&nbsp;&nbsp;&nbsp;// The height in feet of Mount Everest or the speed of light squared
::; Symbol constant:a name representing a constant value, like ''pi'' or ''surname''
::; Symbol constant: A name representing a constant value, like <code>pi</code> or <code>surname</code>
</small>
</small>
:; Variable: a name representing a value that may change over time, like ''sum'', ''currentValue'', or ''orderDate''
:; Variable: A name representing a value that may change over time, like <code>sum</code>, <code>currentValue</code>, or <code>orderDate</code>
:; Operator: one or more characters that represent an expression, like '''+''' for ''plus'' or '''-''' for ''minus'' or '''*''' for ''multiplied by'' or '''/''' for ''divided by''.
:; Operator: One or more characters that represent an expression, like <code>+</code> for ''plus'' or <code>-</code> for ''minus'' or <code>*</code> for ''multiplied by'' or <code>/</code> for ''divided by''.
:: Some operators are made up of other operators used in combination, like '''<=''' ''for less than or equal to'' or '''&&''' for ''and also''.
:: Some operators are made up of other operators used in combination, like <code><=</code> for ''less than or equal to'' or <code>&&</code> for ''and also''. One operator is ''3'' characters long: <code>===</code> means ''is equal to & is of the same type as''. JavaScriptd is ''loosely typed'', so its types are very general, like Number, String, or Date.
 
:: in x++, ++ is a ''unary'' operator.
:: in b - 5, - is a ''binary'' operator.
:: in canDrive = age > 16 ? 'yes' : 'no', ? and : are used like if and else together as the only ''ternary'' operator in JavaScript &mdash; the ''conditional'' operator. The > is a binary operator that returns ''true'' or ''false''. If the result is true (the age is over 16), then canDrive will be true. If it is false, canDrive will be false. It is good for cases where something is this or else that &mdash; one or the other, plain & simple. Since it is plain & simple, it is (perhaps) appropriate to simplify the conditional as well, with ? and :.


:: In <code>x++</code>, <code>++</code> is a ''unary'' operator.
:: In <code>b - 5</code>, <code>-</code> is a ''binary'' operator.
:: In <code>canDrive = age > 16 ? 'yes' : 'no'</code> &mdash; <code>?</code> and <code>:</code> are used like <code>if</code> & <code>else</code> together as the only ''ternary'' operator in JavaScript &mdash; the ''conditional'' operator. The <code>></code> is a binary operator that returns ''true'' or ''false''. If the result is true (the age is over 16), then canDrive will be true. If it is false, canDrive will be false. It is good for cases where something is this or else that &mdash; one or the other, plain & simple. Since it is plain & simple, it is (perhaps) appropriate to simplify the conditional as well, with <code>?</code> and <code>:</code>.


== Shared script ==
== Shared script ==
Line 81: Line 162:
function formatMoney(number, decPlaces, decSep, thouSep) {
function formatMoney(number, decPlaces, decSep, thouSep) {
     decPlaces = isNaN(decPlaces = Math.abs(decPlaces)) ? 2 : decPlaces,
     decPlaces = isNaN(decPlaces = Math.abs(decPlaces)) ? 2 : decPlaces,
     decSep = typeof decSep === "undefined" ? "." : decSep;
     decSep = typeof decSep === "undefined" ? "." : decSep,
     thouSep = typeof thouSep === "undefined" ? "," : thouSep;
     thouSep = typeof thouSep === "undefined" ? "," : thouSep;
     var sign = number < 0 ? "-" : "";
     var sign = number < 0 ? "-" : "";

Navigation menu