Cookie の読み取り、書き込み、削除ができる軽量の Cookie プラグイン。
jquery.cookie.js の構成
最初に jQuery ライブラリ ファイルが含まれ、その後に jquery.cookie.js ライブラリ ファイルが含まれます。
使用法
1. 新しいセッション Cookie を追加します:
$.cookie('the_cookie', 'the_value');
注: Cookie の有効期間が指定されていない場合、作成された Cookie はデフォルトでユーザーがブラウザを閉じるまで有効であるため、
「セッション Cookie」。
2. Cookie を作成し、有効期間を 7 日に設定します。
$.cookie('the_cookie', 'the_value', {expires: 7 }); > 注: Cookie の有効期間が指定されている場合、作成される Cookie は「永続 Cookie」と呼ばれます。
3. Cookie を作成し、Cookie の有効なパスを設定します:
$.cookie('the_cookie', 'the_value', {expires: 7, path: '/' }) ;
注: デフォルトでは、Cookie を設定する Web ページのみが Cookie を読み取ることができます。別のページによって設定された Cookie をページで読み取れるようにする場合は、Cookie のパスを設定する必要があります。 Cookie へのパスは、Cookie を読み取ることができる最上位ディレクトリを設定するために使用されます。この
パスを Web サイトのルート ディレクトリとして設定すると、すべての Web ページが相互に Cookie を読み取れるようになります (競合を防ぐために、通常はこれを設定しません)。
4. Cookie を読み取ります:
$.cookie('the_cookie'); // Cookie が存在します => 'the_value'
$.cookie('not_existing') ; // Cookie が存在しません => null
5. Cookie 値として null を渡して Cookie を削除します:
$.cookie('the_cookie', null); >----------関連パラメータの説明-------
1).expires: 365
を定義します。 Cookie の有効期間。値は数値 (Cookie が作成されてからの日数) または Date オブジェクト
です。省略した場合、作成される Cookie はセッション Cookie となり、ユーザーがブラウザを終了すると削除されます。
2).path: '/'
デフォルト: Cookie を設定する Web ページのみが Cookie を読み取ることができます。
Cookie の有効なパスを定義します。デフォルトでは、このパラメータの値は Cookie を作成した Web ページへのパスです (ブラウザの標準動作)。
Web サイト全体でこの Cookie にアクセスしたい場合は、パス: '/' のように有効なパスを設定する必要があります。有効なパス
を定義する Cookie を削除したい場合は、関数を呼び出すときにこのパスを含める必要があります: $.cookie('the_cookie', null,
{ path: ' /' });。ドメイン: 'example.com'
デフォルト値: Cookie を作成した Web ページが所有するドメイン名。
3).secure: true
デフォルト値: false。 true の場合、Cookie の送信には安全なプロトコル (HTTPS) の使用が必要です。
4).raw: true
デフォルト値: false。
デフォルトでは、Cookie の読み取りおよび書き込み時にエンコードとデコードが自動的に実行されます (エンコードには encodeURIComponent を使用し、デコードには
decodeURIComponent を使用します)。この機能をオフにするには、raw: true を設定します。