From 9c6c4d7b54198b128d0a1d3131a9a70025c8bf00 Mon Sep 17 00:00:00 2001
From: Jan-Henrik Damaschke <jdamaschke@outlook.de>
Date: Tue, 27 Sep 2022 09:55:35 +0200
Subject: [PATCH] docs(content-list):  Updated query reference and added
 example (#1548)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Sébastien Chopin <seb@nuxtjs.com>
---
 .../4.api/1.components/2.content-list.md      | 22 ++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/docs/content/4.api/1.components/2.content-list.md b/docs/content/4.api/1.components/2.content-list.md
index 6787365c8..cb8a6f8e8 100644
--- a/docs/content/4.api/1.components/2.content-list.md
+++ b/docs/content/4.api/1.components/2.content-list.md
@@ -13,7 +13,7 @@ An explicit `path`{lang=ts} can be given to the component.
 - `path`{lang=ts}: The path of the content to load from content source.
   - Type: `String`{lang=ts}
   - Default: `'/'`{lang=ts}
-- `query`{lang=ts}: A query to be passed to `queryContent()`.
+- `query`{lang=ts}: A query builder params object to be passed to `<ContentQuery />` component.
   - Type: `QueryBuilderParams`{lang=ts}
   - Default: `undefined`{lang=ts}
 
@@ -48,3 +48,23 @@ An explicit `path`{lang=ts} can be given to the component.
   </main>
 </template>
 ```
+
+## Query example
+
+```html [pages/index.vue]
+<script setup lang="ts">
+import type { QueryBuilderParams } from '@nuxt/content/dist/runtime/types'
+const query: QueryBuilderParams = { path: '/articles', where: { layout: 'article' }, limit: 5, sort: { date: -1 } }
+</script>
+
+<template>
+  <main>
+    <ContentList :query="query" v-slot="{ list }">
+      <div v-for="article in list" :key="article._path">
+        <h2>{{ article.title }}</h2>
+        <p>{{ article.description }}</p>
+      </div>
+    </ContentList>
+  </main>
+</template>
+```