@# Collapsible list

The `CollapsibleList` component accepts a list of menu items and a count of
visible items. It shows precisely that many items and collapses the rest into a
dropdown menu. The required `visibleItemRenderer` callback prop allows for
customizing the appearance of visible items, using the props from the `MenuItem`
children.

<div class="@ns-callout @ns-intent-danger @ns-icon-error">
    <h4 class="@ns-heading">

Deprecated: use [Overflow list](#core/components/overflow-list)
</h4>

This component is **deprecated since 3.0.0** with the introduction of
[`OverflowList`](#core/components/overflow-list) which provides a similar
experience with two distinct advantages:

<ol>
    <li>Items collapse automatically based on available space in the container.</li>
    <li>

`OverflowList` accepts a generic array of items (instead of explicit
`<MenuItem>` children) with custom renderers for both visible and overflowed
items, allowing for _any_ UI, not just a dropdown menu.

</li>
</ol>

</div>

@reactExample CollapsibleListExample

@## Separators

Often a list of items calls for separators between each item.
Adding separators to a `CollapsibleList` is easily achieved via CSS using `::after` pseudo-elements.

```css.scss
// pass `visibleItemClassName="my-list-item"` to component, then...

.my-list-item::after {
    display: inline-block;
    content: "";
    // custom separator styles...
}

// remove separator after the last item
.my-list-item:last-child::after {
    display: none;
}
```

@## Props

Children of the `CollapsibleList` component _must_ be `MenuItem`s so they can be easily rendered
in the dropdown. Define a `visibleItemRenderer` callback to customize the appearance of visible
items using their [`IMenuItemProps`](#core/components/menu.menu-item).

@interface ICollapsibleListProps