| 9 |
lars |
1 |
<!DOCTYPE html>
|
|
|
2 |
<html>
|
|
|
3 |
<head>
|
|
|
4 |
<meta charset="utf-8">
|
|
|
5 |
<link rel="shortcut icon" type="image/ico" href="http://www.datatables.net/favicon.ico">
|
|
|
6 |
<meta name="viewport" content="initial-scale=1.0, maximum-scale=2.0">
|
|
|
7 |
|
|
|
8 |
<title>DataTables example - Automatic addition of row ID attributes</title>
|
|
|
9 |
<link rel="stylesheet" type="text/css" href="../../media/css/jquery.dataTables.css">
|
|
|
10 |
<link rel="stylesheet" type="text/css" href="../resources/syntax/shCore.css">
|
|
|
11 |
<link rel="stylesheet" type="text/css" href="../resources/demo.css">
|
|
|
12 |
<style type="text/css" class="init">
|
|
|
13 |
|
|
|
14 |
</style>
|
|
|
15 |
<script type="text/javascript" language="javascript" src="//code.jquery.com/jquery-1.11.3.min.js"></script>
|
|
|
16 |
<script type="text/javascript" language="javascript" src="../../media/js/jquery.dataTables.js"></script>
|
|
|
17 |
<script type="text/javascript" language="javascript" src="../resources/syntax/shCore.js"></script>
|
|
|
18 |
<script type="text/javascript" language="javascript" src="../resources/demo.js"></script>
|
|
|
19 |
<script type="text/javascript" language="javascript" class="init">
|
|
|
20 |
|
|
|
21 |
$(document).ready(function() {
|
|
|
22 |
$('#example').DataTable( {
|
|
|
23 |
"processing": true,
|
|
|
24 |
"serverSide": true,
|
|
|
25 |
"ajax": "scripts/ids-objects.php",
|
|
|
26 |
"columns": [
|
|
|
27 |
{ "data": "first_name" },
|
|
|
28 |
{ "data": "last_name" },
|
|
|
29 |
{ "data": "position" },
|
|
|
30 |
{ "data": "office" },
|
|
|
31 |
{ "data": "start_date" },
|
|
|
32 |
{ "data": "salary" }
|
|
|
33 |
]
|
|
|
34 |
} );
|
|
|
35 |
} );
|
|
|
36 |
|
|
|
37 |
</script>
|
|
|
38 |
</head>
|
|
|
39 |
|
|
|
40 |
<body class="dt-example">
|
|
|
41 |
<div class="container">
|
|
|
42 |
<section>
|
|
|
43 |
<h1>DataTables example <span>Automatic addition of row ID attributes</span></h1>
|
|
|
44 |
|
|
|
45 |
<div class="info">
|
|
|
46 |
<p>Often when using server-side processing you will find that it can be useful to have a specific ID on each row (the primary key value from the database for
|
|
|
47 |
example). By assigning the ID you want to apply to each row using the property <code>DT_RowId</code> of the data source object for each row (this property name can
|
|
|
48 |
be configured using the <a href="//datatables.net/reference/option/idSrc"><code class="option" title="DataTables initialisation option">idSrc</code></a> option),
|
|
|
49 |
DataTables will automatically add it for you (note that this will work for Ajax and Javascript loaded data as well as for server-side processing).</p>
|
|
|
50 |
|
|
|
51 |
<p>In addition to <code>DT_RowId</code> there are other properties which perform similar actions - please refer to the <a href=
|
|
|
52 |
"https://datatables.net/manual/server-side">server-side processing section of the manual</a> for full details.</p>
|
|
|
53 |
|
|
|
54 |
<p>This example below shows <code>DT_RowId</code> being used to add information to the table. In addition objects are used as the data source for the rows.</p>
|
|
|
55 |
</div>
|
|
|
56 |
|
|
|
57 |
<table id="example" class="display" cellspacing="0" width="100%">
|
|
|
58 |
<thead>
|
|
|
59 |
<tr>
|
|
|
60 |
<th>First name</th>
|
|
|
61 |
<th>Last name</th>
|
|
|
62 |
<th>Position</th>
|
|
|
63 |
<th>Office</th>
|
|
|
64 |
<th>Start date</th>
|
|
|
65 |
<th>Salary</th>
|
|
|
66 |
</tr>
|
|
|
67 |
</thead>
|
|
|
68 |
|
|
|
69 |
<tfoot>
|
|
|
70 |
<tr>
|
|
|
71 |
<th>First name</th>
|
|
|
72 |
<th>Last name</th>
|
|
|
73 |
<th>Position</th>
|
|
|
74 |
<th>Office</th>
|
|
|
75 |
<th>Start date</th>
|
|
|
76 |
<th>Salary</th>
|
|
|
77 |
</tr>
|
|
|
78 |
</tfoot>
|
|
|
79 |
</table>
|
|
|
80 |
|
|
|
81 |
<ul class="tabs">
|
|
|
82 |
<li class="active">Javascript</li>
|
|
|
83 |
<li>HTML</li>
|
|
|
84 |
<li>CSS</li>
|
|
|
85 |
<li>Ajax</li>
|
|
|
86 |
<li>Server-side script</li>
|
|
|
87 |
</ul>
|
|
|
88 |
|
|
|
89 |
<div class="tabs">
|
|
|
90 |
<div class="js">
|
|
|
91 |
<p>The Javascript shown below is used to initialise the table shown in this example:</p><code class="multiline language-js">$(document).ready(function() {
|
|
|
92 |
$('#example').DataTable( {
|
|
|
93 |
"processing": true,
|
|
|
94 |
"serverSide": true,
|
|
|
95 |
"ajax": "scripts/ids-objects.php",
|
|
|
96 |
"columns": [
|
|
|
97 |
{ "data": "first_name" },
|
|
|
98 |
{ "data": "last_name" },
|
|
|
99 |
{ "data": "position" },
|
|
|
100 |
{ "data": "office" },
|
|
|
101 |
{ "data": "start_date" },
|
|
|
102 |
{ "data": "salary" }
|
|
|
103 |
]
|
|
|
104 |
} );
|
|
|
105 |
} );</code>
|
|
|
106 |
|
|
|
107 |
<p>In addition to the above code, the following Javascript library files are loaded for use in this example:</p>
|
|
|
108 |
|
|
|
109 |
<ul>
|
|
|
110 |
<li><a href="//code.jquery.com/jquery-1.11.3.min.js">//code.jquery.com/jquery-1.11.3.min.js</a></li>
|
|
|
111 |
<li><a href="../../media/js/jquery.dataTables.js">../../media/js/jquery.dataTables.js</a></li>
|
|
|
112 |
</ul>
|
|
|
113 |
</div>
|
|
|
114 |
|
|
|
115 |
<div class="table">
|
|
|
116 |
<p>The HTML shown below is the raw HTML table element, before it has been enhanced by DataTables:</p>
|
|
|
117 |
</div>
|
|
|
118 |
|
|
|
119 |
<div class="css">
|
|
|
120 |
<div>
|
|
|
121 |
<p>This example uses a little bit of additional CSS beyond what is loaded from the library files (below), in order to correctly display the table. The
|
|
|
122 |
additional CSS used is shown below:</p><code class="multiline language-css"></code>
|
|
|
123 |
</div>
|
|
|
124 |
|
|
|
125 |
<p>The following CSS library files are loaded for use in this example to provide the styling of the table:</p>
|
|
|
126 |
|
|
|
127 |
<ul>
|
|
|
128 |
<li><a href="../../media/css/jquery.dataTables.css">../../media/css/jquery.dataTables.css</a></li>
|
|
|
129 |
</ul>
|
|
|
130 |
</div>
|
|
|
131 |
|
|
|
132 |
<div class="ajax">
|
|
|
133 |
<p>This table loads data by Ajax. The latest data that has been loaded is shown below. This data will update automatically as any additional data is
|
|
|
134 |
loaded.</p>
|
|
|
135 |
</div>
|
|
|
136 |
|
|
|
137 |
<div class="php">
|
|
|
138 |
<p>The script used to perform the server-side processing for this table is shown below. Please note that this is just an example script using PHP. Server-side
|
|
|
139 |
processing scripts can be written in any language, using <a href="//datatables.net/manual/server-side">the protocol described in the DataTables
|
|
|
140 |
documentation</a>.</p>
|
|
|
141 |
</div>
|
|
|
142 |
</div>
|
|
|
143 |
</section>
|
|
|
144 |
</div>
|
|
|
145 |
|
|
|
146 |
<section>
|
|
|
147 |
<div class="footer">
|
|
|
148 |
<div class="gradient"></div>
|
|
|
149 |
|
|
|
150 |
<div class="liner">
|
|
|
151 |
<h2>Other examples</h2>
|
|
|
152 |
|
|
|
153 |
<div class="toc">
|
|
|
154 |
<div class="toc-group">
|
|
|
155 |
<h3><a href="../basic_init/index.html">Basic initialisation</a></h3>
|
|
|
156 |
<ul class="toc">
|
|
|
157 |
<li><a href="../basic_init/zero_configuration.html">Zero configuration</a></li>
|
|
|
158 |
<li><a href="../basic_init/filter_only.html">Feature enable / disable</a></li>
|
|
|
159 |
<li><a href="../basic_init/table_sorting.html">Default ordering (sorting)</a></li>
|
|
|
160 |
<li><a href="../basic_init/multi_col_sort.html">Multi-column ordering</a></li>
|
|
|
161 |
<li><a href="../basic_init/multiple_tables.html">Multiple tables</a></li>
|
|
|
162 |
<li><a href="../basic_init/hidden_columns.html">Hidden columns</a></li>
|
|
|
163 |
<li><a href="../basic_init/complex_header.html">Complex headers (rowspan and colspan)</a></li>
|
|
|
164 |
<li><a href="../basic_init/dom.html">DOM positioning</a></li>
|
|
|
165 |
<li><a href="../basic_init/flexible_width.html">Flexible table width</a></li>
|
|
|
166 |
<li><a href="../basic_init/state_save.html">State saving</a></li>
|
|
|
167 |
<li><a href="../basic_init/alt_pagination.html">Alternative pagination</a></li>
|
|
|
168 |
<li><a href="../basic_init/scroll_y.html">Scroll - vertical</a></li>
|
|
|
169 |
<li><a href="../basic_init/scroll_y_dynamic.html">Scroll - vertical, dynamic height</a></li>
|
|
|
170 |
<li><a href="../basic_init/scroll_x.html">Scroll - horizontal</a></li>
|
|
|
171 |
<li><a href="../basic_init/scroll_xy.html">Scroll - horizontal and vertical</a></li>
|
|
|
172 |
<li><a href="../basic_init/comma-decimal.html">Language - Comma decimal place</a></li>
|
|
|
173 |
<li><a href="../basic_init/language.html">Language options</a></li>
|
|
|
174 |
</ul>
|
|
|
175 |
</div>
|
|
|
176 |
|
|
|
177 |
<div class="toc-group">
|
|
|
178 |
<h3><a href="../advanced_init/index.html">Advanced initialisation</a></h3>
|
|
|
179 |
<ul class="toc">
|
|
|
180 |
<li><a href="../advanced_init/events_live.html">DOM / jQuery events</a></li>
|
|
|
181 |
<li><a href="../advanced_init/dt_events.html">DataTables events</a></li>
|
|
|
182 |
<li><a href="../advanced_init/column_render.html">Column rendering</a></li>
|
|
|
183 |
<li><a href="../advanced_init/length_menu.html">Page length options</a></li>
|
|
|
184 |
<li><a href="../advanced_init/dom_multiple_elements.html">Multiple table control elements</a></li>
|
|
|
185 |
<li><a href="../advanced_init/complex_header.html">Complex headers with column visibility</a></li>
|
|
|
186 |
<li><a href="../advanced_init/object_dom_read.html">Read HTML to data objects</a></li>
|
|
|
187 |
<li><a href="../advanced_init/html5-data-attributes.html">HTML5 data-* attributes - cell data</a></li>
|
|
|
188 |
<li><a href="../advanced_init/html5-data-options.html">HTML5 data-* attributes - table options</a></li>
|
|
|
189 |
<li><a href="../advanced_init/language_file.html">Language file</a></li>
|
|
|
190 |
<li><a href="../advanced_init/defaults.html">Setting defaults</a></li>
|
|
|
191 |
<li><a href="../advanced_init/row_callback.html">Row created callback</a></li>
|
|
|
192 |
<li><a href="../advanced_init/row_grouping.html">Row grouping</a></li>
|
|
|
193 |
<li><a href="../advanced_init/footer_callback.html">Footer callback</a></li>
|
|
|
194 |
<li><a href="../advanced_init/dom_toolbar.html">Custom toolbar elements</a></li>
|
|
|
195 |
<li><a href="../advanced_init/sort_direction_control.html">Order direction sequence control</a></li>
|
|
|
196 |
</ul>
|
|
|
197 |
</div>
|
|
|
198 |
|
|
|
199 |
<div class="toc-group">
|
|
|
200 |
<h3><a href="../styling/index.html">Styling</a></h3>
|
|
|
201 |
<ul class="toc">
|
|
|
202 |
<li><a href="../styling/display.html">Base style</a></li>
|
|
|
203 |
<li><a href="../styling/no-classes.html">Base style - no styling classes</a></li>
|
|
|
204 |
<li><a href="../styling/cell-border.html">Base style - cell borders</a></li>
|
|
|
205 |
<li><a href="../styling/compact.html">Base style - compact</a></li>
|
|
|
206 |
<li><a href="../styling/hover.html">Base style - hover</a></li>
|
|
|
207 |
<li><a href="../styling/order-column.html">Base style - order-column</a></li>
|
|
|
208 |
<li><a href="../styling/row-border.html">Base style - row borders</a></li>
|
|
|
209 |
<li><a href="../styling/stripe.html">Base style - stripe</a></li>
|
|
|
210 |
<li><a href="../styling/bootstrap.html">Bootstrap</a></li>
|
|
|
211 |
<li><a href="../styling/foundation.html">Foundation</a></li>
|
|
|
212 |
<li><a href="../styling/jqueryUI.html">jQuery UI ThemeRoller</a></li>
|
|
|
213 |
</ul>
|
|
|
214 |
</div>
|
|
|
215 |
|
|
|
216 |
<div class="toc-group">
|
|
|
217 |
<h3><a href="../data_sources/index.html">Data sources</a></h3>
|
|
|
218 |
<ul class="toc">
|
|
|
219 |
<li><a href="../data_sources/dom.html">HTML (DOM) sourced data</a></li>
|
|
|
220 |
<li><a href="../data_sources/ajax.html">Ajax sourced data</a></li>
|
|
|
221 |
<li><a href="../data_sources/js_array.html">Javascript sourced data</a></li>
|
|
|
222 |
<li><a href="../data_sources/server_side.html">Server-side processing</a></li>
|
|
|
223 |
</ul>
|
|
|
224 |
</div>
|
|
|
225 |
|
|
|
226 |
<div class="toc-group">
|
|
|
227 |
<h3><a href="../api/index.html">API</a></h3>
|
|
|
228 |
<ul class="toc">
|
|
|
229 |
<li><a href="../api/add_row.html">Add rows</a></li>
|
|
|
230 |
<li><a href="../api/multi_filter.html">Individual column searching (text inputs)</a></li>
|
|
|
231 |
<li><a href="../api/multi_filter_select.html">Individual column searching (select inputs)</a></li>
|
|
|
232 |
<li><a href="../api/highlight.html">Highlighting rows and columns</a></li>
|
|
|
233 |
<li><a href="../api/row_details.html">Child rows (show extra / detailed information)</a></li>
|
|
|
234 |
<li><a href="../api/select_row.html">Row selection (multiple rows)</a></li>
|
|
|
235 |
<li><a href="../api/select_single_row.html">Row selection and deletion (single row)</a></li>
|
|
|
236 |
<li><a href="../api/form.html">Form inputs</a></li>
|
|
|
237 |
<li><a href="../api/counter_columns.html">Index column</a></li>
|
|
|
238 |
<li><a href="../api/show_hide.html">Show / hide columns dynamically</a></li>
|
|
|
239 |
<li><a href="../api/api_in_init.html">Using API in callbacks</a></li>
|
|
|
240 |
<li><a href="../api/tabs_and_scrolling.html">Scrolling and Bootstrap tabs</a></li>
|
|
|
241 |
<li><a href="../api/regex.html">Search API (regular expressions)</a></li>
|
|
|
242 |
</ul>
|
|
|
243 |
</div>
|
|
|
244 |
|
|
|
245 |
<div class="toc-group">
|
|
|
246 |
<h3><a href="../ajax/index.html">Ajax</a></h3>
|
|
|
247 |
<ul class="toc">
|
|
|
248 |
<li><a href="../ajax/simple.html">Ajax data source (arrays)</a></li>
|
|
|
249 |
<li><a href="../ajax/objects.html">Ajax data source (objects)</a></li>
|
|
|
250 |
<li><a href="../ajax/deep.html">Nested object data (objects)</a></li>
|
|
|
251 |
<li><a href="../ajax/objects_subarrays.html">Nested object data (arrays)</a></li>
|
|
|
252 |
<li><a href="../ajax/orthogonal-data.html">Orthogonal data</a></li>
|
|
|
253 |
<li><a href="../ajax/null_data_source.html">Generated content for a column</a></li>
|
|
|
254 |
<li><a href="../ajax/custom_data_property.html">Custom data source property</a></li>
|
|
|
255 |
<li><a href="../ajax/custom_data_flat.html">Flat array data source</a></li>
|
|
|
256 |
<li><a href="../ajax/defer_render.html">Deferred rendering for speed</a></li>
|
|
|
257 |
</ul>
|
|
|
258 |
</div>
|
|
|
259 |
|
|
|
260 |
<div class="toc-group">
|
|
|
261 |
<h3><a href="./index.html">Server-side</a></h3>
|
|
|
262 |
<ul class="toc active">
|
|
|
263 |
<li><a href="./simple.html">Server-side processing</a></li>
|
|
|
264 |
<li><a href="./custom_vars.html">Custom HTTP variables</a></li>
|
|
|
265 |
<li><a href="./post.html">POST data</a></li>
|
|
|
266 |
<li class="active"><a href="./ids.html">Automatic addition of row ID attributes</a></li>
|
|
|
267 |
<li><a href="./object_data.html">Object data source</a></li>
|
|
|
268 |
<li><a href="./row_details.html">Row details</a></li>
|
|
|
269 |
<li><a href="./select_rows.html">Row selection</a></li>
|
|
|
270 |
<li><a href="./jsonp.html">JSONP data source for remote domains</a></li>
|
|
|
271 |
<li><a href="./defer_loading.html">Deferred loading of data</a></li>
|
|
|
272 |
<li><a href="./pipeline.html">Pipelining data to reduce Ajax calls for paging</a></li>
|
|
|
273 |
</ul>
|
|
|
274 |
</div>
|
|
|
275 |
|
|
|
276 |
<div class="toc-group">
|
|
|
277 |
<h3><a href="../plug-ins/index.html">Plug-ins</a></h3>
|
|
|
278 |
<ul class="toc">
|
|
|
279 |
<li><a href="../plug-ins/api.html">API plug-in methods</a></li>
|
|
|
280 |
<li><a href="../plug-ins/sorting_auto.html">Ordering plug-ins (with type detection)</a></li>
|
|
|
281 |
<li><a href="../plug-ins/sorting_manual.html">Ordering plug-ins (no type detection)</a></li>
|
|
|
282 |
<li><a href="../plug-ins/range_filtering.html">Custom filtering - range search</a></li>
|
|
|
283 |
<li><a href="../plug-ins/dom_sort.html">Live DOM ordering</a></li>
|
|
|
284 |
</ul>
|
|
|
285 |
</div>
|
|
|
286 |
</div>
|
|
|
287 |
|
|
|
288 |
<div class="epilogue">
|
|
|
289 |
<p>Please refer to the <a href="http://www.datatables.net">DataTables documentation</a> for full information about its API properties and methods.<br>
|
|
|
290 |
Additionally, there are a wide range of <a href="http://www.datatables.net/extensions">extensions</a> and <a href=
|
|
|
291 |
"http://www.datatables.net/plug-ins">plug-ins</a> which extend the capabilities of DataTables.</p>
|
|
|
292 |
|
|
|
293 |
<p class="copyright">DataTables designed and created by <a href="http://www.sprymedia.co.uk">SpryMedia Ltd</a> © 2007-2015<br>
|
|
|
294 |
DataTables is licensed under the <a href="http://www.datatables.net/mit">MIT license</a>.</p>
|
|
|
295 |
</div>
|
|
|
296 |
</div>
|
|
|
297 |
</div>
|
|
|
298 |
</section>
|
|
|
299 |
</body>
|
|
|
300 |
</html>
|