diff --git a/docs/index.html b/docs/index.html index 84282789..b4e3b966 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1260,8 +1260,10 @@ From the example function above, you'll end up with something similar to this HT null Use to add an additional forced sort that is prepended to sortList.
-
- For example, sortForce: [[0,0]] will sort the first column in ascending order. After the forced sort, the user selected column(s), or during initialzation, the sorting order defined in the sortList will follow. And lastly, the sort defined in the sortAppend option will be applied. More explicitly:
+

+ NOTE Only when the user interacts with the table will the sortForce and sortAppend settings be applied. During initialization, and while setting the sortList through the API, both the sortForce and sortAppend settings are ignored. This will allow you to have explicit control over the sorting. +

+ For example, sortForce: [[0,0]] will sort the first column in ascending order. After the forced sort, the user selected column(s), but not during initialzation, the sorting order defined in the sortList will follow. And lastly, the sort defined in the sortAppend option will be applied. More explicitly:

There are three options to determine the sort order and this is the order of priority:
    @@ -1287,7 +1289,9 @@ From the example function above, you'll end up with something similar to this HT null Use to add an initial sort to the table.
    -
    +

    + NOTE Only when the user interacts with the table will the sortForce and sortAppend settings be applied. During initialization, and while setting the sortList through the API, both the sortForce and sortAppend settings are ignored. This will allow you to have explicit control over the sorting. +

    The value contains an array of instructions for per-column sorting and direction in the format: [[columnIndex, sortDirection], ... ] where columnIndex is a zero-based index for your columns left-to-right and sortDirection is 0 for Ascending and 1 for Descending. A valid argument that sorts ascending first by column 1 and then column 2 looks like: [[0,0],[1,0]]. Please see sortForce for more details on other sort order options.
    $(function(){
       $("table").tablesorter({
    @@ -1315,7 +1319,9 @@ From the example function above, you'll end up with something similar to this HT
     				null
     				Use to add an additional forced sort that will be appended to the dynamic selections by the user (v2.24.0).
     					
    -
    +

    + NOTE Only when the user interacts with the table will the sortForce and sortAppend settings be applied. During initialization, and while setting the sortList through the API, both the sortForce and sortAppend settings are ignored. This will allow you to have explicit control over the sorting. +

    For example, can be used to sort people alphabetically after some other user-selected sort that results in rows with the same value like dates or money due. It can help prevent data from appearing as though it has a random secondary sort.
    $(function(){
       $("table").tablesorter({