docs(FilterBar): outline responsive behavior of filter area (#5992)

Fixes #5991

Author: Lukas742

packages/main/src/components/FilterBar/index.tsx

@@ -49,9 +49,16 @@ const resizeObserverEntryWidth = (entry) => {
 
 /**
  * The `FilterBar` displays filters in a user-friendly manner to populate values for a query. It consists of a row containing the `VariantManagement` or a title, the related buttons, and an area underneath displaying the filters. The filters are arranged in a logical row that is divided depending on the space available and the width of the filters. The area containing the filters can be hidden or shown using the "Hide FilterBar / Show FilterBar" button, the "Filters" button shows the filter dialog.
- In this dialog, the consumer has full control over the FilterBar. The filters in this dialog are displayed in one column and organized in groups. Each filter can be marked as visible in the FilterBar by selecting the respective checkbox.
-
- __Note:__ We recommend always fully controlling the filters, as otherwise, you may encounter discrepancies between the filters dialog and the FilterBar, especially when using complex or custom filter components.
+ * In this dialog, the consumer has full control over the FilterBar. The filters in this dialog are displayed in one column and organized in groups. Each filter can be marked as visible in the FilterBar by selecting the respective row.
+ *
+ * __Responsiveness:__
+ * The name of the view or title is always visible. The filter area varies:
+ *
+ * * Desktop: Expanded or collapsed by default
+ * * Tablet: Collapsed by default
+ * * Phone: Not displayed. Accessible through filter dialog.
+ *
+ *__Note:__ We recommend always fully controlling the filters, as otherwise, you may encounter discrepancies between the filters dialog and the FilterBar, especially when using complex or custom filter components.
  */
 const FilterBar = forwardRef<HTMLDivElement, FilterBarPropTypes>((props, ref) => {
   const {

packages/main/src/components/FilterBar/types.ts

@@ -97,7 +97,7 @@ export interface FilterBarPropTypes extends CommonProps {
   /**
    * Defines whether the "Hide/Show Filters" button is displayed in the `FilterBar`.
    *
-   * __Note:__ If `hideToolbar` is `true` this prop has no effect.
+   * __Note:__ If `hideToolbar` is `true` or the FilterBar is used on mobile, this prop has no effect.
    */
   hideToggleFiltersButton?: boolean;
   /**