@primevue/mcp 4.5.5 → 5.0.0-rc.2

package/data/llms/components/scrollpanel.md

@@ -0,0 +1,131 @@
+# ScrollPanel
+
+ScrollPanel is a cross browser, lightweight and skinnable alternative to native browser scrollbar.
+
+## Basic
+
+ScrollPanel is defined using dimensions for the scrollable viewport.
+
+```vue
+<template>
+    <div>
+        <ScrollPanel style="width: 100%; height: 150px">
+            <p class="text-sm">
+                Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
+                Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+            </p>
+            <p class="text-sm">
+                Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam
+                voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Consectetur, adipisci velit, sed quia non numquam eius modi.
+            </p>
+            <p class="m-0 text-sm">
+                At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati cupiditate non provident, similique sunt in culpa qui
+                officia deserunt mollitia animi, id est laborum et dolorum fuga. Et harum quidem rerum facilis est et expedita distinctio. Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus.
+            </p>
+        </ScrollPanel>
+    </div>
+</template>
+```
+
+## Custom
+
+Scrollbar visuals can be styled for a unified look across different platforms.
+
+```vue
+<template>
+    <div>
+        <ScrollPanel
+            style="width: 100%; height: 200px"
+            :dt="{
+                bar: {
+                    background: '{primary.color}'
+                }
+            }"
+        >
+            <p class="text-sm">
+                Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
+                Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+            </p>
+            <p class="text-sm">
+                Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam
+                voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Consectetur, adipisci velit, sed quia non numquam eius modi.
+            </p>
+            <p class="text-sm">
+                At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati cupiditate non provident, similique sunt in culpa qui
+                officia deserunt mollitia animi, id est laborum et dolorum fuga. Et harum quidem rerum facilis est et expedita distinctio. Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus.
+            </p>
+            <p class="text-sm">
+                Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
+                Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+            </p>
+            <p class="text-sm">
+                Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam
+                voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Consectetur, adipisci velit, sed quia non numquam eius modi.
+            </p>
+            <p class="text-sm">
+                At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati cupiditate non provident, similique sunt in culpa qui
+                officia deserunt mollitia animi, id est laborum et dolorum fuga. Et harum quidem rerum facilis est et expedita distinctio. Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus.
+            </p>
+        </ScrollPanel>
+    </div>
+</template>
+```
+
+## Accessibility
+
+Screen Reader Scrollbars of the ScrollPanel has a scrollbar role along with the aria-controls attribute that refers to the id of the scrollable content container and the aria-orientation to indicate the orientation of scrolling. Header Keyboard Support Key Function down arrow Scrolls content down when vertical scrolling is available. up arrow Scrolls content up when vertical scrolling is available. left Scrolls content left when horizontal scrolling is available. right Scrolls content right when horizontal scrolling is available.
+
+## Scroll Panel API
+
+### Props
+
+| Name |Type |Default |Description |
+| --- | --- | --- | --- |
+| step | number | 5 | Step factor to scroll the content while pressing the arrow keys. |
+| dt | any | - | It generates scoped CSS variables using design tokens for the component. |
+| pt | PassThrough<ScrollPanelPassThroughOptions> | - | Used to pass attributes to DOM elements inside the component. |
+| ptOptions | any | - | Used to configure passthrough(pt) options of the component. |
+| unstyled | boolean | false | When enabled, it removes component related styles in the core. |
+
+### Slots
+
+| Name |Parameters |Description |
+| --- | --- | --- |
+| default | Function |  |
+
+### Pass Through Options
+
+| Name |Type |Description |
+| --- | --- | --- |
+| root | ScrollPanelPassThroughOptionType | Used to pass attributes to the root's DOM element. |
+| contentContainer | ScrollPanelPassThroughOptionType | Used to pass attributes to the content container's DOM element. |
+| content | ScrollPanelPassThroughOptionType | Used to pass attributes to the content's DOM element. |
+| barX | ScrollPanelPassThroughOptionType | Used to pass attributes to the horizontal panel's DOM element. |
+| barY | ScrollPanelPassThroughOptionType | Used to pass attributes to the vertical panel's DOM element. |
+| hooks | any | Used to manage all lifecycle hooks. |
+
+### Theming
+
+### CSS Classes
+
+| Class |Description |
+| --- | --- |
+| p-scrollpanel | Class name of the root element |
+| p-scrollpanel-content-container | Class name of the content container element |
+| p-scrollpanel-content | Class name of the content element |
+| p-scrollpanel-bar-x | Class name of the bar x element |
+| p-scrollpanel-bar-y | Class name of the bar y element |
+
+### Design Tokens
+
+| Token |CSS Variable |Description |
+| --- | --- | --- |
+| scrollpanel.transition.duration | --p-scrollpanel-transition-duration | Transition duration of root |
+| scrollpanel.bar.size | --p-scrollpanel-bar-size | Size of bar |
+| scrollpanel.bar.border.radius | --p-scrollpanel-bar-border-radius | Border radius of bar |
+| scrollpanel.bar.focus.ring.width | --p-scrollpanel-bar-focus-ring-width | Focus ring width of bar |
+| scrollpanel.bar.focus.ring.style | --p-scrollpanel-bar-focus-ring-style | Focus ring style of bar |
+| scrollpanel.bar.focus.ring.color | --p-scrollpanel-bar-focus-ring-color | Focus ring color of bar |
+| scrollpanel.bar.focus.ring.offset | --p-scrollpanel-bar-focus-ring-offset | Focus ring offset of bar |
+| scrollpanel.bar.focus.ring.shadow | --p-scrollpanel-bar-focus-ring-shadow | Focus ring shadow of bar |
+| scrollpanel.bar.background | --p-scrollpanel-bar-background | Background of bar |

package/data/llms/components/scrolltop.md

@@ -0,0 +1,87 @@
+# ScrollTop
+
+ScrollTop gets displayed after a certain scroll position and used to navigates to the top of the page quickly.
+
+## Basic
+
+ScrollTop listens window scroll by default.
+
+```vue
+<template>
+    <div class="flex flex-col items-center">
+        <p class="text-sm">Scroll down the page to display the ScrollTop component.</p>
+        <AngleDown class="animate-fadeout animate-duration-1000 animate-infinite text-[1.75rem] mb-[26.25rem]" />
+        <ScrollTop />
+    </div>
+</template>
+
+<script setup>
+import AngleDown from '@primeicons/vue/angle-down';
+<\/script>
+```
+
+## Target Element
+
+Setting the target property to parent binds ScrollTop to its parent element that has scrolling content.
+
+```vue
+<template>
+    <div class="flex justify-center">
+        <div style="width: 250px; height: 200px; overflow: auto">
+            <p class="text-sm">
+                Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Vitae et leo duis ut diam. Ultricies mi quis hendrerit dolor magna eget est lorem. Amet consectetur
+                adipiscing elit ut. Nam libero justo laoreet sit amet. Pharetra massa massa ultricies mi quis hendrerit dolor magna. Est ultricies integer quis auctor elit sed vulputate. Consequat ac felis donec et. Tellus orci ac auctor augue
+                mauris. Semper feugiat nibh sed pulvinar proin gravida hendrerit lectus a. Tincidunt arcu non sodales neque sodales. Metus aliquam eleifend mi in nulla posuere sollicitudin aliquam ultrices. Sodales ut etiam sit amet nisl purus.
+                Cursus sit amet dictum sit amet. Tristique senectus et netus et malesuada fames ac turpis egestas. Et tortor consequat id porta nibh venenatis cras sed. Diam maecenas ultricies mi eget mauris. Eget egestas purus viverra accumsan
+                in nisl nisi. Suscipit adipiscing bibendum est ultricies integer. Mattis aliquam faucibus purus in massa tempor nec.
+            </p>
+            <ScrollTop target="parent" :threshold="100" :buttonProps="{ severity: 'contrast', raised: true, rounded: true, iconOnly: true }">
+                <template #icon>
+                    <ArrowUp />
+                </template>
+            </ScrollTop>
+        </div>
+    </div>
+</template>
+
+<script setup>
+import ArrowUp from '@primeicons/vue/arrow-up';
+<\/script>
+```
+
+## Accessibility
+
+Screen Reader ScrollTop uses a button element with an aria-label that refers to the aria.scrollTop property of the locale API by default, you may use your own aria roles and attributes as any valid attribute is passed to the button element implicitly. Keyboard Support Key Function enter Scrolls to top. space Scrolls to top.
+
+## Scroll Top API
+
+### Props
+
+| Name |Type |Default |Description |
+| --- | --- | --- | --- |
+| target | HintedString<"window" \| "parent"> | window | Target of the ScrollTop. |
+| threshold | number | 400 | Defines the threshold value of the vertical scroll position of the target to toggle the visibility. |
+| icon | string | - | Icon to display. |
+| behavior | string | smooth | Defines the scrolling behaviour, 'smooth' adds an animation and 'auto' scrolls with a jump. |
+| buttonProps | object | - | Used to pass all properties of the ButtonProps to the Button component. |
+| dt | any | - | It generates scoped CSS variables using design tokens for the component. |
+| pt | PassThrough<ScrollTopPassThroughOptions> | - | Used to pass attributes to DOM elements inside the component. |
+| ptOptions | any | - | Used to configure passthrough(pt) options of the component. |
+| unstyled | boolean | false | When enabled, it removes component related styles in the core. |
+
+### Pass Through Options
+
+| Name |Type |Description |
+| --- | --- | --- |
+| root | any | Used to pass attributes to the root's DOM element. |
+| hooks | any | Used to manage all lifecycle hooks. |
+| transition | ScrollTopPassThroughTransitionType | Used to control Vue Transition API. |
+
+### Theming
+
+### CSS Classes
+
+| Class |Description |
+| --- | --- |
+| p-scrolltop | Class name of the root element |
+| p-scrolltop-icon | Class name of the icon element |