1153 server side pagination

[GCHQ-Developer-741]

Summary of the changes

• Added a new slot to ic-data-table, called pagination-bar, where a user can use their own pagination-bar to control pagination when interacting with backend APIs.
• Added react and web-component stories to show the new slot
• Did some minor refactoring and added a check to ic-pagination-bar, to prevent infinite state loops when the same array contents are being received by the pagination-bar, triggering the watch handler
• Added slot definition to canary-docs

Related issue

1153

Checklist

General

• [x] Changes to docs package checked and committed.
• [x] All acceptance criteria reviewed and met.

Testing

• [x] Relevant unit tests and visual regression tests added.
• [x] Visual testing against Figma component specification completed.

Accessibility

• [x] Accessibility Insights FastPass performed.
• [x] A11y unit test added and yields no issues.
• [x] A11y plug-in on Storybook yields no issues.
• [x] Manual screen reader testing performed using NVDA and VoiceOver.
• [x] Manual keyboard testing for keyboard controls and logical focus order.
• [x] Correct roles used and ARIA attributes used correctly where required.
• [x] Logical heading structure is maintained, and the HTML elements used for headings can be changed to fit within the wider page structure.

Resize/zoom behaviour

• [x] Page can be zoomed to 400% with no loss of content.
• [x] Screen magnifier used with no issues.
• [x] Text resized to 200% with no loss of content.
• [x] Text spacing increased as per the WCAG 1.4.12 success criterion with no loss of content.

System modes

• [x] Browser setting 'prefers reduced motion' tested. No animations or motion visible whilst this setting is on.
• [x] Windows High Contrast mode tested with no loss of content.
• [x] System light and dark mode tested with no loss of content.
• [x] Browser support tested (Chrome, Safari, Firefox and Edge).

Testing content extremes

• [x] Min/max content examples tested with no loss of content or overflow.
• [x] All prop combinations work without issue.
• [x] Tested for FOUC (Flash of Unstyled Content) in both SSR (Server-Side Rendering) and SSG (Static Site Generation) settings.
• [x] Controlled and uncontrolled input components tested.

[github-actions[bot]]

View your branch deployment here: https://mi6.github.io/ic-ui-kit/branches/1153-server-side-pagination/web-components View your React branch deployment here: https://mi6.github.io/ic-ui-kit/branches/1153-server-side-pagination/react View your NextJs branch deployment here: https://mi6.github.io/ic-ui-kit/branches/1153-server-side-pagination/nextjs

[ad9242]

Should it be made clearer that the paginationBarOptions prop on data table is only used by the built in pagination bar and not if you use the slot?