ascending( )
Adds a sort to a query, sorting by the specified properties in ascending order.
Description
The ascending()
function refines a DraftPostsQueryBuilder
to sort by the value of propertyName
in ascending order.
You can specify multiple properties for sorting in ascending order by passing each property name as an additional argument. ascending()
sorts the results in the order the properties are passed.
You can sort the following types:
- Number: Sorts numerically.
- Date: Sorts by date and time.
- String: Sorts lexicographically, so
'abc'
comes after'XYZ'
.
If a property contains a number stored as a string (for example, '0'
), that value is sorted alphabetically and not numerically. If a property doesn't have a value, that value is ranked lowest.
Syntax
function ascending(propertyNames: Array<string>): DraftPostsQueryBuilder
ascending Parameters
NAME
TYPE
DESCRIPTION
Properties used in the sort. To sort by multiple properties, pass properties as additional arguments.
Returns
Return Type:
Was this helpful?
ascending
sort to a query1const query = draftPosts.queryDraftPosts.ascending('_id');2
ascending
sort, and run it1import { draftPosts } from 'wix-blog-backend';23export async function myQueryFunction() {4 const results = await draftPosts.queryDraftPosts().ascending('_id').find();56 if (results.items.length > 0) {7 const items = results.items;8 const firstItem = items[0];9 const pageSize = results.pageSize;10 const hasNext = results.hasNext();11 const hasPrev = results.hasPrev();12 const length = results.length;13 const query = results.query;1415 return items;16 } else {17 // Handle if no matching items found18 }19}20