content, - # so we need to fix that - reuse blockqoute code to handle this: + # so we need to fix that - reuse blockquote code to handle this: $figure = preg_replace_callback('{(\s*.+?)}sx', array(&$this, '_doBlockQuotes_callback2'), $figure); From 2ded5514bcb6c07c438d54b50d7395f2cbcd7734 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Sun, 23 Feb 2025 18:07:26 -0500 Subject: [PATCH 11/70] spelling: case-insensitive Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- js/core/core.filter.js | 2 +- test/api/columns/column().search().js | 2 +- test/api/columns/columns().search().js | 2 +- test/api/core/search().js | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/js/core/core.filter.js b/js/core/core.filter.js index ad4218b7..1400ba19 100644 --- a/js/core/core.filter.js +++ b/js/core/core.filter.js @@ -137,7 +137,7 @@ function _fnFilter( searchRows, settings, input, options, column ) * @param {string} sSearch string to search for * @param {bool} bRegex treat as a regular expression or not * @param {bool} bSmart perform smart filtering or not - * @param {bool} bCaseInsensitive Do case insensitive matching or not + * @param {bool} bCaseInsensitive Do case-insensitive matching or not * @returns {RegExp} constructed object * @memberof DataTable#oApi */ diff --git a/test/api/columns/column().search().js b/test/api/columns/column().search().js index 84b3de68..16ef0788 100644 --- a/test/api/columns/column().search().js +++ b/test/api/columns/column().search().js @@ -174,7 +174,7 @@ describe('column - column().search()', function() { }); dt.html('basic'); - it('Non-case sensitive regex search', function() { + it('Case-insensitive regex search', function() { let table = $('#example').DataTable(); table .column(0) diff --git a/test/api/columns/columns().search().js b/test/api/columns/columns().search().js index 51cb7801..b73aa0ac 100644 --- a/test/api/columns/columns().search().js +++ b/test/api/columns/columns().search().js @@ -195,7 +195,7 @@ describe('column - columns().search()', function() { }); dt.html('basic'); - it('Non-case sensitive regex search', function() { + it('Case-insensitive regex search', function() { let table = $('#example').DataTable(); table .columns([0, 1]) diff --git a/test/api/core/search().js b/test/api/core/search().js index 4fd78982..0e4c8291 100644 --- a/test/api/core/search().js +++ b/test/api/core/search().js @@ -109,7 +109,7 @@ describe('core - search()', function() { }); dt.html('basic'); - it('Non-case sensitive regex search', function() { + it('Case-insensitive regex search', function() { let table = $('#example').DataTable(); table.search('^a.*s$', true, false, false).draw(); expect($('#example tbody tr:eq(0) td:eq(0)').text()).toBe('No matching records found'); From b66308d6d83e9baa7b37022ee2e70d2c14c70d2b Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Mon, 3 Mar 2025 08:29:24 -0500 Subject: [PATCH 12/70] spelling: circumstances Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- docs/option/deferLoading.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/option/deferLoading.xml b/docs/option/deferLoading.xml index 5ea92a49..179c01ec 100644 --- a/docs/option/deferLoading.xml +++ b/docs/option/deferLoading.xml @@ -24,7 +24,7 @@ When using server-side processing, the default mode of operation for DataTables Note that this option only has effect when `dt-init serverSide` is enabled. It does not have any effect when using client-side processing. -Additionally, there are a number of cirsumstances where this option **will not work**. For example state saving, predefined filtering, extensions such as SearchPanes and SearchBuilder, and more. Unless the logic that is used to populate the table's initial HTML exactly matches how DataTables populates the data to display (e.g. ordering and search), it will not work. Such use cases _are not supported_. Disable this option if you need to use any of these features. +Additionally, there are a number of circumstances where this option **will not work**. For example state saving, predefined filtering, extensions such as SearchPanes and SearchBuilder, and more. Unless the logic that is used to populate the table's initial HTML exactly matches how DataTables populates the data to display (e.g. ordering and search), it will not work. Such use cases _are not supported_. Disable this option if you need to use any of these features. Unless you really need the behaviour offered by this option and know the impact on other modules you are using, it is strongly recommended that you don't use it! From ac2984300d7549a9690040827d940d5fef6d81b0 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Mon, 3 Mar 2025 08:29:36 -0500 Subject: [PATCH 13/70] spelling: classes Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- build/lib/DT_Markdown.php | 4 ++-- build/lib/markdown_extended.php | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/build/lib/DT_Markdown.php b/build/lib/DT_Markdown.php index f072410a..f77ae41a 100644 --- a/build/lib/DT_Markdown.php +++ b/build/lib/DT_Markdown.php @@ -15,12 +15,12 @@ * paths) */ -function DT_Markdown($text, $default_claases=array(), $truncateWhiteSpace=false){ +function DT_Markdown($text, $default_classes=array(), $truncateWhiteSpace=false){ if ( $truncateWhiteSpace ) { $text = DT_Markdown_Parser::truncateWhiteSpace( $text ); } - $parser = new DT_Markdown_Parser($default_claases); + $parser = new DT_Markdown_Parser($default_classes); return $parser->transform($text); } diff --git a/build/lib/markdown_extended.php b/build/lib/markdown_extended.php index 76439044..3380abbc 100644 --- a/build/lib/markdown_extended.php +++ b/build/lib/markdown_extended.php @@ -2,8 +2,8 @@ require_once('markdown.php'); define( 'MARKDOWNEXTRAEXTENDED_VERSION', "0.3" ); -function MarkdownExtended($text, $default_claases = array()){ - $parser = new MarkdownExtraExtended_Parser($default_claases); +function MarkdownExtended($text, $default_classes = array()){ + $parser = new MarkdownExtraExtended_Parser($default_classes); return $parser->transform($text); } From 4b54f8708206c8c95e44975a9b73cb97922eb0d9 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Mon, 3 Mar 2025 08:29:51 -0500 Subject: [PATCH 14/70] spelling: columns Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- test/options/columns/columns_searchable.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/test/options/columns/columns_searchable.js b/test/options/columns/columns_searchable.js index a67f53f7..edcb5928 100644 --- a/test/options/columns/columns_searchable.js +++ b/test/options/columns/columns_searchable.js @@ -56,7 +56,7 @@ describe('columns.searchable option', function() { }); dt.html('basic'); - it('Disble all colimns using columnDefs', function() { + it('Disble all columns using columnDefs', function() { table = $('#example').DataTable({ columnDefs: [{ searchable: false, targets: '_all' }] }); From c6b0c99580ed0affe677e5dede2db105d03fb728 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Mon, 3 Mar 2025 08:29:59 -0500 Subject: [PATCH 15/70] spelling: compatibility Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- docs/feature/paging.buttons.xml | 2 +- js/model/model.defaults.js | 4 ++-- js/model/model.settings.js | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/feature/paging.buttons.xml b/docs/feature/paging.buttons.xml index 3d660380..c0a57aa2 100644 --- a/docs/feature/paging.buttons.xml +++ b/docs/feature/paging.buttons.xml @@ -9,7 +9,7 @@Date: Mon, 3 Mar 2025 08:30:23 -0500 Subject: [PATCH 16/70] spelling: concatenation Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- build/include.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/build/include.sh b/build/include.sh index 77ffafa2..6a9ffc95 100644 --- a/build/include.sh +++ b/build/include.sh @@ -62,7 +62,7 @@ function css_compress { echo_msg "CSS compressing $FILE.css" $SASS --no-charset --stop-on-error --style compressed $DIR/$FILE.css > $DIR/$FILE.min.css - # compressed style will add a UTF8 BOM which messes with concatination - remove it. + # compressed style will add a UTF8 BOM which messes with concatenation - remove it. sed -i '1s/^\xEF\xBB\xBF//' $DIR/$FILE.min.css echo_msg " File size: $(ls -l $DIR/$FILE.min.css | awk -F" " '{ print $5 }')" From 734a5a82c9093faf690417e19990957aa25cd5f7 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Wed, 19 Mar 2025 19:25:58 -0400 Subject: [PATCH 17/70] spelling: datatables Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- examples/server_side/scripts/ssp.class.php | 2 +- test/api/cells/cell().node().js | 2 +- test/functional/features/dt-zero_config.test.js | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/examples/server_side/scripts/ssp.class.php b/examples/server_side/scripts/ssp.class.php index 49838652..16cedf82 100644 --- a/examples/server_side/scripts/ssp.class.php +++ b/examples/server_side/scripts/ssp.class.php @@ -16,7 +16,7 @@ */ -// Please Remove below 4 lines as this is use in Datatatables test environment for your local or live environment please remove it or else it will not work +// Please Remove below 4 lines as this is use in DataTables test environment for your local or live environment please remove it or else it will not work $file = $_SERVER['DOCUMENT_ROOT'].'/datatables/pdo.php'; if ( is_file( $file ) ) { include( $file ); diff --git a/test/api/cells/cell().node().js b/test/api/cells/cell().node().js index 3b8ca66a..730720ef 100644 --- a/test/api/cells/cell().node().js +++ b/test/api/cells/cell().node().js @@ -30,7 +30,7 @@ describe('cells - cell().node()', function() { dt.html('basic'); - it('Returns first cell as expected from before Datatables initialisation', function() { + it('Returns first cell as expected from before DataTables initialisation', function() { var oldcells = $('#example tbody td'); var table = $('#example').DataTable(); expect(table.cell(0, 0).node()).toBe(oldcells[0]); diff --git a/test/functional/features/dt-zero_config.test.js b/test/functional/features/dt-zero_config.test.js index ac7af0f4..241f6cc6 100644 --- a/test/functional/features/dt-zero_config.test.js +++ b/test/functional/features/dt-zero_config.test.js @@ -1,5 +1,5 @@ // TK COLIN not convinced by the usefulness of these tests... -describe('Basic Datatables Test', function() { +describe('Basic DataTables Test', function() { dt.libs({ js: ['jquery', 'datatables'], css: ['datatables'] @@ -7,7 +7,7 @@ describe('Basic Datatables Test', function() { doc = window.document; - describe('Sanity Checks for Datatables with DOM data', function() { + describe('Sanity Checks for DataTables with DOM data', function() { dt.html('basic'); it('jQuery.dataTable function', function() { From 98dfda9b7539025886423c140a82d9f47f931d81 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Mon, 3 Mar 2025 08:30:42 -0500 Subject: [PATCH 18/70] spelling: delimited Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- build/lib/markdown.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/build/lib/markdown.php b/build/lib/markdown.php index ab53ce38..9bfa93e4 100644 --- a/build/lib/markdown.php +++ b/build/lib/markdown.php @@ -1622,7 +1622,7 @@ function detab($text) { # # Replace tabs with the appropriate amount of space. # - # For each line we separate the line in blocks delemited by + # For each line we separate the line in blocks delimited by # tab characters. Then we reconstruct every line by adding the # appropriate number of space between each blocks. From 80cb19aeae2b98804b402e8ddbb8ee69c94b6b8f Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Mon, 3 Mar 2025 08:30:48 -0500 Subject: [PATCH 19/70] spelling: descriptions Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- build/lib/markdown.php | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/build/lib/markdown.php b/build/lib/markdown.php index 9bfa93e4..1198ced8 100644 --- a/build/lib/markdown.php +++ b/build/lib/markdown.php @@ -1730,7 +1730,7 @@ function __construct() { # Extra variables used during extra transformations. var $footnotes = array(); var $footnotes_ordered = array(); - var $abbr_desciptions = array(); + var $abbr_descriptions = array(); var $abbr_word_re = ''; # Give the current footnote number. @@ -1745,7 +1745,7 @@ function setup() { $this->footnotes = array(); $this->footnotes_ordered = array(); - $this->abbr_desciptions = array(); + $this->abbr_descriptions = array(); $this->abbr_word_re = ''; $this->footnote_counter = 1; @@ -1753,7 +1753,7 @@ function setup() { if ($this->abbr_word_re) $this->abbr_word_re .= '|'; $this->abbr_word_re .= preg_quote($abbr_word); - $this->abbr_desciptions[$abbr_word] = trim($abbr_desc); + $this->abbr_descriptions[$abbr_word] = trim($abbr_desc); } } @@ -1763,7 +1763,7 @@ function teardown() { # $this->footnotes = array(); $this->footnotes_ordered = array(); - $this->abbr_desciptions = array(); + $this->abbr_descriptions = array(); $this->abbr_word_re = ''; parent::teardown(); @@ -2810,7 +2810,7 @@ function _stripAbbreviations_callback($matches) { if ($this->abbr_word_re) $this->abbr_word_re .= '|'; $this->abbr_word_re .= preg_quote($abbr_word); - $this->abbr_desciptions[$abbr_word] = trim($abbr_desc); + $this->abbr_descriptions[$abbr_word] = trim($abbr_desc); return ''; # String that will replace the block } @@ -2833,8 +2833,8 @@ function doAbbreviations($text) { } function _doAbbreviations_callback($matches) { $abbr = $matches[0]; - if (isset($this->abbr_desciptions[$abbr])) { - $desc = $this->abbr_desciptions[$abbr]; + if (isset($this->abbr_descriptions[$abbr])) { + $desc = $this->abbr_descriptions[$abbr]; if (empty($desc)) { return $this->hashPart("$abbr"); } else { From 01deee85cd5f821a3c0d192e291fbe0b57279f8d Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Wed, 19 Mar 2025 19:26:35 -0400 Subject: [PATCH 20/70] spelling: diacritical Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- docs/option/columns.type.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/option/columns.type.xml b/docs/option/columns.type.xml index 123d14dd..01c484be 100644 --- a/docs/option/columns.type.xml +++ b/docs/option/columns.type.xml @@ -37,7 +37,7 @@ * Sorting - sorted numerically * Filtering - HTML tags removed from filtering string * `html-utf8` - Detected if the string contains HTML tags and it contains non-ASCII characters - * Sorting - Sorts using [`localeCompare`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/localeCompare) to ensure diacritc characters are correctly sorted + * Sorting - Sorts using [`localeCompare`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/localeCompare) to ensure diacritical characters are correctly sorted * Filtering - Can search either with or without diacritic characters, and will match with or without * `html` - Basic string processing for HTML tags * Sorting - sorted with HTML tags removed From 3f5bf5a31bbdfecb1382c0877b6d73b2d84ba2b7 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Wed, 19 Mar 2025 13:38:56 -0400 Subject: [PATCH 21/70] spelling: disable Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- test/options/columns/columns_searchable.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/test/options/columns/columns_searchable.js b/test/options/columns/columns_searchable.js index edcb5928..a861e6a0 100644 --- a/test/options/columns/columns_searchable.js +++ b/test/options/columns/columns_searchable.js @@ -38,7 +38,7 @@ describe('columns.searchable option', function() { }); dt.html('basic'); - it('Disble searching on multiple columns', function() { + it('Disable searching on multiple columns', function() { table = $('#example').DataTable({ columns: [null, { searchable: false }, { searchable: false }, null, null, null] }); @@ -56,7 +56,7 @@ describe('columns.searchable option', function() { }); dt.html('basic'); - it('Disble all columns using columnDefs', function() { + it('Disable all columns using columnDefs', function() { table = $('#example').DataTable({ columnDefs: [{ searchable: false, targets: '_all' }] }); From 6267f9c8194714dbf328043735cb10215c5785e3 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Sun, 23 Feb 2025 17:53:22 -0500 Subject: [PATCH 22/70] spelling: display Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- js/model/model.defaults.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/js/model/model.defaults.js b/js/model/model.defaults.js index f3be8c2b..ce84fbdc 100644 --- a/js/model/model.defaults.js +++ b/js/model/model.defaults.js @@ -308,7 +308,7 @@ DataTable.defaults = { * Enable or disable state saving. When enabled HTML5 `localStorage` will be * used to save table display information such as pagination information, * display length, filtering and sorting. As such when the end user reloads - * the page the display display will match what thy had previously set up. + * the page the display will match what thy had previously set up. */ "bStateSave": false, From a8b1b6e96909585903ebd968d98317ca7e7c6a0d Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Wed, 19 Mar 2025 13:39:46 -0400 Subject: [PATCH 23/70] spelling: entire Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- build/lib/markdown.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/build/lib/markdown.php b/build/lib/markdown.php index 1198ced8..a6b795be 100644 --- a/build/lib/markdown.php +++ b/build/lib/markdown.php @@ -965,7 +965,7 @@ function doLists($text) { ); foreach ($markers_relist as $marker_re => $other_marker_re) { - # Re-usable pattern to match any entirel ul or ol list: + # Re-usable pattern to match any entire ul or ol list: $whole_list_re = ' ( # $1 = whole list ( # $2 From fcad8815182dc6c9701c78dca1b1886f3038486f Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Sun, 23 Feb 2025 18:13:03 -0500 Subject: [PATCH 24/70] spelling: fine-grained Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- docs/option/columns.orderable.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/option/columns.orderable.xml b/docs/option/columns.orderable.xml index 6d594d35..3a6f888a 100644 --- a/docs/option/columns.orderable.xml +++ b/docs/option/columns.orderable.xml @@ -12,9 +12,9 @@ Note that this option only affects the end user's ability to order a column. Developers are still able to order a column using the `dt-init order` option at initialisation time or the `dt-api order()` method if required. In such cases, as of DataTables 2, the icon for the column ordering in the header will be shown, but the end user cannot click on it to trigger ordering. - DataTables 2 introduced improved support for complex headers (multiple rows and cells with `colspan` and `rowspan`). This option is still applicable in such cases, but it doesn't offer the fine grained control that you might wish to have to determine which cells will have ordering listeners and ordering icons. + DataTables 2 introduced improved support for complex headers (multiple rows and cells with `colspan` and `rowspan`). This option is still applicable in such cases, but it doesn't offer the fine-grained control that you might wish to have to determine which cells will have ordering listeners and ordering icons. - To make that fine grained control available, DataTables will look for a `data-dt-order` attribute on the `-tag th/td` cells in the table header. The value of this attribute (if present, it is entirely optional) controls the ordering listeners and icons: + To make that fine-grained control available, DataTables will look for a `data-dt-order` attribute on the `-tag th/td` cells in the table header. The value of this attribute (if present, it is entirely optional) controls the ordering listeners and icons: * `data-dt-order="disable"` - Ordering listeners will not be attached to these cells, nor will ordering status icons be shown. * `data-dt-order="icon-only"` - Ordering listeners will not be attached to these cells, but the ordering status icons _will_ be shown. From c20b84656f0bee7ea568a8e87946e6b7b10526ae Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Wed, 19 Mar 2025 13:40:12 -0400 Subject: [PATCH 25/70] spelling: finite Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- docs/feature/search.processing.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/feature/search.processing.xml b/docs/feature/search.processing.xml index 2be04b64..4dab2147 100644 --- a/docs/feature/search.processing.xml +++ b/docs/feature/search.processing.xml @@ -10,7 +10,7 @@ - When working with large data sets on the client-side, it takes a finiate and possibly noticeable amount of time for a search process to run. This option can be used to tell DataTables to display its processing indicator (`-init processing`) when the user enters data into the search box. + When working with large data sets on the client-side, it takes a finite and possibly noticeable amount of time for a search process to run. This option can be used to tell DataTables to display its processing indicator (`-init processing`) when the user enters data into the search box. The value should be given as a boolean, with `true` indicating that the processing display should show, while `false` means it should stay hidden. From 71d68297d4e2af62e62af1066cdb9ae6a0632245 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Wed, 19 Mar 2025 16:22:56 -0400 Subject: [PATCH 26/70] spelling: formatters Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- js/core/core.data.js | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/js/core/core.data.js b/js/core/core.data.js index 7433d433..d01b4fc7 100644 --- a/js/core/core.data.js +++ b/js/core/core.data.js @@ -140,10 +140,10 @@ function _fnGetCellData( settings, rowIdx, colIdx, type ) } if ( type === 'filter' ) { - var fomatters = DataTable.ext.type.search; + var formatters = DataTable.ext.type.search; - if ( fomatters[ col.sType ] ) { - cellData = fomatters[ col.sType ]( cellData ); + if ( formatters[ col.sType ] ) { + cellData = formatters[ col.sType ]( cellData ); } } From 4ef8ea67242ce0a04812b84cc38734eeb2a6e87b Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Wed, 19 Mar 2025 16:23:05 -0400 Subject: [PATCH 27/70] spelling: from https Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- test/options/callbacks/footerCallback.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/test/options/callbacks/footerCallback.js b/test/options/callbacks/footerCallback.js index d13f438c..003babc3 100644 --- a/test/options/callbacks/footerCallback.js +++ b/test/options/callbacks/footerCallback.js @@ -92,7 +92,7 @@ describe('footerCallback Option', function() { expect(args[4].length).toBe(12); }); - // Fromhttps://datatables.net/forums/discussion/78401 + // From https://datatables.net/forums/discussion/78401 dt.html('basic'); it('Correct number of hiding elements', function() { From 5d03d14c4da381f81ea0613666ad43a258998876 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Wed, 19 Mar 2025 16:22:44 -0400 Subject: [PATCH 28/70] spelling: from Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- js/core/core.sort.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/js/core/core.sort.js b/js/core/core.sort.js index 4b882874..702c8ada 100644 --- a/js/core/core.sort.js +++ b/js/core/core.sort.js @@ -86,7 +86,7 @@ function _fnSortDisplay(settings, display) { masterMap[master[i]] = i; } - // And then cache what would be the indexOf fom the display + // And then cache what would be the indexOf from the display for (i=0 ; i Date: Wed, 19 Mar 2025 16:24:15 -0400 Subject: [PATCH 29/70] spelling: handler Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- js/core/core.support.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/js/core/core.support.js b/js/core/core.support.js index eb825bf7..dbe3ff7e 100644 --- a/js/core/core.support.js +++ b/js/core/core.support.js @@ -120,7 +120,7 @@ function _fnExtend( out, extender, breakRefs ) /** - * Bind an event handers to allow a click or return key to activate the callback. + * Bind an event handler to allow a click or return key to activate the callback. * This is good for accessibility since a return on the keyboard will have the * same effect as a click, if the element has focus. * @param {element} n Element to bind the action to From 59817e5af1ef259ec343b4851ecdca9177ba11cb Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Sun, 23 Feb 2025 18:13:44 -0500 Subject: [PATCH 30/70] spelling: id Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- build/lib/markdown.php | 2 +- docs/option/layout.xml | 4 ++-- test/options/Features/div.id.js | 2 +- test/options/Options/rowId.js | 2 +- types/types.d.ts | 6 +++--- 5 files changed, 8 insertions(+), 8 deletions(-) diff --git a/build/lib/markdown.php b/build/lib/markdown.php index a6b795be..0d69561b 100644 --- a/build/lib/markdown.php +++ b/build/lib/markdown.php @@ -2240,7 +2240,7 @@ function doHeaders($text) { $text = preg_replace_callback( '{ (^.+?) # $1: Header text - (?:[ ]+\{\#([-_:a-zA-Z0-9]+)\})? # $2: Id attribute + (?:[ ]+\{\#([-_:a-zA-Z0-9]+)\})? # $2: ID attribute [ ]*\n(=+|-+)[ ]*\n+ # $3: Header footer }mx', array(&$this, '_doHeaders_callback_setext'), $text); diff --git a/docs/option/layout.xml b/docs/option/layout.xml index fd356806..f69bd32b 100644 --- a/docs/option/layout.xml +++ b/docs/option/layout.xml @@ -182,13 +182,13 @@ interface { /** Class to apply to the CELL in the layout grid */ className?: string; - /** Id to apply to the CELL in the layout grid */ + /** ID to apply to the CELL in the layout grid */ id?: string; /** Class to apply to the ROW in the layout grid */ rowClass?: string; - /** Id to apply to the ROW in the layout grid */ + /** ID to apply to the ROW in the layout grid */ rowId?: string; /** List of features to show in this cell */ diff --git a/test/options/Features/div.id.js b/test/options/Features/div.id.js index d1ae33d3..586ed437 100644 --- a/test/options/Features/div.id.js +++ b/test/options/Features/div.id.js @@ -33,7 +33,7 @@ describe('Div id', function() { expect(div[0].className).toBe(''); }); - it('Id is set', function() { + it('ID is set', function() { expect(div[0].id).toBe('test'); }); }); diff --git a/test/options/Options/rowId.js b/test/options/Options/rowId.js index dc780924..8a244b37 100644 --- a/test/options/Options/rowId.js +++ b/test/options/Options/rowId.js @@ -79,7 +79,7 @@ describe('rowId option', function() { }); dt.html('basic'); - it('Id removed when row deleted', function() { + it('ID removed when row deleted', function() { table = $('#example').DataTable({ rowId: 3, }); diff --git a/types/types.d.ts b/types/types.d.ts index e1a01be2..9f3fa444 100644 --- a/types/types.d.ts +++ b/types/types.d.ts @@ -133,7 +133,7 @@ export interface Feature { /** Class name for the div */ className?: string; - /** Id to give the div */ + /** ID to give the div */ id?: string; /** HTML content for the div (cannot be used as well as textContent) */ @@ -218,13 +218,13 @@ type LayoutElement = { /** Class to apply to the CELL in the layout grid */ className?: string; - /** Id to apply to the CELL in the layout grid */ + /** ID to apply to the CELL in the layout grid */ id?: string; /** Class to apply to the ROW in the layout grid */ rowClass?: string; - /** Id to apply to the ROW in the layout grid */ + /** ID to apply to the ROW in the layout grid */ rowId?: string; /** List of features to show in this cell */ From f6e173fb70c932085a2a12ebf6fa0a7730d28ad2 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Sun, 23 Feb 2025 17:55:43 -0500 Subject: [PATCH 31/70] spelling: if this Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- js/ext/ext.renderer.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/js/ext/ext.renderer.js b/js/ext/ext.renderer.js index 7fc89fec..432772a3 100644 --- a/js/ext/ext.renderer.js +++ b/js/ext/ext.renderer.js @@ -40,7 +40,7 @@ $.extend( true, DataTable.ext.renderer, { // on destroy, while the `dt` namespaced event is the one we are // listening for $(settings.nTable).on( 'order.dt.DT column-visibility.dt.DT', function ( e, ctx ) { - if ( settings !== ctx ) { // need to check this this is the host + if ( settings !== ctx ) { // need to check if this is the host return; // table, not a nested one } From 546342afc19c7f885130a655f1ef34260d312983 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Wed, 19 Mar 2025 16:25:28 -0400 Subject: [PATCH 32/70] spelling: ilen Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- build/examples.php | 38 +++++++++++----------- build/lib/DT_Example.php | 14 ++++---- build/lib/DT_Markdown.php | 4 +-- docs/event/xhr.xml | 2 +- docs/option/ajax.dataSrc.xml | 2 +- docs/option/ajax.xml | 2 +- examples/server_side/scripts/ssp.class.php | 10 +++--- js/api/api.ajax.js | 2 +- js/api/api.base.js | 18 +++++----- js/api/api.cells.js | 8 ++--- js/api/api.columns.js | 6 ++-- js/api/api.order.js | 2 +- js/api/api.row.details.js | 6 ++-- js/api/api.rows.js | 6 ++-- js/api/api.selectors.js | 14 ++++---- js/core/core.ajax.js | 2 +- js/core/core.columns.js | 8 ++--- js/core/core.compat.js | 2 +- js/core/core.data.js | 6 ++-- js/core/core.draw.js | 6 ++-- js/core/core.filter.js | 2 +- js/core/core.internal.js | 20 ++++++------ js/core/core.sizing.js | 2 +- js/core/core.sort.js | 12 +++---- js/core/core.state.js | 4 +-- test/api/core/clear().js | 2 +- test/api/core/draw().js | 2 +- test/html-loader-lib.js | 8 ++--- test/options/Features/serverSide.js | 6 ++-- test/options/Options/deferLoading.js | 4 +-- 30 files changed, 110 insertions(+), 110 deletions(-) diff --git a/build/examples.php b/build/examples.php index ba0f06fb..8a0a89f0 100644 --- a/build/examples.php +++ b/build/examples.php @@ -336,7 +336,7 @@ function multiple ( $value, $fn ) { if ( is_array( $value ) ) { - for ( $i=0, $ien=count($value) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($value) ; $i<$iLen ; $i++ ) { $fn( $value[$i] ); } } @@ -660,7 +660,7 @@ function sql_files ( $out_dir ) ); $out = []; - for ( $i=0, $ien=count($json) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($json) ; $i<$iLen ; $i++ ) { $out[] = "( ". $json[$i]['id'].", ". "'".$json[$i]['first_name']."', ". @@ -771,7 +771,7 @@ function sql_files ( $out_dir ) VALUES EOD; $out = []; - for ( $i=0, $ien=count($json) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($json) ; $i<$iLen ; $i++ ) { $out[] = "( ". $json[$i]['id'].", ". "'".$json[$i]['first_name']."', ". @@ -823,7 +823,7 @@ function sql_files ( $out_dir ) VALUES EOD; $insert = []; - for ( $i=0, $ien=count($json) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($json) ; $i<$iLen ; $i++ ) { $insert[] = "\t\t( ". $json[$i]['id'].", ". "'".$json[$i]['first_name']."', ". @@ -882,7 +882,7 @@ function sql_files ( $out_dir ) EOD; - for ( $i=0, $ien=count($json) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($json) ; $i<$iLen ; $i++ ) { $str .= "INSERT INTO \"datatables_demo\" ". "( \"first_name\", \"last_name\", \"age\", \"position\", \"salary\", \"start_date\", \"extn\", \"email\", \"office\", \"seq\" ) ". "VALUES "; @@ -926,7 +926,7 @@ function sql_files ( $out_dir ) EOD; - for ( $i=0, $ien=count($json) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($json) ; $i<$iLen ; $i++ ) { $str .= "INSERT INTO \"datatables_demo\" ". "( \"first_name\", \"last_name\", \"age\", \"position\", \"salary\", \"start_date\", \"extn\", \"email\", \"office\", \"seq\" ) ". "VALUES "; @@ -971,7 +971,7 @@ function json_files ( $out_dir ) // Plain arrays $out = []; - for ( $i=0, $ien=count($json) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($json) ; $i<$iLen ; $i++ ) { $out[] = [ $json[$i]['first_name'].' '.$json[$i]['last_name'], $json[$i]['position'], @@ -995,7 +995,7 @@ function json_files ( $out_dir ) // Arrays with sub objects $out = []; - for ( $i=0, $ien=count($json) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($json) ; $i<$iLen ; $i++ ) { $out[] = [ $json[$i]['first_name'].' '.$json[$i]['last_name'], 'hr' => [ @@ -1017,7 +1017,7 @@ function json_files ( $out_dir ) // Simple object base case $out = []; - for ( $i=0, $ien=count($json) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($json) ; $i<$iLen ; $i++ ) { $out[] = [ 'id' => $json[$i]['id'], 'name' => $json[$i]['first_name'] .' '. $json[$i]['last_name'], @@ -1042,7 +1042,7 @@ function json_files ( $out_dir ) // Objects with sub objects and arrays $out = []; - for ( $i=0, $ien=count($json) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($json) ; $i<$iLen ; $i++ ) { $out[] = [ 'name' => $json[$i]['first_name'].' '.$json[$i]['last_name'], 'hr' => [ @@ -1064,7 +1064,7 @@ function json_files ( $out_dir ) // Salary without formatting $out = []; - for ( $i=0, $ien=count($json) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($json) ; $i<$iLen ; $i++ ) { $country = $json[$i]['office']; if ( $country === 'Singapore' ) { $country = 'Argentina'; @@ -1086,7 +1086,7 @@ function json_files ( $out_dir ) // Objects with sub objects $out = []; - for ( $i=0, $ien=count($json) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($json) ; $i<$iLen ; $i++ ) { $out[] = [ 'name' => [ $json[$i]['last_name'], $json[$i]['first_name'] ], 'hr' => [ @@ -1106,7 +1106,7 @@ function json_files ( $out_dir ) // Orthogonal date data $out = []; - for ( $i=0, $ien=count($json) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($json) ; $i<$iLen ; $i++ ) { $t = strtotime( $json[$i]['start_date'] ); $out[] = [ 'name' => $json[$i]['first_name'] .' '. $json[$i]['last_name'], @@ -1240,7 +1240,7 @@ function tidy_structure ( &$examples, $order ) function dump_structure( &$examples, $pre="" ) { - for ( $i=0, $ien=count($examples) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($examples) ; $i<$iLen ; $i++ ) { $example = $examples[$i]; if ( $example['type'] === 'dir' ) { @@ -1256,7 +1256,7 @@ function dump_structure( &$examples, $pre="" ) function process_structure ( &$examples, $toc='', $cat='' ) { - for ( $i=0, $ien=count($examples) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($examples) ; $i<$iLen ; $i++ ) { $example = $examples[$i]; if ( $example['type'] === 'dir' ) { @@ -1305,7 +1305,7 @@ function build_toc ( $examples, $example, $category ) // Use all examples $out = ''; - for ( $i=0, $ien=count($examples) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($examples) ; $i<$iLen ; $i++ ) { if ( $examples[$i]['type'] === 'dir' && $examples[$i]['name'] !== 'private' ) { $out .= build_toc_category( $examples[$i], $example ); } @@ -1321,7 +1321,7 @@ function build_toc_category ( $category, $current=null ) $inCategory = false; $out = ''; - for ( $i=0, $ien=count($category['files']) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($category['files']) ; $i<$iLen ; $i++ ) { $example = $category['files'][$i]; if ( $example['name'] !== 'index' ) { @@ -1360,7 +1360,7 @@ function build_toc_category ( $category, $current=null ) function has_files ( $files ) { - for ( $i=0, $ien=count($files) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($files) ; $i<$iLen ; $i++ ) { if ( $files[$i]['type'] === 'file' ) { return true; } @@ -1376,7 +1376,7 @@ function has_files ( $files ) function toc_structure ( &$examples ) { - for ( $i=0, $ien=count($examples) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($examples) ; $i<$iLen ; $i++ ) { $group = &$examples[$i]; if ( $group['type'] === 'dir' ) { diff --git a/build/lib/DT_Example.php b/build/lib/DT_Example.php index b3f752a1..ba359986 100644 --- a/build/lib/DT_Example.php +++ b/build/lib/DT_Example.php @@ -394,7 +394,7 @@ public function build_table ( $type, $idIn=null ) $a = explode('|', $type); $t = ''; - for ( $i=0, $ien=count($a) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($a) ; $i<$iLen ; $i++ ) { $t .= $this->build_table( $a[$i] ); } @@ -453,7 +453,7 @@ public function build_table ( $type, $idIn=null ) } else { $cells = ''; - for ( $i=0, $ien=count($columns) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($columns) ; $i<$iLen ; $i++ ) { $cells .= ' '.$this->_column( $columns[$i], 'title' ).' '; } $t .= ''; @@ -479,7 +479,7 @@ public function build_table ( $type, $idIn=null ) } $cells = ''; - for ( $i=0, $ien=count($columns) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($columns) ; $i<$iLen ; $i++ ) { $cell = $this->_column( $columns[$i], 'data', $this->_data[$j] ); if ( strpos( $cell, '_column( $columns[$i], 'title' ).''; } $t .= ' '; @@ -558,7 +558,7 @@ private function _format_libs ( $type ) $out = array(); $libs = $this->_libs[ $type ]; - for ( $i=0, $ien=count($libs) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($libs) ; $i<$iLen ; $i++ ) { $file = $libs[$i]; // needs a path if ( strpos($file, '//') !== 0 && @@ -608,7 +608,7 @@ private function _resolve_xml_libs ( $framework, $type, $libs ) if ( isset( $lib['lib'] ) ) { $split_attr = explode( ' ', (string)$lib['lib'] ); - for ( $i=0, $ien=count($split_attr) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($split_attr) ; $i<$iLen ; $i++ ) { $a[] = $split_attr[$i]; $this->_xml_libs[ $type ][] = $split_attr[$i]; } @@ -624,7 +624,7 @@ private function _resolve_libs ( $framework, $type, $libs ) $exampleLibs = &$this->_libs[ $type ]; $srcLibs = DT_Example::$lookup_libraries[ $type ]; - for ( $i=0, $ien=count($libs) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($libs) ; $i<$iLen ; $i++ ) { $lib = $libs[$i]; if ( strpos($lib, '/') === 0 || strpos($lib, '.') === 0 ) { diff --git a/build/lib/DT_Markdown.php b/build/lib/DT_Markdown.php index f77ae41a..0a54dbcb 100644 --- a/build/lib/DT_Markdown.php +++ b/build/lib/DT_Markdown.php @@ -45,7 +45,7 @@ static function truncateWhiteSpace ( $str ) // Remove the same amount of white space for each line if ( $match && count($match) ) { - for ( $i=0, $ien=count($a) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($a) ; $i<$iLen ; $i++ ) { $a[$i] = preg_replace( '/'.$match[0].'/', '', $a[$i], 1 ); } } @@ -112,7 +112,7 @@ function _docLink ( $software, $type, $item, $html ) $a = explode('|', $item); $s = array(); - for ( $i=0, $ien=count($a) ; $i<$ien ; $i++ ) { + for ( $i=0, $iLen=count($a) ; $i<$iLen ; $i++ ) { $s[] = self::_docLink( $software, $type, $a[$i], htmlspecialchars(trim($a[$i]), ENT_NOQUOTES) ); diff --git a/docs/event/xhr.xml b/docs/event/xhr.xml index 4bd5643b..a287b0a4 100644 --- a/docs/event/xhr.xml +++ b/docs/event/xhr.xml @@ -40,7 +40,7 @@View message'; } diff --git a/docs/option/ajax.xml b/docs/option/ajax.xml index 32843340..55e868ac 100644 --- a/docs/option/ajax.xml +++ b/docs/option/ajax.xml @@ -166,7 +166,7 @@ new DataTable('#myTable', { ajax: { url: 'data.json', dataSrc: function (json) { - for (var i = 0, ien = json.length; i < ien; i++) { + for (var i = 0, iLen = json.length; i < iLen; i++) { json[i][0] = ' Date: Wed, 19 Mar 2025 16:29:07 -0400 Subject: [PATCH 33/70] spelling: in sync Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- test/karma.conf.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/test/karma.conf.js b/test/karma.conf.js index 3c9c07ca..fecb45ce 100644 --- a/test/karma.conf.js +++ b/test/karma.conf.js @@ -263,7 +263,7 @@ module.exports = function(config) { css: '//cdn.datatables.net/v/dt/dt-2.1.0/datatables.css' }, // External libraries - // Ensure that these are insync with the build/examples.php file + // Ensure that these are in sync with the build/examples.php file jquery: { js: '//code.jquery.com/jquery-1.12.4.js' }, From fec7599d877712b4f2999368fad008d177370f61 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Wed, 19 Mar 2025 16:28:55 -0400 Subject: [PATCH 34/70] spelling: indication Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- docs/api/ajax.json().xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/ajax.json().xml b/docs/api/ajax.json().xml index c0c158bf..487325de 100644 --- a/docs/api/ajax.json().xml +++ b/docs/api/ajax.json().xml @@ -19,7 +19,7 @@ Furthermore, if the `dt-init ajax` option is given as a function, this method will return `undefined` rather than the JSON string, since the given function effectively overwrites DataTables own Ajax handler. - Date: Wed, 19 Mar 2025 16:29:21 -0400 Subject: [PATCH 35/70] spelling: iterator Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- types/types.d.ts | 42 +++++++++++++++++++++--------------------- 1 file changed, 21 insertions(+), 21 deletions(-) diff --git a/types/types.d.ts b/types/types.d.ts index 9f3fa444..596c0f20 100644 --- a/types/types.d.ts +++ b/types/types.d.ts @@ -984,13 +984,13 @@ export interface Api { * @param returns Indicate if the callback function will return values or not. If set to true a new API instance will be returns with the return values from the callback function in its result set. If not set, or false the original instance will be returned for chaining, if no values are returned by the callback method. * @returns Original API instance if the callback returns no result (i.e. undefined) or a new API instance with the result set being the results from the callback, in order of execution. */ - iterator(type: 'table', callback: InteratorTable, returns?: boolean): Api ; - iterator(type: 'cell', callback: InteratorCell, returns?: boolean): Api ; - iterator(type: 'column-rows', callback: InteratorColumnRows, returns?: boolean): Api ; - iterator(type: 'column', callback: InteratorColumn, returns?: boolean): Api ; - iterator(type: 'columns', callback: InteratorColumns, returns?: boolean): Api ; - iterator(type: 'row', callback: InteratorRow, returns?: boolean): Api ; - iterator(type: 'rows', callback: InteratorRows, returns?: boolean): Api ; + iterator(type: 'table', callback: IteratorTable, returns?: boolean): Api ; + iterator(type: 'cell', callback: IteratorCell, returns?: boolean): Api ; + iterator(type: 'column-rows', callback: IteratorColumnRows, returns?: boolean): Api ; + iterator(type: 'column', callback: IteratorColumn, returns?: boolean): Api ; + iterator(type: 'columns', callback: IteratorColumns, returns?: boolean): Api ; + iterator(type: 'row', callback: IteratorRow, returns?: boolean): Api ; + iterator(type: 'rows', callback: IteratorRows, returns?: boolean): Api ; /** * Iterate over a result set of table, row, column or cell indexes @@ -1001,13 +1001,13 @@ export interface Api { * @param returns Indicate if the callback function will return values or not. If set to true a new API instance will be returns with the return values from the callback function in its result set. If not set, or false the original instance will be returned for chaining, if no values are returned by the callback method. * @returns Original API instance if the callback returns no result (i.e. undefined) or a new API instance with the result set being the results from the callback, in order of execution. */ - iterator(flatten: boolean, type: 'table', callback: InteratorTable, returns?: boolean): Api ; - iterator(flatten: boolean, type: 'cell', callback: InteratorCell, returns?: boolean): Api ; - iterator(flatten: boolean, type: 'column-rows', callback: InteratorColumnRows, returns?: boolean): Api ; - iterator(flatten: boolean, type: 'column', callback: InteratorColumn, returns?: boolean): Api ; - iterator(flatten: boolean, type: 'columns', callback: InteratorColumns, returns?: boolean): Api ; - iterator(flatten: boolean, type: 'row', callback: InteratorRow, returns?: boolean): Api ; - iterator(flatten: boolean, type: 'rows', callback: InteratorRows, returns?: boolean): Api ; + iterator(flatten: boolean, type: 'table', callback: IteratorTable, returns?: boolean): Api ; + iterator(flatten: boolean, type: 'cell', callback: IteratorCell, returns?: boolean): Api ; + iterator(flatten: boolean, type: 'column-rows', callback: IteratorColumnRows, returns?: boolean): Api ; + iterator(flatten: boolean, type: 'column', callback: IteratorColumn, returns?: boolean): Api ; + iterator(flatten: boolean, type: 'columns', callback: IteratorColumns, returns?: boolean): Api ; + iterator(flatten: boolean, type: 'row', callback: IteratorRow, returns?: boolean): Api ; + iterator(flatten: boolean, type: 'rows', callback: IteratorRows, returns?: boolean): Api ; /** * Join the elements in the result set into a string. @@ -1417,7 +1417,7 @@ export interface State { * @param settings Table settings object * @param counter Loop counter */ -type InteratorTable = (settings: InternalSettings, counter: number) => any; +type IteratorTable = (settings: InternalSettings, counter: number) => any; /** * "cell" - loop over each table and cell in the result set @@ -1428,7 +1428,7 @@ type InteratorTable = (settings: InternalSettings, counter: number) => any; * @param tableCounter Table counter (outer) * @param cellCounter Cell counter (inner) */ -type InteratorCell = (settings: InternalSettings, rowIndex: number, columnIndex: number, tableCounter: number, cellCounter: number) => any; +type IteratorCell = (settings: InternalSettings, rowIndex: number, columnIndex: number, tableCounter: number, cellCounter: number) => any; /** * "columns" - loop over each item in the result set @@ -1437,7 +1437,7 @@ type InteratorCell = (settings: InternalSettings, rowIndex: number, columnIndex: * @param resultItem Result set item * @param counter Loop counter */ -type InteratorColumns = (settings: InternalSettings, resultItem: any, counter: number) => any; +type IteratorColumns = (settings: InternalSettings, resultItem: any, counter: number) => any; /** * "column" - loop over each table and column in the result set @@ -1447,7 +1447,7 @@ type InteratorColumns = (settings: InternalSettings, resultItem: any, counter: n * @param tableCounter Table counter (outer) * @param columnCounter Column counter (inner) */ -type InteratorColumn = (settings: InternalSettings, columnIndex: number, tableCounter: number, columnCounter: number) => any; +type IteratorColumn = (settings: InternalSettings, columnIndex: number, tableCounter: number, columnCounter: number) => any; /** * "column-rows" - loop over each table, column and row in the result set applying selector-modifier. @@ -1458,7 +1458,7 @@ type InteratorColumn = (settings: InternalSettings, columnIndex: number, tableCo * @param columnCounter Column counter (inner) * @param rowIndexes Row indexes */ -type InteratorColumnRows = (settings: InternalSettings, columnIndex: number, tableCounter: number, columnCounter: number, rowIndexes: number[]) => any; +type IteratorColumnRows = (settings: InternalSettings, columnIndex: number, tableCounter: number, columnCounter: number, rowIndexes: number[]) => any; /** * "row" - loop over each table and row in the result set @@ -1468,7 +1468,7 @@ type InteratorColumnRows = (settings: InternalSettings, columnIndex: number, tab * @param tableCounter Table counter (outer) * @param rowCounter Row counter (inner) */ -type InteratorRow = (settings: InternalSettings, rowIndex: number, tableCounter: number, rowCounter: number) => any; +type IteratorRow = (settings: InternalSettings, rowIndex: number, tableCounter: number, rowCounter: number) => any; /** * "rows" - loop over each item in the result set @@ -1477,7 +1477,7 @@ type InteratorRow = (settings: InternalSettings, rowIndex: number, tableCounter: * @param resultItem Result set item * @param counter Loop counter */ -type InteratorRows = (settings: InternalSettings, resultItem: any, counter: number) => any; +type IteratorRows = (settings: InternalSettings, resultItem: any, counter: number) => any; export interface ApiAjax { /** From 6123f5175551a0f1cd2e6397d47387339833b5fa Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Sun, 23 Feb 2025 18:13:53 -0500 Subject: [PATCH 36/70] spelling: its Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- js/core/core.sort.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/js/core/core.sort.js b/js/core/core.sort.js index dd078c9d..9f2499f2 100644 --- a/js/core/core.sort.js +++ b/js/core/core.sort.js @@ -266,7 +266,7 @@ function _fnSort ( oSettings, col, dir ) /* Do the sort - here we want multi-column sorting based on a given data source (column) * and sorting function (from oSort) in a certain direction. It's reasonably complex to - * follow on it's own, but this is what we want (example two column sorting): + * follow on its own, but this is what we want (example two column sorting): * fnLocalSorting = function(a,b){ * var test; * test = oSort['string-asc']('data11', 'data12'); From 9d83407f43ecb55884ec65d3c2dbf0044f294231 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Sun, 23 Feb 2025 17:42:34 -0500 Subject: [PATCH 37/70] spelling: javascript Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- build/data.json | 8 ++++---- build/lib/DT_Example.php | 8 ++++---- build/lib/DT_Markdown.php | 2 +- build/make.sh | 2 +- build/templates/example.html | 6 +++--- build/wrapper.js | 2 +- descriptors/composer.json | 2 +- docs/api/DataTable.util.diacritics().xml | 2 +- docs/api/DataTable.util.escapeRegex().xml | 2 +- docs/api/DataTable.util.get().xml | 2 +- docs/api/any().xml | 2 +- docs/api/cell().invalidate().xml | 4 ++-- docs/api/cells().invalidate().xml | 4 ++-- docs/api/each().xml | 4 ++-- docs/api/filter().xml | 4 ++-- docs/api/flatten().xml | 2 +- docs/api/i18n().xml | 2 +- docs/api/includes().xml | 2 +- docs/api/indexOf().xml | 4 ++-- docs/api/join().xml | 6 +++--- docs/api/lastIndexOf().xml | 4 ++-- docs/api/length.xml | 2 +- docs/api/map().xml | 4 ++-- docs/api/pluck().xml | 4 ++-- docs/api/pop().xml | 4 ++-- docs/api/push().xml | 4 ++-- docs/api/reduce().xml | 4 ++-- docs/api/reduceRight().xml | 4 ++-- docs/api/reverse().xml | 4 ++-- docs/api/row().data().xml | 2 +- docs/api/row().invalidate().xml | 4 ++-- docs/api/row.add().xml | 2 +- docs/api/rows().data().xml | 2 +- docs/api/rows().invalidate().xml | 4 ++-- docs/api/rows.add().xml | 2 +- docs/api/shift().xml | 4 ++-- docs/api/slice().xml | 4 ++-- docs/api/sort().xml | 6 +++--- docs/api/splice().xml | 4 ++-- docs/api/table().footer.structure().xml | 4 ++-- docs/api/table().header.structure().xml | 4 ++-- docs/api/toArray().xml | 10 +++++----- docs/api/unique().xml | 2 +- docs/api/unshift().xml | 4 ++-- docs/event/dt-error.xml | 2 +- docs/option/DataTable.ext.errMode.xml | 2 +- docs/option/ajax.dataSrc.xml | 6 +++--- docs/option/ajax.xml | 2 +- docs/option/columns.className.xml | 2 +- docs/option/columns.data.xml | 4 ++-- docs/option/columns.orderable.xml | 2 +- docs/option/columns.render.xml | 4 ++-- docs/option/data.xml | 2 +- docs/option/deferRender.xml | 2 +- docs/option/language.decimal.xml | 4 ++-- docs/option/rowId.xml | 2 +- docs/type/DataTables.Api.xml | 2 +- docs/type/DataTables.Type.xml | 2 +- docs/type/array.xml | 4 ++-- docs/type/boolean.xml | 4 ++-- docs/type/function.xml | 4 ++-- docs/type/integer.xml | 4 ++-- docs/type/node.xml | 2 +- docs/type/null.xml | 4 ++-- docs/type/number.xml | 4 ++-- docs/type/object.xml | 6 +++--- docs/type/string.xml | 4 ++-- docs/type/undefined.xml | 4 ++-- examples/advanced_init/html5-data-options.xml | 12 ++++++------ examples/advanced_init/object_dom_read.xml | 4 ++-- examples/ajax/custom_data_flat.xml | 2 +- examples/ajax/custom_data_property.xml | 4 ++-- examples/ajax/deep.xml | 2 +- examples/api/api_in_init.xml | 2 +- examples/api/highlight.xml | 2 +- examples/basic_init/zero_configuration.xml | 2 +- examples/data_sources/index.xml | 2 +- examples/data_sources/js_array.xml | 12 ++++++------ examples/i18n/comma-decimal.xml | 4 ++-- examples/i18n/datetime.xml | 2 +- examples/i18n/rtl.xml | 2 +- examples/server_side/ids.xml | 2 +- examples/server_side/scripts/jsonp.php | 2 +- js/api/api.page.js | 2 +- js/core/core.columns.js | 2 +- js/core/core.data.js | 2 +- js/core/core.internal.js | 2 +- js/ext/ext.js | 4 ++-- js/ext/ext.sorting.js | 2 +- js/integration/dataTables.bulma.js | 2 +- js/integration/dataTables.semanticui.js | 2 +- js/model/model.defaults.columns.js | 10 +++++----- js/model/model.defaults.js | 6 +++--- js/model/model.settings.js | 2 +- test/data/array.txt | 8 ++++---- test/data/data.txt | 8 ++++---- test/data/flat.txt | 8 ++++---- test/data/objects_deep.txt | 8 ++++---- test/functional/features/data-nodes.js | 2 +- test/html-loader-lib.js | 2 +- test/html/ISO8601.html | 8 ++++---- test/html/basic.html | 8 ++++---- test/html/basic_container.html | 8 ++++---- test/html/basic_id.html | 8 ++++---- test/html/basic_wide.html | 8 ++++---- test/html/complex-header-footer.html | 8 ++++---- test/html/dates_non_std.html | 8 ++++---- test/html/html.html | 8 ++++---- test/html/html5.html | 8 ++++---- test/html/liveOrder.html | 8 ++++---- test/html/no_footer.html | 8 ++++---- test/html/two_footers.html | 8 ++++---- test/html/two_headers.html | 8 ++++---- test/html/two_tables.html | 8 ++++---- types/types.d.ts | 8 ++++---- 115 files changed, 244 insertions(+), 244 deletions(-) diff --git a/build/data.json b/build/data.json index 09a5c7d0..742a09d6 100644 --- a/build/data.json +++ b/build/data.json @@ -44,7 +44,7 @@ "first_name": "Cedric", "last_name": "Kelly", "age": "22", - "position": "Senior Javascript Developer", + "position": "Senior JavaScript Developer", "salary": "433060", "start_date": "2012-03-29", "extn": "6224", @@ -109,7 +109,7 @@ "first_name": "Colleen", "last_name": "Hurst", "age": "39", - "position": "Javascript Developer", + "position": "JavaScript Developer", "salary": "205500", "start_date": "2009-09-15", "extn": "2360", @@ -642,7 +642,7 @@ "first_name": "Jennifer", "last_name": "Acosta", "age": "43", - "position": "Junior Javascript Developer", + "position": "Junior JavaScript Developer", "salary": "75650", "start_date": "2013-02-01", "extn": "3431", @@ -720,7 +720,7 @@ "first_name": "Michael", "last_name": "Bruce", "age": "29", - "position": "Javascript Developer", + "position": "JavaScript Developer", "salary": "183000", "start_date": "2011-06-27", "extn": "5384", diff --git a/build/lib/DT_Example.php b/build/lib/DT_Example.php index ba359986..71807250 100644 --- a/build/lib/DT_Example.php +++ b/build/lib/DT_Example.php @@ -681,17 +681,17 @@ private function _resolve_framework_lib ( $framework, $type, $lib ) 'jquery' : 'dataTables'; - // Always include the core Javascript file. + // Always include the core JavaScript file. $out[] = $path.'/js/'.$jsBaseFilename.'.'.$filename.$min.'.js'; - // Possibly include a framework Javascript file. If the framework is + // Possibly include a framework JavaScript file. If the framework is // DataTables, then there will be no override JS file. if ( $framework !== 'dataTables' && $component['framework']['js'] ) { $out[] = $path.'/js/'.$filename.'.'.$framework.$min.'.js'; } } else if ( $type === 'css' ) { - // Possibly include a framework Javascript file. + // Possibly include a framework JavaScript file. if ( $component['framework']['css'] ) { $out[] = $path.'/css/'.$filename.'.'.$framework.$min.'.css'; } @@ -949,7 +949,7 @@ private function _libs_for_js () { Cedric Kelly -Senior Javascript Developer +Senior JavaScript Developer Edinburgh 29th Mar 12 $433,060 diff --git a/build/lib/DT_Markdown.php b/build/lib/DT_Markdown.php index 0a54dbcb..60836aa6 100644 --- a/build/lib/DT_Markdown.php +++ b/build/lib/DT_Markdown.php @@ -210,7 +210,7 @@ function _docLink ( $software, $type, $item, $html ) break; case 'js': // JS type - $lang = 'Javascript'; + $lang = 'JavaScript'; break; default: diff --git a/build/make.sh b/build/make.sh index a9850677..f73af9ad 100755 --- a/build/make.sh +++ b/build/make.sh @@ -343,7 +343,7 @@ function usage { - SearchPanes - StateRestore - js - Create the DataTables Javascript file + js - Create the DataTables JavaScript file serve - Run an HTTP server to allow the built examples to load diff --git a/build/templates/example.html b/build/templates/example.html index 9a657250..0821155d 100644 --- a/build/templates/example.html +++ b/build/templates/example.html @@ -38,7 +38,7 @@{software} example {title}
-
- Javascript
+- JavaScript
- HTML
- CSS
- Ajax
@@ -47,7 +47,7 @@{software} example {title}
--The Javascript shown below is used to initialise the table shown in this example:
+The JavaScript shown below is used to initialise the table shown in this example:
@@ -55,7 +55,7 @@{js-esc}
{software} example {title}
{js-vanilla-esc}
In addition to the above code, the following Javascript library files are loaded for use in this example:
+In addition to the above code, the following JavaScript library files are loaded for use in this example:
diff --git a/build/wrapper.js b/build/wrapper.js index f560ad58..e79a65f9 100644 --- a/build/wrapper.js +++ b/build/wrapper.js @@ -1,5 +1,5 @@ /** - * Create a loader wrapper around Javascript files + * Create a loader wrapper around JavaScript files */ const fs = require('fs'); diff --git a/descriptors/composer.json b/descriptors/composer.json index 15e2dcf3..d306dcc1 100644 --- a/descriptors/composer.json +++ b/descriptors/composer.json @@ -1,7 +1,7 @@ { "name": "datatables/datatables", "version": "_VERSION_", - "description": "DataTables is a plug-in for the jQuery Javascript library. It is a highly flexible tool, based upon the foundations of progressive enhancement, which will add advanced interaction controls to any HTML table.", + "description": "DataTables is a plug-in for the jQuery JavaScript library. It is a highly flexible tool, based upon the foundations of progressive enhancement, which will add advanced interaction controls to any HTML table.", "homepage": "https://www.datatables.net/", "author": "SpryMedia", "license": [ diff --git a/docs/api/DataTable.util.diacritics().xml b/docs/api/DataTable.util.diacritics().xml index 86a71aab..66a80620 100644 --- a/docs/api/DataTable.util.diacritics().xml +++ b/docs/api/DataTable.util.diacritics().xml @@ -34,7 +34,7 @@ This method exposes that ability for external use as well as the ability to replace the diacritic removal method that DataTables uses. - Our default method uses [the `normalize` method](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/normalize) in Javascript with a `NFD` normalisation form. The way this works is to decompose the accented character into a base ASCII character plus its accent as a second character. We then remove the accent characters. + Our default method uses [the `normalize` method](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/normalize) in JavaScript with a `NFD` normalisation form. The way this works is to decompose the accented character into a base ASCII character plus its accent as a second character. We then remove the accent characters. ]]> diff --git a/docs/api/DataTable.util.escapeRegex().xml b/docs/api/DataTable.util.escapeRegex().xml index fcab937f..f8fa6a9f 100644 --- a/docs/api/DataTable.util.escapeRegex().xml +++ b/docs/api/DataTable.util.escapeRegex().xml @@ -14,7 +14,7 @@- When working with regular expressions it can often be useful to escape input so formatted strings with characters that have special meaning in a regular expression will simply perform a character match. There are a number of special characters in Javascript's regular expressions and DataTables requires the ability to escape these strings internally (for user input of search data) - this method exposes that ability externally. + When working with regular expressions it can often be useful to escape input so formatted strings with characters that have special meaning in a regular expression will simply perform a character match. There are a number of special characters in JavaScript's regular expressions and DataTables requires the ability to escape these strings internally (for user input of search data) - this method exposes that ability externally. This is a utility method that is provided for use by extension and plug-in authors. Its use does not directly effect a DataTable or DataTables configuration. It is used internally by DataTables and is made available in the public API to help promote code reuse for extension authors. diff --git a/docs/api/DataTable.util.get().xml b/docs/api/DataTable.util.get().xml index 691e4d19..ab1b04fd 100644 --- a/docs/api/DataTable.util.get().xml +++ b/docs/api/DataTable.util.get().xml @@ -14,7 +14,7 @@ - It can often be useful in Javascript to write data location descriptors as a string, as we often do with JSON notation - e.g. `staff.name`, or having the flexibility of using a function to get arbitrary data. The DataTables `-init columns.data` and `-init columns.render` properties make use of this to be able to easily describe where data should be fetched from to display in a column. This method exposes that ability as part of the DataTables API for use in plug-ins and other libraries. + It can often be useful in JavaScript to write data location descriptors as a string, as we often do with JSON notation - e.g. `staff.name`, or having the flexibility of using a function to get arbitrary data. The DataTables `-init columns.data` and `-init columns.render` properties make use of this to be able to easily describe where data should be fetched from to display in a column. This method exposes that ability as part of the DataTables API for use in plug-ins and other libraries. The key point with this method is to remember that it will itself return a function, which you must then execute to be able to read the nested data - e.g.: diff --git a/docs/api/any().xml b/docs/api/any().xml index 9eff4277..2eae7606 100644 --- a/docs/api/any().xml +++ b/docs/api/any().xml @@ -13,7 +13,7 @@ It can be useful to know if an API instance contains any data so you can determine what action to take. For example, knowing if the table has any data in it, if a row selector finds any rows or if specific data is available in the table. - While with a standard Javascript `-type array` you can simply test for the `length` property being 0, that isn't always true with the DataTables API object as it is multi-table aware. This means that it can contain arrays of information from multiple tables, which may themselves be empty. + While with a standard JavaScript `-type array` you can simply test for the `length` property being 0, that isn't always true with the DataTables API object as it is multi-table aware. This means that it can contain arrays of information from multiple tables, which may themselves be empty. This method provides a quick test to see if there are any results available in the API instance. Its result could also be determined by using the `dt-api flatten()` method and then checking the resulting length (i.e. `api.flatten().length !== 0`). diff --git a/docs/api/cell().invalidate().xml b/docs/api/cell().invalidate().xml index c426138f..7a5d6d31 100644 --- a/docs/api/cell().invalidate().xml +++ b/docs/api/cell().invalidate().xml @@ -10,12 +10,12 @@Data source to read the new data from. - By default, DataTables will automatically read the new data for the row from the same source as it was originally read (i.e. DOM sourced or Javascript sourced) but this parameter can be used to override that and tell DataTables specifically which should be used to read in the new data. This might be useful if you are Ajax loading data but use the DOM to modify the contents of cells. + By default, DataTables will automatically read the new data for the row from the same source as it was originally read (i.e. DOM sourced or JavaScript sourced) but this parameter can be used to override that and tell DataTables specifically which should be used to read in the new data. This might be useful if you are Ajax loading data but use the DOM to modify the contents of cells. This property can take the values: * `-string auto` - use original data source - * `-string data` - use the Javascript data structure + * `-string data` - use the JavaScript data structure * `-string dom` - use the data currently held in the DOM DataTables API instance with selected cell reference in the result set diff --git a/docs/api/cells().invalidate().xml b/docs/api/cells().invalidate().xml index 772242ea..85dda72c 100644 --- a/docs/api/cells().invalidate().xml +++ b/docs/api/cells().invalidate().xml @@ -10,12 +10,12 @@Data source to read the new data from. - By default, DataTables will automatically read the new data for the row from the same source as it was originally read (i.e. DOM sourced or Javascript sourced) but this parameter can be used to override that and tell DataTables specifically which should be used to read in the new data. This might be useful if you are Ajax loading data but use the DOM to modify the contents of cells. + By default, DataTables will automatically read the new data for the row from the same source as it was originally read (i.e. DOM sourced or JavaScript sourced) but this parameter can be used to override that and tell DataTables specifically which should be used to read in the new data. This might be useful if you are Ajax loading data but use the DOM to modify the contents of cells. This property can take the values: * `-string auto` - use original data source - * `-string data` - use the Javascript data structure + * `-string data` - use the JavaScript data structure * `-string dom` - use the data currently held in the DOM DataTables API instance with selected cell references in the result set diff --git a/docs/api/each().xml b/docs/api/each().xml index 35221ec8..42080c22 100644 --- a/docs/api/each().xml +++ b/docs/api/each().xml @@ -20,11 +20,11 @@- This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the Javascript `Array` type. + This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the JavaScript `Array` type. Note that when working with the plural methods such as `dt-api rows()` and `dt-api columns()` you may wish to use the `dt-api rows().every()`, `dt-api columns().every()` and `dt-api cells().every()` methods to iterate over each row, column or cell with the context set to that table element. This might sound a little complicated, but it can significantly simplify your code! Please refer to the documentation for each of the `every` methods for full details. - The `dt-api each()` method is a proxy for the Javascript `Array.prototype.forEach` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `forEach`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach). In browsers which do not support `forEach` natively, a polyfill is provided to allow this DataTables method to operate as expected. + The `dt-api each()` method is a proxy for the JavaScript `Array.prototype.forEach` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `forEach`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach). In browsers which do not support `forEach` natively, a polyfill is provided to allow this DataTables method to operate as expected. This method will reduce a 2D array structure to a simple 1D structure, which can be particularly useful when working with the plural methods such as `dt-api rows()` and `dt-api columns()` which can return 2D structures data (for example in the columns data, each column has its own array of information). - This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the Javascript `Array` type. + This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the JavaScript `Array` type. i18n( token, def [, numeric ] ) Look up a language token that was defined in the DataTables' `dt-init language` initialisation object. - The language token to lookup from the language object. The token should be given in Javascript dotted object notation (as a _string_) which will be used by DataTables to lookup the resulting value. This value follows the same rules as `dt-init columns.data` as a string. + The language token to lookup from the language object. The token should be given in JavaScript dotted object notation (as a _string_) which will be used by DataTables to lookup the resulting value. This value follows the same rules as `dt-init columns.data` as a string. The default value to use if the DataTables initialisation has not specified a value. This can be a string for simple cases, or an object for plurals. diff --git a/docs/api/includes().xml b/docs/api/includes().xml index c6a612b9..7d39b3cc 100644 --- a/docs/api/includes().xml +++ b/docs/api/includes().xml @@ -16,7 +16,7 @@ You may find it useful to know if an API instance's result set contains a particular value. While that can be achieved readily with `-api indexOf()`, this utility method can be a useful short-cut if you don't need to know the value's location in the result set. - This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the Javascript `Array` type. + This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the JavaScript `Array` type. It is often very useful to know if a value is in a result set, and further, what its position is in the result set if it is present. This method provides exactly that ability, searching for the value given, starting from index 0 (see `dt-api lastIndexOf()` for starting at the end of the array) and giving its position in the result set. - This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the Javascript `Array` type. + This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the JavaScript `Array` type. - In this case, this method is a proxy for the Javascript `Array.prototype.indexOf` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `indexOf`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/indexOf). In browsers which do not support `indexOf` natively, a polyfill is provided to allow this DataTables method to operate as expected. + In this case, this method is a proxy for the JavaScript `Array.prototype.indexOf` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `indexOf`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/indexOf). In browsers which do not support `indexOf` natively, a polyfill is provided to allow this DataTables method to operate as expected. - This method operates in exactly the same way as the Javascript array `join` method, combining the contents of the array (in this case the API instance) into a single string. + This method operates in exactly the same way as the JavaScript array `join` method, combining the contents of the array (in this case the API instance) into a single string. - This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the Javascript `Array` type. + This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the JavaScript `Array` type. - In this case, this method is a proxy for the Javascript `Array.prototype.join` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for concat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/join). + In this case, this method is a proxy for the JavaScript `Array.prototype.join` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for concat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/join). It is often useful to know if a value is in a result set, and if so, which position it holds. This method provides exactly that ability, searching for the value given, starting from the last item in the instance's result set and working back through the result set (see `dt-api indexOf()` to search for the first instance of a value) and giving its position in the result set. - This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the Javascript `Array` type. + This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the JavaScript `Array` type. - In this case, this method is a proxy for the Javascript `Array.prototype.lastIndexOf` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `lastIndexOf`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/lastIndexOf). In browsers which do not support `lastIndexOf` natively, a polyfill is provided to allow this DataTables method to operate as expected. + In this case, this method is a proxy for the JavaScript `Array.prototype.lastIndexOf` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `lastIndexOf`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/lastIndexOf). In browsers which do not support `lastIndexOf` natively, a polyfill is provided to allow this DataTables method to operate as expected. This option defines the number of elements that are stored in an API instance's result set. - This property makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the Javascript `Array` type. + This property makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the JavaScript `Array` type. In this case, this property is basically the same as the `Array.length` property. For more information about the original property, please refer to the [Mozilla MDN documentation for `length`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/length). diff --git a/docs/api/map().xml b/docs/api/map().xml index f5529c28..2719fb2b 100644 --- a/docs/api/map().xml +++ b/docs/api/map().xml @@ -22,13 +22,13 @@ The `dt-api map()` method is useful for traversing a result set and creating a new instance, whose result set is defined by the values returned. As such any logic condition can be applied to the values of the original result set, transforming the data as required. - This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the Javascript `Array` type. + This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the JavaScript `Array` type. **Important compatibility note**: This method is implemented in the same way as the ECMA-262 5th edition `Array.prototype.map` method and is not identical to [jQuery's `$.map` method](https://api.jquery.com/jquery.map/). The key difference is in how the returned value is handled. The ECMAScript standard requires that the resulting array (DataTables API instance in this case) is of identical length as the input array, while that is not true in `$.map`. When using jQuery's `$.map` method `null` or `undefined` can be returned to remove an item from the resulting array. In ECMAScript, and this DataTables method, those values are used in the new instance. If you wish to remove items from the result set, use the `dt-api filter()` method. - This method is a proxy for the Javascript `Array.prototype.map` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `map`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map). In browsers which do not support `map` natively, a polyfill is provided to allow this DataTables method to operate as expected. + This method is a proxy for the JavaScript `Array.prototype.map` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `map`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map). In browsers which do not support `map` natively, a polyfill is provided to allow this DataTables method to operate as expected. 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. - As of DataTables 1.12 Javascript dot notation can also be used to read nested JSON data. All of the options offered by `-api DataTable.util.get()` can get used. + As of DataTables 1.12 JavaScript dot notation can also be used to read nested JSON data. All of the options offered by `-api DataTable.util.get()` can get used. New API instance with the values in the result retrieved from the source object properties defined by the property being plucked. @@ -18,7 +18,7 @@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 inherit a lot of the abilities and methods of the Javascript `Array` type. + This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the JavaScript `Array` type. - Just as with Javascript arrays', since the DataTables API object is "array like", items can be removed from a result set using this method. *Popping* a result, pops it off the end. The API instance's result set is reduced in length by 1 and the item that was removed is returned from the function call. `dt-api shift()` can be used to perform the same action, but at the start of the array, if required. + Just as with JavaScript arrays', since the DataTables API object is "array like", items can be removed from a result set using this method. *Popping* a result, pops it off the end. The API instance's result set is reduced in length by 1 and the item that was removed is returned from the function call. `dt-api shift()` can be used to perform the same action, but at the start of the array, if required. - This method is a proxy for the Javascript `Array.prototype.pop` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `pop`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/pop). + This method is a proxy for the JavaScript `Array.prototype.pop` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `pop`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/pop). - Just as with Javascript arrays', since the DataTables API object is "array like", items can be added to a result set using this method. *Pushing* an item onto an API instance adds it to the end of the result set. Items can be added at the start of the result set using `dt-api unshift()` if required. + Just as with JavaScript arrays', since the DataTables API object is "array like", items can be added to a result set using this method. *Pushing* an item onto an API instance adds it to the end of the result set. Items can be added at the start of the result set using `dt-api unshift()` if required. - This method is a proxy for the Javascript `Array.prototype.push` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `push`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/push). + This method is a proxy for the JavaScript `Array.prototype.push` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `push`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/push). This method will quite simply take the elements in an API instance's result set and reverse the order of those element, in place. This is particularly used when used with the `dt-api sort()` method. - This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the Javascript `Array` type. + This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the JavaScript `Array` type. - In this case, this method is a proxy for the Javascript `Array.prototype.reverse` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `reverse`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/reverse). + In this case, this method is a proxy for the JavaScript `Array.prototype.reverse` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `reverse`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/reverse). row().data( d ) Set the data for the selected row - Data to use for the row. This may be an array, object or Javascript object instance, but must be in the same format as the other data in the table (i.e. if your table uses objects, pass in an object here!). + Data to use for the row. This may be an array, object or JavaScript object instance, but must be in the same format as the other data in the table (i.e. if your table uses objects, pass in an object here!). DataTables API instance with the row retrieved by the selector in the result set. diff --git a/docs/api/row().invalidate().xml b/docs/api/row().invalidate().xml index 5e6cd728..fa9888d8 100644 --- a/docs/api/row().invalidate().xml +++ b/docs/api/row().invalidate().xml @@ -11,12 +11,12 @@Data source to read the new data from. - By default, DataTables will automatically read the new data for the row from the same source as it was originally read (i.e. DOM sourced or Javascript sourced) but this parameter can be used to override that and tell DataTables specifically which should be used to read in the new data. This might be useful if you are Ajax loading data but use the DOM to modify the contents of cells. + By default, DataTables will automatically read the new data for the row from the same source as it was originally read (i.e. DOM sourced or JavaScript sourced) but this parameter can be used to override that and tell DataTables specifically which should be used to read in the new data. This might be useful if you are Ajax loading data but use the DOM to modify the contents of cells. This property can take the values: * `-string auto` - use original data source - * `-string data` - use the Javascript data structure + * `-string data` - use the JavaScript data structure * `-string dom` - use the data currently held in the DOM DataTables API instance with selected row reference in the result set diff --git a/docs/api/row.add().xml b/docs/api/row.add().xml index 934f4bfb..750f456a 100644 --- a/docs/api/row.add().xml +++ b/docs/api/row.add().xml @@ -9,7 +9,7 @@Add a new row to the table using the given data Select a row found by a row selector - Data to use for the new row. This may be an array, object, Javascript object instance or a `-tag tr` element. If a data structure is used (i.e. array or object) it must be in the same format as the other data in the table (i.e. if your table uses objects, pass in an object with the same properties here!). + Data to use for the new row. This may be an array, object, JavaScript object instance or a `-tag tr` element. If a data structure is used (i.e. array or object) it must be in the same format as the other data in the table (i.e. if your table uses objects, pass in an object with the same properties here!). DataTables API instance with the newly added row in its result set. diff --git a/docs/api/rows().data().xml b/docs/api/rows().data().xml index 75cbeb31..5519b7e5 100644 --- a/docs/api/rows().data().xml +++ b/docs/api/rows().data().xml @@ -7,7 +7,7 @@ rows().data() Get the data for the rows from the selector -DataTables API instance with data for each row from the selector in the result set. Each entry is the original data source object for that row, be it an array, object or Javascript object instance. +DataTables API instance with data for each row from the selector in the result set. Each entry is the original data source object for that row, be it an array, object or JavaScript object instance. diff --git a/docs/api/rows().invalidate().xml b/docs/api/rows().invalidate().xml index 5a617fe0..17c64d9c 100644 --- a/docs/api/rows().invalidate().xml +++ b/docs/api/rows().invalidate().xml @@ -10,12 +10,12 @@ Data source to read the new data from. - By default, DataTables will automatically read the new data for the row from the same source as it was originally read (i.e. DOM sourced or Javascript sourced) but this parameter can be used to override that and tell DataTables specifically which should be used to read in the new data. This might be useful if you are Ajax loading data but use the DOM to modify the contents of cells. + By default, DataTables will automatically read the new data for the row from the same source as it was originally read (i.e. DOM sourced or JavaScript sourced) but this parameter can be used to override that and tell DataTables specifically which should be used to read in the new data. This might be useful if you are Ajax loading data but use the DOM to modify the contents of cells. This property can take the values: * `-string auto` - use original data source - * `-string data` - use the Javascript data structure + * `-string data` - use the JavaScript data structure * `-string dom` - use the data currently held in the DOM DataTables API instance with selected row references in the result set diff --git a/docs/api/rows.add().xml b/docs/api/rows.add().xml index 0c1da345..e257011b 100644 --- a/docs/api/rows.add().xml +++ b/docs/api/rows.add().xml @@ -9,7 +9,7 @@Add new rows to the table using the data given Select a row found by a row selector - Array of data elements, with each one describing a new row to be added to the table (i.e. `data.length` is the number of new rows that will be added to the table). Each data element may be an array, object, Javascript object instance or a `-tag tr` element. The data structure given must be in the same format as the other data in the table (i.e. if your table uses objects, pass in an object here!). + Array of data elements, with each one describing a new row to be added to the table (i.e. `data.length` is the number of new rows that will be added to the table). Each data element may be an array, object, JavaScript object instance or a `-tag tr` element. The data structure given must be in the same format as the other data in the table (i.e. if your table uses objects, pass in an object here!). DataTables API instance with the newly added rows in its result set. diff --git a/docs/api/shift().xml b/docs/api/shift().xml index 8ab5cfbf..6a7bb8b7 100644 --- a/docs/api/shift().xml +++ b/docs/api/shift().xml @@ -11,9 +11,9 @@- Just as with Javascript arrays, since the DataTables API object is "array like", items can be removed from a result set using this method. *Shifting* a result, shifts the item off the start of the result set. The API instance's result set is reduced in length by 1 and the item that was removed is returned from the function call. `dt-api pop()` can be used to perform the same action, but at the end of the array, if required. + Just as with JavaScript arrays, since the DataTables API object is "array like", items can be removed from a result set using this method. *Shifting* a result, shifts the item off the start of the result set. The API instance's result set is reduced in length by 1 and the item that was removed is returned from the function call. `dt-api pop()` can be used to perform the same action, but at the end of the array, if required. - This method is a proxy for the Javascript `Array.prototype.shift` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `shift`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/shift). + This method is a proxy for the JavaScript `Array.prototype.shift` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `shift`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/shift). - The DataTables API object is "array like" and inherits many of the same characteristics as a Javascript array. The `-api slice()` method is one of these. It provides the ability to create an independent copy of the instance so it can be manipulated without affecting the original. + The DataTables API object is "array like" and inherits many of the same characteristics as a JavaScript array. The `-api slice()` method is one of these. It provides the ability to create an independent copy of the instance so it can be manipulated without affecting the original. - This method is a proxy for the Javascript `Array.prototype.slice` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `slice`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/slice). + This method is a proxy for the JavaScript `Array.prototype.slice` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `slice`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/slice). sort( [ fn ] ) Sort the elements of the API instance's result set. - This is a standard Javascript sort comparison function. It accepts two parameters: + This is a standard JavaScript sort comparison function. It accepts two parameters: * Value 1 to compare * Value 2 to compare @@ -21,9 +21,9 @@ The `dt-api sort()` method provides a way of sorted the data in an API instance's result set, which can be particularly useful if you then want to use that data for displaying to the end user - for example as a `dt-tag select` list for a search input. This method should not be confused with `dt-api order()` which is used to order for records in the DataTable. - This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the Javascript `Array` type. + This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the JavaScript `Array` type. - In this case, this method is a proxy for the Javascript `Array.prototype.sort` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `sort`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort). + In this case, this method is a proxy for the JavaScript `Array.prototype.sort` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `sort`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort). The methods of `dt-api pop()`, `dt-api shift()` etc can be useful to modify an Api instance's result set, but they are restricted to operating at the start of the end of the result set. This method can be used to modify the result set at any point. - This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the Javascript `Array` type. + This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the JavaScript `Array` type. - In this case, this method is a proxy for the Javascript `Array.prototype.splice` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `splice`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/splice). + In this case, this method is a proxy for the JavaScript `Array.prototype.splice` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `splice`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/splice). table().footer.structure() -Get a Javascript representation of the table footer structure +Get a JavaScript representation of the table footer structure 2.0 @@ -19,7 +19,7 @@ @@ -27,7 +27,7 @@ Please refer to the [server-side processing documentation](https://datatables.net/manual/server-side) for a full description of these parameters. - Each mapping value may be a string in Javascript dotted object notation or a function. If a function a single parameter is passed in, the JSON response from the server, and the return value should be the value for the parameter. + Each mapping value may be a string in JavaScript dotted object notation or a function. If a function a single parameter is passed in, the JSON response from the server, and the return value should be the value for the parameter. @@ -42,7 +42,7 @@diff --git a/docs/api/table().header.structure().xml b/docs/api/table().header.structure().xml index 83821cff..41a36442 100644 --- a/docs/api/table().header.structure().xml +++ b/docs/api/table().header.structure().xml @@ -1,7 +1,7 @@ table().header.structure() -Get a Javascript representation of the table header structure +Get a JavaScript representation of the table header structure 2.0 @@ -19,7 +19,7 @@ diff --git a/docs/option/ajax.dataSrc.xml b/docs/option/ajax.dataSrc.xml index e9d49475..528bd857 100644 --- a/docs/option/ajax.dataSrc.xml +++ b/docs/option/ajax.dataSrc.xml @@ -10,7 +10,7 @@ Note that if your Ajax source simply returns an array of data to display, rather than an object, set this parameter to be an empty string. - Additionally you can use Javascript dotted object notation to get a data source for multiple levels of object / array nesting. + Additionally you can use JavaScript dotted object notation to get a data source for multiple levels of object / array nesting.toArray() -Create a native Javascript array object from an API instance. +Create a native JavaScript array object from an API instance. 1.10 toArray() -Create a native Javascript array from an API instance. -Javascript array which contains the values from the API instance's result set. +Create a native JavaScript array from an API instance. +JavaScript array which contains the values from the API instance's result set. - The DataTables API object provides a lot of the methods that you would expect to find in a native Javascript array and generally acts a lot like an array, but there are times when you want to work directly with a Javascript array rather than a DataTables API instance. This method can be used to create a native Javascript array which contains the same items as contained in the API instance's result set. + The DataTables API object provides a lot of the methods that you would expect to find in a native JavaScript array and generally acts a lot like an array, but there are times when you want to work directly with a JavaScript array rather than a DataTables API instance. This method can be used to create a native JavaScript array which contains the same items as contained in the API instance's result set. - This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the Javascript `Array` type. + This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the JavaScript `Array` type. It is often useful to know what data is available in a result set, with duplicate items removed (for example creating a `dt-tag select` list for use as a search input). Although unique items can be found quite trivially with a loop, this utility function provides that ability for you in one simple method. - This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the Javascript `Array` type. + This method makes use of the fact that DataTables API objects are "array like", in that they inherit a lot of the abilities and methods of the JavaScript `Array` type. - Just as with Javascript arrays', since the DataTables API object is "array like", items can be added to a result set using this method. *Unshifting* an item onto an API instance adds it to the start of the result set. Items can be added at the end of the result set using `dt-api push()` if required. + Just as with JavaScript arrays', since the DataTables API object is "array like", items can be added to a result set using this method. *Unshifting* an item onto an API instance adds it to the start of the result set. Items can be added at the end of the result set using `dt-api push()` if required. - This method is a proxy for the Javascript `Array.prototype.unshift` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `unshift`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/unshift). + This method is a proxy for the JavaScript `Array.prototype.unshift` method and is provided as a utility method for the DataTables API. For more information about the original method, please refer to the [Mozilla MDN documentation for `unshift`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/unshift). As a function `dataSrc` provides the ability to manipulate the data returned from the server from one form into another. For example, if your data is split over multiple arrays you might combine it into a single array to return for processing and display by DataTables. - In this form `dataSrc` can be used to transform any data source, such as non-JSON data (XML, YAML, etc) into the Javascript array that DataTables expects. + In this form `dataSrc` can be used to transform any data source, such as non-JSON data (XML, YAML, etc) into the JavaScript array that DataTables expects. diff --git a/docs/option/ajax.xml b/docs/option/ajax.xml index 55e868ac..f6303884 100644 --- a/docs/option/ajax.xml +++ b/docs/option/ajax.xml @@ -38,7 +38,7 @@ * `data` (`dt-init ajax.data`) - As with jQuery, `data` can be provided as an object, but as an extension, it can also be provided as a function to manipulate the data DataTables sends to the server. The function takes a single parameter, an object where the parameters are name / value pairs that DataTables has readied for sending. An object may be returned which will be use used as the data to send to the server (therefore, if you wish to use the DataTables set parameters, you must merge them in your function), or you can add the items to the object that was passed in and not return anything from the function. This supersedes `fnServerParams` from DataTables 1.9-. * `dataSrc` (`dt-init ajax.dataSrc`) - By default DataTables will look for the property `data` (or `aaData` for compatibility with DataTables 1.9-) when obtaining data from an Ajax source or for server-side processing - this parameter allows that property to be changed, through two different forms: - * As a string - define the property from the object to read. Note that if your Ajax source simply returns an array of data to display, rather than an object, set this parameter to be an empty string. Additionally you can use Javascript dotted object notation to get a data source for multiple levels of object / array nesting. + * As a string - define the property from the object to read. Note that if your Ajax source simply returns an array of data to display, rather than an object, set this parameter to be an empty string. Additionally you can use JavaScript dotted object notation to get a data source for multiple levels of object / array nesting. * As a function - As a function it takes a single parameter, the JSON returned from the server, which can be manipulated as required. The returned value from the function is what will be used by DataTables as the data source for the table. * This supersedes `sAjaxDataProp` from DataTables 1.9-. * `submitAs` (`-init ajax.submitAs`) - Instruct the Ajax request to send the data to the server as HTTP parameters (default), or as a JSON string (since DataTables 2.3). diff --git a/docs/option/columns.className.xml b/docs/option/columns.className.xml index 6a1168d2..87f46d58 100644 --- a/docs/option/columns.className.xml +++ b/docs/option/columns.className.xml @@ -7,7 +7,7 @@- Quite simply this option adds a class to each cell in a column, regardless of if the table source is from DOM, Javascript or Ajax. This can be useful for styling columns. + Quite simply this option adds a class to each cell in a column, regardless of if the table source is from DOM, JavaScript or Ajax. This can be useful for styling columns. Read and write an object property to and from the data source. There are three 'special' options that can be used in the string to alter how DataTables reads the data from the source object: - * `.` - Dotted Javascript notation. Just as you use a `.` in Javascript to read from nested objects, so to can the options specified in `data`. For example: `browser.version` or `browser.name`. If your object parameter name contains a period, use `\\` to escape it - i.e. `first\\.name`. + * `.` - Dotted JavaScript notation. Just as you use a `.` in JavaScript to read from nested objects, so to can the options specified in `data`. For example: `browser.version` or `browser.name`. If your object parameter name contains a period, use `\\` to escape it - i.e. `first\\.name`. * `[]` - Array notation. DataTables can automatically combine data from an array source, joining the data with the characters provided between the two brackets. For example: `name[, ]` would provide a comma-space separated list from the source array. If no characters are provided between the brackets, the original array source is returned. * `()` - Function notation. Adding `()` to the end of a parameter will execute a function of the name given. For example: `browser()` for a simple function on the data source, `browser.version()` for a function in a nested property or even `browser().version` to get an object property if the function called returns an object. Note that function notation is recommended for use in `render` rather than `data` as it is much simpler to use as a renderer. @@ -67,7 +67,7 @@ This function might be called multiple times, as DataTables will call it for the different data types that it needs - sorting, filtering and display. - Please note that DataTables will call the function as a _setter_ when a new row is added only when the row's data is read from the DOM (i.e. the table is initialised on a pre-populated HTML table). The function is not called as setter when the data is source from Javascript or Ajax under the assumption that the data is already in the format required. + Please note that DataTables will call the function as a _setter_ when a new row is added only when the row's data is read from the DOM (i.e. the table is initialised on a pre-populated HTML table). The function is not called as setter when the data is source from JavaScript or Ajax under the assumption that the data is already in the format required. HTML table element diff --git a/docs/option/columns.orderable.xml b/docs/option/columns.orderable.xml index 3a6f888a..08db1f56 100644 --- a/docs/option/columns.orderable.xml +++ b/docs/option/columns.orderable.xml @@ -23,7 +23,7 @@ The `data-dt-order` option can be applied to a `-tag tr` element in the table header, as well as the individual cells. If applied to the `-tag tr` the configuration given will cascade down to all cells in that row. - The `data-dt-order` property is the only option that DataTables has which cannot be set via Javascript and is read from the DOM (you could use Javascript to add the attributes before table initialisation if you require). In future, we may offer the ability to construct a complex header via the initialisation options, which would also address this. + The `data-dt-order` property is the only option that DataTables has which cannot be set via JavaScript and is read from the DOM (you could use JavaScript to add the attributes before table initialisation if you require). In future, we may offer the ability to construct a complex header via the initialisation options, which would also address this.Read an object property from the data source. There are three 'special' options that can be used in the string to alter how DataTables reads the data from the source object: - * `.` - Dotted Javascript notation. Just as you use a `.` in Javascript to read from nested objects, so you can use the options specified in `data`. For example: `browser.version` or `browser.name`. If your object parameter name contains a period, use `\\` to escape it - i.e. `first\\.name`. + * `.` - Dotted JavaScript notation. Just as you use a `.` in JavaScript to read from nested objects, so you can use the options specified in `data`. For example: `browser.version` or `browser.name`. If your object parameter name contains a period, use `\\` to escape it - i.e. `first\\.name`. * `[]` - Array notation. DataTables can automatically combine data from an array source, joining the data with the characters provided between the two brackets. For example: `name[, ]` would provide a comma-space separated list from the source array. If no characters are provided between the brackets, the original array source is returned. See above for further information on array access. @@ -40,7 +40,7 @@ - DataTables has a number of [built in helper rendering functions](/manual/data/renderers#Built-in-helpers) that can be used to perform basic formatting. These helpers can be accessed from `$.fn.dataTable.render` and will resolve to a function (see below) that will be used for the data rendering. This works very well when you define the columns in pure Javascript, but if you wish to define them with JSON, since there is no ability to define functions in JSON we need a different method - the array values provide that ability. + DataTables has a number of [built in helper rendering functions](/manual/data/renderers#Built-in-helpers) that can be used to perform basic formatting. These helpers can be accessed from `$.fn.dataTable.render` and will resolve to a function (see below) that will be used for the data rendering. This works very well when you define the columns in pure JavaScript, but if you wish to define them with JSON, since there is no ability to define functions in JSON we need a different method - the array values provide that ability. The first element of the array should be a string that contains the rendering function's name. The remaining elements of the array are then passed to the specified rendering function. diff --git a/docs/option/data.xml b/docs/option/data.xml index 55d170c7..84faaec0 100644 --- a/docs/option/data.xml +++ b/docs/option/data.xml @@ -9,7 +9,7 @@ DataTables can obtain the data it is to display in the table's body from a number of sources, including being passed in as an array of row data using this initialisation parameter. As with other dynamic data sources, arrays or objects can be used for the data source for each row, with `dt-init columns.data` employed to read from specific object properties. - Using this initialisation option can be useful when creating a table from a Javascript data source, or from a custom Ajax data get. + Using this initialisation option can be useful when creating a table from a JavaScript data source, or from a custom Ajax data get. Note that if `dt-init data` is specified, the data given in the array will replace any information that was found in the table's DOM when initialised. diff --git a/docs/option/deferRender.xml b/docs/option/deferRender.xml index 7b2f538f..70b20f57 100644 --- a/docs/option/deferRender.xml +++ b/docs/option/deferRender.xml @@ -11,7 +11,7 @@ ⎖) or a dash (`-`) are often used to show the decimal place in a displayed number. + A dot (`.`) is used to mark the decimal place in JavaScript, however, [many parts of the world use a comma](https://en.wikipedia.org/wiki/Decimal_mark) (`,`) and other characters such as the Unicode decimal separator (⎖
) or a dash (`-`) are often used to show the decimal place in a displayed number. - When reading such numbers, Javascript won't automatically recognise them as numbers, however, DataTables' type detection and sorting methods can be instructed through the `dt-init language.decimal` option which character is used as the decimal place in your numbers. This will be used to correctly adjust DataTables' type detection and sorting algorithms to sort numbers in your table. + When reading such numbers, JavaScript won't automatically recognise them as numbers, however, DataTables' type detection and sorting methods can be instructed through the `dt-init language.decimal` option which character is used as the decimal place in your numbers. This will be used to correctly adjust DataTables' type detection and sorting algorithms to sort numbers in your table. This option is a little unusual as DataTables will never display a formatted, floating point number (it has no need to!) so this option only effects how it parses the read data (none of the other language options have this ability). diff --git a/docs/option/rowId.xml b/docs/option/rowId.xml index cd7af8fd..e3e56c55 100644 --- a/docs/option/rowId.xml +++ b/docs/option/rowId.xml @@ -10,7 +10,7 @@It can often be useful to have a [`id` attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/id) on each `-tag tr` element in a DataTable for row selection and data source identification, particularly when using events. - DataTables will attempt to automatically read an id value from the data source for each row using the property defined by this option. By default it is `DT_RowId` but can be set to any other name. As with `dt-init columns.data` it can also read from a nested JSON data source by using Javascript dotted object notation (e.g. `DT_RowId: 'image.id'`). + DataTables will attempt to automatically read an id value from the data source for each row using the property defined by this option. By default it is `DT_RowId` but can be set to any other name. As with `dt-init columns.data` it can also read from a nested JSON data source by using JavaScript dotted object notation (e.g. `DT_RowId: 'image.id'`). If no id value for the row is found, the `id` property will not be automatically set. diff --git a/docs/type/DataTables.Api.xml b/docs/type/DataTables.Api.xml index 1aeb45cc..e29dc81b 100644 --- a/docs/type/DataTables.Api.xml +++ b/docs/type/DataTables.Api.xml @@ -11,7 +11,7 @@ The DataTables API provides the ability to programmatically control one or more ## API structure -The API object is _array-like_, in that it has a `length` property, elements in its result set can be accessed using Javascript array notation (`[]`) and it provides many (although not all) of the same methods as an `dt-type array` (for example `dt-api push()` and `dt-api indexOf()`). +The API object is _array-like_, in that it has a `length` property, elements in its result set can be accessed using JavaScript array notation (`[]`) and it provides many (although not all) of the same methods as an `dt-type array` (for example `dt-api push()` and `dt-api indexOf()`). ## Accessing the API diff --git a/docs/type/DataTables.Type.xml b/docs/type/DataTables.Type.xml index 6053589d..26baa785 100644 --- a/docs/type/DataTables.Type.xml +++ b/docs/type/DataTables.Type.xml @@ -70,7 +70,7 @@ Ordering in DataTables is done by the `pre`, `asc` and `desc` functions defined Each of these functions is optional and you may use one of the following combinations: * `pre` only - ordering will be done using the DataTables default sort on the returned data. -* `asc` and `desc` only - [standard Javascript sorting functions](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort). +* `asc` and `desc` only - [standard JavaScript sorting functions](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort). * All three - the preformatted data will be passed into the custom ordering methods. It is strongly recommended that you provide a `pre` method if you need to transform the data from the original data type into something that the ordering methods will use. This is because the `pre` function is run only once per data point while ordering, while the `asc` and `desc` ordering methods might be called multiple times per data point. diff --git a/docs/type/array.xml b/docs/type/array.xml index da2389ae..90d67f92 100644 --- a/docs/type/array.xml +++ b/docs/type/array.xml @@ -1,12 +1,12 @@ array -Javascript `Array` type +JavaScript `Array` type boolean -Javascript `Boolean` type +JavaScript `Boolean` type function -Javascript `Function` +JavaScript `Function` integer -Subset of the Javascript `Number` type using only integers +Subset of the JavaScript `Number` type using only integers null -Javascript `null` type +JavaScript `null` type number -Javascript `Number` type +JavaScript `Number` type object -Javascript `Object` type +JavaScript `Object` type diff --git a/docs/type/string.xml b/docs/type/string.xml index eb7e4320..aabb6896 100644 --- a/docs/type/string.xml +++ b/docs/type/string.xml @@ -1,12 +1,12 @@ string -Javascript `String` type +JavaScript `String` type undefined -Javascript `undefined` type +JavaScript `undefined` type Cedric Kelly -Senior Javascript Developer +Senior JavaScript Developer Edinburgh 22 2012/03/29 @@ -116,7 +116,7 @@ The table below shows the use of `dt-init pageLength` and `dt-init order` on theColleen Hurst -Javascript Developer +JavaScript Developer San Francisco 39 2009/09/15 @@ -444,7 +444,7 @@ The table below shows the use of `dt-init pageLength` and `dt-init order` on theJennifer Acosta -Junior Javascript Developer +Junior JavaScript Developer Edinburgh 43 2013/02/01 @@ -492,7 +492,7 @@ The table below shows the use of `dt-init pageLength` and `dt-init order` on theMichael Bruce -Javascript Developer +JavaScript Developer Singapore 29 2011/06/27 diff --git a/examples/advanced_init/object_dom_read.xml b/examples/advanced_init/object_dom_read.xml index f666a7d7..874b5777 100644 --- a/examples/advanced_init/object_dom_read.xml +++ b/examples/advanced_init/object_dom_read.xml @@ -34,13 +34,13 @@ new DataTable('#example', {diff --git a/examples/i18n/comma-decimal.xml b/examples/i18n/comma-decimal.xml index 774375c0..0ec3ef63 100644 --- a/examples/i18n/comma-decimal.xml +++ b/examples/i18n/comma-decimal.xml @@ -27,9 +27,9 @@ new DataTable('#example', { - Javascript sourced data +JavaScript sourced data ⎖) or a dash (`-`) are often used to show the decimal place in a displayed number. +A dot (`.`) is used to mark the decimal place in JavaScript, however, [many parts of the world use a comma](https://en.wikipedia.org/wiki/Decimal_mark) (`,`) and other characters such as the Unicode decimal separator ( ⎖
) or a dash (`-`) are often used to show the decimal place in a displayed number. -When reading such numbers, Javascript won't automatically recognise them as numbers, however, DataTables' type detection and sorting methods can be instructed through the `dt-init language.decimal` option which character is used as the decimal place in your numbers. This will be used to correctly adjust DataTables' type detection and sorting algorithms to sort numbers in your table. +When reading such numbers, JavaScript won't automatically recognise them as numbers, however, DataTables' type detection and sorting methods can be instructed through the `dt-init language.decimal` option which character is used as the decimal place in your numbers. This will be used to correctly adjust DataTables' type detection and sorting algorithms to sort numbers in your table. Any character can be passed in using the `dt-init language.decimal` option, although the decimal place character used in a single table must be consistent (i.e. numbers with a dot decimal place and comma decimal place cannot both appear in the same table). Different tables on the same page can use different decimal characters if required. diff --git a/examples/i18n/datetime.xml b/examples/i18n/datetime.xml index 38340a5d..d08827b9 100644 --- a/examples/i18n/datetime.xml +++ b/examples/i18n/datetime.xml @@ -31,7 +31,7 @@ new DataTable('#example', {diff --git a/examples/server_side/ids.xml b/examples/server_side/ids.xml index 8aa55b5d..03df0ffc 100644 --- a/examples/server_side/ids.xml +++ b/examples/server_side/ids.xml @@ -41,7 +41,7 @@ new DataTable('#example', { Cedric Kelly -Senior Javascript Developer +Senior JavaScript Developer Edinburgh 22 2012-03-29 @@ -86,7 +86,7 @@Colleen Hurst -Javascript Developer +JavaScript Developer San Francisco 39 2009-09-15 @@ -414,7 +414,7 @@Jennifer Acosta -Junior Javascript Developer +Junior JavaScript Developer Edinburgh 43 2013-02-01 @@ -462,7 +462,7 @@Michael Bruce -Javascript Developer +JavaScript Developer Singapore 29 2011-06-27 diff --git a/test/html/basic.html b/test/html/basic.html index 9677e39e..8137ee31 100644 --- a/test/html/basic.html +++ b/test/html/basic.html @@ -46,7 +46,7 @@Cedric Kelly -Senior Javascript Developer +Senior JavaScript Developer Edinburgh 22 2012/03/29 @@ -86,7 +86,7 @@Colleen Hurst -Javascript Developer +JavaScript Developer San Francisco 39 2009/09/15 @@ -414,7 +414,7 @@Jennifer Acosta -Junior Javascript Developer +Junior JavaScript Developer Edinburgh 43 2013/02/01 @@ -462,7 +462,7 @@Michael Bruce -Javascript Developer +JavaScript Developer Singapore 29 2011/06/27 diff --git a/test/html/basic_container.html b/test/html/basic_container.html index c21fa4a3..b785cf7f 100644 --- a/test/html/basic_container.html +++ b/test/html/basic_container.html @@ -47,7 +47,7 @@Cedric Kelly -Senior Javascript Developer +Senior JavaScript Developer Edinburgh 22 2012/03/29 @@ -87,7 +87,7 @@Colleen Hurst -Javascript Developer +JavaScript Developer San Francisco 39 2009/09/15 @@ -415,7 +415,7 @@Jennifer Acosta -Junior Javascript Developer +Junior JavaScript Developer Edinburgh 43 2013/02/01 @@ -463,7 +463,7 @@Michael Bruce -Javascript Developer +JavaScript Developer Singapore 29 2011/06/27 diff --git a/test/html/basic_id.html b/test/html/basic_id.html index ec7419d0..3a002a62 100644 --- a/test/html/basic_id.html +++ b/test/html/basic_id.html @@ -46,7 +46,7 @@Cedric Kelly -Senior Javascript Developer +Senior JavaScript Developer Edinburgh 22 2012/03/29 @@ -86,7 +86,7 @@Colleen Hurst -Javascript Developer +JavaScript Developer San Francisco 39 2009/09/15 @@ -414,7 +414,7 @@Jennifer Acosta -Junior Javascript Developer +Junior JavaScript Developer Edinburgh 43 2013/02/01 @@ -462,7 +462,7 @@Michael Bruce -Javascript Developer +JavaScript Developer Singapore 29 2011/06/27 diff --git a/test/html/basic_wide.html b/test/html/basic_wide.html index d0d953b3..a5db928a 100644 --- a/test/html/basic_wide.html +++ b/test/html/basic_wide.html @@ -57,7 +57,7 @@Cedric Kelly -Senior Javascript Developer +Senior JavaScript Developer Edinburgh 22 2012/03/29 @@ -122,7 +122,7 @@Colleen Hurst -Javascript Developer +JavaScript Developer San Francisco 39 2009/09/15 @@ -655,7 +655,7 @@Jennifer Acosta -Junior Javascript Developer +Junior JavaScript Developer Edinburgh 43 2013/02/01 @@ -733,7 +733,7 @@Michael Bruce -Javascript Developer +JavaScript Developer Singapore 29 2011/06/27 diff --git a/test/html/complex-header-footer.html b/test/html/complex-header-footer.html index e9116a6f..d1f9649f 100644 --- a/test/html/complex-header-footer.html +++ b/test/html/complex-header-footer.html @@ -48,7 +48,7 @@Cedric Kelly -Senior Javascript Developer +Senior JavaScript Developer Edinburgh 22 2012/03/29 @@ -88,7 +88,7 @@Colleen Hurst -Javascript Developer +JavaScript Developer San Francisco 39 2009/09/15 @@ -416,7 +416,7 @@Jennifer Acosta -Junior Javascript Developer +Junior JavaScript Developer Edinburgh 43 2013/02/01 @@ -464,7 +464,7 @@Michael Bruce -Javascript Developer +JavaScript Developer Singapore 29 2011/06/27 diff --git a/test/html/dates_non_std.html b/test/html/dates_non_std.html index 4662003b..3d301023 100644 --- a/test/html/dates_non_std.html +++ b/test/html/dates_non_std.html @@ -46,7 +46,7 @@Cedric Kelly -Senior Javascript Developer +Senior JavaScript Developer Edinburgh 22 29 Mar 2012 @@ -86,7 +86,7 @@Colleen Hurst -Javascript Developer +JavaScript Developer San Francisco 39 15 Sep 2009 @@ -414,7 +414,7 @@Jennifer Acosta -Junior Javascript Developer +Junior JavaScript Developer Edinburgh 43 1 Feb 2013 @@ -462,7 +462,7 @@Michael Bruce -Javascript Developer +JavaScript Developer Singapore 29 27 Jun 2011 diff --git a/test/html/html.html b/test/html/html.html index e097c7e9..e9be81c7 100644 --- a/test/html/html.html +++ b/test/html/html.html @@ -46,7 +46,7 @@Cedric Kelly -Senior Javascript Developer +Senior JavaScript Developer Edinburgh 22 2012/03/29 @@ -86,7 +86,7 @@Colleen Hurst -Javascript Developer +JavaScript Developer San Francisco 39 2009/09/15 @@ -414,7 +414,7 @@Jennifer Acosta -Junior Javascript Developer +Junior JavaScript Developer Edinburgh 43 2013/02/01 @@ -462,7 +462,7 @@Michael Bruce -Javascript Developer +JavaScript Developer Singapore 29 2011/06/27 diff --git a/test/html/html5.html b/test/html/html5.html index fc9f0785..f1a18aa2 100644 --- a/test/html/html5.html +++ b/test/html/html5.html @@ -46,7 +46,7 @@Cedric Kelly -Senior Javascript Developer +Senior JavaScript Developer Edinburgh 22 2012/03/29 @@ -86,7 +86,7 @@Colleen Hurst -Javascript Developer +JavaScript Developer San Francisco 39 2009/09/15 @@ -414,7 +414,7 @@Jennifer Acosta -Junior Javascript Developer +Junior JavaScript Developer Edinburgh 43 2013/02/01 @@ -462,7 +462,7 @@Michael Bruce -Javascript Developer +JavaScript Developer Singapore 29 2011/06/27 diff --git a/test/html/liveOrder.html b/test/html/liveOrder.html index 83b660de..5819152a 100644 --- a/test/html/liveOrder.html +++ b/test/html/liveOrder.html @@ -85,7 +85,7 @@Cedric Kelly - +