Use BitCarousel with customized style, visible items count, and scroll items count for advanced scenarios.
+
+
+ The VisibleItemsCount parameter lays several slides out side by side, and ScrollItemsCount sets how many of
+ them a navigation moves at a time, so the carousel can page through its items in groups or advance them one
+ by one. The two of them together decide where the carousel stops: a page is one step of it, which is what a
+ dot stands for and what OnChange reports, so a carousel that shows three slides and moves them one at a time
+ gets a dot per slide rather than one per screenful, and its dots keep up with it.
+
+
+ Three at a time, moved three at a time (three pages of three slides):
+
+
+ The same nine slides shown three at a time but moved one at a time, which stops in seven places instead of
+ three. The slides the next step shares with the current one stay where they are instead of being thrown out
+ and animated back in.
+
+
+
+
+ 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+
+
+
+
+
+
+
+ The way the carousel is operated by hand is configurable: NoDrag turns off dragging it with the pointer,
+ NoKeyboard takes it out of the tab sequence and turns off the arrow key navigation (arrow keys, Home and
+ End), Wheel navigates it with the mouse wheel (or a trackpad scroll), and DragThreshold sets how far a drag
+ has to travel before it counts. A drag that travels further across the carousel than along it is left alone,
+ so scrolling a page by dragging over a carousel never flips its slides; and a wheel moves the carousel
+ forwards when it is scrolled away from the reader (down, or right), whichever way its slides are laid out.
+
+
+ This carousel is navigated with the mouse wheel and cannot be dragged:
+
+
+
+ 1
+ 2
+ 3
+ 4
+ 5
+ 6
+
+
+
+
+
+
+ The AnimationDuration parameter sets how long the slide transition takes, in seconds (0.5 by default).
+ A value of 0 moves the slides at once, with no animation at all, and the same duration also drives the
+ cross-fade speed of the Fade effect.
+
+
+ Slow transition (1.5 seconds):
+
+
+
+ No animation (0 seconds):
+
+
+
+
+
+
+ The DefaultPage parameter sets the page (1 based, like GoTo) the carousel shows when it first renders.
+ It is only read during the first layout, so changing it afterwards does not move the carousel (use GoTo
+ for that), and values outside of the range of the carousel are clamped to its first or last page.
+
+
+
+
+ 1
+ 2
+ 3
+ 4
+ 5
+
+
+
+
+
+
+ The ResponsiveOptions parameter adapts VisibleItemsCount and ScrollItemsCount to the width of the carousel.
+ Each option applies while the carousel is no wider than its Breakpoint (in pixels) and the narrowest matching
+ one wins, so the options can be listed in any order; a carousel wider than every breakpoint keeps the counts
+ of its own parameters. The width that is matched is the width of the carousel itself rather than of the
+ window, so the same carousel adapts to the room it is given inside a sidebar and across a full width page.
+
+
+ Resize the window (or this panel) to watch the number of slides change:
+
+
+
+ 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+
+
+
+
+
+
+ The DotTemplate parameter replaces the content of a dot, receiving the zero based index of the page it
+ navigates to, so the row below the slides can carry page numbers, thumbnails, or anything else. A dot that
+ holds content is laid out around it instead of being drawn as the default circle, and it keeps the
+ accessible label (DotAriaLabel) and the current page marker the carousel gives it either way.
+
+
+ Numbered dots:
+
+
+
+ @(index + 1)
+
+ 1
+ 2
+ 3
+ 4
+
+
+
+
+ Thumbnails of the slides they navigate to:
+
+
+
+
+
+
+ The carousel follows the carousel pattern of the ARIA authoring practices out of the box: its root is a
+ region marked as a carousel, every slide is a group marked as a slide, the slides that are scrolled out of
+ the view are taken out of the reading and the tab order, all of the controls are real buttons that point at
+ the slides they move with aria-controls, and the play/pause button is the first thing the keyboard reaches
+ so the motion can be stopped before anything else. The text of all of that is yours to set:
+
+
+
+ - AriaLabel names the carousel region, which is what a screen reader announces on the way in.
+ - ItemAriaLabelFormat names the slides that carry no label of their own ("{0} of {1}" by default, where {0} is the position of the slide and {1} the number of slides); a slide that deserves a better name takes an AriaLabel of its own.
+ - DotsAriaLabel names the group of dots and DotAriaLabel prefixes each one of them, which is followed by the number of the page it navigates to.
+ - GoLeftAriaLabel and GoRightAriaLabel name the navigation buttons, which otherwise are labelled after what they do (which flips with the direction of the carousel).
+ - PlayButtonAriaLabel and PauseButtonAriaLabel name the rotation control in each of its two states.
+
+
+
+
+
+
+
+ The Color parameter offers the general colors of the theme for the chrome of the carousel: it colors the dot
+ of the current page and the navigation buttons. The Accent parameter is its lighter-weight sibling that only
+ offers the primary/secondary/tertiary/transparent kinds for the current dot.
+
+
+
+
+
Primary
+
+ 1
+ 2
+ 3
+
+
+
+
Success
+
+ 1
+ 2
+ 3
+
+
+
+
Warning
+
+ 1
+ 2
+ 3
+
+
+
+
Error
+
+ 1
+ 2
+ 3
+
+
+
+
+
+
Use icons from external libraries like FontAwesome, Material Icons, and Bootstrap Icons with the GoLeftIcon and GoRightIcon parameters.
@@ -209,22 +624,22 @@
GoLeftIcon="@BitIconInfo.Fa("solid circle-arrow-right")"
GoRightIcon="@BitIconInfo.Fa("solid circle-arrow-left")">
-
+
Aurora
This is Aurora and it's fantastic
-
+
Beautiful Mountain
This is a Beautiful Mountain and it's gorgeous
-
+
Forest In The Valley
This is a Forest In The Valley and it's beautiful
-
+
Road Among The Mountains
This is a Road Among The Mountains and it's amazing
@@ -240,30 +655,86 @@
GoLeftIcon="@BitIconInfo.Bi("arrow-right-circle")"
GoRightIcon="@BitIconInfo.Bi("arrow-left-circle")">
-
+
Aurora
This is Aurora and it's fantastic
-
+
Beautiful Mountain
This is a Beautiful Mountain and it's gorgeous
-
+
Forest In The Valley
This is a Forest In The Valley and it's beautiful
-
+
Road Among The Mountains
This is a Road Among The Mountains and it's amazing