jQuery jQuery.param(obj)

Slyweb

Поиск функций jQuery

Характеристика функции

[Функция] jQuery.param(obj)

Раздел "Forms"

Метод объединяет значения массива или объекта в пригодное для использования в URL значение при отправке данных через Ajax.

Параметры

jQuery.param(obj)

1.2

obj: массив или jQuery объект, занчения котрого будут объединены

jQuery.param(obj,traditional)

1.4

obj: массив или объект для объединения его значений

traditional: булев индикатор, определяющий способ объединения

Описание

Данный метод используется внутренне для конвертации значения элемента в объединённое строковое представление. (подробнее об этом смотрите в описании метода .serialize())

Начиная с jQuery 1.4 метод $.param() рекурсивно добирается до объектов, снабжая их дополнительными метками в соответствие с популярными языками "PHP" и "Ruby on Rails". Для отключения такой функциональности установите: jQuery.ajaxSettings.traditional = true;.

Примечание: так как некоторые фоеймовивки имеют ограничения по количеству объектом массива при разборе, мы должны соблюдать осторожность при передаче аргумента содержащего массив или объект вложенные в другой массив. В jQuery 1.4 поддерживается сериализация элементов input в соответствие со стандартом HTML.

Возможно, Вам будет интересно прочитать статьи о jQuery:

Примеры

Пример:

Мы можем отобразить строковое представление объекта и его раздекодированное значение с помощью метода decodeURIComponent. Занчения перменных recursiveEncoded и recursiveDecoded отобразятся следующим образом:

a%5Bone%5D=1&a%5Btwo%5D=2&a%5Bthree%5D=3&b%5B%5D=1&b%5B%5D=2&b%5B%5D=3

a[one]=1&a[two]=2&a[three]=3&b[]=1&b[]=2&amp;b[]=3

Пример
Весь код

"jQuery"

var myObject = {
  a: {
    one: 1, 
    two: 2, 
    three: 3
  }, 
  b: [1,2,3]
};
var recursiveEncoded = jQuery.param(myObject);
var recursiveDecoded = decodeURIComponent(jQuery.param(myObject));

$('#results1').text(recursiveEncoded);
$('#results2').text(recursiveDecoded);

"HTML"

<div id="results1"></div>
<div id="results2"></div>

"CSS"

div { color:blue; }

"Живой пример jQuery"

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
                    "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<link href="http://slyweb.ru/css/jqueryiframe.css" 
rel="stylesheet" type="text/css"/>
  <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.5.0/jquery.min.js"></script>
<script>
  $(document).ready(function(){

var myObject = {
  a: {
    one: 1, 
    two: 2, 
    three: 3
  }, 
  b: [1,2,3]
};
var recursiveEncoded = jQuery.param(myObject);
var recursiveDecoded = decodeURIComponent(jQuery.param(myObject));

$('#results1').text(recursiveEncoded);
$('#results2').text(recursiveDecoded);

  });
</script>

</head>
<body class="iframe">


<div id="results1"></div>
<div id="results2"></div>


</body>
</html>


<style>

div { color:blue; }

</style>

Пример:

Мы можем отобразить строковое представление объекта и его раздекодированное значение с помощью метода decodeURIComponent. значения переменных recursiveEncoded и recursiveDecoded отобразятся следующим образом:

a=%5Bobject+Object%5D&b=1&b=2&b=3

a=[object+Object]&b=1&b=2&b=3

Пример
Весь код

"jQuery"

var myObject = {
  a: {
    one: 1, 
    two: 2, 
    three: 3
  }, 
  b: [1,2,3]
};
var shallowEncoded = jQuery.param(myObject, true);
var shallowDecoded = decodeURIComponent(shallowEncoded);

$('#results1').text(shallowEncoded);
$('#results2').text(shallowDecoded);

"HTML"

<div id="results1"></div>
<div id="results2"></div>

"CSS"

div { color:red; }

"Живой пример jQuery"

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
                    "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<link href="http://slyweb.ru/css/jqueryiframe.css" 
rel="stylesheet" type="text/css"/>
  <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.5.0/jquery.min.js"></script>
<script>
  $(document).ready(function(){

var myObject = {
  a: {
    one: 1, 
    two: 2, 
    three: 3
  }, 
  b: [1,2,3]
};
var shallowEncoded = jQuery.param(myObject, true);
var shallowDecoded = decodeURIComponent(shallowEncoded);

$('#results1').text(shallowEncoded);
$('#results2').text(shallowDecoded);

  });
</script>

</head>
<body class="iframe">


<div id="results1"></div>
<div id="results2"></div>


</body>
</html>


<style>

div { color:red; }

</style>

Пример:

Приоритетным поведением метода $.param() для Jquery 1.4 является установка аргумента traditional как true.

Пример
Весь код

"jQuery"

var myObject = {
  a: {
    one: 1, 
    two: 2, 
    three: 3
  }, 
  b: [1,2,3]
};
var shallowEncoded = jQuery.param(myObject, true);
var shallowDecoded = decodeURIComponent(shallowEncoded);

$('#results1').text(shallowEncoded);
$('#results2').text(shallowDecoded);

"HTML"

<div id="results1"></div>
<div id="results2"></div>

"CSS"

div { color:red; }

"Живой пример jQuery"

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
                    "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<link href="http://slyweb.ru/css/jqueryiframe.css" 
rel="stylesheet" type="text/css"/>
  <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.5.0/jquery.min.js"></script>
<script>
  $(document).ready(function(){

var myObject = {
  a: {
    one: 1, 
    two: 2, 
    three: 3
  }, 
  b: [1,2,3]
};
var shallowEncoded = jQuery.param(myObject, true);
var shallowDecoded = decodeURIComponent(shallowEncoded);

$('#results1').text(shallowEncoded);
$('#results2').text(shallowDecoded);

  });
</script>

</head>
<body class="iframe">


<div id="results1"></div>
<div id="results2"></div>


</body>
</html>


<style>

div { color:red; }

</style>

Метод появился в jQuery 1.2

Официальная страница метода - http://api.jquery.com/jQuery.param/

Форма для комментариев

Версия jQuery 1.4.2 Документ создан 2010-08-21

Ошибки и опечатки
Предложения и жалобы
Поддержка сайта

Александр Ермаков. Хостинг - www.pwstudio.org

Руководство jQuery 1.4.2

Плагины jQuery UI

Эффекты

Возможно, Вам будет интересно прочитать статьи о jQuery: