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许可发布的代码。