Query results summary
المان Query Results Summary، که در نسخه 1.12.2 معرفی شد، به شما امکان میدهد تعداد نتایج query را به صورت پویا نمایش دهید و به کاربران کمک کنید بفهمند در حال مشاهده کدام آیتمها هستند نسبت به کل نتایج. این برای نتایج جستجو، صفحات آرشیو و لیستهای صفحهبندیشده که کاربران در چندین صفحه محتوا جابجا میشوند بسیار مفید است. این المان را میتوانید در پنل Elements زیر دسته "Query" پیدا کنید.
نکته: اگر یک افزونه شخص ثالث تاریخچه Query بریکس را از طریق hook bricks/query/force_run غیرفعال کند، ممکن است خلاصه نتایج اطلاعات نادرستی نمایش دهد.
سازگاری
المان Query Results Summary با اکشنهای AJAX بومی Bricks به خوبی کار میکند، از جمله:
- Pagination AJAX
- Load More
- Infinite Scroll
- فیلترهای Query
این تضمین میکند که خلاصه به صورت پویا هنگامیکه کاربران با المانهای مبتنی بر query در صفحه تعامل دارند بهروز شود.
مثال:
تنظیمات
Query
query هدف را که خلاصه باید برای آن نمایش داده شود انتخاب کنید.
Format
متن خلاصه را با استفاده از placeholder ها سفارشی کنید:
%start%— ایندکس اولین آیتم در صفحه فعلی.%end%— ایندکس آخرین آیتم در صفحه فعلی.%total%— تعداد کل نتایج.
فرمت پیشفرض: Results: %start% - %end% of %total% posts
خروجی نمونه: Results: 1 - 5 of 14 posts
Text: One Result
یک پیام سفارشی تعریف کنید که وقتی query دقیقاً یک نتیجه برمیگرداند نمایش داده شود تا تفاوت مفرد/جمع را مدیریت کنید.
متن پیشفرض: One post found
Text: No Results
یک پیام سفارشی مشخص کنید که وقتی query صفر نتیجه برمیگرداند نمایش داده شود.
متن پیشفرض: No posts found
مرجع توسعهدهنده
JSON schema کامل: query-results-summary Schema