NF3 - JQUERY

De wikiserver
La revisió el 18:47, 7 feb 2015 per Jnoguera (Discussió | contribucions) (→‎MÈTODES)
Dreceres ràpides: navegació, cerca

JQuery

Introducció

jQuery és un frameworkde JavaScript que permet simplificar el maneig dels documents HTML, l'arbre DOM, manejar esdeveniments, desenvolupar animacions i afegir interacció amb Ajax a pàgines web.

JQuery és programari lliure i de codi obert creat per John Resig que a més treballa per a Mozilla Corporation.

La primera versió de jQuery estable aparèixer l'any 2006 i l'última, de febrer de 2011, és la versió 1.5.1. Aquesta última versió es caracteritza per la utilització d'Ajax.

L'ús de jQuery llibretera al programador d'haver de implementar els mètodes JavaScript que el framework conté. Entre altres facilitats, jQuery té implementats tots els seus mètodes per detectar el navegador de l'usuari i adaptar les funcions a cada un d'ells.

La llibreria jQuery en resum ens aporta els següents avantatges:

  • Estalvia moltes línies de codi.
  • Fa transparent el suport de la nostra aplicació per als navegadors

principals.

  • Proveeix d'un mecanisme per a la captura d'esdeveniments.
  • Proveeix un conjunt de funcions per animar el contingut de la pàgina en

forma molt senzilla.

  • Integra funcionalitats per treballar amb AJAX.

PRINCIPIS D'ÚS

La forma d'interactuar amb la pàgina és mitjançant la funció $ (), un àlies de jQuery que rep com a paràmetre una expressió CSS o el nom d'una etiqueta HTML i retorna tots els elements que concorden amb l'expressió. 


// Devuelve el elemento con id="cabecera" 
$("#cabecera")  
// Devolverá una matriz de elementos con class="destacado" 
$(".destacado")

Un cop obtinguts els elements, se'ls pot aplicar qualsevol de les funcions que facilita la biblioteca. 

// Se elimina el estilo (removeClass()) y se aplica uno nuevo (addClass()) a todos los nodos con class=" destacado " 
$(". destacado ").removeClass("destacado ").addClass("nodestacado");

CARREGAR LA WEB

Una de les funcions més utilitzades en les aplicacions JavaScript és la següent 

window.onload = function () {,,,}

L'ordre anterior fa que function () s'executi una vegada que la pàgina s'hagi carregat per complet. jQuery disposa d'una funció equivalent 

$ (document) .ready (function () {...})

El gran avantatge de la funció de jQuery, és que la pàgina es pot manipular quant s'ha carregat el seu codi HTML (i per tant, s'ha construït l'arbre DOM de la pàgina) mentre que la funció de JavaScript espera que es carreguin tots els elements de la pàgina, incloent totes les imatges. D'aquesta manera, les aplicacions realitzades amb jQuery poden respondre de forma molt més ràpida que les aplicacions JavaScript tradicionals.

ACCÉS ALS ELEMENTS DEL WEB

D'altra banda, la funció getElementById () és possiblement la més utilitzada a desenvolupar aplicacions web, ja que permet seleccionar un element a partir de la seva atribut "id". A més, hi ha dues funcions relacionades:

getElementsByTagName () i getElementsByName (). jQuery inclou la funció $ () com una alternativa més ràpida i completa per seleccionar qualsevol element de la pàgina:

Con JavaScript 

// Seleccionar un elemento 
document.getElementById("miParrafo"); 
// Seleccionar todos los enlaces 
document.getElementsByTagName("a"); 
// Seleccionar todo lo anterior 
---- 
// Seleccionar mediante la clase CSS 
----

Con jQuery 

// Seleccionar un elemento 
$("#miParrafo"); 
 // Seleccionar todos los enlaces 
$("a"); 
// Seleccionar todo lo anterior 
$("#miParrafo, a") 
// Seleccionar mediante la clase CSS 
$(".miClase")

SELECTORS

jQuery s'utilitza selectors per identificar aquells elements sobre els quals es vol actuar. Un selector és una cadena de caràcters que identifica un o diversos elements d'una pàgina web. Els selectors bàsics utilitzats en jQuery són:

Selector d'etiquetes. 

$("h2")  
//selecciona tots els elements que tenen etiqueta <h2> ... .. </ h2>
  • Selector por etiqueta/contingut. 
$("p:contains('Hola')") 
//selecciona els paràgrafs (<p> ... </ p>) que continguin la paraula "Hola"
  • Selector per etiqueta / propietat. 
$("div:visible") 
//selecciona els div que tinguin la propietat visible = true
  • Selector per etiquetes/classe. 
$("li.nombreClase") 
//selecciona els li que tinguin assignada la classe CSS nombreClase


Selector per identificador 

$ ("#MeusComentaris")
// selecciona tots els elements que tenen l'atribut id = misComentarios

Selector per classe CSS 

$ (".miClase")
// selecciona tots els elements que tenen com a atribut class = "miClase"

Selectors de diversos elements 

$ ("p, a")
// Selecciona tots els <a> i tots els <p>

Selectors posicionals

  Els selectors posicionals están basats en les relacions posicionals entre elements segons l'estructura DOM del document.

  • Selecciona el primer element

    de la pàgina

$ ("p:first")
  • Selecciona el primer <img> de la pàgina que té un atribut src acabat en .png
$ ("Img[src $ =. Png]: first)
  • Selecciona tots els paràgrafs que implementin la classe CSS miClase:
$ ("P[miClase]")
  • Selecciona tots els divs que continguin algun paràgraf dins:
$ ("Div[p]")
  • Selecciona tots els paràgrafs que tinguin almenys un enllaç:
$ ("p[a]")
  • Selecciona tots els ràdio buttons que han estat revisats
$ ("input[@ type = ràdio] [@ checked]")


Selectors parent> child

Els selectors parent> child permet que es pugui puguin accedir als elements que siguin fills directes d'altres. 

// selecciona totes les etiquetes b que són filles directes dels paràgrafs
$ ("p> b")
// selecciona totes les etiquetes que són filles directes de l'element amb id = "capa"
$ ("# capa> *")


Selectors de formulari

Els selectors de formulari permeten seleccionar elements de formulari de forma específica.

  • Selecciona tots els elements <input> amb un tipus d'atribut igual al nom del selector.
$ (": Text")
// selecciona tots els input que tinguin tipus text
$ (": Checkbox")
// selecciona tots els input que tinguin tipus checkbox
  • Selecciona tots els elements input
$ (": Input")
  • Selecciona tots els elements button
$ (": Button")
  • Selecciona tots els elements activats del formulari:
$ (": Enabled")
  • Selecciona tots els ràdio buttons i checkbox del formulari que estan premuts
$ (": checked")
  • Selecciona tots els radio button que estiguin revisats
$ (": ràdio: checked")

Selectors de jerarquia

  • Selector de descendents: selecciona elements que baixin d'un altre element (CSS 1)
jquery ("div.entrada h2")
  • Selector de fills: selecciona elements que siguin fills directes d'un altre element (CSS 2)
jquery ("div.entrada> h2")
  • Pseudo classe fill: selecciona l'enèsim fill d'un element (CSS 3)
jquery ("tr: nth-child (1)")
  • Pseudo classe primer fill: selecciona el primer fill d'un element (CSS 2)
jquery ("tr: first-child")
  • Pseudo classe últim fill: selecciona l'últim fill d'un element (CSS 3)
jquery ("tr: last-child")
  • Pseudo classe fill únic: selecciona els elements que siguin fills únics de altres elements (CSS 3)
jquery ("div: only-child")
  • Pseudo classe primer: selecciona el primer element d'un grup de elements. Equival a eq (0) (jQuery)
jquery ("td: first)")
  • Pseudo classe últim: selecciona l'últim element d'un grup de elements (jQuery)
jquery ("td: last)")
  • Pseudo classe més gran que: selecciona tots els elements amb un índex major que l'indicat en un grup d'elements (jQuery)
jquery ("td: gt (0)")
  • Pseudo classe menor que: selecciona tots els elements amb un índex menor que l'indicat en un grup d'elements (jQuery)
jquery ("td: lt (3)")
  • Pseudo classe parell: selecciona els elements parells d'un grup d'elements (jQuery)
jquery ("td: even")
  • Pseudo classe senar: selecciona els elements imparells d'un grup de elements (jQuery)
jquery ("td: odd")
  • Selector de germans: selecciona tots els germans que es troben precedits d'un altre element (CSS 3)
jquery ("div.entrada ~ p")
  • Selector de proper adjacent: similar a l'anterior, però només selecciona el adjacent directe (CSS 2)
jquery ("div.entrada + p")
  • Pseudo classe pare: selecciona els pares d'altres elements (jQuery)
jquery ("h2: parent")
  • Pseudo classe buit: selecciona els elements que no tinguin cap fill,incloent text pla (CSS 3)
jquery (": empty")


TAULES DE SELECTORS

Quan una funció jQuery retorna diversos elements, ho fa en format de taula,on cada element està identificat per una posició de la mateixa. llavors mitjançant: eq (índex) podem obtenir l'element de la llista a què es fa referència de la posició índex + 1, tenint en compte que les llista en jQuery comencen comptar des de 0. Per exemple, en la següent instrucció emmagatzema una referència al tercer enllaç que implementa la classe "enlaceAmigos". 

enllaç = $ ('a.enlaceAmigos: eq (2)')

A continuació es mostra com accedir al paràgraf número 3 (segona posició) 

miParrafo = $ ("p: eq (2)")

OPERADORS

Es poden utilitzar els operadors ^ =, $ = i * =.

  • ^ = per obtenir els elements d'una pàgina HTML que continguin un atribut que comenci per un valor determinat.
  • $ = per obtenir els elements d'una pàgina HTML que acabi per un valor determinat.
  • * = per obtenir els elements d'una pàgina HTML que contingui un valor determinat.
$ (document) .ready (function () {
// fa referència als enllaços que comencen per mailto:
$ ('a[href^="mailto:"]'). addClass ('mailto');
// fa referència als enllaços que facin referència a un fitxer pdf
$ ('a[href$=". pdf"]'). addClass ('enlacePdf');
// fa referència a un enllaç a sitio.com
$ ('a[href*="sitio.com"]'). addClass ('lloc');
});

Aquestes classes CSS han d'estar prèviament definides a la pàgina, per exemple: 

.mailto {color: blue; }
.enlacePdf {color: green; }
.sitio {color: yellow; }

D'aquesta manera, els enllaços de tipus mailto apareixeran en blau, els enllaços a fitxers pdf verds i els enllaços a "sitio.com" apareixeran en groc.


Utilitzant Events (Event handler)

Si volem afegir esdeveniments als diferents elements que apareixen a la pàgina web utilitzant Jquery podem fer-ho molt fàcilment: 

$('#boton').click(function() {
	$('#missatge').show(); //es mostra el missatge
});

Però quan s'executa un element moltes vegades volem utilitzar l'element on està l'esdeveniment per tal de fer alguna cosa amb els seus valors. Jquery ens permet utilitzar la paraula reservada this. 

$('#Boton').click(function() {
	$(this).hide(); // el botó desapareix
});

$(this)proporciona una manera més maca d'accedir al botó en comptes de tornar a seleccionar-ho. Amb JQuery podem fer coses molt potents com el botó 'toggle': 

$('#toggleBoto').click(function() {
	$('#missatge').toggle();
	if ($('#missatge').is(':visible')) {
		$(this).val('Amaga');
	} else {
		$(this).val('Mostra');
	}
});


TIPUS D'ESDEVENIMENTS

jQuery disposa de tantes funcions com esdeveniments estàndard de JavaScript. El nom de cada funció és el mateix que el de l'esdeveniment, sense l'habitual prefix "On": focus (), blur (), keyup (), mouseover (), MouseUp (), resize (), submit (), etc.

ESDEVENIMENTS RELACIONATS AMB EL RATOLÍ

  • click () Detecta l'esdeveniment clic quan es produeix en un element de la pàgina.
  • dblclick () Detecta un esdeveniment quan es produeix un doble clic sobre un element.
  • hover () Aquesta funció en realitat serveix per manejar dos esdeveniments, quan el ratolí entra i surt de sobre d'un element. Per tant s'ha d'enviar dos funcions en comptes d'una.
  • mouseDown () Detecta un esdeveniment quan l'usuari fa clic al moment que pressiona el botó i independentment de si el deixa anar o no. serveix tant per al botó dret com l'esquerre del ratolí.
  • MouseUp () Detecta un esdeveniment quan l'usuari ha fet clic i després deixa anar un botó del ratolí. L'esdeveniment MouseUp es produeix només en el moment dedeixar anar el botó.
  • mouseenter () Detecta l'esdeveniment es produeix en situar el ratolí a sobre d'un element de la pàgina.
  • mouseleave () Detecta un esdeveniment quan el ratolí surt de sobre d'un element de la pàgina.
  • mousemove () Detecta l'esdeveniment que es produeix en moure el ratolí sobre un element de la pàgina.
  • mouseout () Detecta l'esdeveniment que es deslliga quan l'usuari surt amb el ratolí de la superfície d'un element.
  • mouseover () Detecta l'esdeveniment que es produeix quan el ratolí està sobre un element, però té com a particularitat que pot produir diverses vegades mentre es mou el ratolí sobre l'element, sense necessitat d'haver sortit.


ESDEVENIMENTS RELACIONATS AMB EL TECLAT

  • keydown () Detecta l'esdeveniment que es produeix en el moment que es pressiona una tecla del teclat, independentment de si s'allibera la pressió o es manté. Es produeix una única vegada en el moment exacte de la pressió.
  • keypress () Detecta l'esdeveniment que ocorre quan es digitals un caràcter, o es pressiona altre tipus de tecla. És com l'esdeveniment keypress de Javascript, per la qual que s'entén que keypress () s'executa una vegada, com a resposta a una pulsació i immediat alliberament de la tecla, o diverses vegades si es prem una tecla i es manté premuda.
  • keyup () Detecta l'esdeveniment que es produeix en el moment d'alliberar una tecla, és a dir, en deixar de pressionar una tecla que teníem premuda.


ESDEVENIMENTS COMBINATS TECLAT-RATOLÍ

  • blur () L'esdeveniment blur es llança sobre un element que acaba de perdre el focus. Normalment aquest esdeveniment és aplicable a inputs de formularis.
  • Focusin () Esdeveniment que es produeix quan l'element guanya el focus de la aplicació, que pot produir en fer clic sobre un element o alpressionar el tabulador i situar el focus en aquest element.
  • focusout () Ocorre quan l'element perd el focus de l'aplicació, que pot ocórrer quan el focus està en aquest element i premem el tabulador,o ens movem a un altre element amb el ratolí.
  • focus() Serveix per a definir accions quan es produeix l'esdeveniment focus de Javascript, quan l'element guanya el focus de l'aplicació

ALTRES ESDEVENIMENTS

  • resize () Aquest esdeveniment és llança quan es canvia la mida de la finestra.

Aquest esdeveniment només s'envia a l'objecte window.

  • scroll () Aquest esdeveniment s'envia als elements que canvien el seu scroll davant d'una acció de l'usuari. S'aplica als objectes Window System, frames i elements amb la propietat overflow CSS posada en estat "scroll".
  • select () L'esdeveniment select es llança quan l'usuari selecciona un text del element sobre el qual es gestiona l'esdeveniment. Aquest esdeveniment només s'aplica als textarea i als inputs de tipus text.
  • submit () Aquest esdeveniment es llança quan un usuari està tractant d'enviar un formulari. Aquest esdeveniment només és vàlid per a formularis. depenent del navegador és possible enviar el formulari sense necessitat de punxar en un

botó, simplement prement la tecla ENTER. Quan això succeeix el esdeveniment no es llança, per la qual cosa hem de parar especial atenció a aquest comportament per gestionar en el seu corresponent esdeveniment "Keypressed".

  • toggle () L'esdeveniment toggle s'utilitza per generar comportaments canvi d'estat generats en punxar sobre un element. Per exemple, pot interessar que en punxar sobre un element es visualitzi i que al tornar a punxar s'oculti. Toggle ens permet fer això associant dos o més funcions al mateix esdeveniment que es van executant de forma seqüencial.

La primera vegada que es punxa sobre l'element (i totes les vegades senars), es executa la primera funció i la segona vegada que es punxa l'element (i totes les vegades parells) s'executa la segona funció: 

$ (document) .ready (function () {
   $ ("p"). toggle (function () {
        alert ("Em acabes d'activar");
     }, function () {
          alert ("Em acabes de desactivar");
   });
});
  • unload () L'esdeveniment unload es llança quan un usuari navega fora de la pàgina web o es dirigeix cap a una altra part de la web. S'executa sempre, fins i tot si l'usuari tanca el navegador


DEFINIR / ELIMINAR ESDEVENIMENTS: bind / unbind

BIND El mètode bind () permet definir qualsevol tipus d'esdeveniments i els enllaça amb el controlador d'esdeveniment que el programador desitgi. La seva sintaxi és la següent: 

bind (tipo_evento, controlador_evento)
//tipo_evento: és l'esdeveniment que es vol enllaçar amb l'objecte 
//controlador_evento: es correspon amb la funció que farà de controlador per al esdeveniment definit.

A l'hora d'aplicar bind s'han de seguir els següents passos en el fitxer jQuery:

1. Definir els controladors d'esdeveniments com funcions i assignar cada controlador a una variable que posteriorment serà referenciada.

2. Aplicar el mètode bind i utilitzar la variable creada a 1. Al final el codi jQuery quedaria com segueix: 

//1. Definir el controlador de evento 
var functionControlador=function(event){ 
   if ($(this).css("color")=="#0000ff") 
      $(this).css("color", "#ffff00"); 
   else 
      $(this).css("color", "blue"); 
}; 
 
$(document).ready(function(){ 
//2. Utilizar bind para asignar eventos/controladores al element p 
 $("p").bind("click mouseenter mouseleave", functionControlador); 
});

UNBING Es pot utilitzar unbind per eliminar un esdeveniment prèviament assignat a un o diversos elements. Per eliminar tots els esdeveniments associats a un element 

$(“elemento”).unbind();

Per eliminar un esdeveniment associat a un element 

$(“elemento”).unbind(“evento”);

MÈTODES

text ()

Per saber el contingut d'un element l'objecte jQuery compta amb un mètode anomenat text (), que es pot utilitzar per

  • Modificar el contingut d'un element
$ ("#MiElemento").text("paràgraf Nou")
  • Obtenir el contingut d'un element
var contingut = $("#miElemento").text ()

Exemple

La següent funció jQuery canvia el text del paràgraf que està en primera posició quan es prem dobleclick en qualsevol paràgraf de la web, a més mostra el contingut anterior del paràgraf en una finestra. 

$ (document).ready(function () {
   $ ("p").dblclick(function () {
     var contingut = $("p:eq(1)").text ()
     alert (contingut);
     $ ("p:eq(1)").text("nou text");
   })
});

html ()

És possible afegir blocs de codi HTML a partir d'un element de la pàgina. aquesta propietat és bàsicament = innerHTML del DOM.

  • Per afegir un bloc HMTL
$ (element) .html (bloque_HTML)
  • Per obtenir el bloc HTML contingut a partir de l'element que fa referència l'objecte jQuery.
$ (element) .html ()

attr()/removeAttr

El método attr() permite agregar propiedades a un elemento HTML y recuperar el valor de su propiedad.

  • Recuperar el valor de la propietat 
$(elemento).attr(nombre_propiedad)
  • Dona valor a una propietat 
$(elemento).attr(nombre de propiedad,valor)
  • Eliminar una propietat 
$(elemento).removeAttr(nombre de propiedad)

Exemple 

$(document).ready(function(){ 
  $("p").click(function(){ 
    $("#miEnlace").attr("title","Pepe"); 
  }) 
});


addClass / removeClass

Els mètodes addClass i removeClass ens permeten associar i desassociar una classe a un element o conjunt d'elements HTML.

  • Afegir una classe CSS a un element.
$(element).addClass("nombre_clase")
  • Eliminar una classe CSS d'un element
$(element).removeClass("nombre_clase")
.azul{              //clase css
  color: #0000cc;
} 

//dins del script
$("#elBotonA").click(asociarClase);

function asociarClase()
{ 
 var x=$("h1"); 
 x.addClass("azul");
}

Fonaments

La potencia de Jquery radica en recuperar elements de les pàgines html i realitzar operacions amb ells d'una manera fàcil i ràpida. Si coneixes CSS, ets conscient del poder dels selectors que descriuen grups d'elements pel seu tipus, atributs o situació dins del document. Amb Jquery podem utilitzar aquest coneixement, i simplificar la manera d'utilitzar Javascript.

Selectors

Per exemple, el selector

  • p a

fa referència a tots els enllaços (elements <a>) que estan dintre d'un element <p>. Jquery utilitza els mateixos selectors CSS i a més a més, inclou alguns dels selectors més poderosos de CSS3. Amb Jquery, utilitzarem la següent sintaxi: $(selector) o jquery(selector)). Per exemple, per obtenir tots els enllaços que estan dintre d'un element <p> farem: 

$("p a");
//o bé:
jquery("p a");

Un altre exemple: Si volem ocultar tots els divs que pertanyen a la classe "ender": 

$("div.ender").hide();

Un altre exemple molt comú és canviar el text que hi ha en un element html. Amb Jquery es pot fer de dues maneres que donen resultats idèntics: 

// Primera Manera:
$("selector").html("Acabo d'afegir Text a un element");
// Segona Manera:
$("selector")[0].innerHTML = "Acabo d'afegir Text a un element";

Que passaria si el 'selector' retornes més d'un element? Doncs que si utilitzem la 1a manera, es posaria el text "Acabo d'afegir Text a un element" a tots els elements seleccionat. Molt útil quan volem canviar tot el HTML d'un grup d'elements. I amb la segona manera? Hauriem de fer: 

var elements = $("selector");
for(var i=0;i<elements.length;i++)
elements[i].innerHTML =
"Acabo d'afegir Text a un grup de nodes";

Aquest últim exemple és MOLT POC RECOMANAT. És molt més pràctic i eficient utilitzar la 1a manera a l'hora de programar amb JQuery.

Exemples de selectors:

Selector Explicació
$("p:even") Selecciona tots els paràgrafs parells
$("p:odd") Selecciona tots els paràgrafs senars
$("tr:nth-child(1)") Selecciona la primera fila de cada taula
$("body > div") Selecciona el/s fill/s directe/s <div> de <body>
$("a[href$= 'pdf ']") Selecciona els enllaços a fitxers pdf
$("body > div:has(a)") Selecciona el/s fill/s directe/s <div> de <body> que contenen enllaços

Assegurant-nos que la pàgina està a punt

Abans que podem interaccionar amb elements d'HTML en una pàgina, aquests han d'estar carregats: només els podem canviar una vegada que són ja allà. L'única manera fiable era esperar que es carregui la pàgina sencera abans que poguéssim executar qualsevol script. JQuery té un esdeveniment molt potent que ens permet executar el script tant aviat com sigui possible. Gràcies a això, les nostres aplicacions semblaran que es carreguen molt mes ràpid. Aquesta funció és: $(document).ready(....); 

$(document).ready(function() {
    alert('Benvinguts a la pàgina JQuery ...');
});

Aquesta funció s'utilitza tant que existeix una drecera: 

$(function() { alert('Benvinguts a la pàgina JQuery ...'); });

Utilitzant CSS

Després que hem seleccionat els elements som capaços d'afegir i treure estils, classes, i més. Exemple per obtenir un atribut css: 

$(document).ready(function() {
	var fontSize = $('#productes tbody tr:first').css('font-size');
	alert(fontSize);
});

Exemple per canviar un atribut css: 

$(document).ready(function() {
	$('#productes tbody tr:even').css('background-color','#dddddd');
});

Però i si es vol canviar o afegir dos o més atributs? 

$('#productes tbody tr:even').css('background-color','#dddddd');
$('#productes tbody tr:even').css('color', '#666666');

Podem simplificar lo anterior amb una sola crida : 

$('#productes tbody tr:even').css({
	'background-color': '#dddddd', 
	'color': '#666666',
	'font-size': '11pt',
	'line-height': '2.5em' 
});

Utilitzant Events (Event handler)

Si volem afegir esdeveniments als diferents elements que apareixen a la pàgina web utilitzant Jquery podem fer-ho molt fàcilment: 

$('#boton').click(function() {
	$('#missatge').show(); //es mostra el missatge
});

Però quan s'executa un element moltes vegades volem utilitzar l'element on està l'esdeveniment per tal de fer alguna cosa amb els seus valors. Jquery ens permet utilitzar la paraula reservada this. 

$('#Boton').click(function() {
	$(this).hide(); // el botó desapareix
});

$(this)proporciona una manera més maca d'accedir al botó en comptes de tornar a seleccionar-ho. Amb JQuery podem fer coses molt potents com el botó 'toggle': 

$('#toggleBoto').click(function() {
	$('#missatge').toggle();
	if ($('#missatge').is(':visible')) {
		$(this).val('Amaga');
	} else {
		$(this).val('Mostra');
	}
});

Afegir elements al DOM

Podem afegir elements al HTMl utilitzant JQUERY: 

$('<input type="button" value="toggle" id="toggleBoto">').insertAfter('#missatge');
$('#toggleBoto').click(function() {
	$('#missatge').toggle();
});

Altres funcions per afegir elements: 

$('<strong>Començar!</strong>').prependTo('#missatge');
$('<strong>Acabar!</strong>').appendTo('#missatge');

Fins i tot, podem esborrar elements: 

$('#missatge').remove();

Canviar el text d'un element

Si volem canviar el text d'un element tenim dos maneres: 

$('p').html('<strong>Alerta!</strong> hi ha etiquetes html... ');
$('h2').text('<strong>Alerta!</strong> hi ha etiquetes html ...');

La funció $(selector).html(...) interpretarà les etiquetes html que s'introdueixin dintre del text a mostrar. En canvi, si no volem que s'interpretin les etiquetes html utilitzarem la funció $(selector).text(...) Podem utilitzar aquestes funcions per obtenir el text en comptes de modificar-ho? Sí! 

alert($('h2:first').text());

Afegir efectes i animacions

Hi ha diverses funcions de jquery que tenen la habilitat de poder-se animar. Com l'efecte toggle de l'exemple anterior: 

$('#toggleBoto').click(function() {
	$('#missatge').toggle('slow');
});

Quan l'animació ha acabat podem programar que s'executi una funció automàticament (callback function): 

$('#missatge').slideToggle('slow', function() {
	alert('s'ha acabat l'animació!')
});

Però potser, el que volem és que desaparegui el botó: 

$('#missatge').slideUp('slow', function() {
	$('#toggleBoto').fadeOut();
});

Molt més

Com ja heu vist, amb JQuery podeu fer moltes coses de manera ràpida i fàcil. Us recomano aquests llibres : <p> Earle Castledine, Craig Sharkie, "jQuery: Novice to Ninja", Ed. Sitepoint, 2010, ISBN 978-0-9805768-5-6

Bear Bibeault, Yehuda Katz, "JQuery in Action Second Edition", Ed. Manning, 2010, ISBN 978-935182-32-0

Exercicis

Exercici Botons Celestials amb jQuery

Crea una pàgina web amb dos botons amb el text:

  • Text boto 1: 'Angelet'
  • Text boto 2: 'Diablet'

El comportament ha de ser el següent: Cada vegada que es clica sobre un botó 'Angelet' es creen n botons més, on n és un número aleatori entre 1 i 10 i aquests botons poden ser 'Angelets o Diablets'. Cada vegada que es clica sobre un botó 'Diablet' s'eliminen n botons, on n és un número aleatori entre 1 i 20.

Exercici Web Dinámica amb jQuery

a) Crea un HTML amb els següents camps: Input text1 : Que demani la etiqueta que es vol crear Input text2 : Que demani On es vol crear (una altre etiqueta que ja hauria d'existir) Boto crear: Crea el node del input text1 com a fill de input text2. b)Creació automática: Crea automàticament una Web via DOM que contingui: Tants paràgrafs com text trobis a la web http://www.lipsum.com/ Cada paràgraf ha de tenir un botó per tal de poder-lo eliminar.

Jquery i AJAX

jQuery soporta AJAX permetent abstraer les diferencies que poden existir entre els navegadors. Els mètodes que podem utilitzar son:

  • $.get()
  • $.getScript()
  • $.getJSON()
  • $.post()
  • $.load()

Però tots ells estan basats en el mètode:

  • $.ajax()

$.ajax()

El mètode $.ajax és configurat a través d'un objecte, el qual conté totes les instruccions que necessita jQuery per completar la petició. Aquest mètode és particularment útil a causa que ofereix la possibilitat d'especificar accions en cas que la petició hagi fallat o no. A més, en estar configurat a través d'un objecte, és possible definir les seves propietats de forma separada, fent que sigui més fàcil la reutilització del codi. Pot visitar http://api.jquery.com/jquery.ajax/ per consultar la documentació sobre les opcions disponibles en el mètode. Exemple: 

$.ajax({
        // la URL de la petició
        url : 'post.php',
    
        //informació a enviar
        // (també es posible utilitzar una cadena de dades)
        data : { id : 123 },
    
        // especificar si será una petició POST o GET
        type : 'GET',
    
        // el tipus d'informació que s'espera de resposta
        dataType : 'json',
    
        // codi a executar si la petició es satisfactoria;
        // la resposta es pasada com argument a la funció
        success : function(json) {
            $('<h1/>').text(json.title).appendTo('body');
            $('<div class="content"/>')
                .html(json.html).appendTo('body');
        },
    
        // codi a executar si la petició falla;
        // en pasen com arguments a la funció
        // l'objete jqXHR (extensió de XMLHttpRequest), un text amb l'estat
        // de la petició i un text amb la descripció del error que hagi donat el servidor
        error : function(jqXHR, status, error) {
            alert('hi ha un problema');
        },
    
        // codi a executar sense importar si la petició va fallar o no
        complete : function(jqXHR, status) {
            alert('Petición realizada');
        }
    });

El mètode $.ajax posseeix moltes opcions de configuració, i és justament aquesta característica la que fa que sigui un mètode molt útil. Per a una llista completa de les opcions disponibles, pot consultar http://api.jquery.com/jquery.ajax/; a continuació es mostren les més comunes:

Opcions Explicació
async Estableix si la petició serà asíncrona o no. De forma predeterminada el valor és true. Ha de tenir en compte que si l'opció s'estableix en false, la petició bloquejarà l'execució d'altres codis fins que aquesta petició hagi finalitzat.
cache Estableix si la petició serà guardada en la cache del navegador. De forma predeterminada és true para tots els dataType excepte para “script” i “jsonp”. Quan posseeix el valor false, s'agrega una cadena de caràcters anti-cache al final de la URL de la petició.
complete Estableix una funció de devolució de trucada que s'executa quan la petició aquesta completa, encara que hagi fallat o no. La funció rep com a arguments l'objecte jqXHR (en versions anteriors o iguals a jQuery 1.4, rep en el seu lloc l'objecte de la petició en cru XMLHTTPRequest) i un text especificant l'estatus de la mateixa petició (success, notmodified, error, timeout, abort, o parsererror).
context Estableix l'abast en què la/les funcionis de devolució de trucada s'executessin (per exemple, defineix el significat de this dins de les funcions). De manera predeterminada this fa referència a l'objecte originalment passat al mètode $.ajax.
data Estableix la informació que s'enviarà al servidor. Aquesta pot ser tant un objecte com una cadena de dades (per exemple foo=bar&baz=bim.)
dataType Estableix el tipus d'informació que s'espera rebre com a resposta del servidor. Si no s'especifica cap valor, de forma predeterminada, jQuery revisa el tipus MIME que posseeix la resposta.
error Estableix una funció de devolució de trucada (CALLBACK) a executar si resulta algun error en la petició. Aquesta funció rep com a arguments l'objecte jqXHR (en versions anteriors o iguals a jQuery 1.4, rep en el seu lloc l'objecte de la petició en cru XMLHTTPRequest), un text especificant l'estatus de la mateixa petició (timeout, error, abort, o parsererror) i un text amb la descripció de l'error que hagi enviat el servidor (per exemple Not Found o Internal Server Error).
jsonp Estableix el nom de la funció de devolució de trucada a enviar quan es realitza una petició JSONP.
succes Estableix una funció a executar si la petició a estat satisfactòria. Aquesta funció rep com a arguments l'objecte jqXHR (en versions anteriors o iguals a jQuery 1.4, rep en el seu lloc l'objecte de la petició en cru XMLHTTPRequest), un text especificant l'estatus de la mateixa petició i la informació de la petició (convertida a objecte Javascript en el cas que dataType sigui JSON), l'estatus de la mateixa.
timeout Estableix un temps en mil·lisegons per considerar a una petició com fallada
traditional Si el seu valor és true, s'utilitza l'estil de serialización de dades utilitzat abans de jQuery 1.4. Per a més detalls pot visitar http://api.jquery.com/jquery.param/.
type De forma predeterminada el seu valor és “GET”. Altres tipus de peticions també poden ser utilitzades (com PUT i DELETE), no obstant això poden no estar suportats per tots els navegadors.
url Estableix la URL on es realitza la petició. L'opció url és obligatòria per al mètode $.ajax;

Altres mètodes

Els mètodes que proveeix la biblioteca són:

  • $.get

Realitza una petició GET a una URL proveïda.

  • $.post

Realitza una petició POST a una URL proveïda.

  • $.getScript

Afegeix un script a la pàgina.

  • $.getJSON

Realitza una petició GET a una URL proveïda i espera que una dada JSON sigui retornat.

Els mètodes han de tenir els següents arguments, en ordre:

  • url

La URL on es realitzarà la petició. El seu valor és obligatori.

  • data

La informació que s'enviarà al servidor. El seu valor és opcional i pot ser tant un objecte com una cadena de dades (com foo=bar&baz=bim).

Nota: Aquesta opció no és correcte per al mètode $.getScript.

  • success callback

Una funció opcional que s'executa en cas que petició hagi estat satisfactòria. Aquesta funció rep com a arguments la informació de la petició i l'objecte en brut d'aquesta petició.

  • data type

El tipus de dada que s'espera rebre des del servidor. El seu valor és opcional.

Nota

Aquesta opció és solament aplicable per a mètodes en què no està especificat el tipus de dada en el nom del mateix mètode. Exemples: 

$.get('/users.php', { userId : 1234 }, function(resp) {
        console.log(resp);
    });
    
$.getScript('/static/js/myScript.js', function() {
        functionFromMyScript();
});
    
$.getJSON('/details.php', function(resp) {
        $.each(resp, function(k, v) {
        console.log(k + ' : ' + v);
        });
});

$.load()

El mètode $(selector).load() és l'únic que es pot cridar des d'una selecció. Aquest mètode obté el codi HTML d'una URL i als elements seleccionats els modifica amb la informació obtinguda. 

$('#newContent').load('/foo.html');
$('#newContent').load('/foo.html #myDiv h1:first', function(html) {
      alert('Contenido actualizado');
    });

Events AJAX

Sovint, voldrà executar una funció quan una petició hagi començat o acabat, com per exemple, mostrar o ocultar un indicador. En lloc de definir aquestes funcions dins de cada petició, jQuery proveeix la possibilitat de vincular esdeveniments Ajax a elements seleccionats. Per a una llista completa d'esdeveniments Ajax, pot consultar http://docs.jquery.com/ajax_events. 

$(document)
        .ajaxStart(function() { $('#loading_indicator').show(); })
        .ajaxStop(function() { $('#loading_indicator').hide(); });

Podeu obtenir imatges per mostrar com a indicadors a: http://www.ajaxload.info/

Exercicis

Chat

Es vol crear un chat amb JQuery. El contingut del chat es guardarà en un fitxer al servidor php. Aquest fitxer es modificarà cada vegada que algú enviï informació. Els clients (navegadors) indicaran l'última línia del fitxer que han rebut per tal d'actualitzar els seus missatges

Podeu trobar al moodle la solució d'aquest exercici

Pilota

  • a) Es vol moure una pilota per la pantalla. Aquesta pilota es mou en tots els navegadors alhora. Per fer-ho, el servidor php té la posició de la pilota a la pantalla i els navegadors, mitjançant jquery, la mostren.
  • b) La pilota no ha de parar de moure's, però la seva direcció la decideix el client mitjançant les tecles (up, down, left, rigth).

Podeu trobar al moodle la solució d'aquest exercici

Obtingut de «http://wikiserver.infomerce.es/index.php?title=NF3_-_JQUERY&oldid=3883»