Title: Gredich Smooth Scroll
Author: Gredich
Published: <strong>2026 年 7 月 15 日</strong>
Last modified: 2026 年 7 月 15 日

---

搜索插件

![](https://ps.w.org/gredich-smooth-scroll/assets/icon-256x256.png?rev=3609283)

# Gredich Smooth Scroll

 作者：[Gredich](https://profiles.wordpress.org/gredich/)

[下载](https://downloads.wordpress.org/plugin/gredich-smooth-scroll.1.0.0.zip)

 * [详情](https://cn.wordpress.org/plugins/gredich-smooth-scroll/#description)
 * [评价](https://cn.wordpress.org/plugins/gredich-smooth-scroll/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/gredich-smooth-scroll/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/gredich-smooth-scroll/#developers)

 [支持](https://wordpress.org/support/plugin/gredich-smooth-scroll/)

## 描述

Adds Lenis library for smooth scrolling with a full settings page — no coding required.
Unlike headless wrappers, it includes:

Features:
 * GSAP/ScrollTrigger integration * Smooth anchor links with configurable
offset * Automatic nested scroll detection * Exclude specific elements by ID or 
class * Support for both vertical and horizontal scrolling * Touch device support
with adjustable sensitivity * Easy-to-use settings page

### Development

Build assets (JS, CSS) are copied from the `lenis` npm package.
 Source code and
full development repository available at: – Lenis library: https://github.com/darkroomengineering/
lenis

## 安装

 1. Upload the `gredich-smooth-scroll` folder to the `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Go to Settings > Gredich Smooth Scroll to configure the plugin

## 常见问题

### How do I exclude an element from smooth scrolling?

There are two ways:

 1. **Using data attributes (recommended):** Add `data-lenis-prevent` attribute to 
    any HTML element you want to exclude. For finer control, use:

 Attribute
 Description

 `data-lenis-prevent`
 Prevent all smooth scroll events

 `data-lenis-prevent-wheel`
 Prevent wheel events only

 `data-lenis-prevent-touch`
 Prevent touch events only

 `data-lenis-prevent-vertical`
 Prevent vertical scroll events only

 `data-lenis-prevent-horizontal`
 Prevent horizontal scroll events only

 1. **Using the settings page:** Go to Settings > Gredich Smooth Scroll and add the
    element’s ID or class to the exclusion list.

### What is the difference between ID and class selectors?

 * ID selectors start with `#` (e.g., `#my-element`)
 * Class selectors start with `.` (e.g., `.my-class`)

### Can I use both methods together?

Yes! You can combine data attributes with ID/class exclusions.

### How does the plugin handle nested scroll elements?

By default, the plugin automatically detects nested scrollable elements and lets
them scroll natively. You can control this behavior from **Settings > Gredich Smooth
Scroll** using the “Allow Nested Scroll” option.

 * **Enabled (default):** Lenis detects nested scroll containers automatically. 
   Best for most sites.
 * **Disabled:** Disable only if you experience performance issues and prefer to
   manually exclude elements using the data attributes or exclusion list above.

## 评价

此插件暂无评价。

## 贡献者及开发者

「Gredich Smooth Scroll」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ Gredich ](https://profiles.wordpress.org/gredich/)
 *   [ Diego ](https://profiles.wordpress.org/diarpu/)

[帮助将「Gredich Smooth Scroll」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/gredich-smooth-scroll)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/gredich-smooth-scroll/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/gredich-smooth-scroll/)，或通过[RSS](https://plugins.trac.wordpress.org/log/gredich-smooth-scroll/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/gredich-smooth-scroll/)。

## 更新日志

#### 1.0.0

 * Initial release

## 额外信息

 *  版本 **1.0.0**
 *  最后更新：**3 周前**
 *  活跃安装数量 **不到10**
 *  WordPress 版本 ** 5.8 或更高版本 **
 *  已测试的最高版本为 **7.0.2**
 *  PHP 版本 ** 7.4 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/gredich-smooth-scroll/)
 * 标签
 * [lenis](https://cn.wordpress.org/plugins/tags/lenis/)[scroll](https://cn.wordpress.org/plugins/tags/scroll/)
   [scrolling](https://cn.wordpress.org/plugins/tags/scrolling/)[smooth](https://cn.wordpress.org/plugins/tags/smooth/)
   [smooth scroll](https://cn.wordpress.org/plugins/tags/smooth-scroll/)
 *  [高级视图](https://cn.wordpress.org/plugins/gredich-smooth-scroll/advanced/)

## 评级

尚未提交反馈。

[Your review](https://wordpress.org/support/plugin/gredich-smooth-scroll/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/gredich-smooth-scroll/reviews/)

## 贡献者

 *   [ Gredich ](https://profiles.wordpress.org/gredich/)
 *   [ Diego ](https://profiles.wordpress.org/diarpu/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/gredich-smooth-scroll/)