@wordpress/components
Version:
UI components for WordPress.
115 lines (114 loc) • 4 kB
JavaScript
import { __, _x } from "@wordpress/i18n";
import AuthorSelect from "./author-select.mjs";
import CategorySelect from "./category-select.mjs";
import FormTokenField from "../form-token-field/index.mjs";
import RangeControl from "../range-control/index.mjs";
import SelectControl from "../select-control/index.mjs";
import { VStack } from "../v-stack/index.mjs";
import { jsx } from "react/jsx-runtime";
// packages/components/src/query-controls/index.tsx
const DEFAULT_MIN_ITEMS = 1;
const DEFAULT_MAX_ITEMS = 100;
const MAX_CATEGORIES_SUGGESTIONS = 20;
function isSingleCategorySelection(props) {
return "categoriesList" in props;
}
function isMultipleCategorySelection(props) {
return "categorySuggestions" in props;
}
const defaultOrderByOptions = [
{
label: __("Newest to oldest"),
value: "date/desc"
},
{
label: __("Oldest to newest"),
value: "date/asc"
},
{
label: __("A → Z"),
value: "title/asc"
},
{
label: __("Z → A"),
value: "title/desc"
}
];
/**
* Controls to query for posts.
*
* ```jsx
* const MyQueryControls = () => (
* <QueryControls
* { ...{ maxItems, minItems, numberOfItems, order, orderBy, orderByOptions } }
* onOrderByChange={ ( newOrderBy ) => {
* updateQuery( { orderBy: newOrderBy } )
* }
* onOrderChange={ ( newOrder ) => {
* updateQuery( { order: newOrder } )
* }
* categoriesList={ categories }
* selectedCategoryId={ category }
* onCategoryChange={ ( newCategory ) => {
* updateQuery( { category: newCategory } )
* }
* onNumberOfItemsChange={ ( newNumberOfItems ) => {
* updateQuery( { numberOfItems: newNumberOfItems } )
* } }
* />
* );
* ```
*/
function QueryControls({ authorList, selectedAuthorId, numberOfItems, order, orderBy, orderByOptions = defaultOrderByOptions, maxItems = DEFAULT_MAX_ITEMS, minItems = DEFAULT_MIN_ITEMS, onAuthorChange, onNumberOfItemsChange, onOrderChange, onOrderByChange, ...props }) {
return /* @__PURE__ */ jsx(VStack, {
spacing: "4",
className: "components-query-controls",
children: [
onOrderChange && onOrderByChange && /* @__PURE__ */ jsx(SelectControl, {
label: __("Order by"),
value: orderBy === void 0 || order === void 0 ? void 0 : `${orderBy}/${order}`,
options: orderByOptions,
onChange: (value) => {
if (typeof value !== "string") return;
const [newOrderBy, newOrder] = value.split("/");
if (newOrder !== order) onOrderChange(newOrder);
if (newOrderBy !== orderBy) onOrderByChange(newOrderBy);
}
}, "query-controls-order-select"),
isSingleCategorySelection(props) && props.categoriesList && props.onCategoryChange && /* @__PURE__ */ jsx(CategorySelect, {
categoriesList: props.categoriesList,
label: __("Category"),
noOptionLabel: _x("All", "categories"),
selectedCategoryId: props.selectedCategoryId,
onChange: props.onCategoryChange
}, "query-controls-category-select"),
isMultipleCategorySelection(props) && props.categorySuggestions && props.onCategoryChange && /* @__PURE__ */ jsx(FormTokenField, {
label: __("Categories"),
value: props.selectedCategories && props.selectedCategories.map((item) => ({
id: item.id,
value: item.name || item.value
})),
suggestions: Object.keys(props.categorySuggestions),
onChange: props.onCategoryChange,
maxSuggestions: MAX_CATEGORIES_SUGGESTIONS
}, "query-controls-categories-select"),
onAuthorChange && /* @__PURE__ */ jsx(AuthorSelect, {
authorList,
label: __("Author"),
noOptionLabel: _x("All", "authors"),
selectedAuthorId,
onChange: onAuthorChange
}, "query-controls-author-select"),
onNumberOfItemsChange && /* @__PURE__ */ jsx(RangeControl, {
label: __("Number of items"),
value: numberOfItems,
onChange: onNumberOfItemsChange,
min: minItems,
max: maxItems,
required: true
}, "query-controls-range-control")
]
});
}
export { QueryControls, QueryControls as default };
//# sourceMappingURL=index.mjs.map