创建我的第一个 JavaScript 库的旅程是变革性的,帮助我成长。我是怎么到这里的?让我们从头开始吧。
完成 UnifyUI Blocks 和 Flexiwind Blocks 的测试版后,我和我的朋友面临着一个挑战:添加下拉列表、折叠和选项卡等交互式组件。
由于 UnifyUI 和 Flexiwind 不同:一个使用 UnoCSS,另一个使用 TailwindCSS,我们最初为两者编写单独的脚本。但很快我们就发现这是一个不太理想的解决方案。
在研究了 Preline 如何处理与为 TailwindCSS 定制的专用 JavaScript 插件的交互后,我们发现需要一个与 CSS 框架无关的解决方案。
创建一个与 CSS 框架无关的库对我们来说至关重要,因为我们希望 Flexilla 能够与任何 CSS 框架甚至与纯 CSS无缝协作。许多开发人员,包括使用 UnoCSS、TailwindCSS 甚至 Bootstrap 的开发人员,应该能够灵活地不受限制地增强其组件。
通过使 Flexilla 独立于特定框架,我们可以提供适用于许多不同类型项目的多功能工具。它还与我们在 UnifyUI 和 Flexiwind Blocks 上所做的工作保持一致,其中灵活性是关键。
受到 Preline 和 Flowbite 插件的启发,我们决定创建完全开源的 Flexilla。
Flexilla 是一个独立的库,旨在独立管理交互,而不依赖于任何特定的 CSS 框架。它提供了与 TailwindCSS、UnoCSS 或任何其他 CSS 技术顺利集成的灵活性。
我们的目标是以不限于特定 CSS 环境的方式增强组件。
一开始,我不知道从哪里开始。我应该克隆 Preline 并对其进行调整吗?不,那对我没有帮助,因为我的目标是通过这个项目学习。
一开始,我的代码一团糟:不可读且难以理解。
我有一个“packages”文件夹,这是一场灾难!这使得单独发布某些包变得困难,所以我需要一个解决方案。
解决方案
我发现了一篇关于勒纳的文章,立即引起了我的兴趣。经过几天的阅读文档和重组代码后,我拥有了一个令我自豪的组织。 Lerna 允许我简化更新、管理单一存储库中的多个包并独立发布它们。
是的,我面临这样的困境:我是否应该使用 PopperJS?
这是一个很大的挑战,但我会把这个故事留到以后的文章中。
这是一个主要的绊脚石。我最初以 1.0.0 版本发布了该库及其所有包……发布后,我意识到某些包存在问题。因此,对于每次修复,我都会发布该库及其软件包的新版本。坏主意!最终,一位朋友建议我阅读一篇关于 SEMVER 的文章,突然间,版本控制变得有意义了——尽管我有点晚了。
这就是我最终得到版本 2.x.x 的库的原因。从那时起,我就不再犯这些错误了。有了Lerna,我不再需要担心更改尚未更新的软件包版本; Lerna 帮我处理这件事。
Flexilla 不依赖于任何特定的 CSS 框架,使其与 TailwindCSS、UnoCSS 甚至 plain CSS 兼容。这种灵活性确保您可以将其与您的项目集成,无论您使用什么 CSS 框架。
Flexilla 提供模块化组件,例如下拉菜单、选项卡和折叠。这些组件是轻量级的,易于根据需要添加,因此您只需添加要使用的组件,这有助于性能和捆绑包大小。
该库具有易于使用的 API,只需最少的配置。这是如何设置下拉组件的简单示例:
import { Dropdown } from '@flexilla/flexilla'; Dropdown.init("#myDropdown");
此示例展示了如何仅用几行代码即可快速初始化下拉列表,从而使各个级别的开发人员都可以轻松访问它。
Inspired by headless UI libraries, Flexilla allows you to control the styles completely, so you’re not limited by predefined designs or themes. This makes it easy to integrate into custom-styled projects and ensures it won’t conflict with existing styles.
Flexilla components come with customizable events. For example, you can add actions to respond to user actions or customize behaviors for specific interactions, like on dropdown open or tab change.
const myDropdown = new Dropdown('#myDropdown', { onShow: () => console.log('Dropdown is shown!'), onHide: () => console.log('Dropdown is hidden!'), }); const myAccordionEl = document.querySelector("#myAccordion") const myAccordion = Accordion.init(myAccordionEl) myAccordionEl.addEventListener("change-item",()=>{ console.log("Accordion item changed") })
Use Flexilla when you're working on a project where you don't want to use a JavaScript framework but need interactive components with accessibility in mind. (Recommended: AstroJS, PHP and PHP frameworks, Static Websites)
It can work well with VueJS, but it's not recommended. With ReactJS, don't even try!
Flexilla will continue to evolve. I plan to add more components, improve the existing ones, and refine the documentation. In addition to existing components, I plan to introduce other common components like notifications and toasts. This will allow Flexilla to support a wider range of interactive needs.
According to my needs, Flexilla has proven to be a valuable tool for creating interactive components in my projects.
Starting out can be scary. I was afraid no one would appreciate my work, afraid it wouldn't serve any purpose. But I assure you, not trying is the biggest mistake. Today, I have no regrets about creating this library. It has allowed me to learn so much : code organization, versioning, managing npm packages… Don’t hesitate to share your solution with the world and be open to feedback, whether positive or negative. It will help you grow!
If you have ideas, suggestions, or code improvements, don’t hesitate to fork the repository, submit a pull request, or open an issue. Together, we can enhance the library and create a valuable resource for developers everywhere.
On that note, take care, and don’t forget to check out Flexilla and let me know what you think!
以上是我的 Flexilla 构建之旅:无头交互式组件库的详细内容。更多信息请关注PHP中文网其他相关文章!