Este código foi criado para facilitar pegar valores de query strings usando o jQuery. Ele pode retornar o valor de uma query string, uma coleção de query strings, a quantidade, selecionar a query string pelo índice e não diferenciar maiúsculas e minúsculas.

Instalação

  1. Faça o download dos arquivos
  2. Se ainda não tiver a referência do jQuery no seu HTML inclua como no exemplo abaixo
  3. Escolha um dos arquivos do jQuery QueryString para ser referido no seu HTML. A primeira opção pode ser a mais adequada se você não deseja modificar o código.
// Se você ainda não tem o arquivo do jQuery informado no seu
// HTML, insira o código abaixo
<script type="text/javascript" src="javascript/jquery-1.4.2.min.js"></script>
 
// Insira o código a seguir após o código do jQuery se você
// deseja a versão compacta de $.QueryString ou...
<script type="text/javascript" src="source/querystring-0.9.0-min.js"></script>
 
// ... insira o código abaixo se preferir a versão para
// desenvolvedores
<script type="text/javascript" src="source/querystring-0.9.0.js"></script>

Como Usar

Se não informado, $.QueryString irá procurar a query string da barra de endereço do browser. Para informar uma URL diferente, verifique os parâmetros de options.

// Retorna null se não existe nenhuma query string 
$.QueryString();
  
// Retorna o total de query strings
$.QueryString().size;
  
// Retorna null se a query string solicitada não existir
// ou o valor daquery string se existir
$.QueryString( //string );
  
// Informa o total de query strings de mesmo nome
$.QueryString( //string ).length;
  
// Retorna o valor de uma query string de uma URL informada, escolhe
// o índicee diferencia ou não maiúsculas e minúsculas
$.QueryString( //string, { // options
    href : // URL string,
    index : // number,
    isCaseSensitive : boolean
});
  
// Pega o valor de uma query string como um objeto
$.QueryString().objectName;

Os parâmetros de options e seus valores aceitos são:

href (string)(opcional) URL com ou sem query strings onde as query strings serão procuradas. Padrão: window.location

index (number)(opcional) Retorna o valor de uma query string em uma coleção de query strings de mesmo nome. Padrão: null

isCaseSensitive (boolean)(opcional) Decide se a query string procurada deve ter as letras maiúsculas e minúsculas deferenciadas. Padrão: true

Exemplos

Visite www.darlesson.com/jquery/querystring/.

Suporte

Este código é gratuito sob as licensas MIT e GPL. Mas se você acha que ele foi de grande ajuda economizando o seu tempo, por favor me dê suporte financeiramente através de uma doação ou adicione o link do meu site (http://darlesson.com/) no seu pra que possa continuar compartilhando, criando e melhorando meus códigos.

Para informar bugs, por favor envie comentários ou sugestões pela minha página de contato.

Original em inglês no endereço http://www.darlesson.com/jquery/querystring/