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
jquery cheat sheet
jquery selectors
jquery ajax syntax
jquery event methods
jquery dom manipulation
jquery effects and animation
jquery traversing methods
jquery reference
Precisa de ajuda?
Encontrou um problema com esta ferramenta? Avise a nossa equipa.