Diferència entre revisions de la pàgina «Mòduls amb Javascript»

De wikijoan
Salta a la navegació Salta a la cerca
 
(Hi ha 22 revisions intermèdies del mateix usuari que no es mostren)
Línia 18: Línia 18:
 
Trobem els ''exports'' en els scripts de la carpeta ''modules/'': ''canvas.js'' i ''square.js''. Les funcions definides en aquests mòduls s'importen en el ''main.js'', que és el fitxer principal de Javascript. El ''index.html'' és el punt d'entrada de la web/html, i fa referència al ''main.js'' com has fet moltes vegades.
 
Trobem els ''exports'' en els scripts de la carpeta ''modules/'': ''canvas.js'' i ''square.js''. Les funcions definides en aquests mòduls s'importen en el ''main.js'', que és el fitxer principal de Javascript. El ''index.html'' és el punt d'entrada de la web/html, i fa referència al ''main.js'' com has fet moltes vegades.
  
Debes prestar atención a las pruebas locales — si intentas cargar el archivo HTML localmente (es decir, con una URL file:///), te encontrarás con errores de CORS debido a los requisitos de seguridad del módulo JavaScript. Necesitas hacer tus pruebas a través de un servidor.
+
Has de tindre en compte els problemes que et trobaràs amb les proves locals (si intentes carregar l'arxiu HTML localment, és a dir, amb una URL file:///, ettrobaràs amb errors de CORS degut als requisits de seguretat del mòdul JavaScript. Necessites fer les teves proves en el teu servidor web:
 
+
*http://ruta_apache/index.html
 
Comprovar que el primer exemple funciona correctament (''basic-modules''), i comprovar que funciona la resta d'exemples.
 
Comprovar que el primer exemple funciona correctament (''basic-modules''), i comprovar que funciona la resta d'exemples.
  
=Cas pràctic. Dibuixar un mapa amb la llibreria OpenLayers=
+
=Utilitzar mòduls a la consola.=
==Treballar amb llibreries==
+
En aquesta cas hem d'utilitzar l'extensió ''.mjs'' (mòduls de js en comptes de .js). El codi mínim i que no té interfície gràfica seria:
A high-performance, feature-packed library for all your mapping needs.
 
*https://openlayers.org/
 
  
Donar una ullada a tots els exemples que podem fer a:
+
script ''square.mjs'':
*https://openlayers.org/en/latest/examples/
+
<pre>
 +
const name = 'square';
  
Però el ''hola món'' de com pintar un mapa és a:
+
function instanciar(length, color) {
*https://openlayers.org/en/latest/doc/quickstart.html
+
  return {
 +
    length: length,
 +
    color: color
 +
  };
 +
}
  
En el primer exemple no utilitzem els mòduls, ho fem amb les llibreries:
+
function reportArea(length) {
 +
  console.log(length*length);
 +
}
  
script ''pintar_mapa.html'':
+
function reportPerimeter(length) {
<pre>
+
    console.log(4*length);
<!doctype html>
+
}
<html lang="en">
 
  <head>
 
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/openlayers/openlayers.github.io@master/en/v6.5.0/css/ol.css" type="text/css">
 
    <style>
 
      .map {
 
        height: 400px;
 
        width: 100%;
 
      }
 
    </style>
 
    <script src="https://cdn.jsdelivr.net/gh/openlayers/openlayers.github.io@master/en/v6.5.0/build/ol.js"></script>
 
    <title>OpenLayers example</title>
 
  </head>
 
  <body>
 
    <h2>My Map</h2>
 
    <div id="map" class="map"></div>
 
    <script type="text/javascript">
 
      var map = new ol.Map({
 
        target: 'map',
 
        layers: [
 
          new ol.layer.Tile({
 
            source: new ol.source.OSM()
 
          })
 
        ],
 
        view: new ol.View({
 
          center: ol.proj.fromLonLat([37.41, 8.82]),
 
          zoom: 4
 
        })
 
      });
 
    </script>
 
  </body>
 
</html>
 
</pre>
 
Pintar el mapa sobre la teva ciutat amb un nivell de zoom detallat.
 
  
Ara farem aquest mateix exercici amb mòduls. Els exemples que hem vist anteriorment estan tots amb mòduls.
+
export { name, instanciar, reportArea, reportPerimeter };
==Treballar amb mòduls==
 
Per treballar amb mòduls, que és la manera recomanable, hem d'anar als ''Tutorials'', i anar al primer de tots: ''Building an OpenLayers Application'':
 
*https://openlayers.org/en/latest/doc/tutorials/
 
*https://openlayers.org/en/latest/doc/tutorials/bundle.html
 
<pre>
 
$ mkdir app
 
$ cd app
 
</pre>
 
Per crear l'aplicació i importar tots els mòduls de Openlayers, utilitzarem ''npm''.
 
<pre>
 
$ npm init
 
 
</pre>
 
</pre>
Quan et pregunta, pots deixar totes les opcions per defecte. S'ha creat el fitxer package.json.
 
  
This will create a package.json file in your working directory. Add OpenLayers as dependency to your application with
+
script ''main.mjs'':
<pre>
 
$ npm install ol
 
</pre>
 
Es crea la carpeta ''node_modules'' amb totes les dependències.
 
At this point you can ask NPM to add required development dependencies by running
 
 
<pre>
 
<pre>
$ npm install --save-dev parcel-bundler
+
import { name, instanciar, reportArea, reportPerimeter } from './square.mjs';
</pre>
 
Què és parcel? (TBD)
 
  
Ara necessitem construir l'aplicació, amb els fitxers ''index.js'' i ''index.html''.
+
let square1 = instanciar(100, 'blue');
 
+
reportArea(square1.length);
script ''index.js'':
+
reportPerimeter(square1.length);
<pre>
 
import 'ol/ol.css';
 
import {Map, View} from 'ol';
 
import TileLayer from 'ol/layer/Tile';
 
import OSM from 'ol/source/OSM';
 
 
 
const map = new Map({
 
  target: 'map',
 
  layers: [
 
    new TileLayer({
 
      source: new OSM()
 
    })
 
  ],
 
  view: new View({
 
    center: [0, 0],
 
    zoom: 0
 
  })
 
});
 
 
</pre>
 
</pre>
  
script ''index.html'':
+
I si fem:
 
<pre>
 
<pre>
<!DOCTYPE html>
+
$ node main.mjs
<html>
+
10000
  <head>
+
400
    <meta charset="utf-8">
 
    <title>Using Parcel with OpenLayers</title>
 
    <style>
 
      #map {
 
        width: 400px;
 
        height: 250px;
 
      }
 
    </style>
 
  </head>
 
  <body>
 
    <div id="map"></div>
 
    <script src="./index.js"></script>
 
  </body>
 
</html>
 
 
</pre>
 
</pre>
 +
Podem provar aquest codi en l'espai que tens en el servidor '''vps-89148e22.vps.ovh.net'''.
  
Modifiquem el fitxer ''package.json'' per definir com es fa el ''build'' de l'aplicació i com s'engega (''start''):
+
=Tasques a realitzar=
 
+
[[Fitxer:Arc sant marti.png | thumbnail | (c) by Levon]]
''package.json'':
+
L'exemple mínim per dibuixar un cercle en un canvas el trobaràs per exemple a:
<pre>
+
*https://www.w3schools.com/tags/canvas_arc.asp
{
 
  "name": "test",
 
  "version": "1.0.0",
 
  "description": "",
 
  "main": "index.js",
 
  "scripts": {
 
    "test": "echo \"Error: no test specified\" && exit 1",
 
    "start": "parcel index.html",
 
    "build": "parcel build --public-url . index.html"
 
  },
 
  "author": "",
 
  "license": "ISC"
 
}
 
</pre>
 
Finalment, per fer córrer l'aplicació, farem:
 
 
<pre>
 
<pre>
$ npm start
+
var c = document.getElementById("myCanvas");
 
+
var ctx = c.getContext("2d");
> app@1.0.0 start /home/joan/M06_WEC_2021/UF2/openlayers/app
+
ctx.beginPath();
> parcel index.html
+
ctx.arc(100, 75, 50, 0, 2 * Math.PI);
 
+
ctx.stroke();
Server running at http://localhost:1234
 
✨  Built in 13.21s.
 
 
</pre>
 
</pre>
*localhost:1234
+
En realitat, més que un cercle estàs dibuixant un arc de circunferència. Quan l'angle són 360º (=2*Pi) aleshores l'arc és una circunferència sencera.
Per crear un production bundle (es crea la carpeta dist/)
 
<pre>
 
$ npm run build
 
  
> app@1.0.0 build /home/joan/M06_WEC_2021/UF2/openlayers/app
+
El mètode ''arc()'' té 5 paràmetres: la posició x i y del centre, el radi, l'angle on comença l'arc, i la longitud de l'arc (en graus).
> parcel build --public-url . index.html
 
  
✨  Built in 21.59s.
+
Basan-te en el codi que has vist a ''square.js'', faràs el script ''circle.js'' on definiràs els següents mètodes:
 +
*draw()
 +
*randomCirlce()
 +
*reportArea()
 +
*reportPerimeter
  
dist/app.ef0d89f9.js.map    ⚠️  1.95 MB    248ms
+
Seguint el mateix esquema, programaràs el script ''index.html'' (que contindrà dos canvas diferents) i el script ''main.js''.
dist/app.ef0d89f9.js         540.56 KB    19.16s
 
dist/app.bb28b584.css.map      7.18 KB      3ms
 
dist/app.bb28b584.css          3.96 KB    5.42s
 
dist/index.html                  273 B    2.06s
 
  
</pre>
+
'''1.''' En el primer canvas, dibuixaràs l'arc de Sant Martí (semicercles concèntrics). En una matriu posaràs els colors de l'Arc de Sant Martí (https://www.krishnamani.in/color-codes-for-rainbow-vibgyor-colours/), i tot recorrent aquesta matriu aniràs construint l'Arc de Sant Martí.
and copy the ''dist/'' folder to your production server.
 
  
Aquesta carpeta '''dist/''' conté totes les llibreries i el codi comprimit. L'objectiu és ara posar aquesta carpeta ''dist/'' dins el teu Apache/XAMP i veure que funciona. Per tant, distingim entre l'entorn de desenvolupament, i l'entorn de desplegament en la fase de producció.
+
'''2.''' En el segon canvas dibuixaràs 10 cercles aleatoris amb diferents graus de gris (serà aleatori el centre, el radi i el nivell de gris).
=Dòlmens de Catalunya=
 
Se't proporciona un fitxer JSON amb tots els dòlmens, geolocalitzats.
 
  
=Dòlmens de Catalunya=
 
(TBD)
 
=Feina per l'alumne=
 
(TBD)
 
 
=Entrega al Classroom=
 
=Entrega al Classroom=
(TBD)
+
Entregaràs al Classroom, dins del termini, un pdf amb dues captures de pantalla dels dos canvas, el codi del script ''circle.js'', i el codi del fitxer ''main.js''.
 
+
{{Autor}}, març 2022
{{Autor}}, març 2021
 

Revisió de 17:39, 31 març 2022

Mòduls. Introducció

$ unzip js-examples-master.zip

Anem al primer exemple:

$ cd js-examples-master/modules/basic-modules/
$ ls
index.html
main.js
modules/
    canvas.js
    square.js

Trobem els exports en els scripts de la carpeta modules/: canvas.js i square.js. Les funcions definides en aquests mòduls s'importen en el main.js, que és el fitxer principal de Javascript. El index.html és el punt d'entrada de la web/html, i fa referència al main.js com has fet moltes vegades.

Has de tindre en compte els problemes que et trobaràs amb les proves locals (si intentes carregar l'arxiu HTML localment, és a dir, amb una URL file:///, ettrobaràs amb errors de CORS degut als requisits de seguretat del mòdul JavaScript. Necessites fer les teves proves en el teu servidor web:

Comprovar que el primer exemple funciona correctament (basic-modules), i comprovar que funciona la resta d'exemples.

Utilitzar mòduls a la consola.

En aquesta cas hem d'utilitzar l'extensió .mjs (mòduls de js en comptes de .js). El codi mínim i que no té interfície gràfica seria:

script square.mjs:

const name = 'square';

function instanciar(length, color) {
  return {
    length: length,
    color: color
  };
}

function reportArea(length) {
  console.log(length*length);
}

function reportPerimeter(length) {
    console.log(4*length);
}

export { name, instanciar, reportArea, reportPerimeter };

script main.mjs:

import { name, instanciar, reportArea, reportPerimeter } from './square.mjs';

let square1 = instanciar(100, 'blue');
reportArea(square1.length);
reportPerimeter(square1.length);

I si fem:

$ node main.mjs 
10000
400

Podem provar aquest codi en l'espai que tens en el servidor vps-89148e22.vps.ovh.net.

Tasques a realitzar

(c) by Levon

L'exemple mínim per dibuixar un cercle en un canvas el trobaràs per exemple a:

var c = document.getElementById("myCanvas");
var ctx = c.getContext("2d");
ctx.beginPath();
ctx.arc(100, 75, 50, 0, 2 * Math.PI);
ctx.stroke();

En realitat, més que un cercle estàs dibuixant un arc de circunferència. Quan l'angle són 360º (=2*Pi) aleshores l'arc és una circunferència sencera.

El mètode arc() té 5 paràmetres: la posició x i y del centre, el radi, l'angle on comença l'arc, i la longitud de l'arc (en graus).

Basan-te en el codi que has vist a square.js, faràs el script circle.js on definiràs els següents mètodes:

  • draw()
  • randomCirlce()
  • reportArea()
  • reportPerimeter

Seguint el mateix esquema, programaràs el script index.html (que contindrà dos canvas diferents) i el script main.js.

1. En el primer canvas, dibuixaràs l'arc de Sant Martí (semicercles concèntrics). En una matriu posaràs els colors de l'Arc de Sant Martí (https://www.krishnamani.in/color-codes-for-rainbow-vibgyor-colours/), i tot recorrent aquesta matriu aniràs construint l'Arc de Sant Martí.

2. En el segon canvas dibuixaràs 10 cercles aleatoris amb diferents graus de gris (serà aleatori el centre, el radi i el nivell de gris).

Entrega al Classroom

Entregaràs al Classroom, dins del termini, un pdf amb dues captures de pantalla dels dos canvas, el codi del script circle.js, i el codi del fitxer main.js.


creat per Joan Quintana Compte, març 2022