/[projects]/misc/horsensspejder-web/jquery/DataTables-1.9.4/docs/DataTable.defaults.oLanguage.html
ViewVC logotype

Annotation of /misc/horsensspejder-web/jquery/DataTables-1.9.4/docs/DataTable.defaults.oLanguage.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 2125 - (hide annotations) (download) (as text)
Wed Mar 12 19:30:05 2014 UTC (10 years, 2 months ago) by torben
File MIME type: text/html
File size: 22567 byte(s)
initial import
1 torben 2125 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
2     <html>
3     <head>
4     <meta http-equiv="Content-type" content="text/html; charset=utf-8">
5     <title>Namespace: oLanguage - documentation</title>
6    
7     <style type="text/css" media="screen">
8     @import "media/css/doc.css";
9     @import "media/css/shCore.css";
10     @import "media/css/shThemeDataTables.css";
11     </style>
12    
13     <script type="text/javascript" src="media/js/shCore.js"></script>
14     <script type="text/javascript" src="media/js/shBrushJScript.js"></script>
15     <script type="text/javascript" src="media/js/jquery.js"></script>
16     <script type="text/javascript" src="media/js/doc.js"></script>
17     </head>
18     <body>
19     <div class="fw_container">
20    
21     <a name="top"></a>
22     <div class="fw_header">
23     <h1 class="page-title">Namespace: oLanguage</h1>
24     <h2 class="ancestors">Ancestry: <span class="ancestors"><a href="DataTable.html">DataTable</a> » <a href="DataTable.defaults.html">.defaults</a>.</span> » oLanguage</h2>
25     <div class="page-info">
26     DataTables v1.9.4 documentation
27     </div>
28     </div>
29    
30    
31    
32     <div class="fw_nav">
33     <h2>Navigation</h2>
34     <ul>
35     <li><a href="#top">Overview</a></li>
36     <li><a href="#summary">Summary</a><div><table cellpadding="5" border="0" cellspacing="0" width="100%"><tbody><tr><td>Classes (0)</td><td><a href="#summary_namespaces">Namespaces (2)</a></td></tr><tr><td>Properties (0)</td><td><a href="#summary_properties_static">Static properties (12)</a></td></tr><tr><td>Methods (0)</td><td>Static methods (0)</td></tr><tr><td>Events (0)</td><td></td></tr></tbody></table></div></li><li><a href="#details">Details</a><div><table cellpadding="5" border="0" cellspacing="0" width="100%"><tbody><tr><td>Properties (0)</td><td><a href="#summary_properties_static">Static properties (12)</a></td></tr><tr><td>Methods (0)</td><td>Static methods (0)</td></tr><tr><td>Events (0)</td><td></td></tr></tbody></table></div></li></ul>
37     <div style="margin-top: 10px;">
38     <input type="hidden" name="show_private" value="0">
39     <span id="private_label">Hiding</span> private elements
40     (<a id="private_toggle" href="">toggle</a>)
41     </span>
42     </div>
43     <div>
44     <input type="hidden" name="show_extended" value="1">
45     <span id="extended_label">Showing</span> extended elements
46     (<a id="extended_toggle" href="">toggle</a>)
47     </span>
48     </div>
49     </div>
50    
51     <div class="fw_content">
52     <a name="overview"></a>
53     <div class="doc_overview">
54     <div class="nav_blocker"></div>
55     <p>All strings that DataTables uses in the user interface that it creates
56     are defined in this object, allowing you to modified them individually or
57     completely replace them all as required.</p><dl class="details">
58    
59     </dl>
60    
61     </div>
62    
63    
64     <div class="doc_summary">
65     <a name="summary"></a>
66     <h2>Summary</h2>
67    
68     <div class="doc_group"><a name="summary_namespaces"></a><h3 class="subsection-title">Namespaces</h3>
69     <dl>
70     <dt class="even"><span class="type-name"><a href="DataTable.defaults.oLanguage.oAria.html">oAria</a></span></dt><dd class="even"><p>Strings that are used for WAI-ARIA labels and controls only (these are not
71     actually visible on the page, but will be read by screenreaders, and thus
72     must be internationalised as well).</p></dd><dt class="odd"><span class="type-name"><a href="DataTable.defaults.oLanguage.oPaginate.html">oPaginate</a></span></dt><dd class="odd"><p>Pagination string used by DataTables for the two built-in pagination
73     control types ("two_button" and "full_numbers")</p></dd>
74     </dl></div><div class="doc_group"><a name="summary_properties_static"></a><h3 class="subsection-title">Properties - static</h3>
75    
76     <dl>
77     <dt class=" even"><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sEmptyTable">sEmptyTable</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" even"><p>This string is shown in preference to sZeroRecords when the table is
78     empty of data (regardless of filtering). Note that this is an optional
79     parameter - if it is not given, the value of sZeroRecords will be used
80     instead (either the default or given value).</p></dd><dt class=" odd"><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sInfo">sInfo</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" odd"><p>This string gives information to the end user about the information that
81     is current on display on the page. The <em>START</em>, <em>END</em> and <em>TOTAL</em>
82     variables are all dynamically replaced as the table display updates, and
83     can be freely moved or removed as the language requirements change.</p></dd><dt class=" even"><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sInfoEmpty">sInfoEmpty</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" even"><p>Display information string for when the table is empty. Typically the
84     format of this string should match sInfo.</p></dd><dt class=" odd"><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sInfoFiltered">sInfoFiltered</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" odd"><p>When a user filters the information in a table, this string is appended
85     to the information (sInfo) to give an idea of how strong the filtering
86     is. The variable <em>MAX</em> is dynamically updated.</p></dd><dt class=" even"><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sInfoPostFix">sInfoPostFix</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" even"><p>If can be useful to append extra information to the info string at times,
87     and this variable does exactly that. This information will be appended to
88     the sInfo (sInfoEmpty and sInfoFiltered in whatever combination they are
89     being used) at all times.</p></dd><dt class=" odd"><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sInfoThousands">sInfoThousands</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" odd"><p>DataTables has a build in number formatter (fnFormatNumber) which is used
90     to format large numbers that are used in the table information. By
91     default a comma is used, but this can be trivially changed to any
92     character you wish with this parameter.</p></dd><dt class=" even"><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sLengthMenu">sLengthMenu</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" even"><p>Detail the action that will be taken when the drop down menu for the
93     pagination length option is changed. The '<em>MENU</em>' variable is replaced
94     with a default select list of 10, 25, 50 and 100, and can be replaced
95     with a custom select box if required.</p></dd><dt class=" odd"><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sLoadingRecords">sLoadingRecords</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" odd"><p>When using Ajax sourced data and during the first draw when DataTables is
96     gathering the data, this message is shown in an empty row in the table to
97     indicate to the end user the the data is being loaded. Note that this
98     parameter is not used when loading data by server-side processing, just
99     Ajax sourced data with client-side processing.</p></dd><dt class=" even"><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sProcessing">sProcessing</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" even"><p>Text which is displayed when the table is processing a user action
100     (usually a sort command or similar).</p></dd><dt class=" odd"><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sSearch">sSearch</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" odd"><p>Details the actions that will be taken when the user types into the
101     filtering input text box. The variable "<em>INPUT</em>", if used in the string,
102     is replaced with the HTML text box for the filtering input allowing
103     control over where it appears in the string. If "<em>INPUT</em>" is not given
104     then the input box is appended to the string automatically.</p></dd><dt class=" even"><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sUrl">sUrl</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" even"><p>All of the language information can be stored in a file on the
105     server-side, which DataTables will look up if this parameter is passed.
106     It must store the URL of the language file, which is in a JSON format,
107     and the object has the same properties as the oLanguage object in the
108     initialiser object (i.e. the above parameters). Please refer to one of
109     the example language files to see how this works in action.</p></dd><dt class=" odd"><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sZeroRecords">sZeroRecords</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" odd"><p>Text shown inside the table records when the is no information to be
110     displayed after filtering. sEmptyTable is shown when there is simply no
111     information in the table at all (regardless of filtering).</p></dd>
112     </dl></div>
113     </div>
114    
115    
116    
117    
118     <div class="doc_details">
119     <a name="details"></a>
120     <h2>Details</h2>
121     <div class="doc_group"><a name="details_properties"></a><h3 class="subsection-title">Properties - static</h3>
122     <dl>
123     <dt class=" even"><a name="sEmptyTable"></a><a name="sEmptyTable_details"></a><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sEmptyTable">sEmptyTable</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" even"><p>This string is shown in preference to sZeroRecords when the table is
124     empty of data (regardless of filtering). Note that this is an optional
125     parameter - if it is not given, the value of sZeroRecords will be used
126     instead (either the default or given value).</p><div class="collapse_details"><dl class="details">
127    
128     </dl>
129     <h5>Example</h5>
130     <div class="example-code">
131     <pre class="brush: js"> $(document).ready( function() {
132     $('#example').dataTable( {
133     "oLanguage": {
134     "sEmptyTable": "No data available in table"
135     }
136     } );
137     } );</pre>
138     </div>
139     </div></dd><dt class=" odd"><a name="sInfo"></a><a name="sInfo_details"></a><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sInfo">sInfo</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" odd"><p>This string gives information to the end user about the information that
140     is current on display on the page. The <em>START</em>, <em>END</em> and <em>TOTAL</em>
141     variables are all dynamically replaced as the table display updates, and
142     can be freely moved or removed as the language requirements change.</p><div class="collapse_details"><dl class="details">
143    
144     </dl>
145     <h5>Example</h5>
146     <div class="example-code">
147     <pre class="brush: js"> $(document).ready( function() {
148     $('#example').dataTable( {
149     "oLanguage": {
150     "sInfo": "Got a total of _TOTAL_ entries to show (_START_ to _END_)"
151     }
152     } );
153     } );</pre>
154     </div>
155     </div></dd><dt class=" even"><a name="sInfoEmpty"></a><a name="sInfoEmpty_details"></a><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sInfoEmpty">sInfoEmpty</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" even"><p>Display information string for when the table is empty. Typically the
156     format of this string should match sInfo.</p><div class="collapse_details"><dl class="details">
157    
158     </dl>
159     <h5>Example</h5>
160     <div class="example-code">
161     <pre class="brush: js"> $(document).ready( function() {
162     $('#example').dataTable( {
163     "oLanguage": {
164     "sInfoEmpty": "No entries to show"
165     }
166     } );
167     } );</pre>
168     </div>
169     </div></dd><dt class=" odd"><a name="sInfoFiltered"></a><a name="sInfoFiltered_details"></a><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sInfoFiltered">sInfoFiltered</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" odd"><p>When a user filters the information in a table, this string is appended
170     to the information (sInfo) to give an idea of how strong the filtering
171     is. The variable <em>MAX</em> is dynamically updated.</p><div class="collapse_details"><dl class="details">
172    
173     </dl>
174     <h5>Example</h5>
175     <div class="example-code">
176     <pre class="brush: js"> $(document).ready( function() {
177     $('#example').dataTable( {
178     "oLanguage": {
179     "sInfoFiltered": " - filtering from _MAX_ records"
180     }
181     } );
182     } );</pre>
183     </div>
184     </div></dd><dt class=" even"><a name="sInfoPostFix"></a><a name="sInfoPostFix_details"></a><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sInfoPostFix">sInfoPostFix</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" even"><p>If can be useful to append extra information to the info string at times,
185     and this variable does exactly that. This information will be appended to
186     the sInfo (sInfoEmpty and sInfoFiltered in whatever combination they are
187     being used) at all times.</p><div class="collapse_details"><dl class="details">
188    
189     </dl>
190     <h5>Example</h5>
191     <div class="example-code">
192     <pre class="brush: js"> $(document).ready( function() {
193     $('#example').dataTable( {
194     "oLanguage": {
195     "sInfoPostFix": "All records shown are derived from real information."
196     }
197     } );
198     } );</pre>
199     </div>
200     </div></dd><dt class=" odd"><a name="sInfoThousands"></a><a name="sInfoThousands_details"></a><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sInfoThousands">sInfoThousands</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" odd"><p>DataTables has a build in number formatter (fnFormatNumber) which is used
201     to format large numbers that are used in the table information. By
202     default a comma is used, but this can be trivially changed to any
203     character you wish with this parameter.</p><div class="collapse_details"><dl class="details">
204    
205     </dl>
206     <h5>Example</h5>
207     <div class="example-code">
208     <pre class="brush: js"> $(document).ready( function() {
209     $('#example').dataTable( {
210     "oLanguage": {
211     "sInfoThousands": "'"
212     }
213     } );
214     } );</pre>
215     </div>
216     </div></dd><dt class=" even"><a name="sLengthMenu"></a><a name="sLengthMenu_details"></a><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sLengthMenu">sLengthMenu</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" even"><p>Detail the action that will be taken when the drop down menu for the
217     pagination length option is changed. The '<em>MENU</em>' variable is replaced
218     with a default select list of 10, 25, 50 and 100, and can be replaced
219     with a custom select box if required.</p><div class="collapse_details"><dl class="details">
220    
221     </dl>
222     <h5>Examples</h5>
223     <div class="example-code">
224     <pre class="brush: js"> // Language change only
225     $(document).ready( function() {
226     $('#example').dataTable( {
227     "oLanguage": {
228     "sLengthMenu": "Display _MENU_ records"
229     }
230     } );
231     } );
232    
233     </pre>
234     </div>
235    
236     <div class="example-code">
237     <pre class="brush: js"> // Language and options change
238     $(document).ready( function() {
239     $('#example').dataTable( {
240     "oLanguage": {
241     "sLengthMenu": 'Display <select>'+
242     '<option value="10">10</option>'+
243     '<option value="20">20</option>'+
244     '<option value="30">30</option>'+
245     '<option value="40">40</option>'+
246     '<option value="50">50</option>'+
247     '<option value="-1">All</option>'+
248     '</select> records'
249     }
250     } );
251     } );</pre>
252     </div>
253     </div></dd><dt class=" odd"><a name="sLoadingRecords"></a><a name="sLoadingRecords_details"></a><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sLoadingRecords">sLoadingRecords</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" odd"><p>When using Ajax sourced data and during the first draw when DataTables is
254     gathering the data, this message is shown in an empty row in the table to
255     indicate to the end user the the data is being loaded. Note that this
256     parameter is not used when loading data by server-side processing, just
257     Ajax sourced data with client-side processing.</p><div class="collapse_details"><dl class="details">
258    
259     </dl>
260     <h5>Example</h5>
261     <div class="example-code">
262     <pre class="brush: js"> $(document).ready( function() {
263     $('#example').dataTable( {
264     "oLanguage": {
265     "sLoadingRecords": "Please wait - loading..."
266     }
267     } );
268     } );</pre>
269     </div>
270     </div></dd><dt class=" even"><a name="sProcessing"></a><a name="sProcessing_details"></a><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sProcessing">sProcessing</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" even"><p>Text which is displayed when the table is processing a user action
271     (usually a sort command or similar).</p><div class="collapse_details"><dl class="details">
272    
273     </dl>
274     <h5>Example</h5>
275     <div class="example-code">
276     <pre class="brush: js"> $(document).ready( function() {
277     $('#example').dataTable( {
278     "oLanguage": {
279     "sProcessing": "DataTables is currently busy"
280     }
281     } );
282     } );</pre>
283     </div>
284     </div></dd><dt class=" odd"><a name="sSearch"></a><a name="sSearch_details"></a><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sSearch">sSearch</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" odd"><p>Details the actions that will be taken when the user types into the
285     filtering input text box. The variable "<em>INPUT</em>", if used in the string,
286     is replaced with the HTML text box for the filtering input allowing
287     control over where it appears in the string. If "<em>INPUT</em>" is not given
288     then the input box is appended to the string automatically.</p><div class="collapse_details"><dl class="details">
289    
290     </dl>
291     <h5>Examples</h5>
292     <div class="example-code">
293     <pre class="brush: js"> // Input text box will be appended at the end automatically
294     $(document).ready( function() {
295     $('#example').dataTable( {
296     "oLanguage": {
297     "sSearch": "Filter records:"
298     }
299     } );
300     } );
301    
302     </pre>
303     </div>
304    
305     <div class="example-code">
306     <pre class="brush: js"> // Specify where the filter should appear
307     $(document).ready( function() {
308     $('#example').dataTable( {
309     "oLanguage": {
310     "sSearch": "Apply filter _INPUT_ to table"
311     }
312     } );
313     } );</pre>
314     </div>
315     </div></dd><dt class=" even"><a name="sUrl"></a><a name="sUrl_details"></a><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sUrl">sUrl</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" even"><p>All of the language information can be stored in a file on the
316     server-side, which DataTables will look up if this parameter is passed.
317     It must store the URL of the language file, which is in a JSON format,
318     and the object has the same properties as the oLanguage object in the
319     initialiser object (i.e. the above parameters). Please refer to one of
320     the example language files to see how this works in action.</p><div class="collapse_details"><dl class="details">
321    
322     </dl>
323     <h5>Example</h5>
324     <div class="example-code">
325     <pre class="brush: js"> $(document).ready( function() {
326     $('#example').dataTable( {
327     "oLanguage": {
328     "sUrl": "http://www.sprymedia.co.uk/dataTables/lang.txt"
329     }
330     } );
331     } );</pre>
332     </div>
333     </div></dd><dt class=" odd"><a name="sZeroRecords"></a><a name="sZeroRecords_details"></a><span class="type-attr"><span class="type-signature">&lt;static> </span></span><span class="type-name"><a href="#sZeroRecords">sZeroRecords</a></span><span class="type-sig"><span class="type-signature"> :string</span></span></dt><dd class=" odd"><p>Text shown inside the table records when the is no information to be
334     displayed after filtering. sEmptyTable is shown when there is simply no
335     information in the table at all (regardless of filtering).</p><div class="collapse_details"><dl class="details">
336    
337     </dl>
338     <h5>Example</h5>
339     <div class="example-code">
340     <pre class="brush: js"> $(document).ready( function() {
341     $('#example').dataTable( {
342     "oLanguage": {
343     "sZeroRecords": "No records to display"
344     }
345     } );
346     } );</pre>
347     </div>
348     </div></dd>
349     </dl></div>
350     </div>
351    
352     </div>
353    
354     <div class="fw_footer">
355     DataTables: Copyright 2008-2012 Allan Jardine, all rights reserved<br>
356    
357     Documentation generated by <a href="https://github.com/micmath/JSDoc">JSDoc 3</a> on
358     23th Sep 2012 - 14:27
359     with the <a href="http://datatables.net/">DataTables</a> template.
360     </div>
361     </body>
362     </html>

  ViewVC Help
Powered by ViewVC 1.1.20