oruga

Oruga UI就像毛毛蟲一樣，很少，但功能很強。它在您的手中，將其變成蝴蝶

（？）=>？

特徵

Oruga是Vue.js的輕量級UI組件庫，而無需任何依賴性。它提供了一組易於自定義的組件，並且不依賴任何特定樣式或CSS框架（例如Bootstrap，Bulma，parwindcss等...）。因此，它不提供網格系統或CSS實用程序，但是您可以集成您喜歡的任何CSS框架。 Oruga為您提供一組功能組件，因此您只能專注於應用程序的UI/UX方面，並且可以完全靈活地用於將來的更改，而無需觸摸JavaScript行。

• CSS框架不可知論：不依賴特定的CSS框架/庫，但是您可以輕鬆地將組件與其中一個集成在一起，因為它們以不同的方式完全自定義
• 具有類固醇的組件：大多數組件不是本機元素的簡單包裝器，但它們添加了新的和自定義的功能
• 輕量級：沒有其他內部依賴性和僅導入您需要的組件

如果您需要一個組件庫並想要輕鬆應用您的自定義樣式，則Oruga是您的庫！ ？

此外，如果您不想自己設置所有東西，我們將創建了幾個主題，為您提供各種現成的樣式。 ？

文件

在此處瀏覽在線文檔。

？有關組件自定義的更多信息，請仔細閱讀文檔中的“自定義”部分。

？要查看Oruga的行動，請轉到文檔中的示例部分。

注意：文檔示例的源代碼可以在每個組件的examples目錄中找到，也可以用作演示。

快速開始

？ Oruga可用於Vue.js版本3.x版本

設置Oruga

1. 安裝Oruga。

npm install @oruga-ui/oruga-next

2. 導入組件：

• 要快速開始，請使用Oruga註冊所有組件：

   import { createApp } from 'vue'
  import Oruga from '@oruga-ui/oruga-next' ;
  
  createApp ( ... ) . use ( Oruga ) ;

• 要使用樹木搖動，請手動註冊組件：

   import { createApp } from 'vue'
  import { OField , OInput } from '@oruga-ui/oruga'
  
  createApp ( ... )
    . use ( OField )
    . use ( OInput )

• 或將它們導入您的SFC。

定制

Oruga的超級大國是其可配置性和CSS框架不可知的方法。每個組件可以通過使用類映射方法定義特定類來單獨自定義和配置。因此，Oruga默認情況下沒有任何樣式。但是，有幾種官方的預定義配置稱為主題，您可以包含並擴展以使應用程序具有個人外觀和感覺。默認情況下，所有組件都帶有預定義的類。

請閱讀Oruga文檔中的“自定義”部分。

如果您想使用Tailwind ， Bulma ， Bootstrap ， Material或任何其他CSS框架查看官方的Oruga多幀示例示例（此處可用的源代碼），或者如果您更熟悉TailWindCSS 2，請在此處嘗試我們的官方parwindcss demo a try（如果您更熟悉tailwindcss demo a try（如果您可以使用）

將Oruga與NUXT一起使用

目前，Oruga不提供NUXT.JS模塊。

您plugins使用nuxt.js插件系統在oruga.js ：

 import Oruga from '@oruga-ui/oruga-next' ;

export default defineNuxtPlugin ( ( nuxtApp ) => {
  nuxtApp . vueApp . use ( Oruga ) ;
} ) ;

要在您的應用程序中提供此插件，請在nuxt.config.js中的plugins數組中添加此文件

plugins: [ { src : '~plugins/oruga.js' } ]

要了解插件如何與NUXT.JS一起使用，請查看NUXTJS插件文檔。

看看官方的NUXTJS + ORUGA示例。

貢獻

請參閱貢獻指南。

聯繫我們？

→加入Oruga Discord服務器。

版本控制

Oruga使用語義版本2.0.0用於包裝版本。

雖然仍處於beta中，但版本將遵循以下模式： v0.yz ，其中：

• Y ：專業（打破變化）
• Z ：次要或補丁

核心團隊

沃爾特·托馬西（Walter Tommasi）

安德里亞·斯塔吉（Andrea Stagi）

馬塞爾·莫拉維克（Marcel Moravek）

貢獻者

感謝所有參與參與的項目，每天改進該項目

完整列表。

學分

Matteo Guadagnini設計的Oruga徽標

Fabrizio Masini創建的複選框和無線電組件和節日資產的Oruga SVG圖像

執照

根據MIT許可發布的代碼。