0.5.1 • Published 9 years ago

wiloquery v0.5.1

Weekly downloads
29
License
Licence Public Ri...
Repository
-
Last release
9 years ago

Wiloquery (obsolète)

Status NPM Module SemVer License

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.

ChromeFirefoxInternet ExplorerOperaSafari
54910.55
0.5.1

9 years ago

0.5.0

9 years ago

0.4.2

10 years ago

0.4.1

10 years ago

0.4.0

10 years ago

0.3.2

10 years ago

0.3.1

10 years ago