Preview Updated 2026-05-10

Grid

A 24-column Row / Col grid system for page ratios, gutters, offsets, and responsive layout.

Basic Usage

CfRow / CfCol form a 24-column grid system. span=6 is 25%, span=8 is 33.33%, and span=12 is 50%. gutter controls horizontal and vertical spacing, while offset creates left-side blank columns.

背景

100%

25%

25% + offset 6

33.33%

33.33% + offset 8

50%

66.66%

xs=24 / md=12 / lg=8

响应式断点

gutter=[12, 12]

src/App.vue

<script setup lang="ts">
import { CfCol, CfRow } from '@chufix-design/vue';
</script>
<template>
  <div class="grid-demo">
    <section class="grid-concept" aria-label="24 栅格比例示意">
      <div class="grid-guide" aria-hidden="true"></div>
      <CfRow :gutter="[8, 8]">
        <CfCol :span="24"><div class="grid-block grid-block--solid">100%</div></CfCol>
        <CfCol :span="6"><div class="grid-block">25%</div></CfCol>
        <CfCol :span="6" :offset="6"><div class="grid-block">25% + offset 6</div></CfCol>
        <CfCol :span="8"><div class="grid-block">33.33%</div></CfCol>
        <CfCol :span="8" :offset="8"><div class="grid-block">33.33% + offset 8</div></CfCol>
        <CfCol :span="12"><div class="grid-block">50%</div></CfCol>
        <CfCol :span="16"><div class="grid-block">66.66%</div></CfCol>
      </CfRow>
    </section>
    <section class="grid-card">
      <CfRow :gutter="[12, 12]" align="stretch">
        <CfCol :xs="24" :md="12" :lg="8">
          <div class="panel">xs=24 / md=12 / lg=8</div>
        </CfCol>
        <CfCol :xs="24" :md="12" :lg="8">
          <div class="panel">响应式断点</div>
        </CfCol>
        <CfCol :xs="24" :md="24" :lg="8">
          <div class="panel">gutter=[12, 12]</div>
        </CfCol>
      </CfRow>
    </section>
  </div>
</template>
<style scoped>
.grid-demo {
  width: 100%;
  display: grid;
  gap: 18px;
}

.grid-concept {
  position: relative;
  overflow: hidden;
  border: 1px solid var(--line-1);
  border-radius: 8px;
  padding: 18px;
  background: var(--surface-1);
}

.grid-guide {
  position: absolute;
  inset: 18px;
  pointer-events: none;
  opacity: .8;
  background:
    linear-gradient(
      90deg,
      color-mix(in srgb, var(--accent-1) 8%, transparent) 0,
      color-mix(in srgb, var(--accent-1) 8%, transparent) calc(100% - 8px),
      transparent calc(100% - 8px)
    );
  background-size: 4.1666666667% 100%;
}

.grid-block {
  position: relative;
  z-index: 1;
  min-height: 48px;
  display: grid;
  place-items: center;
  border-radius: 4px;
  background: color-mix(in srgb, var(--accent-1) 68%, white);
  color: white;
  font-weight: 700;
  box-shadow: inset 0 0 0 1px color-mix(in srgb, var(--accent-1) 18%, transparent);
}

.grid-block--solid {
  background: var(--accent-1);
}

.grid-card {
  border: 1px solid var(--line-1);
  border-radius: 8px;
  padding: 16px;
  background: var(--surface-0);
}

.panel {
  height: 84px;
  display: grid;
  place-items: center;
  border-radius: 8px;
  border: 1px solid var(--line-1);
  background: var(--surface-1);
  color: var(--fg-1);
}
</style>

<script setup>
import { CfCol, CfRow } from '@chufix-design/vue';
</script>
<template>
  <div class="grid-demo">
    <section class="grid-concept" aria-label="24 栅格比例示意">
      <div class="grid-guide" aria-hidden="true"></div>
      <CfRow :gutter="[8, 8]">
        <CfCol :span="24"><div class="grid-block grid-block--solid">100%</div></CfCol>
        <CfCol :span="6"><div class="grid-block">25%</div></CfCol>
        <CfCol :span="6" :offset="6"><div class="grid-block">25% + offset 6</div></CfCol>
        <CfCol :span="8"><div class="grid-block">33.33%</div></CfCol>
        <CfCol :span="8" :offset="8"><div class="grid-block">33.33% + offset 8</div></CfCol>
        <CfCol :span="12"><div class="grid-block">50%</div></CfCol>
        <CfCol :span="16"><div class="grid-block">66.66%</div></CfCol>
      </CfRow>
    </section>
    <section class="grid-card">
      <CfRow :gutter="[12, 12]" align="stretch">
        <CfCol :xs="24" :md="12" :lg="8">
          <div class="panel">xs=24 / md=12 / lg=8</div>
        </CfCol>
        <CfCol :xs="24" :md="12" :lg="8">
          <div class="panel">响应式断点</div>
        </CfCol>
        <CfCol :xs="24" :md="24" :lg="8">
          <div class="panel">gutter=[12, 12]</div>
        </CfCol>
      </CfRow>
    </section>
  </div>
</template>
<style scoped>
.grid-demo {
  width: 100%;
  display: grid;
  gap: 18px;
}

.grid-concept {
  position: relative;
  overflow: hidden;
  border: 1px solid var(--line-1);
  border-radius: 8px;
  padding: 18px;
  background: var(--surface-1);
}

.grid-guide {
  position: absolute;
  inset: 18px;
  pointer-events: none;
  opacity: .8;
  background:
    linear-gradient(
      90deg,
      color-mix(in srgb, var(--accent-1) 8%, transparent) 0,
      color-mix(in srgb, var(--accent-1) 8%, transparent) calc(100% - 8px),
      transparent calc(100% - 8px)
    );
  background-size: 4.1666666667% 100%;
}

.grid-block {
  position: relative;
  z-index: 1;
  min-height: 48px;
  display: grid;
  place-items: center;
  border-radius: 4px;
  background: color-mix(in srgb, var(--accent-1) 68%, white);
  color: white;
  font-weight: 700;
  box-shadow: inset 0 0 0 1px color-mix(in srgb, var(--accent-1) 18%, transparent);
}

.grid-block--solid {
  background: var(--accent-1);
}

.grid-card {
  border: 1px solid var(--line-1);
  border-radius: 8px;
  padding: 16px;
  background: var(--surface-0);
}

.panel {
  height: 84px;
  display: grid;
  place-items: center;
  border-radius: 8px;
  border: 1px solid var(--line-1);
  background: var(--surface-1);
  color: var(--fg-1);
}
</style>

import { CfCol, CfRow } from '@chufix-design/react';

export default function Demo() {
  return (
    <>
      <CfRow gutter={[16, 16]}>
      <CfCol span={6}>25%</CfCol>
      <CfCol span={12}>50%</CfCol>
      <CfCol span={6}>25%</CfCol>
      </CfRow>
    </>
  );
}

import { CfCol, CfRow } from '@chufix-design/react';

export default function Demo() {
  return (
    <>
      <CfRow gutter={[16, 16]}>
      <CfCol span={6}>25%</CfCol>
      <CfCol span={12}>50%</CfCol>
      <CfCol span={6}>25%</CfCol>
      </CfRow>
    </>
  );
}

Row API

Prop	Type	Default	Description
`as`	`string / ElementType`	`div`	Rendered element
`gutter`	`number / string / [x, y]`	`0`	Horizontal / vertical spacing
`justify`	`start / center / end / space-around / space-between / space-evenly`	`start`	Horizontal distribution
`align`	`top / middle / bottom / stretch`	`top`	Vertical alignment
`wrap`	`boolean`	`true`	Allow wrapping

Col API

Prop	Type	Default	Description
`as`	`string / ElementType`	`div`	Rendered element
`span`	`number`	`24`	Column span, 0–24
`offset`	`number`	`0`	Left offset columns
`push`	`number`	`0`	Move right by columns
`pull`	`number`	`0`	Move left by columns
`order`	`number`	`0`	Flex order
`xs / sm / md / lg / xl / xxl`	`number / ColBreakpointConfig`	`—`	Responsive config