Layout 布局

通过基础的 24 分栏，迅速简便地创建布局。

TIP

组件默认使用 Flex 布局，不需要手动设置 type="flex"。

请注意父容器避免使用 inline 相关样式，会导致组件宽度不能撑满。

列的基本单位为1，最多24个，最少0个。

基础布局

使用列创建基础网格布局。

通过 row 和 col 组件，并通过 col 组件的 span 属性我们就可以自由地组合布局。

export function RowBasic() {  return (    <div>      <ElRow style={rowSpacing}>        <ElCol className={styles.col} span={24}>          <div style={purpleDark} />        </ElCol>      </ElRow>      <ElRow style={rowSpacing}>        <ElCol className={styles.col} span={12}>          <div style={purple} />        </ElCol>        <ElCol className={styles.col} span={12}>          <div style={purpleLight} />        </ElCol>      </ElRow>      <ElRow style={rowSpacing}>        <ElCol className={styles.col} span={8}>          <div style={purple} />        </ElCol>        <ElCol className={styles.col} span={8}>          <div style={purpleLight} />        </ElCol>        <ElCol className={styles.col} span={8}>          <div style={purple} />        </ElCol>      </ElRow>      <ElRow style={rowSpacing}>        {[0, 1, 2, 3].map((index) => (          <ElCol className={styles.col} key={index} span={6}>            <div style={index % 2 === 0 ? purple : purpleLight} />          </ElCol>        ))}      </ElRow>      <ElRow>        {[0, 1, 2, 3, 4, 5].map((index) => (          <ElCol className={styles.col} key={index} span={4}>            <div style={index % 2 === 0 ? purple : purpleLight} />          </ElCol>        ))}      </ElRow>    </div>  );}

分栏间隔

支持列间距。

行提供 gutter 属性来指定列之间的间距，其默认值为0。

export function RowGutter() {  return (    <ElRow gutter={20}>      {[0, 1, 2, 3].map((index) => (        <ElCol className={styles.col} key={index} span={6}>          <div style={purple} />        </ElCol>      ))}    </ElRow>  );}

混合布局

通过基础的 1/24 分栏任意扩展组合形成较为复杂的混合布局。

export function RowHybrid() {  return (    <div>      <ElRow gutter={20} style={rowSpacing}>        <ElCol className={styles.col} span={16}>          <div style={purple} />        </ElCol>        <ElCol className={styles.col} span={8}>          <div style={purple} />        </ElCol>      </ElRow>      <ElRow gutter={20} style={rowSpacing}>        <ElCol className={styles.col} span={8}>          <div style={purple} />        </ElCol>        <ElCol className={styles.col} span={8}>          <div style={purple} />        </ElCol>        <ElCol className={styles.col} span={4}>          <div style={purple} />        </ElCol>        <ElCol className={styles.col} span={4}>          <div style={purple} />        </ElCol>      </ElRow>      <ElRow gutter={20}>        <ElCol className={styles.col} span={4}>          <div style={purple} />        </ElCol>        <ElCol className={styles.col} span={16}>          <div style={purple} />        </ElCol>        <ElCol className={styles.col} span={4}>          <div style={purple} />        </ElCol>      </ElRow>    </div>  );}

列偏移

您可以指定列偏移量。

通过制定 col 组件的 offset 属性可以指定分栏偏移的栏数。

export function RowOffset() {  return (    <div>      <ElRow gutter={20} style={rowSpacing}>        <ElCol className={styles.col} span={6}>          <div style={purple} />        </ElCol>        <ElCol className={styles.col} span={6} offset={6}>          <div style={purple} />        </ElCol>      </ElRow>      <ElRow gutter={20} style={rowSpacing}>        <ElCol className={styles.col} span={6} offset={6}>          <div style={purple} />        </ElCol>        <ElCol className={styles.col} span={6} offset={6}>          <div style={purple} />        </ElCol>      </ElRow>      <ElRow gutter={20}>        <ElCol className={styles.col} span={12} offset={6}>          <div style={purple} />        </ElCol>      </ElRow>    </div>  );}

对齐方式

默认使用 flex 布局来对分栏进行灵活的对齐。

您可以通过justify 属性来定义子元素的排版方式，其取值为start、center、end、space-between、space-around或space-evenly。

export function RowJustify() {  const justifies = [    "start",    "center",    "end",    "space-between",    "space-around",    "space-evenly",  ] as const;  return (    <div>      {justifies.map((justify, index) => (        <ElRow          key={justify}          justify={justify}          className={styles.rowBg}          style={index === justifies.length - 1 ? undefined : rowSpacing}        >          <ElCol className={styles.col} span={6}>            <div style={purple} />          </ElCol>          <ElCol className={styles.col} span={6}>            <div style={purpleLight} />          </ElCol>          <ElCol className={styles.col} span={6}>            <div style={purple} />          </ElCol>        </ElRow>      ))}    </div>  );}

响应式布局

参照了 Bootstrap 的响应式设计，预设了五个响应尺寸：xs、sm、md、lg 和 xl。

export function RowResponsive() {  return (    <ElRow gutter={10}>      <ElCol className={styles.col} xs={8} sm={6} md={4} lg={3} xl={1}>        <div style={purple} />      </ElCol>      <ElCol className={styles.col} xs={4} sm={6} md={8} lg={9} xl={11}>        <div style={purpleLight} />      </ElCol>      <ElCol className={styles.col} xs={4} sm={6} md={8} lg={9} xl={11}>        <div style={purple} />      </ElCol>      <ElCol className={styles.col} xs={8} sm={6} md={4} lg={3} xl={1}>        <div style={purpleLight} />      </ElCol>    </ElRow>  );}

基于断点的隐藏类

Element Plus 额外提供了一系列类名，用于在某些条件下隐藏元素。这些类名可以添加在任何 DOM 元素或自定义组件上。如果需要，请自行引入以下文件：

import 'element-plus/theme-chalk/display.css'

这些类名为：

hidden-xs-only - 当视口在 xs 尺寸时隐藏
hidden-sm-only - 当视口在 sm 尺寸时隐藏
hidden-sm-and-down - 当视口在 sm 及以下尺寸时隐藏
hidden-sm-and-up - 当视口在 sm 及以上尺寸时隐藏
hidden-md-only - 当视口在 md 尺寸时隐藏
hidden-md-and-down - 当视口在 md 及以下尺寸时隐藏
hidden-md-and-up - 当视口在 md 及以上尺寸时隐藏
hidden-lg-only - 当视口在 lg 尺寸时隐藏
hidden-lg-and-down - 当视口在 lg 及以下尺寸时隐藏
hidden-lg-and-up - 当视口在 lg 及以上尺寸时隐藏
hidden-xl-only - 当视口在 xl 尺寸时隐藏

Row API

Row Attributes

属性名	说明	类型	默认值
gutter	栅格间隔，同时作为 Col 的左右内边距	`number`	0
justify	水平排列方式	`enum`	start
align	垂直对齐方式	`enum`	—
tag	渲染的标签名	`string`	div
className / style	根节点类名与样式	`string` / `CSSProperties`	—

Row Events

无。

Row Slots

插槽名	说明	React 写法
default	列内容	`children`

Col API

Col Attributes

属性名	说明	类型	默认值
span	栅格占位格数，共 24 格	`number`	24
offset	左侧间隔格数	`number`	—
pull	向右移动格数	`number`	—
push	向左移动格数	`number`	—
xs / sm / md / lg / xl	响应式断点，值为格数或 `{ span, offset, pull, push }`	`number` / `object`	—
tag	渲染的标签名	`string`	div
className / style	根节点类名与样式	`string` / `CSSProperties`	—

Col Events

无。

Col Slots

插槽名	说明	React 写法
default	列内容	`children`

Exposes

Row / Col 均无 expose。