W3Cookies por: Leandro Vieira.

[KaKarotto]

Pessoal, queria compartilhar com vocês um código muito útil escrito pelo Leandro Vieira para manipular as chaves dos cookies facilmente, já que vi muita gente batendo cabeça na hora de manipulá-los.

O código é esse:

/**
 * w3cookies (0.1) - 23/12/2006
 * Leandro Vieira Pinho
 * Localize-me. Blog: [ http://leandro.w3invent.com.br ], E-mail leandro[at]w3invent[dot]com[dot]br
 */
var w3cookies = {
    date: new Date(),
    // Cria o(s) cookie(s)
    // Forma de uso: w3cookies.create('nome_do_cookie','valor',dias_para_expirar);
    create: function(strName, strValue, intDays) {
        if ( intDays ) {
            this.date.setTime(this.date.getTime()+(intDays*24*60*60*1000));
            var expires = "; expires=" + this.date.toGMTString();
        } else {
            var expires = "";
        }
        document.cookie = strName + "=" + strValue + expires + "; path=/";
    },
    // Ler as informações de um cookie em específico
    // Forma de uso: w3cookies.read('nome_do_cookie');
    read: function(strName) {
        var strNameIgual = strName + "=";
        var arrCookies = document.cookie.split(";");
        for ( var i = 0, strCookie; strCookie = arrCookies[i]; i++ ) {
            while ( strCookie.charAt(0) == " ") {
                strCookie = strCookie.substring(1,strCookie.length);
            }
            if ( strCookie.indexOf(strNameIgual) == 0 ) {
                return strCookie.substring(strNameIgual.length,strCookie.length);
            }
        }
        return null;
    },
    // Delete um cookie desejado
    // Forma de uso: w3cookies.erase('nome_do_cookie');
    erase: function(strName) {
        this.create(strName,"",-1);
    }
}

Você pode salvar em um arquivo externo para melhor organização. O código está bem comentado e de fácil entendimento, porém eu vou explicar o que cada um dos métodos faz para facilitar. w3cookies.create Cria a chave, o valor dela e o tempo para expirar o cookie. Forma de uso:

w3cookies.create(
    'nome_do_cookie',
    'valor',
    dias_para_expirar
)

w3cookies.read Lê o valor da chave. Forma de uso:

w3cookies.read('nome_do_cookie')

w3cookies.erase Deleta a chave. Forma de uso:

w3cookies.erase('nome_do_cookie')

Legal né? ^_^

Ele é bem simples, como todo o código bem feito deve ser, então existem mais operações que podem ser usadas além dessas 3 básicas.

Caso alguém se interesse em implementar mais funções seria muito interessante para todos nós. Gostaria então que usassem os posts de resposta para discutir sobre possíveis "plugins" para o w3cookies do Leandro.

Propostas:

- Ler todos os valores das chaves no cookie

- Adicionar valores em uma chave existente separando-os por vírgulas, ex:

chave1=nome1, nome2, nome3, nome4;

- remover valores (separados por vírgula) em uma chave existente.

Abraço