wiloquery v0.5.1
Wiloquery (obsolète)
Bibliothèque JavaScript fournissant un objet JSON pour les paramètres de l'URL.
Obsolète
Cette bibliothèque est obsolète. Veuillez utiliser URLSearchParams :
// Récupérer la page du site demandée (www.example.org?p=news). Et par
// défaut : aller sur la page d'accueil.
var params = new URLSearchParams(window.location.search.slice(1));
var page = params.has("p") ? params.get("p")
: "home";
Description
La bibliothèque JavaScript Wiloquery fourni une variable contenant une
représentation
JSON de la
variable window.location.search
. Pour chaque paramètre de l'URL, une
propriété est ajoutée dans l'objet JSON. Si un paramètre est présent plusieurs
fois dans l'URL : les valeurs sont regroupées dans un tableau. Pour les
paramètres n'ayant pas de valeur : null
est stocké dans l'objet.
Par exemple pour l'URL http://www.example.org/?a=x&b=y&b=z&c=&d&&
, la
variable contiendra :
{
"a": "x",
"b": ["y", "z"],
"c": "",
"d": null
}
Téléchargement
Vous pouvez récupérer le script avec npm :
npm install wiloquery
Utilisation
AMD
Pour l'utilisation de la bibliothèque avec un chargeur AMD (par exemple RequireJS) :
require(["wiloquery"], function (wiloquery) {
// ...
var foo = wiloquery.foo;
});
// Ou :
define(["wiloquery"], function (wiloquery) {
// ...
var foo = wiloquery.foo;
});
CommonJS
Si vous souhaitez utiliser la bibliothèque avec le protocole CommonJS, voici un exemple :
var wiloquery = require("wiloquery");
// ...
var foo = wiloquery.foo;
Variable global
Il suffit de télécharger le script et de l'inclure dans la page HTML. La
variable sera stockée dans la propriété query
de l'objet window.location
.
<!DOCTYPE html>
<html>
<head>
<!-- ... -->
<script src="wiloquery.js"></script>
<!-- ... -->
<script>
var foo = window.location.query.foo;
</script>
</head>
<body>
<!-- ... -->
</body>
</html>
Exemples
// Récupérer la page du site demandée (www.example.org?p=news). Et par
// défaut : aller sur la page d'accueil.
var page = "p" in window.location.query ? window.location.query.p
: "home";
Compatibilité
Voici les versions minimales nécessaires pour utiliser la bibliothèque avec les principaux navigateurs.
Chrome | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|
5 | 4 | 9 | 10.5 | 5 |