consul/ui/packages/consul-ui/app/components/paged-collection
Michael Klein 03a1a86dfe
ui: chore - upgrade ember and friends (#14518)
* v3.20.2...v3.24.0

* Fix handle undefined outlet in route component

* Don't use template helper for optional modal.open

Using the optional-helper here will trigger a computation
in the same runloop error. This is because we are setting
the `modal`-property when the `<Ref>` component gets
rendered which will update the `this.modal`-property which
will then recompute the `optional`-helper leading to this
error.

Instead we will create an action that will call the `open`-method
on the modal when it is defined. This gets rid of the double
computation error as we will not access the modal property
twice in the same runloop when `modal` is getting set.

* Fix - fn needs to be passed function tab-nav

We create functions in the component file instead
so that fn-helper stops complaining about the
need to pass a function.

* Update ember-exam to 6.1 version

"Makes it compatible" with ember-qunit v5

* scheduleOnce setMaxHeight paged-collection

We need to schedule to get around double-computation error.

* Fix - model.data is removed from ember-data

This has been private API all along - we need to
work around the removal.

Reference: https://github.com/emberjs/data/pull/7338/files#diff-9a8746fc5c86fd57e6122f00fef3155f76f0f3003a24b53fb7c4621d95dcd9bfL1310

* Fix `propContains` instead of `deepEqual` policy

Recent model.data works differently than iterating attributes.
We use `propContains` instead of `deepEqual`. We are only
interested in the properties we assert against and match
the previous behavior with this change.

* Fix `propContains` instead of `deepEqual` token

* Better handling single-records repo test-helper

`model.data` has been removed we need to handle proxies and
model instances differently.

* Fix remaining repository tests with propContains

We don't want to match entire objects - we don't care
about properties we haven't defined in the assertion.

* Don't use template helper for optional modal.open

Using a template helper will give us a recomputation error -
we work around it by creating an explicit action on
the component instead.

* Await `I $verb the $pageObject object` step

* Fix no more customization ember-can

No need to customize, the helper handles destruction
fine on its own.

* Fix - don't pass `optional` functions to fn

We will declare the functions on the component instead.
This gives us the same behavior but no error from
`fn`, which expects a function to be passed.

* Fix - handle `undefined` state on validate modifier

StateChart can yield out an undefined `state` we need
to handle that in the validate modifier

* Fix linting errors tests directory

* Warn / turn off new ember linting issues

We will tackle them one by one and don't want to
autofix issues that could be dangerous to auto-fix.

* Auto-fix linting issues

* More linting configuration

* Fix remaining linting issues

* Fix linting issues new files after rebase

* ui: Remove ember-cli-uglify config now we are using terser (#14574)

Co-authored-by: John Cowen <johncowen@users.noreply.github.com>
2022-09-15 09:43:17 +01:00
..
README.mdx
index.hbs
index.js
index.scss

README.mdx

# PagedCollection

A renderless component to act as a helper for different types of pagination.

```hbs preview-template
<figure>
  <figcaption>
    Provide a widget so we can try switching between two pagination methods
  </figcaption>
  <select
    onchange={{action (mut this.type) value="target.value"}}
  >
    <option>virtual-scroll</option>
    <option>index</option>
  </select>
</figure>

<figure>
  <figcaption>Get some data and page it</figcaption>
  <DataSource
    @src={{uri "/partition/default/dc-1/nodes"}}
  as |source|>
    <PagedCollection
      @type={{or this.type "virtual-scroll"}}
      @items={{or source.data (array)}}
      @perPage={{8}}
      @page={{or this.page 1}}
      @rowHeight="43"
    as |pager|>
      <div
        style={{{style-map
          (array 'outline' '1px solid rgb(var(--tone-gray-300))')
          (array 'max-height' '360' 'px')
          (array '--paged-row-height' (if (not-eq this.type 'index') '43px'))
        }}}
        {{did-insert pager.viewport}}
        {{on-resize pager.resize}}
      >
        <ul
          style={{{style-map
            (array 'height' pager.totalHeight 'px')
            (array '--paged-start' pager.startHeight 'px')
          }}}
        >
        {{#each pager.items as |item|}}
          <li
            style={{{style-map
              (array 'height' '43' 'px')
              (array 'outline' '1px solid rgb(var(--tone-gray-100))')
            }}}
          >
            {{item.Node}}
          </li>
        {{/each}}
        </ul>
      </div>
      <pager.Pager>
        <div
          style={{{style-map
            (array 'display' 'flex')
            (array 'flex-direction' (if (not-eq pager.page pager.totalPages) 'row-reverse'))
            (array 'justify-content' 'space-between')
          }}}
        >
        {{#if (not-eq pager.page pager.totalPages)}}
        <Action
          {{on 'click' (set this 'page' (add pager.page 1))}}
        >
          Next
        </Action>
        {{/if}}
        {{#if (not-eq pager.page 1)}}
          <Action
            {{on 'click' (set this 'page' (sub pager.page 1))}}
          >
            Prev
          </Action>
        {{/if}}
        </div>
      </pager.Pager>
    </PagedCollection>
  </DataSource>
</figure>
```

## Arguments

| Argument | Type | Default | Description |
| --- | --- | --- | --- |
| `type` | `(native-scroll \| virtual-scroll \| index)` | `native-scroll` | The type of pagination |
| `items` | `array` | `undefined` | An array or items to be paginated |
| `rowHeight` | `(string \| number)` | `undefined` | When `@type=virtual-scroll` this informs the scroller of the size of each row in the scroll pane. For the moment this _must_ be the same for every row. |
| `page` | `number` | `undefined` | When `@type=index` this is the current page number to show |
| `perPage` | `number` | `undefined` | When `@type=index` this is the amount of rows to show per page |

## Exported API

| Name | Type | Description |
| --- | --- | --- |
| `items` | `array` | An array of the items to be shown on the current page |
| `page` | `number` | The current page number (a mirror of @page) |
| `resize` | `Function` | Function to be called on the resize of the viewport |
| `viewport` | `Function` | Function to be called on the `did-insert` of the viewport to be used for scrolling |
| `rowHeight` | `Function` | Function to be called to set the rowHeight of the virtual-scroller |
| `startHeight` | `number` | Size of the area before the panel to be virtually-scroller, usually you should use this to set `--paged-start` wrapping element of the scrollable items |
| `totalHeight` | `number` | Size of the of the entire panel in order to show the correctly sized scroll thumb |
| `totalPages` | `number` | Totol number of pages |