1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
<?xml version="1.0" encoding="UTF-8" ?>
<dt-api group="utility">
<name>pluck()</name>
<summary>Create a new API instance with the value of a property from the objects in the current result set.</summary>
<since>1.10</since>
<type type="function">
<signature>pluck( property )</signature>
<description>Iterate over the result set of an API instance, creating a new API instance from the values retrieved from the original elements.</description>
<parameter type="string|integer" name="property">
Object property name to use from the element in the original result set for the new result set. This will typically be a string with the target property name, but can also be an array index if working with arrays.
</parameter>
<returns type="DataTables.Api">New API instance with the values in the result retrieved from the source object properties defined by the property being plucked.</returns>
</type>
<description>
When working with objects you may often find that you want an array containing just one property of the source object. This typically involves writing a trivial loop to create that array, although here, that loop is performed in this method, reducing the amount of code required to a trivial function call to get the data required.
This method makes use of the fact that DataTables API objects are "array like", in that they inherent a lot of the abilities and methods of the Javascript `Array` type.
</description>
<example title="Pluck the name property from the data objects for the table rows"><![CDATA[
var table = $('#example').DataTable(
"data": [
{
"name": "Tiger Nixon",
"position": "System Architect",
"salary": "$3,120",
"start_date": "2011/04/25",
"office": "Edinburgh",
"extn": "5421"
},
{
"name": "Garrett Winters",
"position": "Director",
"salary": "$5,300",
"start_date": "2011/07/25",
"office": "Edinburgh",
"extn": "8422"
},
{
"name": "Ashton Cox",
"position": "Technical Author",
"salary": "$4,800",
"start_date": "2009/01/12",
"office": "San Francisco",
"extn": "1562"
}
],
"columns": [
{ "data": "name" },
{ "data": "position" },
{ "data": "office" },
{ "data": "extn" },
{ "data": "start_date" },
{ "data": "salary" }
]
);
var names = table
.rows()
.data()
.pluck( 'name' );
]]></example>
<example title="Nested data - get the `salary` data property by using `pluck()` twice."><![CDATA[
var table = $('#example').DataTable({
"data": [
{
"name": "Tiger Nixon",
"hr": {
"position": "System Architect",
"salary": "$320,800",
"start_date": "2011/04/25"
}
},
{
"name": "Garrett Winters",
"hr": {
"position": "Accountant",
"salary": "$170,750",
"start_date": "2011/07/25"
}
},
{
"name": "Ashton Cox",
"hr": {
"position": "Junior Technical Author",
"salary": "$86,000",
"start_date": "2009/01/12"
}
}
],
"columns": [
{ "data": "name" },
{ "data": "hr.position" }
]
);
var salaries = table
.rows()
.data()
.pluck( 'hr' )
.pluck( 'salary' );
]]></example>
</dt-api>
|
