@gfazioli/mantine-lens-select

中文文档
1.0.18发布于 2026/11/09MITTypeScriptESM + CJS零依赖近 30 天下载 2284

A fisheye/lens magnification select component for React built with Mantine. Displays items with a macOS Dock-like magnification effect on hover. Supports count mode (no data array needed), min/max/step range, horizontal/vertical orientations, configurable

原始使用文档
文档目录8 节
  1. Overview
  2. Features
  3. Installation
  4. Usage
  5. Simple count mode
  6. Range with step
  7. Custom data
  8. Sponsor

Mantine Lens Select Component

Mantine Lens Select

mantine-lens-select at a glance, refreshed daily: commits, releases, stars, issues and pull requests, a year of commit activity, the weekly rhythm, languages, latest commits and releases, contributors
Made with glancecard · refreshed daily

Overview

This component is created on top of the Mantine library.

The Mantine Lens Select component is a fisheye/lens magnification select for React applications built with Mantine. It displays a list of items with a macOS Dock-like magnification effect on hover, where items near the cursor scale up creating an interactive and visually engaging selection experience.

Features

  • Fisheye/lens magnification effect on hover (macOS Dock-like)
  • Count mode: <LensSelect count={15} /> — no data array needed
  • Range mode: min/max/step props (like Mantine Slider)
  • Horizontal and vertical orientation support
  • Configurable magnification, lens range, scale, opacity, and blur effects
  • Controlled and uncontrolled modes via value/defaultValue/onChange
  • Keyboard navigation (Arrow keys, Home, End) with optional loop
  • Mouse wheel and touch/swipe navigation
  • Custom item rendering via renderItem callback
  • LensSelect.Indicator compound component for selection indicator
  • Full Mantine Styles API support
  • WAI-ARIA listbox pattern for accessibility
  • GPU-optimized with targeted will-change
  • TypeScript — full type safety out of the box

[!note]

Demo and Documentation | More Mantine Components

Installation

npm install @gfazioli/mantine-lens-select

or

yarn add @gfazioli/mantine-lens-select

After installation import package styles at the root of your application:

import '@gfazioli/mantine-lens-select/styles.css';

Usage

Simple count mode

import { LensSelect } from '@gfazioli/mantine-lens-select';

function Demo() {
  return <LensSelect count={20} />;
}

Range with step

<LensSelect min={0} max={100} step={10} withIndicator />

Custom data

import { LensSelect } from '@gfazioli/mantine-lens-select';

const data = [
  { value: 'home', view: <span>🏠</span> },
  { value: 'search', view: <span>🔍</span> },
  { value: 'mail', view: <span>📧</span> },
  { value: 'settings', view: <span>⚙️</span> },
];

function Demo() {
  return <LensSelect data={data} withIndicator />;
}

Sponsor

Your support helps me:

  • Keep the project actively maintained with timely bug fixes and security updates
  • Add new features, improve performance, and refine the developer experience
  • Expand test coverage and documentation for smoother adoption
  • Ensure long-term sustainability without relying on ad hoc free time
  • Prioritize community requests and roadmap items that matter most

Open source thrives when those who benefit can give back - even a small monthly contribution makes a real difference. Sponsorships help cover maintenance time, infrastructure, and the countless invisible tasks that keep a project healthy.

Your help truly matters.

Become a sponsor today and help me keep this project reliable, up-to-date, and growing for everyone.

版本与发布记录

@gfazioli/mantine-lens-select 共发布 19 个版本,首次发布于 2026/04/09;过去 12 个月发布了 19 个版本。

版本发布日期距今
1.0.18latest2026/11/097 天前
1.0.172026/11/069 天前
1.0.162026/10/2621 天前
1.0.152026/10/2225 天前
1.0.142026/10/131 个月前
1.0.132026/10/101 个月前

关于 @gfazioli/mantine-lens-select 的常见问题

@gfazioli/mantine-lens-select 是什么?

A fisheye/lens magnification select component for React built with Mantine. Displays items with a macOS Dock-like magnification effect on hover. Supports count mode (no data array needed), min/max/step range, horizontal/vertical orientations, configurable

如何安装 @gfazioli/mantine-lens-select?

在项目目录运行 npm install @gfazioli/mantine-lens-select,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.x || ^19.x)、react-dom(^18.x || ^19.x)、@mantine/core(>=9.0.0)、@mantine/hooks(>=9.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@gfazioli/mantine-lens-select 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@gfazioli/mantine-lens-select 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@gfazioli/mantine-lens-select 可以商用吗?

@gfazioli/mantine-lens-select 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gfazioli/mantine-lens-select 的下载量有多少?

根据 npm 官方下载统计,@gfazioli/mantine-lens-select 在 2026/10/17 – 2026/11/15 这 30 天内被下载 2,284 次,日均约 76 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gfazioli/mantine-lens-select 还在维护吗?

最新版本 1.0.18 发布于 2026/11/09(7 天前);至今共发布 19 个版本,其中过去 12 个月发布了 19 个;首次发布于 2026/04/09。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。