Collection.orderBy(fieldPath: string, string: order): Collection

支持端:小程序 , 云函数 , Web

指定查询排序条件

参数

fieldPath: string

string: order

返回值

Collection

说明

方法接受一个必填字符串参数 fieldName 用于定义需要排序的字段,一个字符串参数 order 定义排序顺序。order 只能取 ascdesc

如果需要对嵌套字段排序,需要用 “点表示法” 连接嵌套字段,比如 style.color 表示字段 style 里的嵌套字段 color

同时也支持按多个字段排序,多次调用 orderBy 即可,多字段排序时的顺序会按照 orderBy 调用顺序先后对多个字段排序

示例代码:按一个字段排序

按进度排升序取待办事项

  1. db.collection('todos').orderBy('progress', 'asc')
  2. .get()
  3. .then(console.log)
  4. .catch(console.error)

示例代码:按多个字段排序

先按 progress 排降序(progress 越大越靠前)、再按 description 排升序(字母序越前越靠前)取待办事项:

  1. db.collection('todos')
  2. .orderBy('progress', 'desc')
  3. .orderBy('description', 'asc')
  4. .get()
  5. .then(console.log)
  6. .catch(console.error)