# Article Slider block

> Blog article carousel with cover cards, circular prev/next controls and a progress-line indicator

Featured-article blog carousel with circular prev/next buttons and a 1px progress line as position indicator. Cover scales on hover; category badge and read time. shadcn Carousel, Progress, AspectRatio, Badge, Card. Article slider, featured posts.

- Type: Pro block
- Category: [Blog](https://web.dev.reui.io/blocks/marketing/blog.md)
- Page: https://web.dev.reui.io/blocks/marketing/blog/blog-3
- MCP: `get_block("blog-3")`
- Built with: Aspect Ratio, Badge, Card, Carousel, Progress
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

A post slider stepped by round previous and next buttons, with a 1px progress line that fills to the last visible post

## Agent notes

- `BLOG_POSTS` holds 6 sample posts with Unsplash `COVER` images; the progress math and its screen reader label also read `BLOG_POSTS.length`, so swap every use
- `getVisibleArticleCount` hardcodes 1, 2 or 3 visible cards to match the `CarouselItem` basis classes; change both together
- The category `Badge` in `PostCard` renders as a link with a placeholder `href`, apart from the cover and title links

## When not to use

- A static grid where every post stays visible with its excerpt and author: use [Blog Index Grid](https://web.dev.reui.io/blocks/marketing/blog/blog-1.md) (`get_block("blog-1")`)

## Third-party libraries

- Embla Carousel v8: [API reference](https://www.embla-carousel.com/docs/v8/api), [docs](https://www.embla-carousel.com/docs/v8/get-started/react), through shadcn Carousel

## Install

```bash
npx shadcn@latest add @reui/blog-3
```

## About Blog blocks

### When to use

- A blog, news or insights index of post cards with cover images, in a grid or a carousel
- A single article reading page with a byline, body sections, topic tags and related posts

### When not to use

- Dashboard tiles for KPIs, profiles or setup guides, with no article to read: use the [Card blocks](https://web.dev.reui.io/blocks/application/card.md)
- A dashboard side panel of figures, transactions or integrations, one record per row: use the [List blocks](https://web.dev.reui.io/blocks/application/list.md)
- Photo tiles that send shoppers into a store department or collection: use the [Category Card blocks](https://web.dev.reui.io/blocks/ecommerce/category-card.md)

### Agent notes

- Every root component takes no props and renders `BLOG_POSTS` or `ARTICLE` from components/data.ts; add a prop to pass in posts from your CMS
- Every link is a hash `href` placeholder and every cover `img` loads an Unsplash demo image; swap in your post routes and covers
- Each page.tsx wraps the block in a padded `min-h-svh` container; remove it when the block renders inside your site layout

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.
