@gitlab/ui 52.6.1 → 52.7.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [52.7.0](https://gitlab.com/gitlab-org/gitlab-ui/compare/v52.6.1...v52.7.0) (2022-12-20)
+
+
+### Features
+
+* **GlListbox:** Add infinite scroll to listbox ([d42c9e6](https://gitlab.com/gitlab-org/gitlab-ui/commit/d42c9e64745fdc0ee65e1d612712a1aaf61a2228))
+
 ## [52.6.1](https://gitlab.com/gitlab-org/gitlab-ui/compare/v52.6.0...v52.6.1) (2022-12-20)
 
 

package/dist/components/base/new_dropdowns/listbox/listbox.js

@@ -5,6 +5,7 @@ import { GL_DROPDOWN_SHOWN, GL_DROPDOWN_HIDDEN, HOME, END, ARROW_UP, ARROW_DOWN
 import { buttonCategoryOptions, dropdownVariantOptions, buttonSizeOptions } from '../../../../utils/constants';
 import GlButton from '../../button/button';
 import GlLoadingIcon from '../../loading_icon/loading_icon';
+import GlIntersectionObserver from '../../../utilities/intersection_observer/intersection_observer';
 import GlSearchBoxByType from '../../search_box_by_type/search_box_by_type';
 import GlBaseDropdown from '../base_dropdown/base_dropdown';
 import GlListboxItem from './listbox_item';
@@ -30,7 +31,8 @@ var script = {
     GlButton,
     GlSearchBoxByType,
     GlListboxSearchInput,
-    GlLoadingIcon
+    GlLoadingIcon,
+    GlIntersectionObserver
   },
   model: {
     prop: 'selected',
@@ -203,6 +205,37 @@ var script = {
       required: false,
       default: false
     },
+    /**
+     * Enables infinite scroll.
+     * When set to `true`, the `@bottom-reached` event will be fired when
+     * the bottom of the listbox is scrolled to.
+     * Does not support groups.
+     */
+    infiniteScroll: {
+      type: Boolean,
+      required: false,
+      default: false
+    },
+    /**
+     * This prop is used for infinite scroll.
+     * It represents the total number of items that exist,
+     * even if they have not yet been loaded.
+     * Do not set this prop if the total number of items is unknown.
+     */
+    totalItems: {
+      type: Number,
+      required: false,
+      default: null
+    },
+    /**
+     * This prop is used for infinite scroll.
+     * Set to `true` when more items are being loaded.
+     */
+    infiniteScrollLoading: {
+      type: Boolean,
+      required: false,
+      default: false
+    },
     /**
      * Message to be displayed when filtering produced no results
      */
@@ -291,6 +324,9 @@ var script = {
         return this.selected.length > 0;
       }
       return Boolean(this.selected);
+    },
+    showIntersectionObserver() {
+      return this.infiniteScroll && !this.infiniteScrollLoading && !this.loading && !this.searching;
     }
   },
   watch: {
@@ -316,6 +352,11 @@ var script = {
       }
     }
   },
+  created() {
+    if (process.env.NODE_ENV !== 'production' && this.infiniteScroll && this.items.some(item => !isOption(item))) {
+      throw new Error('Infinite scroll does not support groups. Please set the "infiniteScroll" prop to "false"');
+    }
+  },
   methods: {
     open() {
       this.$refs.baseDropdown.open();
@@ -457,6 +498,24 @@ var script = {
     closeAndFocus() {
       this.$refs.baseDropdown.closeAndFocus();
     },
+    onIntersectionObserverAppear() {
+      /**
+       * Emitted when bottom of listbox has been scrolled to.
+       * Used for infinite scroll.
+       *
+       * @event bottom-reached
+       */
+      this.$emit('bottom-reached');
+    },
+    listboxItemMoreItemsAriaAttributes(index) {
+      if (this.totalItems === null) {
+        return {};
+      }
+      return {
+        'aria-setsize': this.totalItems,
+        'aria-posinset': index + 1
+      };
+    },
     isOption
   }
 };
@@ -465,7 +524,7 @@ var script = {
 const __vue_script__ = script;
 
 /* template */
-var __vue_render__ = function () {var _vm=this;var _h=_vm.$createElement;var _c=_vm._self._c||_h;return _c('gl-base-dropdown',{ref:"baseDropdown",attrs:{"aria-haspopup":"listbox","aria-labelledby":_vm.toggleAriaLabelledBy,"toggle-id":_vm.toggleId,"toggle-text":_vm.listboxToggleText,"toggle-class":_vm.toggleClass,"text-sr-only":_vm.textSrOnly,"category":_vm.category,"variant":_vm.variant,"size":_vm.size,"icon":_vm.icon,"disabled":_vm.disabled,"loading":_vm.loading,"no-caret":_vm.noCaret,"right":_vm.right},on:_vm._d({},[_vm.$options.events.GL_DROPDOWN_SHOWN,_vm.onShow,_vm.$options.events.GL_DROPDOWN_HIDDEN,_vm.onHide])},[(_vm.headerText)?_c('div',{staticClass:"gl-display-flex gl-align-items-center gl-p-4! gl-min-h-8",class:_vm.$options.HEADER_ITEMS_BORDER_CLASSES},[_c('div',{staticClass:"gl-flex-grow-1 gl-font-weight-bold gl-font-sm gl-pr-2",attrs:{"id":_vm.headerId,"data-testid":"listbox-header-text"}},[_vm._v("\n      "+_vm._s(_vm.headerText)+"\n    ")]),_vm._v(" "),(_vm.showResetButton)?_c('gl-button',{staticClass:"gl-focus-inset-border-2-blue-400! gl-flex-shrink-0 gl-font-sm! gl-px-2! gl-py-2!",attrs:{"category":"tertiary","data-testid":"listbox-reset-button"},on:{"click":_vm.onResetButtonClicked}},[_vm._v("\n      "+_vm._s(_vm.resetButtonLabel)+"\n    ")]):_vm._e()],1):_vm._e(),_vm._v(" "),(_vm.searchable)?_c('div',{class:_vm.$options.HEADER_ITEMS_BORDER_CLASSES},[_c('gl-listbox-search-input',{ref:"searchBox",attrs:{"aria-owns":_vm.listboxId,"data-testid":"listbox-search-input","placeholder":_vm.searchPlaceholder},on:{"input":_vm.search,"keydown":_vm.onKeydown},model:{value:(_vm.searchStr),callback:function ($$v) {_vm.searchStr=$$v;},expression:"searchStr"}}),_vm._v(" "),(_vm.searching)?_c('gl-loading-icon',{staticClass:"gl-my-3",attrs:{"data-testid":"listbox-search-loader","size":"md"}}):_vm._e()],1):_vm._e(),_vm._v(" "),(_vm.showList)?_c(_vm.listboxTag,{ref:"list",tag:"component",staticClass:"gl-dropdown-contents gl-list-style-none gl-pl-0 gl-mb-0",attrs:{"id":"listbox","aria-labelledby":_vm.listAriaLabelledBy || _vm.headerId || _vm.toggleId,"role":"listbox","tabindex":"-1"},on:{"keydown":_vm.onKeydown}},[_vm._l((_vm.items),function(item,index){return [(_vm.isOption(item))?[_c('gl-listbox-item',{key:item.value,attrs:{"is-selected":_vm.isSelected(item),"is-focused":_vm.isFocused(item),"is-check-centered":_vm.isCheckCentered},on:{"select":function($event){return _vm.onSelect(item, $event)}}},[_vm._t("list-item",function(){return [_vm._v("\n            "+_vm._s(item.text)+"\n          ")]},{"item":item})],2)]:[_c('gl-listbox-group',{key:item.text,class:_vm.groupClasses(index),attrs:{"name":item.text},scopedSlots:_vm._u([(_vm.$scopedSlots['group-label'])?{key:"group-label",fn:function(){return [_vm._t("group-label",null,{"group":item})]},proxy:true}:null],null,true)},[_vm._v(" "),_vm._l((item.options),function(option){return _c('gl-listbox-item',{key:option.value,attrs:{"is-selected":_vm.isSelected(option),"is-focused":_vm.isFocused(option),"is-check-centered":_vm.isCheckCentered},on:{"select":function($event){return _vm.onSelect(option, $event)}}},[_vm._t("list-item",function(){return [_vm._v("\n              "+_vm._s(option.text)+"\n            ")]},{"item":option})],2)})],2)]]})],2):_vm._e(),_vm._v(" "),(_vm.announceSRSearchResults)?_c('span',{staticClass:"gl-sr-only",attrs:{"data-testid":"listbox-number-of-results","aria-live":"assertive"}},[_vm._t("search-summary-sr-only")],2):(_vm.showNoResultsText)?_c('div',{staticClass:"gl-pl-7 gl-pr-5 gl-pt-3 gl-font-base gl-text-gray-600",attrs:{"aria-live":"assertive","data-testid":"listbox-no-results-text"}},[_vm._v("\n    "+_vm._s(_vm.noResultsText)+"\n  ")]):_vm._e(),_vm._v(" "),_vm._t("footer")],2)};
+var __vue_render__ = function () {var _vm=this;var _h=_vm.$createElement;var _c=_vm._self._c||_h;return _c('gl-base-dropdown',{ref:"baseDropdown",attrs:{"aria-haspopup":"listbox","aria-labelledby":_vm.toggleAriaLabelledBy,"toggle-id":_vm.toggleId,"toggle-text":_vm.listboxToggleText,"toggle-class":_vm.toggleClass,"text-sr-only":_vm.textSrOnly,"category":_vm.category,"variant":_vm.variant,"size":_vm.size,"icon":_vm.icon,"disabled":_vm.disabled,"loading":_vm.loading,"no-caret":_vm.noCaret,"right":_vm.right},on:_vm._d({},[_vm.$options.events.GL_DROPDOWN_SHOWN,_vm.onShow,_vm.$options.events.GL_DROPDOWN_HIDDEN,_vm.onHide])},[(_vm.headerText)?_c('div',{staticClass:"gl-display-flex gl-align-items-center gl-p-4! gl-min-h-8",class:_vm.$options.HEADER_ITEMS_BORDER_CLASSES},[_c('div',{staticClass:"gl-flex-grow-1 gl-font-weight-bold gl-font-sm gl-pr-2",attrs:{"id":_vm.headerId,"data-testid":"listbox-header-text"}},[_vm._v("\n      "+_vm._s(_vm.headerText)+"\n    ")]),_vm._v(" "),(_vm.showResetButton)?_c('gl-button',{staticClass:"gl-focus-inset-border-2-blue-400! gl-flex-shrink-0 gl-font-sm! gl-px-2! gl-py-2!",attrs:{"category":"tertiary","data-testid":"listbox-reset-button"},on:{"click":_vm.onResetButtonClicked}},[_vm._v("\n      "+_vm._s(_vm.resetButtonLabel)+"\n    ")]):_vm._e()],1):_vm._e(),_vm._v(" "),(_vm.searchable)?_c('div',{class:_vm.$options.HEADER_ITEMS_BORDER_CLASSES},[_c('gl-listbox-search-input',{ref:"searchBox",attrs:{"aria-owns":_vm.listboxId,"data-testid":"listbox-search-input","placeholder":_vm.searchPlaceholder},on:{"input":_vm.search,"keydown":_vm.onKeydown},model:{value:(_vm.searchStr),callback:function ($$v) {_vm.searchStr=$$v;},expression:"searchStr"}}),_vm._v(" "),(_vm.searching)?_c('gl-loading-icon',{staticClass:"gl-my-3",attrs:{"data-testid":"listbox-search-loader","size":"md"}}):_vm._e()],1):_vm._e(),_vm._v(" "),(_vm.showList)?_c(_vm.listboxTag,{ref:"list",tag:"component",staticClass:"gl-dropdown-contents gl-list-style-none gl-pl-0 gl-mb-0",attrs:{"id":"listbox","aria-labelledby":_vm.listAriaLabelledBy || _vm.headerId || _vm.toggleId,"role":"listbox","tabindex":"-1"},on:{"keydown":_vm.onKeydown}},[_vm._l((_vm.items),function(item,index){return [(_vm.isOption(item))?[_c('gl-listbox-item',_vm._b({key:item.value,attrs:{"is-selected":_vm.isSelected(item),"is-focused":_vm.isFocused(item),"is-check-centered":_vm.isCheckCentered},on:{"select":function($event){return _vm.onSelect(item, $event)}}},'gl-listbox-item',_vm.listboxItemMoreItemsAriaAttributes(index),false),[_vm._t("list-item",function(){return [_vm._v("\n            "+_vm._s(item.text)+"\n          ")]},{"item":item})],2)]:[_c('gl-listbox-group',{key:item.text,class:_vm.groupClasses(index),attrs:{"name":item.text},scopedSlots:_vm._u([(_vm.$scopedSlots['group-label'])?{key:"group-label",fn:function(){return [_vm._t("group-label",null,{"group":item})]},proxy:true}:null],null,true)},[_vm._v(" "),_vm._l((item.options),function(option){return _c('gl-listbox-item',{key:option.value,attrs:{"is-selected":_vm.isSelected(option),"is-focused":_vm.isFocused(option),"is-check-centered":_vm.isCheckCentered},on:{"select":function($event){return _vm.onSelect(option, $event)}}},[_vm._t("list-item",function(){return [_vm._v("\n              "+_vm._s(option.text)+"\n            ")]},{"item":option})],2)})],2)]]}),_vm._v(" "),(_vm.showIntersectionObserver)?_c('gl-intersection-observer',{on:{"appear":_vm.onIntersectionObserverAppear}}):_vm._e()],2):_vm._e(),_vm._v(" "),(_vm.infiniteScrollLoading)?_c('gl-loading-icon',{staticClass:"gl-my-3",attrs:{"data-testid":"listbox-infinite-scroll-loader","size":"md"}}):_vm._e(),_vm._v(" "),(_vm.announceSRSearchResults)?_c('span',{staticClass:"gl-sr-only",attrs:{"data-testid":"listbox-number-of-results","aria-live":"assertive"}},[_vm._t("search-summary-sr-only")],2):(_vm.showNoResultsText)?_c('div',{staticClass:"gl-pl-7 gl-pr-5 gl-pt-3 gl-font-base gl-text-gray-600",attrs:{"aria-live":"assertive","data-testid":"listbox-no-results-text"}},[_vm._v("\n    "+_vm._s(_vm.noResultsText)+"\n  ")]):_vm._e(),_vm._v(" "),_vm._t("footer")],2)};
 var __vue_staticRenderFns__ = [];
 
   /* style */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitlab/ui",
-  "version": "52.6.1",
+  "version": "52.7.0",
   "description": "GitLab UI Components",
   "license": "MIT",
   "main": "dist/index.js",

package/src/components/base/new_dropdowns/listbox/listbox.spec.js

@@ -1,5 +1,6 @@
 import { mount } from '@vue/test-utils';
 import { nextTick } from 'vue';
+import { useMockIntersectionObserver } from '~/utils/use_mock_intersection_observer';
 import GlBaseDropdown from '../base_dropdown/base_dropdown.vue';
 import {
   GL_DROPDOWN_SHOWN,
@@ -9,6 +10,7 @@ import {
   HOME,
   END,
 } from '../constants';
+import GlIntersectionObserver from '../../../utilities/intersection_observer/intersection_observer.vue';
 import GlListbox, { ITEM_SELECTOR } from './listbox.vue';
 import GlListboxItem from './listbox_item.vue';
 import GlListboxGroup from './listbox_group.vue';
@@ -25,6 +27,8 @@ describe('GlListbox', () => {
     });
   };
 
+  useMockIntersectionObserver();
+
   const findBaseDropdown = () => wrapper.findComponent(GlBaseDropdown);
   const findListContainer = () => wrapper.find('[role="listbox"]');
   const findListboxItems = (root = wrapper) => root.findAllComponents(GlListboxItem);
@@ -36,6 +40,7 @@ describe('GlListbox', () => {
   const findLoadingIcon = () => wrapper.find("[data-testid='listbox-search-loader']");
   const findSRNumberOfResultsText = () => wrapper.find("[data-testid='listbox-number-of-results']");
   const findResetButton = () => wrapper.find("[data-testid='listbox-reset-button']");
+  const findIntersectionObserver = () => wrapper.findComponent(GlIntersectionObserver);
 
   describe('toggle text', () => {
     describe.each`
@@ -435,4 +440,125 @@ describe('GlListbox', () => {
       expect(wrapper.vm.closeAndFocus).toHaveBeenCalled();
     });
   });
+
+  describe('when `infiniteScroll` prop is `true`', () => {
+    it('should throw an error when items are groups', () => {
+      expect(() => {
+        buildWrapper({
+          items: mockGroups,
+          infiniteScroll: true,
+        });
+      }).toThrow(
+        'Infinite scroll does not support groups. Please set the "infiniteScroll" prop to "false"'
+      );
+      expect(wrapper).toHaveLoggedVueErrors();
+    });
+
+    it('renders `GlIntersectionObserver` component', () => {
+      buildWrapper({
+        headerText: 'Select assignee',
+        items: mockOptions,
+        infiniteScroll: true,
+      });
+
+      expect(findIntersectionObserver().exists()).toBe(true);
+    });
+
+    describe('when bottom of listbox is reached', () => {
+      it('emits `bottom-reached` event', () => {
+        buildWrapper({
+          items: mockOptions,
+          infiniteScroll: true,
+        });
+
+        findIntersectionObserver().vm.$emit('appear');
+
+        expect(wrapper.emitted('bottom-reached')).toEqual([[]]);
+      });
+    });
+
+    describe('when `loading` prop is `true`', () => {
+      it('does not render `GlIntersectionObserver` component', () => {
+        buildWrapper({
+          items: mockOptions,
+          infiniteScroll: true,
+          loading: true,
+        });
+
+        expect(findIntersectionObserver().exists()).toBe(false);
+      });
+    });
+
+    describe('when `searching` prop is `true`', () => {
+      it('does not render `GlIntersectionObserver` component', () => {
+        buildWrapper({
+          items: mockOptions,
+          infiniteScroll: true,
+          searching: true,
+        });
+
+        expect(findIntersectionObserver().exists()).toBe(false);
+      });
+    });
+
+    describe('when `infiniteScrollLoading` prop is `true`', () => {
+      beforeEach(() => {
+        buildWrapper({
+          items: mockOptions,
+          infiniteScroll: true,
+          infiniteScrollLoading: true,
+        });
+      });
+
+      it('shows loading icon', () => {
+        expect(wrapper.find('[data-testid="listbox-infinite-scroll-loader"]').exists()).toBe(true);
+      });
+
+      it('does not render `GlIntersectionObserver` component', () => {
+        expect(findIntersectionObserver().exists()).toBe(false);
+      });
+    });
+
+    describe('when `totalItems` prop is set', () => {
+      it('adds `aria-setsize` and `aria-posinset` attributes to listbox items', () => {
+        const totalItems = mockOptions.length;
+
+        buildWrapper({
+          items: mockOptions,
+          infiniteScroll: true,
+          totalItems,
+        });
+
+        findListboxItems().wrappers.forEach((listboxItem, index) => {
+          expect(listboxItem.attributes('aria-setsize')).toBe(totalItems.toString());
+          expect(listboxItem.attributes('aria-posinset')).toBe((index + 1).toString());
+        });
+      });
+    });
+
+    describe('when `totalItems` prop is not set', () => {
+      it('does not add `aria-setsize` and `aria-posinset` attributes to listbox items', () => {
+        buildWrapper({
+          items: mockOptions,
+          infiniteScroll: true,
+        });
+
+        findListboxItems().wrappers.forEach((listboxItem) => {
+          expect(listboxItem.attributes('aria-setsize')).toBe(undefined);
+          expect(listboxItem.attributes('aria-posinset')).toBe(undefined);
+        });
+      });
+    });
+  });
+
+  describe('when `infiniteScroll` prop is `false`', () => {
+    it('does not render `GlIntersectionObserver` component', () => {
+      buildWrapper({
+        items: mockOptions,
+        infiniteScroll: false,
+      });
+
+      expect(findIntersectionObserver().exists()).toBe(false);
+    });
+  });
 });

package/src/components/base/new_dropdowns/listbox/listbox.stories.js

@@ -13,6 +13,8 @@ import {
   GlAvatar,
 } from '../../../../index';
 import { makeContainer } from '../../../../utils/story_decorators/container';
+import { disableControls } from '../../../../utils/stories_utils';
+import { setStoryTimeout } from '../../../../utils/test_utils';
 import readme from './listbox.md';
 import { mockOptions, mockGroups } from './mock_data';
 import { flattenedOptions } from './utils';
@@ -28,6 +30,8 @@ const generateProps = ({
   loading = defaultValue('loading'),
   searchable = defaultValue('searchable'),
   searching = defaultValue('searching'),
+  infiniteScroll = defaultValue('infiniteScroll'),
+  infiniteScrollLoading = defaultValue('infiniteScrollLoading'),
   noResultsText = defaultValue('noResultsText'),
   searchPlaceholder = defaultValue('searchPlaceholder'),
   noCaret = defaultValue('noCaret'),
@@ -51,6 +55,8 @@ const generateProps = ({
   loading,
   searchable,
   searching,
+  infiniteScroll,
+  infiniteScrollLoading,
   noResultsText,
   searchPlaceholder,
   noCaret,
@@ -77,6 +83,8 @@ const makeBindings = (overrides = {}) =>
     ':loading': 'loading',
     ':searchable': 'searchable',
     ':searching': 'searching',
+    ':infinite-scroll': 'infiniteScroll',
+    ':infinite-scroll-loading': 'infiniteScrollLoading',
     ':no-results-text': 'noResultsText',
     ':search-placeholder': 'searchPlaceholder',
     ':no-caret': 'noCaret',
@@ -534,3 +542,53 @@ SearchableGroups.args = generateProps({
   items: mockGroups,
 });
 SearchableGroups.decorators = [makeContainer({ height: '370px' })];
+
+export const InfiniteScroll = (
+  args,
+  { argTypes: { infiniteScroll, infiniteScrollLoading, items, ...argTypes } }
+) => ({
+  props: Object.keys(argTypes),
+  components: {
+    GlListbox,
+  },
+  data() {
+    return {
+      selected: mockOptions[1].value,
+      items: mockOptions.slice(0, 10),
+      infiniteScrollLoading: false,
+      infiniteScroll: true,
+    };
+  },
+  mounted() {
+    if (this.startOpened) {
+      openListbox(this);
+    }
+  },
+  methods: {
+    onBottomReached() {
+      this.infiniteScrollLoading = true;
+
+      setStoryTimeout(() => {
+        this.items.push(...mockOptions.slice(10, 12));
+        this.infiniteScrollLoading = false;
+        this.infiniteScroll = false;
+      }, 1000);
+    },
+  },
+  template: template('', {
+    label: `<span class="gl-my-0" id="listbox-label">Select a department</span>`,
+    bindingOverrides: {
+      ':items': 'items',
+      ':infinite-scroll': 'infiniteScroll',
+      ':infinite-scroll-loading': 'infiniteScrollLoading',
+      ':total-items': 12,
+      '@bottom-reached': 'onBottomReached',
+    },
+  }),
+});
+
+InfiniteScroll.argTypes = {
+  ...disableControls(['infiniteScroll', 'infiniteScrollLoading', 'items']),
+};
+InfiniteScroll.args = generateProps();
+InfiniteScroll.decorators = [makeContainer({ height: '370px' })];

package/src/components/base/new_dropdowns/listbox/listbox.vue

@@ -17,6 +17,7 @@ import {
 } from '../../../../utils/constants';
 import GlButton from '../../button/button.vue';
 import GlLoadingIcon from '../../loading_icon/loading_icon.vue';
+import GlIntersectionObserver from '../../../utilities/intersection_observer/intersection_observer.vue';
 import GlSearchBoxByType from '../../search_box_by_type/search_box_by_type.vue';
 import GlBaseDropdown from '../base_dropdown/base_dropdown.vue';
 import GlListboxItem from './listbox_item.vue';
@@ -43,6 +44,7 @@ export default {
     GlSearchBoxByType,
     GlListboxSearchInput,
     GlLoadingIcon,
+    GlIntersectionObserver,
   },
   model: {
     prop: 'selected',
@@ -215,6 +217,37 @@ export default {
       required: false,
       default: false,
     },
+    /**
+     * Enables infinite scroll.
+     * When set to `true`, the `@bottom-reached` event will be fired when
+     * the bottom of the listbox is scrolled to.
+     * Does not support groups.
+     */
+    infiniteScroll: {
+      type: Boolean,
+      required: false,
+      default: false,
+    },
+    /**
+     * This prop is used for infinite scroll.
+     * It represents the total number of items that exist,
+     * even if they have not yet been loaded.
+     * Do not set this prop if the total number of items is unknown.
+     */
+    totalItems: {
+      type: Number,
+      required: false,
+      default: null,
+    },
+    /**
+     * This prop is used for infinite scroll.
+     * Set to `true` when more items are being loaded.
+     */
+    infiniteScrollLoading: {
+      type: Boolean,
+      required: false,
+      default: false,
+    },
     /**
      * Message to be displayed when filtering produced no results
      */
@@ -298,6 +331,9 @@ export default {
       }
       return Boolean(this.selected);
     },
+    showIntersectionObserver() {
+      return this.infiniteScroll && !this.infiniteScrollLoading && !this.loading && !this.searching;
+    },
   },
   watch: {
     selected: {
@@ -324,6 +360,17 @@ export default {
       },
     },
   },
+  created() {
+    if (
+      process.env.NODE_ENV !== 'production' &&
+      this.infiniteScroll &&
+      this.items.some((item) => !isOption(item))
+    ) {
+      throw new Error(
+        'Infinite scroll does not support groups. Please set the "infiniteScroll" prop to "false"'
+      );
+    }
+  },
   methods: {
     open() {
       this.$refs.baseDropdown.open();
@@ -467,6 +514,25 @@ export default {
     closeAndFocus() {
       this.$refs.baseDropdown.closeAndFocus();
     },
+    onIntersectionObserverAppear() {
+      /**
+       * Emitted when bottom of listbox has been scrolled to.
+       * Used for infinite scroll.
+       *
+       * @event bottom-reached
+       */
+      this.$emit('bottom-reached');
+    },
+    listboxItemMoreItemsAriaAttributes(index) {
+      if (this.totalItems === null) {
+        return {};
+      }
+
+      return {
+        'aria-setsize': this.totalItems,
+        'aria-posinset': index + 1,
+      };
+    },
     isOption,
   },
 };
@@ -551,6 +617,7 @@ export default {
             :is-selected="isSelected(item)"
             :is-focused="isFocused(item)"
             :is-check-centered="isCheckCentered"
+            v-bind="listboxItemMoreItemsAriaAttributes(index)"
             @select="onSelect(item, $event)"
           >
             <!-- @slot Custom template of the listbox item -->
@@ -583,8 +650,17 @@ export default {
           </gl-listbox-group>
         </template>
       </template>
+      <gl-intersection-observer
+        v-if="showIntersectionObserver"
+        @appear="onIntersectionObserverAppear"
+      />
     </component>
-
+    <gl-loading-icon
+      v-if="infiniteScrollLoading"
+      data-testid="listbox-infinite-scroll-loader"
+      size="md"
+      class="gl-my-3"
+    />
     <span
       v-if="announceSRSearchResults"
       data-testid="listbox-number-of-results"