`getResultSortedRowIds`

The getResultSortedRowIds function returns a reactive object reflecting the sorted Row Ids in a result Table, and registers a listener so that any changes will update current.

getResultSortedRowIds(
  queryId: MaybeGetter<string>,
  cellId?: MaybeGetter<undefined | string>,
  descending?: MaybeGetter<boolean>,
  offset?: MaybeGetter<number>,
  limit?: MaybeGetter<undefined | number>,
  queriesOrQueriesId?: MaybeGetter<undefined | QueriesOrQueriesId>,
): {current: Ids}

	Type	Description
`queryId`	`MaybeGetter<string>`	The `Id` of the Query (or a getter returning it).
`cellId?`	`MaybeGetter<undefined \| string>`	The `Id` of the `Cell` to sort by (or a getter returning it).
`descending?`	`MaybeGetter<boolean>`	Whether to sort descending (or a getter returning it).
`offset?`	`MaybeGetter<number>`	The starting `Row` offset (or a getter returning it).
`limit?`	`MaybeGetter<undefined \| number>`	The maximum number of Rows (or a getter returning it).
`queriesOrQueriesId?`	`MaybeGetter<undefined \| QueriesOrQueriesId>`	The `Queries` object to use (plain or getter), or its `Id`.
returns	`{current: Ids}`	A reactive object with a `current` `Ids` property.

Example

This example passes a TinyBase object into a Svelte component and reads the reactive object's current property.

App.svelte

<svelte:options runes={true} />

<script>
  import {getResultSortedRowIds} from 'tinybase/ui-svelte';

  let {queries} = $props();

  const result = getResultSortedRowIds(
'petColors', 'color', false, 0, undefined, queries);
</script>

{JSON.stringify(result.current)}

import {flushSync, mount} from 'svelte';
import {createQueries, createStore} from 'tinybase';
import App from './App.svelte';

const store = createStore()
  .setTables({
    pets: {
      fido: {species: 'dog', color: 'brown', sold: false, next: 'felix'},
      felix: {species: 'cat', color: 'black', sold: true},
    },
    species: {dog: {price: 5}, cat: {price: 4}},
  })
  .setValues({open: true, employees: 3});
const queries = createQueries(store).setQueryDefinition(
  'petColors',
  'pets',
  ({select}) => select('color'),
);
const app = document.body.appendChild(document.createElement('div'));
flushSync(() => mount(App, {target: app, props: {queries}}));
console.log(app.textContent);
// -> '["felix","fido"]'

Since

v8.1.0