npm 包 @aragon/ui 使用教程

阅读时长 6 分钟读完

本文介绍了如何使用 @aragon/ui 这个 npm 包以及它的 API 和组件,以及如何在你的项目中进行布局,主题和自定义。

什么是 @aragon/ui

@aragon/ui 是一个用 React 构建的 UI 库,其中包含了很多开箱即用的组件和工具来构建用户界面。它尤其适合于创建 dApp,DAO 或者其他去中心化应用的前端界面和用户体验。

安装

在使用 @aragon/ui 之前,你需要先在项目中安装它:

然后,你需要在你的项目中引入它:

使用

布局组件

@aragon/ui 提供了一组基本布局组件,可以轻松地构建出样式统一的页面:

<Box>

<Box> 组件是最基本的布局组件,它可以帮助你在页面中组合其他组件,并且提供 padding 和 margin 的控制。

-- -------------------- ---- -------
------ - --- - ---- ------------

-------- ----- -
  ------ -
    ---- ----------- ---------- --------------------------
      ---------- -----------
    ------
  -
-

<Split>

<Split> 组件可以将页面分为左右两个部分,用来放置两个不同的组件。

-- -------------------- ---- -------
------ - ---- ----- - ---- ------------

-------- ----- -
  ------ -
    ------
      ------------- ----------- ----------------------
      --------------- ----------- -----------------------
    --
  -
-

<Bar>

<Bar> 组件可以放置在页面的顶部或底部,用于导航或底部工具栏。

-- -------------------- ---- -------
------ - ---- --- - ---- ------------

-------- ----- -
  ------ -
    ---- ----------- -----------
      -----
        ------- ---------
      ------
      ------------------
      -----
        --------- -------
      ------
    ------
  -
-

组件

@aragon/ui 提供了一系列的组件,可以帮助你快速构建用户界面。

<Button>

<Button> 组件可以创建一个标准的按钮,你可以添加任意数量的 props 来控制按钮的外观和行为。

-- -------------------- ---- -------
------ - ------ - ---- ------------

-------- ----- -
  ------ -
    ------- ------------- ----------- -- ------------------------
      ----- ---
    ---------
  -
-

<Text>

<Text> 组件可以放置一个文本段落,可以设置字体大小,颜色,以及其他属性。

-- -------------------- ---- -------
------ - ---- - ---- ------------

-------- ----- -
  ------ -
    ----- ----------- -------------
      ---- -- - -----
    -------
  -
-

<IdentityBadge>

<IdentityBadge> 组件可以显示一个身份徽章,它通常用于显示地址、名称、头像等用户身份信息。

-- -------------------- ---- -------
------ - ------------- - ---- ------------

-------- ----- -
  ------ -
    --------------
      ----------- ----
      --------------------------
      ---------------
    --
  -
-

<ProgressBar>

<ProgressBar> 组件可以创建一个进度条,可以控制进度、颜色和其他属性。

主题和自定义

@aragon/ui 允许自定义主题,以满足你的项目需求。你可以使用 <ThemeProvider> 组件来更改主题。

-- -------------------- ---- -------
------ - -------------- ------ - ---- ------------

----- ------- - -
  ------- -
    ------------- -------
    -------- -------
    ---------------- -------
    ---------- ---------
    ----------- -------
    ------ --------
  --
  ------------ -
    ---------------- -----------
  --
-

-------- ----- -
  ------ -
    -------------- ----------------
      ------------- ------------
    ----------------
  -
-

你还可以使用 styled-components@aragon/ui/themming 模块来自定义组件的样式。

-- -------------------- ---- -------
------ ------ ---- -------------------
------ - ------ - ---- ------------
------ - ---------- - ---- -----------------

----- ------------ - ---------------
  -------------
  ------------ --
-

-------- ----- -
  ------ -
    ------------- ---------- -------------- ----------- -- ------------------------
      ----- ---
    ---------------
  -
-

结论

@aragon/ui 是一个很好用的 React UI 库,提供了很多实用的组件,布局和工具,可以帮助你快速构建用户界面。使用主题和自定义功能,你甚至可以按照自己的方式来定制组件和样式。希望这篇文章可以帮助你更好地了解如何使用 @aragon/ui。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/96556