> ## Documentation Index
> Fetch the complete documentation index at: https://algolia.com/llms.txt
> Use this file to discover all available pages before exploring further.
# SortBy
> Shows a list of indices for alternative sorting or ranking of search results.
export const Index = () =>
index
;
{/* vale Algolia.HeadingPronouns = NO */}
## About this widget
This widget displays a list of indices,
allowing a user to change the way hits are sorting
(with [replica indices](/doc/guides/managing-results/refine-results/sorting/how-to/creating-replicas)).
Another common use case for this widget is to let users switch between different indices.
For this widget to work,
you must define all indices that you pass down as options as replicas of the main .
## Examples
```dart Dart icon=code theme={"system"}
class SearchSortBy extends StatefulWidget {
const SearchSortBy({
super.key,
required this.searcher,
required this.sorts,
required this.selected,
});
final HitsSearcher searcher; // can be lifted up (w/ callback)
final Map sorts;
final String selected;
@override
State createState() => _SearchSortByState();
}
class _SearchSortByState extends State {
late String selected = widget.selected;
@override
Widget build(BuildContext context) {
return Card(
child: DropdownButton(
value: selected,
items: widget.sorts.keys
.map((sort) => DropdownMenuItem(
value: sort,
child: Text(sort),
))
.toList(),
onChanged: (value) {
setState(() => selected = value!);
widget.searcher.applyState(
(state) => state.copyWith(indexName: widget.sorts[value]!));
},
),
);
}
}
```