npm 包 @canner/page-wrapper 使用教程

阅读时长 8 分钟读完

简介

@canner/page-wrapper 是一个 React 组件库,用于帮助开发人员快速构建包含头部,侧边栏,内容以及底部的网页布局。它可以非常方便的处理这个布局,并且可以适应不同设备大小和方向。

安装和使用

  1. 安装

使用 npm 安装:

或者使用 yarn 安装:

  1. 使用

引入组件:

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

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

参数

参数名 类型 默认值 描述
mode string 'default' 网页布局模式,可选值为 'default' 或 'app'
header React.ReactNode 头部内容
sidebar React.ReactNode 侧边栏内容
main React.ReactNode 主要内容
footer React.ReactNode 底部内容
headerProps object {} 头部的属性
sidebarProps object {width: 256, collapsible: true} 侧边栏的属性
mainProps object {} 主要内容的属性
footerProps object {} 底部的属性

mode 参数有两种取值:'default' 和 'app','default' 表示默认布局(含有侧边栏),'app' 表示应用布局(没有侧边栏)。

详细参数解释如下:

  1. headerProps:
参数名 类型 默认值 描述
height number 72 头部高度,单位为像素
style object {} 头部样式
beforeIcon React.ReactNode 头部左侧显示的图标
afterIcon React.ReactNode 头部右侧显示的图标
  1. sidebarProps:
参数名 类型 默认值 描述
width number 256 侧边栏宽度
collapsible boolean true 是否可以折叠
style object {} 侧边栏样式
icon React.ReactNode <menuicon> 折叠按钮左侧显示的图标,在没有可收缩的侧边栏的情况下将不会显示
title string | React.ReactNode 'Canner' 侧边栏标题
  1. mainProps:
参数名 类型 默认值 描述
style object {} 主要内容
  1. footerProps:
参数名 类型 默认值 描述
style object {} 底部

示例代码

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

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

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

结语

通过使用 @canner/page-wrapper,我们可以非常方便的构建一个包含头部,侧边栏,主要内容以及底部的网页布局。同时,组件提供了非常灵活的参数配置,可以适应不同设备的大小和方向。

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