Grâce à Berdir, je l'ai fait fonctionner. Voilà comment cela fonctionne plus en détail.
Tablesort est déclenché "automatiquement" si les tableaux (colonnes) du tableau $ headers contiennent les clés 'data', 'field' et éventuellement 'sort'. Cela créera des liens avec «tri» et «ordre» dans les en-têtes de colonne et affichera la petite flèche et autres.
Pour effectuer votre propre tri, obtenez les paramètres de tri actuels avec tablesort_get_order et tablesort_get_sort et utilisez ces valeurs pour votre propre fonction de tri. La clé 'sql' dans le tableau retourné par tablesort_get_order contient le nom du champ à utiliser pour le tri.
Un exemple de code (non testé) avec le tableau $ users contenant des détails pour chaque utilisateur:
// setup the table data that we want to show
$tableData = array();
foreach ($users as $userDetails) {
$tableData[] = array(
'name' => $userDetails['name'],
'visits' => $userDetails['visits'],
'views' => $userDetails['views'],
'comments' => $userDetails['comments']
);
}
// headers array, sorting by default on comments
$headers = array(
array('data' => t('Name'), 'field' => 'name'),
array('data' => t('Visits'), 'field' => 'visits'),
array('data' => t('Views'), 'field' => 'views'),
array('data' => t('Comments'), 'field' => 'comments', 'sort' => 'desc')
);
// getting the current sort and order parameters from the url
$order = tablesort_get_order($headers);
$sort = tablesort_get_sort($headers);
// sort the table data accordingly (write your own sort function)
$tableData = my_array_sort($tableData, $order['sql'], $sort);
// create the array with rows for theme table
$rows = array();
foreach ($tableData as $entry) {
$rows[] = array(
array('data' => $entry['name']),
array('data' => $entry['visits']),
array('data' => $entry['views']),
array('data' => $entry['comments']),
);
}
// add any attributes and sent everything to theme table
$attributes = array('class' => array('my_class'));
$table = array('header' => $headers, 'attributes' => $attributes, 'rows' => $rows);
$html = theme('table', $table);