Folha de referência jQuery
Uma referência jQuery pesquisável e imprimível: seletores, manipulação do DOM, eventos, efeitos, travessia, AJAX e auxiliares de formulários. Grátis.
Selectors
14$('#id')
Select an element by its id
$('.class')
Select all elements with a class
$('div')
Select all elements of a tag name
$('*')
Select every element in the page
$('[name="email"]')
Select by an attribute value
$('a[href^="https"]')
Attribute starts-with selector
$('ul li:first')
First matched element
$('ul li:last')
Last matched element
$('tr:eq(2)')
Element at a zero-based index
$('li:not(.done)')
Exclude elements matching a selector
$(':checked')
All checked checkboxes/radios
$('div:visible')
Only currently visible elements
$('ul li')
Descendant combinator
$('ul > li')
Direct child combinator
Document ready & DOM
10$(function () { /* ... */ });
Run code once the DOM is ready
$(document).ready(fn)
Explicit document-ready handler
$(window).on('load', fn)
Run after all assets have loaded
$(this)
Wrap the current context element
$(el)
Wrap a raw DOM node in jQuery
$('<div class="box"></div>')
Create a new element from HTML
$('#box')[0]
Get the underlying DOM node
$('#box').get(0)
Get the DOM node via .get()
$('.item').length
Count the matched elements
$('#box').is(':visible')
Test a selector against the set
DOM manipulation
12$('#box').html('<b>Hi</b>')
Set the inner HTML
$('#box').text('Hello')
Set the text content (escaped)
$('#name').val('Ada')
Set a form field value
$('#list').append('<li>x</li>')
Insert content at the end
$('#list').prepend('<li>x</li>')
Insert content at the start
$('#box').before('<hr>')
Insert content before the element
$('#box').after('<hr>')
Insert content after the element
$('#box').remove()
Remove the element from the DOM
$('#box').empty()
Remove all child nodes
$('#box').clone()
Create a copy of the element
$('#box').wrap('<div>')
Wrap the element in new HTML
$('#box').replaceWith('<p>')
Replace the element entirely
Attributes & CSS
13$('#img').attr('src')
Get an attribute value
$('#img').attr('alt', 'Logo')
Set an attribute value
$('#cb').prop('checked')
Get a DOM property (checked/disabled)
$('#cb').prop('checked', true)
Set a DOM property
$('#img').removeAttr('title')
Remove an attribute
$('.box').addClass('active')
Add a CSS class
$('.box').removeClass('active')
Remove a CSS class
$('.box').toggleClass('open')
Toggle a CSS class on/off
$('.box').hasClass('active')
Test if a class is present
$('#box').css('color', 'red')
Set a single CSS property
$('#box').css({top: 0, left: 0})
Set multiple CSS properties
$('#box').width()
Get the computed width in pixels
$('#box').height()
Get the computed height in pixels
Events
12$('#btn').on('click', fn)
Attach an event handler
$('#btn').off('click')
Detach event handlers
$('#btn').click(fn)
Shorthand click handler
$('#form').submit(fn)
Handle form submission
$('#sel').change(fn)
Handle value changes
$('#in').keyup(fn)
Handle key-up in a field
$('#list').on('click', '.item', fn)
Delegated event for dynamic children
$('#btn').trigger('click')
Programmatically fire an event
$('#btn').one('click', fn)
Run a handler at most once
e.preventDefault()
Stop the default browser action
e.stopPropagation()
Stop the event from bubbling
e.target
The element that triggered the event
Effects & animation
12$('#box').show()
Display a hidden element
$('#box').hide()
Hide an element
$('#box').toggle()
Toggle visibility
$('#box').fadeIn(300)
Fade an element in
$('#box').fadeOut(300)
Fade an element out
$('#box').fadeTo(300, 0.5)
Fade to a given opacity
$('#box').slideUp()
Slide an element up (collapse)
$('#box').slideDown()
Slide an element down (expand)
$('#box').slideToggle()
Toggle a slide animation
$('#box').animate({left: 100})
Animate CSS properties
$('#box').stop()
Stop the current animation
$('#box').delay(500).fadeIn()
Delay the next queued effect
Traversing
12$('#box').find('.item')
Find descendants matching a selector
$('#box').parent()
Get the direct parent
$('#box').parents('.row')
Get all ancestors matching a selector
$('#box').closest('.row')
Nearest matching ancestor (or self)
$('#box').children()
Get the direct children
$('#box').siblings()
Get sibling elements
$('#box').next()
Get the next sibling
$('#box').prev()
Get the previous sibling
$('.item').each(fn)
Iterate over each matched element
$('.item').filter('.on')
Reduce the set by a selector
$('.item').first()
Reduce the set to the first element
$('.item').eq(1)
Reduce the set to one index
AJAX
11$.ajax({url: '/api', method: 'GET'})
Full-control AJAX request
$.get('/api', fn)
Shorthand HTTP GET request
$.post('/api', data, fn)
Shorthand HTTP POST request
$.getJSON('/api.json', fn)
GET request expecting JSON
$('#box').load('/part.html')
Load HTML into an element
$.ajax({dataType: 'json'})
Set the expected response type
$.ajax({data: {q: 'x'}})
Send request parameters
.done(function (res) {})
Run a callback on success
.fail(function (err) {})
Run a callback on failure
.always(function () {})
Run a callback after completion
$.ajaxSetup({headers: {}})
Set defaults for all requests
Forms
10$('#form').serialize()
Encode form data as a query string
$('#form').serializeArray()
Encode form data as an array
$('#name').val()
Read a field value
$('#name').val('Ada')
Write a field value
$(':input')
Select all form input elements
$('#cb').is(':checked')
Test if a checkbox is checked
$('#sel option:selected')
Get the selected option
$('#in').focus()
Move focus to a field
$('#form').on('submit', fn)
Handle the form submit event
$('#in').prop('disabled', true)
Disable a form control
Utilities
11$.each(arr, fn)
Iterate over an array or object
$.map(arr, fn)
Build a new array from each item
$.grep(arr, fn)
Filter an array by a predicate
$.extend({}, a, b)
Merge objects into a target
$.trim(' hi ')
Trim leading/trailing whitespace
$.inArray(2, arr)
Find an item index in an array
$.isArray(x)
Test whether a value is an array
$.isFunction(x)
Test whether a value is a function
$.parseJSON(str)
Parse a JSON string into an object
$.now()
Current timestamp in milliseconds
$.type(x)
Get the internal type of a value
Nenhuma entrada corresponde a “:q”.
Sobre Folha de referência jQuery
Este guia de referência de jQuery é uma referência compacta para a biblioteca que ainda alimenta boa parte dos sites existentes: seletores, document ready e fundamentos do DOM, manipulação do DOM, atributos e CSS, eventos, efeitos e animação, travessia, AJAX, formulários, e utilitários.
Se você mantém front-ends legados, plugins ou temas de CMS mais antigos, a fluência em jQuery ainda é uma habilidade prática. Cada linha combina uma chamada de método com uma descrição de uma frase, para que você lembre a assinatura exata para delegação de eventos, travessia encadeada ou uma requisição AJAX sem vasculhar documentação antiga.
A folha é gratuita e totalmente executada no navegador. Filtre métodos em tempo real com a caixa de busca, salte entre seções pelo sumário fixo, copie qualquer trecho com um clique e imprima a página quando estiver mergulhado em uma refatoração legada.
Como usar Folha de referência jQuery
- Percorra as seções, de Seletores e Document ready e DOM até Travessia e AJAX e Utilitários.
- Busque por um método como on, closest ou ajax para filtrar a folha em tempo real.
- Salte para uma seção como Efeitos e animação pela barra lateral fixa.
- Clique em um trecho ou no ícone de copiar para copiar a chamada jQuery para o seu código.
- Imprima a folha para referência offline enquanto trabalha em projetos legados.
Perguntas frequentes
Dez seções: seletores, document ready e fundamentos do DOM, manipulação do DOM, atributos e CSS, eventos, efeitos e animação, travessia, AJAX, formulários, e utilitários.
Para novos projetos a maioria das equipes usa JavaScript puro, mas uma quantidade enorme de código em produção, plugins e temas de CMS ainda roda jQuery: esta folha é voltada para manter e migrar esse código com confiança.
Sim. A seção de eventos inclui a forma delegada de .on() junto com bind, unbind e trigger: o padrão mais necessário ao trabalhar com elementos inseridos dinamicamente.
Sim. Clique em qualquer trecho, ou no ícone de copiar na sua linha, e a chamada é copiada para sua área de transferência pronta para colar.
Sim, totalmente gratuita: pesquisável, imprimível e renderizada no navegador sem cadastro.
Pesquisas populares
cheat sheet jquery
seletores jquery
sintaxe ajax jquery
métodos de evento jquery
manipulação do dom jquery
efeitos e animação jquery
métodos de travessia jquery
referência jquery
Precisa de ajuda?
Encontrou um problema com esta ferramenta? Avise a nossa equipa.