」工欲善其事,必先利其器。「—孔子《論語.錄靈公》
首頁 > 程式設計 > 我的 Flexilla 建置之旅:無頭互動式元件庫

我的 Flexilla 建置之旅:無頭互動式元件庫

發佈於2024-11-02
瀏覽:418

My Journey to Building Flexilla: Headless interactive component library

创建我的第一个 JavaScript 库的旅程是变革性的,帮助我成长。我是怎么到这里的?让我们从头开始吧。

完成 UnifyUI Blocks 和 Flexiwind Blocks 的测试版后,我和我的朋友面临着一个挑战:添加下拉菜单、折叠和选项卡等交互式组件。

由于 UnifyUI 和 Flexiwind 不同:一个使用 UnoCSS,另一个使用 TailwindCSS,我们最初为两者编写单独的脚本。但很快我们就发现这不是一个理想的解决方案。

在研究了 Preline 如何处理与为 TailwindCSS 定制的专用 JavaScript 插件的交互后,我们发现需要一个与 CSS 框架无关的解决方案。

为什么 CSS 框架无关?

创建一个与 CSS 框架无关的库对我们来说至关重要,因为我们希望 Flexilla 能够与任何 CSS 框架甚至与纯 CSS无缝协作。许多开发人员,包括使用 UnoCSSTailwindCSS 甚至 Bootstrap 的开发人员,应该能够灵活地不受限制地增强其组件。

通过使 Flexilla 独立于特定框架,我们可以提供适用于许多不同类型项目的多功能工具。它还与我们在 UnifyUI 和 Flexiwind Blocks 上所做的工作保持一致,其中灵活性是关键。

解决方案

受到 Preline 和 Flowbite 插件的启发,我们决定创建完全开源的 Flexilla。

Flexilla 是一个独立的库,旨在独立管理交互,而不依赖于任何特定的 CSS 框架。它提供了与 TailwindCSS、UnoCSS 或任何其他 CSS 技术顺利集成的灵活性。

我们的目标是以不限于特定 CSS 环境的方式增强组件。

挑战

起初,我不知道从哪里开始。我应该克隆 Preline 并对其进行调整吗?不,那对我没有帮助,因为我的目标是通过这个项目学习

代码组织

一开始,我的代码一团糟:不可读且难以理解。

我有一个“packages”文件夹,这是一场灾难!这使得单独发布某些包变得困难,所以我需要一个解决方案。

解决方案

我发现了一篇关于勒纳的文章,立即引起了我的兴趣。经过几天的阅读文档和重组代码后,我拥有了一个令我自豪的组织。 Lerna 允许我简化更新、管理单一存储库中的多个包并独立发布它们。

波普尔JS?

是的,我面临这样的困境:我是否应该使用 PopperJS?

这是一个巨大的挑战,但我会将这个故事留到以后的文章中。

版本控制

这是一个主要的绊脚石。我最初以 1.0.0 版本发布了该库及其所有包……发布后,我意识到某些包存在问题。因此,对于每次修复,我都会发布该库及其软件包的新版本。坏主意!最终,一位朋友建议我阅读一篇关于 SEMVER 的文章,突然间,版本控制变得有意义了——尽管我有点晚了。

这就是我最终得到版本 2.x.x 的库的原因。从那时起,我就不再犯这些错误了。有了Lerna,我不再需要担心更改尚未更新的软件包版本; Lerna 帮我处理这件事。

特征

1. CSS框架不可知论

Flexilla 不依赖于任何特定的 CSS 框架,使其与 TailwindCSSUnoCSS 甚至 plain CSS 兼容。这种灵活性确保您可以将其与您的项目集成,无论您使用什么 CSS 框架。

2. 模块化组件

Flexilla 提供模块化组件,例如下拉菜单、选项卡和折叠。这些组件是轻量级的,易于根据需要添加,因此您只需添加要使用的组件,这有助于性能捆绑包大小

3. 简单API

该库具有易于使用的 API,只需最少的配置。这是如何设置下拉组件的简单示例:

   import { Dropdown } from '@flexilla/flexilla';
   Dropdown.init("#myDropdown");

此示例展示了如何仅用几行代码即可快速初始化下拉列表,从而使各个级别的开发人员都可以轻松访问它。

4. 无头架构

受无头 UI 库的启发,Flexilla 允许您完全控制样式,因此您不受预定义设计或主题的限制。这使得它可以轻松集成到自定义样式的项目并确保它不会与现有样式冲突。

5. 自定义事件

Flexilla 组件附带可自定义事件。例如,您可以添加操作来响应用户操作或自定义特定交互的行为,例如打开下拉列表或选项卡更改时。

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")
})

何时何地使用图书馆?

当您处理的项目不想使用 JavaScript 框架但需要考虑到可访问性的交互式组件时,请使用 Flexilla。 (推荐:AstroJS、PHP 和 PHP 框架、静态网站)
它可以与 VueJS 很好地配合,但不推荐。使用 ReactJS,甚至不要尝试!

Flexilla 的下一步是什么?

Flexilla 将继续发展。我计划添加更多组件,改进现有组件,并完善文档。除了现有的组件之外,我还计划引入其他常见组件,例如通知和 toast。这将使 Flexilla 能够支持更广泛的交互需求。

结论

根据我的需求,Flexilla 已被证明是在我的项目中创建交互式组件的宝贵工具。
开始可能会很可怕。我担心没有人会欣赏我的工作,担心它没有任何作用。但我向你保证,不去尝试是最大的错误。今天,我对创建这个图书馆并不后悔。它让我学到了很多东西:代码组织、版本控制、管理 npm 包……毫不犹豫地与世界分享您的解决方案,并乐于接受反馈,无论是积极的还是消极的。它会帮助你成长!

如果您有想法、建议或代码改进,请立即分叉存储库、提交拉取请求或提出问题。我们可以共同增强库并为世界各地的开发人员创造宝贵的资源。

请注意,别忘了查看 Flexilla 并让我知道您的想法!

版本聲明 本文轉載於:https://dev.to/unifyui-dev/my-journey-to-building-flexilla-headless-interactive-component-library-5ceg?1如有侵犯,請聯絡[email protected]刪除
最新教學 更多>
  • Websocket 或 Socket io!讓我們來看看吧!
    Websocket 或 Socket io!讓我們來看看吧!
    WebSockets 与 Socket.IO:实时对决 当谈到网络上的实时通信时,开发人员经常发现自己陷入两个选择之间:WebSockets 和 Socket.IO。这两种工具都擅长它们的工作——提供了一种在客户端和服务器之间实现双向通信的方法——但每种工具都有自己独特的个性。这有...
    程式設計 發佈於2024-11-02
  • Deno 起飛
    Deno 起飛
    网络是人类最大的软件平台,拥有超过 50 亿用户,并且还在不断增长。然而,随着 Web 开发需求的飙升,其复杂性也随之增加。在无尽的配置文件、大量的样板文件和大量的依赖项之间,开发人员花费更多的时间来进行设置,而不是构建下一个大东西。? 进入 Deno,这是一种用于 JavaScript 和 Typ...
    程式設計 發佈於2024-11-02
  • 使用 Django Rest Framework 尋找海森堡
    使用 Django Rest Framework 尋找海森堡
    The idea The idea was to create a simple platform for DEA agents, to manage information about characters from the Breaking Bad/Better Call Sa...
    程式設計 發佈於2024-11-02
  • 湯姆和傑瑞燈代碼
    湯姆和傑瑞燈代碼
    <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, ...
    程式設計 發佈於2024-11-02
  • 透過實作學習 TDD:在 Umbraco 的富文本編輯器中標記成員
    透過實作學習 TDD:在 Umbraco 的富文本編輯器中標記成員
    在我正在建構的系統中,我需要能夠在網站的文字中提及 Umbraco 會員。為此,我需要建立 Umbraco 富文本編輯器的擴充:TinyMCE。 情境 作為內容編輯者,我想在訊息或文章中標記成員,以便他們收到有關其新內容的通知。 我研究了類似的實現,例如 Slack 或 X 上的...
    程式設計 發佈於2024-11-02
  • 如何在Python測試情境中模擬HTTP請求和回應?
    如何在Python測試情境中模擬HTTP請求和回應?
    Python 測試的模擬請求和回應在Python 測試中,有必要模擬模組及其功能來控制執行流程並驗證具體場景。其中,模擬 requests 模組通常用於測試依賴 HTTP 請求的函數或方法。 考慮一個包含以下程式碼的views.py 檔案:def myview(request): res1 ...
    程式設計 發佈於2024-11-02
  • 如何建立適用於 Windows、Linux 和 macOS 的 Python 條碼掃描器
    如何建立適用於 Windows、Linux 和 macOS 的 Python 條碼掃描器
    条形码扫描已成为从零售、物流到医疗保健等各个行业的重要工具。在桌面平台上,它可以快速捕获和处理信息,无需手动输入数据,从而节省时间并减少错误。在本教程中,我们将通过构建适用于 Windows、Linux 的 Python 条形码扫描仪 继续探索 Dynamsoft Capture Vision SD...
    程式設計 發佈於2024-11-02
  • ## 如何在 Python 中建立不可變物件以及為什麼 nametuple 是最好的方法?
    ## 如何在 Python 中建立不可變物件以及為什麼 nametuple 是最好的方法?
    Python 中的不可變物件在 Python 中,不變性為保護資料完整性提供了一種有價值的機制。然而,創建不可變物件會帶來一定的挑戰。 重寫 setattr常見的方法是重寫 setattr方法。然而,即使在 init 過程中也會呼叫此方法,因此它不適合建立不可變物件。 子類化 Tuple另一種策略涉...
    程式設計 發佈於2024-11-02
  • 最常被問到的 React 面試問題
    最常被問到的 React 面試問題
    如何優化 React 應用程式的效能? 1。組件應謹慎更新 實作 shouldComponentUpdate 或 React.memo 透過比較 props 或 states 來防止不必要的重新渲染。 2.使用功能組件和鉤子 帶鉤子的功能組件通常比類組件性能更高。 3.延遲載入...
    程式設計 發佈於2024-11-02
  • (Wordpress 初學者):僅將子網域從託管轉移(遷移)到另一個新託管。
    (Wordpress 初學者):僅將子網域從託管轉移(遷移)到另一個新託管。
    我只想從 Bluehost 託管轉移(遷移)一個新託管(例如 Fastcomet 或 Chemicloud)的子網域。 我想知道我遷移子網域的步驟是否正確以及我應該做什麼更改 DNS 內容...... ** 我的情況1:** – 主 Web 網域(例如:forcleanworld.com)保留在 ...
    程式設計 發佈於2024-11-02
  • 使用 Java 進行資料分析:資訊處理初學者指南
    使用 Java 進行資料分析:資訊處理初學者指南
    Java 是適用於資料分析的強大語言,它提供用於處理大型資料集和執行複雜分析的基礎結構,包括:資料結構:用於儲存和組織資料的集合,例如陣列和清單。 IO 流:用於讀取和寫入檔案的物件。 Java 集合框架:用於管理和操作資料結構的強大集合類別庫。使用 Java 進行資料分析的實際案例包括分析文字文件...
    程式設計 發佈於2024-11-02
  • 僱用自由 Python 開發人員時要避免的常見錯誤
    僱用自由 Python 開發人員時要避免的常見錯誤
    介紹 聘請合適的自由 Python 開發人員可以決定你的專案的成敗。然而,許多企業在招募過程中會犯一些常見的錯誤,這些錯誤可能會導致招募延遲、成本超支和結果不佳。以下是如何避免這些陷阱並確保專案成功的方法。 沒有明確定義專案要求 最常見的錯誤之一是在開始招募流程之...
    程式設計 發佈於2024-11-02
  • AWS SAM Lambda 專案的本機開發伺服器
    AWS SAM Lambda 專案的本機開發伺服器
    现在我正在开发一个项目,其中使用 AWS lambda 作为请求处理程序构建 REST API。整个过程使用 AWS SAM 定义 lambda、层并将其连接到漂亮的 template.yaml 文件中的 Api 网关。 问题 在本地测试此 API 并不像其他框架那样简单。虽然 AW...
    程式設計 發佈於2024-11-02
  • 什麼是 React?
    什麼是 React?
    最近,我决定通过注册 元前端开发人员专业证书将我的技能提升到一个新的水平。 专业化涵盖各种主题,从基本的 Web 开发语言(例如 HTML、CSS 和 JavaScript)到高级框架 React。 通过这篇文章和以下博客文章,我的目标是分享我在通过认证过程中的经验、学习和进步。 所以… ...
    程式設計 發佈於2024-11-02
  • 如何在C++中實作虛擬運算子重載?
    如何在C++中實作虛擬運算子重載?
    虛擬運算子重載背景在 C 中,可以為自訂資料類型重載運算符,從而提供客製化的行為。然而,允許多態行為的虛擬方法不能直接用於運算子重載。 問題考慮創建一個虛擬運算子
    程式設計 發佈於2024-11-02

免責聲明: 提供的所有資源部分來自互聯網,如果有侵犯您的版權或其他權益,請說明詳細緣由並提供版權或權益證明然後發到郵箱:[email protected] 我們會在第一時間內為您處理。

Copyright© 2022 湘ICP备2022001581号-3