原型工具

使用 Foundation 的原型工具快速创建布局和 UI 原型。这些可选的类和混合非常适合将草图和模型快速转换为编码原型。

从原型到生产

原型设计使我们能够更清楚地看到问题,而且通常是在开发过程的早期阶段。草图或线框图中的设计只能让我们在理解行为、可行性和实现成本(时间或资源)方面走得更远。原型设计流程促进了设计师和开发人员之间的密切合作,以找到更好的解决方案。

有时原型代码注定要被丢弃,这没关系。在早期开发阶段,将想法和交互呈现出来并与利益相关者分享以供审查是非常有价值的。这就是想法得到充实和改进的方式。我们交付的不是代码,而是问题的解决方案。提出想法,获得反馈,迭代,重复。然后,当各方都对正在采取的正确方法感到满意时,再回过头来清理和重构。

Foundation 的原型工具可帮助您从头开始超快速地构建编码原型。这使您能够通过反馈和实验更快地找到正确的答案。从定位到视觉样式,有一系列实用程序可供选择。每个实用程序都有一个混合,因此您可以使用自己的自定义类或在生产中将类交换为混合以获得更清晰的标记。

默认情况下禁用原型模式!

并非所有项目都需要原型工具,添加像这样的实用程序类会增加 CSS 文件大小,尤其是在您没有全部使用它们的情况下。出于这些原因,默认情况下禁用原型模式。

许多原型类使用 `!important` 来确保它们不会被更具体的选择器覆盖。该框架有意识地避免使用 `!important` 声明。请注意,我们只在那些不应该被覆盖的特定 **CSS** 属性上插入了 `!important`。


启用原型模式

像下面这样的原型类应该只用于原型设计任务。此外,如果您正在使用 **Sass**,我们鼓励您改用 **[原型混合](#sass-mixins)**。

使用 Sass 版本的 Foundation,您可以通过两种方式启用原型模式

如果您在主 Sass 文件中使用 foundation-everything() 混合,只需传入 $prototype: true 即可启用原型模式。

@include foundation-everything($prototype: true);

如果您手动包含了每个组件(就像我们的入门项目那样),请打开您的 app.scss 文件并简单地注释掉

// @include foundation-prototype-classes;

所以它看起来像

@include foundation-prototype-classes;

您可以改为仅导入您需要的特定实用程序类。为了方便起见,下面列出了完整列表

@include foundation-prototype-typescale;
@include foundation-prototype-text-utilities;
@include foundation-prototype-text-transformation;
@include foundation-prototype-text-decoration;
@include foundation-prototype-font-styling;
@include foundation-prototype-list-style-type;
@include foundation-prototype-rounded;
@include foundation-prototype-bordered;
@include foundation-prototype-shadow;
@include foundation-prototype-arrow;
@include foundation-prototype-separator;
@include foundation-prototype-overflow;
@include foundation-prototype-display;
@include foundation-prototype-position;
@include foundation-prototype-border-box;
@include foundation-prototype-border-none;
@include foundation-prototype-sizing;
@include foundation-prototype-spacing;

想要更多自定义?点击此处查看 Sass 参考


响应式断点

默认情况下禁用响应式断点。

这些原型类还具有可选的移动优先响应类,因此设置类将应用于小断点和大断点,除非被更大断点的类覆盖。
您可以通过将 $global-prototype-breakpoints 设置为 true 来轻松启用这些类。

<p class="medium-text-uppercase">This text will be uppercase for medium and up.</p>
<p class="large-text-lowercase">This text will be lowercase for large breakpoint.</p>

您还可以通过选择仅为需要作为响应类的特定原型助手添加响应断点来自定义内容。
例如,文本转换类有一个断点变量 $prototype-transformation-breakpoints,它被设置为 $global-prototype-breakpoints,默认情况下设置为 false。要为文本转换类启用响应断点,只需设置

$prototype-transformation-breakpoints: true;

组件样式

这些 .radius.rounded.bordered.shadow 类可以独立使用或组合使用,分别通过圆角、赋予浅边框和创建阴影来设置组件样式。主要用于按钮、卡片、表格、图像等等。

**Sass 提示**:您可以使用 [阴影](#shadow) 混合来创建类似 shadow-hover-focus 的内容。[Codepen 示例](https://codepen.io/IamManchanda/pen/XMRMwo)

在视频中观看此部分

按钮

<button type="button" class="button radius bordered shadow primary">Primary</button>
<button type="button" class="button rounded bordered shadow secondary">Secondary</button>
<button type="button" class="button radius bordered shadow success">Success</button>
<button type="button" class="button rounded bordered shadow alert">Alert</button>
<button type="button" class="button radius bordered shadow warning">Warning</button>

开关

.rounded 类添加到 .switch 以使其变圆。

<div class="switch rounded">
  <input class="switch-input" id="exampleSwitch" type="checkbox" name="exampleSwitch">
  <label class="switch-paddle" for="exampleSwitch">
    <span class="show-for-sr">Download Kittens</span>
  </label>
</div>

卡片

<div class="radius bordered shadow card">
  <img src="https://placehold.it/500x250">
  <div class="card-divider">
    Styled Card
  </div>
  <div class="card-section">
    <h4>This is a card.</h4>
    <p>It has an easy to override visual style, and is appropriately subdued.</p>
  </div>
</div>
样式卡片

这是一张卡片。

它有一种易于覆盖的视觉风格,并且经过适当的柔和处理。

样式卡片

这是一张卡片。

它有一种易于覆盖的视觉风格,并且经过适当的柔和处理。

样式卡片

这是一张卡片。

它有一种易于覆盖的视觉风格,并且经过适当的柔和处理。

表格

<table class="radius bordered shadow">
    <!-- My Table goes here -->
</table>
表头 表头 表头 表头
内容在此处 这是较长的内容 Donec id elit non mi porta gravida at eget metus。 内容在此处 内容在此处
内容在此处 这是较长的内容在此处 Donec id elit non mi porta gravida at eget metus。 内容在此处 内容在此处
内容在此处 这是较长的内容 Donec id elit non mi porta gravida at eget metus。 内容在此处 内容在此处
内容在此处 这是较长的内容在此处 Donec id elit non mi porta gravida at eget metus。 内容在此处 内容在此处

图像

<img src="https://placehold.it/150x150" class="radius">

箭头工具

主要用作导航的下拉箭头。

<div class="arrow-down"></div>
<div class="arrow-up"></div>
<div class="arrow-right"></div>
<div class="arrow-left"></div>

分隔符

这会在元素标题下方创建一个微小的分隔符,通常用于节标题中。

您不需要使用 [文本对齐类](typography-helpers.html#text-alignment),因为此分隔符实用程序处理文本本身的对齐方式。
<h3 class="separator-left">Lorem</h3>
<h3 class="separator-center">Ipsum Dolor</h3>
<h3 class="separator-right">Tempor</h3>

Lorem

Ipsum Dolor

Tempor


字体样式

您可以使用字体样式来设置文本样式。您可以通过向元素添加 font-normalfont-boldfont-italic 来更改字体样式。您还可以使用 font-wide 放大元素的文本。

<p class="font-wide">Lorem ipsum dolor sit amet, consectetur adipisicing elit.</p>
<p class="font-normal">Lorem ipsum dolor sit amet, consectetur adipisicing elit. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</p>
<p class="font-bold">Perspiciatis tempore cumque, magni aspernatur, quidem. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse</p>
<p class="font-italic">Lorem minus, placeat, cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.iure voluptas aliquam tempora neque?</p>

Lorem ipsum dolor sit amet, consectetur adipisicing elit.

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

Perspiciatis tempore cumque, magni aspernatur, quidem. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse

Lorem minus, placeat, cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.iure voluptas aliquam tempora neque?


列表样式

请注意,[无序列表](typography-helpers.html#un-bulleted-list),即 .no-bullet,默认情况下对有序列表和无序列表都启用。

无序列表

<ul class="no-bullet"></ul>
<ul class="list-disc"></ul>
<ul class="list-circle"></ul>
<ul class="list-square"></ul>

有序列表

<ol class="no-bullet"></ol>
<ol class="list-decimal"></ol>
<ol class="list-lower-alpha"></ol>
<ol class="list-lower-latin"></ol>
<ol class="list-lower-roman"></ol>
<ol class="list-upper-alpha"></ol>
<ol class="list-upper-latin"></ol>
<ol class="list-upper-roman"></ol>

文本助手

图像替换(隐藏文本)

您可以包含一个带有视觉隐藏的辅助文本的图像,以实现可访问性和改进 SEO。.text-hide 类将在图像上下文中视觉隐藏元素的文本。

<a href="#" class="text-hide">
  <img src="https://placehold.it/100x30" alt="zurb logo">
  Zurb <!-- Logo Text  -->
</a>
zurb logo Zurb

文本转换

文本转换允许您控制文本的大小写。您可以通过向元素添加 .text-uppercasetext-lowercasetext-capitalize 来更改文本转换。

<p class="text-uppercase"><!-- Text here --></p>
<p class="text-lowercase"><!-- Text here --></p>
<p class="text-capitalize"><!-- Text here --></p>

这是大写文本。故事发生在银河帝国纪元元年,也就是“基地纪元”元年。《银河帝国史》以川陀为开篇,它是拥有 12,000 年历史的银河帝国的首都。尽管帝国表面上稳定而强大,但它正在慢慢衰落,其方式与西罗马帝国的衰落相似。

这是小写文本。故事发生在银河帝国纪元元年,也就是“基地纪元”元年。《银河帝国史》以川陀为开篇,它是拥有 12,000 年历史的银河帝国的首都。尽管帝国表面上稳定而强大,但它正在慢慢衰落,其方式与西罗马帝国的衰落相似。

这是一段首字母大写的文本。 故事背景设定在公元 0 年(“基地纪元”),《基地》开篇于川陀,这个拥有 12,000 年历史的银河帝国的首都。 虽然帝国看起来稳定而强大,但它正在慢慢衰落,其方式与西罗马帝国的衰落相似。

注意:`.text-capitalize` 会更改每个单词的首字母大小写,而不会影响其他字母的大小写。

文本装饰

文本装饰可用于为文本添加下划线、上划线或删除线。 您可以通过向元素添加 .text-underline.text-overline.text-line-through 来更改文本装饰。

<p class="text-underline">Lorem ipsum dolor sit amet, consectetur adipisicing elit. </p>
<p class="text-overline">Perspiciatis tempore cumque, magni aspernatur, quidem</p>
<p class="text-line-through">Lorem minus, placeat, iure voluptas aliquam tempora neque?</p>

Lorem ipsum dolor sit amet, consectetur adipisicing elit.

Perspiciatis tempore cumque, magni aspernatur, quidem

Lorem minus, placeat, iure voluptas aliquam tempora neque?


文本截断

.text-truncate 类将截断您的文本并显示省略号。 此类适用于单行文本。

<p class="text-truncate">Lorem ipsum dolor sit amet, consectetur adipisicing elit. Aperiam voluptatem similique officiis recusandae esse cum in totam quisquam perspiciatis quod! Magnam culpa vitae, tempore eos explicabo cupiditate. Deserunt, quisquam, quos!</p>

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Aperiam voluptatem similique officiis recusandae esse cum in totam quisquam perspiciatis quod! Magnam culpa vitae, tempore eos explicabo cupiditate. Deserunt, quisquam, quos!


文本不换行

如果您想防止文本换行到下一行,可以使用 .text-nowrap。 请注意,除非使用 <br> 标签,否则文本将继续保持在同一行。

<p class="text-nowrap">Lorem ipsum dolor sit amet, consectetur adipisicing elit. Aperiam voluptatem similique officiis recusandae esse cum in totam quisquam perspiciatis quod! Magnam culpa vitae, tempore eos explicabo cupiditate. Deserunt, quisquam, quos!</p>

文本换行

要强制文本换行到下一行,可以使用 .text-wrap

<p class="text-wrap">Lorem ipsum dolor sit amet, consectetur adipisicing elit. Aperiam voluptatem similique officiis recusandae esse cum in totam quisquam perspiciatis quod! Magnam culpa vitae, tempore eos explicabo cupiditate. Deserunt, quisquam, quos!</p>

边距助手

使用这些易于使用的边距类在元素周围生成间距。

请注意,在下方,`1 = 1 * $global-margin`,依此类推。 默认情况下,`$global-margin` 等于 `1rem`,您可以通过 [Sass 变量](#sass-variables) 轻松自定义。

在视频中观看此部分

边距(所有边)

<div class="margin-0"></div>
<div class="margin-1"></div>
<div class="margin-2"></div>
<div class="margin-3"></div>

上边距

<div class="margin-top-0"></div>
<div class="margin-top-1"></div>
<div class="margin-top-2"></div>
<div class="margin-top-3"></div>

下边距

<div class="margin-bottom-0"></div>
<div class="margin-bottom-1"></div>
<div class="margin-bottom-2"></div>
<div class="margin-bottom-3"></div>

左边距

<div class="margin-left-0"></div>
<div class="margin-left-1"></div>
<div class="margin-left-2"></div>
<div class="margin-left-3"></div>

右边距

<div class="margin-right-0"></div>
<div class="margin-right-1"></div>
<div class="margin-right-2"></div>
<div class="margin-right-3"></div>

左右边距(水平轴)

<div class="margin-horizontal-0"></div>
<div class="margin-horizontal-1"></div>
<div class="margin-horizontal-2"></div>
<div class="margin-horizontal-3"></div>

上下边距(垂直轴)

<div class="margin-vertical-0"></div>
<div class="margin-vertical-1"></div>
<div class="margin-vertical-2"></div>
<div class="margin-vertical-3"></div>

边距:用作混合宏

.foo {
  @include margin(1, 0, 2, null);
}

以上代码将生成以下输出

.foo {
  margin-top: 1rem !important;
  margin-right: 0 !important;
  margin-bottom: 2rem !important;
}

注意:`margin-left` 属性未打印,因为此混合宏也接受 `null` 作为值以减少 CSS 输出。 请参阅此处的 Sass 参考


填充助手

使用这些易于使用的填充类在内容周围生成间距。

请注意,在下方,`1 = 1 * $global-padding`,依此类推。 默认情况下,`$global-padding` 等于 `1rem`,您可以通过 [Sass 变量](#sass-variables) 轻松自定义。

填充(所有边)

<div class="padding-0"></div>
<div class="padding-1"></div>
<div class="padding-2"></div>
<div class="padding-3"></div>

上填充

<div class="padding-top-0"></div>
<div class="padding-top-1"></div>
<div class="padding-top-2"></div>
<div class="padding-top-3"></div>

下填充

<div class="padding-bottom-0"></div>
<div class="padding-bottom-1"></div>
<div class="padding-bottom-2"></div>
<div class="padding-bottom-3"></div>

左填充

<div class="padding-left-0"></div>
<div class="padding-left-1"></div>
<div class="padding-left-2"></div>
<div class="padding-left-3"></div>

右填充

<div class="padding-right-0"></div>
<div class="padding-right-1"></div>
<div class="padding-right-2"></div>
<div class="padding-right-3"></div>

左右填充(水平轴)

<div class="padding-horizontal-0"></div>
<div class="padding-horizontal-1"></div>
<div class="padding-horizontal-2"></div>
<div class="padding-horizontal-3"></div>

上下填充(垂直轴)

<div class="padding-vertical-0"></div>
<div class="padding-vertical-1"></div>
<div class="padding-vertical-2"></div>
<div class="padding-vertical-3"></div>

填充:用作混合宏

.bar {
  @include padding(1, 0, 2, null);
}

以上代码将生成以下输出

.bar {
  padding-top: 1rem !important;
  padding-right: 0 !important;
  padding-bottom: 2rem !important;
}

注意:`padding-left` 属性未打印,因为此混合宏也接受 `null` 作为值以减少 CSS 输出。 请参阅此处的 Sass 参考


尺寸

这些宽度和高度类可帮助您轻松地使元素相对于其父元素达到所需的宽度或高度。 默认情况下,它支持 `25%`、`50%`、`75%` 和 `100%`。 但是,您可以通过 Sass map 变量添加更多尺寸。

宽度

<div class="width-25"></div>
<div class="width-50"></div>
<div class="width-75"></div>
<div class="width-100"></div>

<div class="max-width-100"></div>

高度

<div class="height-25"></div>
<div class="height-50"></div>
<div class="height-75"></div>
<div class="height-100"></div>

<div class="max-height-100"></div>

边框盒

边框盒允许您仅添加内容、填充和边框,而不在宽度和高度 CSS 属性中添加边距。

<div class="border-box"></div>

无边框

无边框允许您快速将任何元素的边框重置为 `none`。

<div class="callout primary border-none">
  Hi! I am a callout with no Borders
</div>
嗨! 我是一个没有边框的标注

显示类

显示类允许您更改任何元素的显示属性。

<div class="display-inline"></div>
<div class="display-inline-block"></div>
<div class="display-block"></div>
<div class="display-table"></div>
<div class="display-table-cell"></div>

这些涵盖了一些最常用的显示类型。 MDN 此处 指定了许多其他显示值。 如果您需要其中一些类,则可以使用 `$prototype-display` 通过 Sass 变量轻松添加它们。 Sass 参考 此处

  • 对于 `display: flex`,请使用 `.flex-container`。 请参阅 [Flexbox 参考](flexbox.html)
  • 对于 `display: none`,请使用 `.hide`。 或 Foundation 的 [可见性类](visibility.html)

定位

定位类可帮助您更改元素的位置值。 默认情况下,元素的位置值为 `static`。

<div class="position-relative"></div>
<div class="position-absolute"></div>
<div class="position-fixed"></div>
<div class="position-fixed-top"></div>
<div class="position-fixed-bottom"></div>
<div class="position-static"></div>

定位:用作混合宏

position 混合宏可用于设置位置并同时设置 `top` `right` `bottom` 和/或 `left` 属性。

.foo {
  @include position(fixed, 1, 2, 0, null);
}

以上代码将生成以下输出

.foo {
  position: fixed !important;
  top: 1rem !important;
  right: 2rem !important;
  bottom: 0 !important;
}

请参阅如何未打印 `left` 偏移量,因为此混合宏也接受 `null` 作为值。 Sass 参考 此处


溢出

这些溢出类可帮助您剪切内容、渲染滚动条或仅在其溢出块级容器时显示内容。

所有边

<div class="overflow-visible"></div>
<div class="overflow-hidden"></div>
<div class="overflow-scroll"></div>

水平轴

<div class="overflow-x-visible"></div>
<div class="overflow-x-hidden"></div>
<div class="overflow-x-scroll"></div>

垂直轴

<div class="overflow-y-visible"></div>
<div class="overflow-y-hidden"></div>
<div class="overflow-y-scroll"></div>

注意:在 CSS 规范中,将 X 或 Y 方向上的 `overflow: hidden` 与相反方向上的 `overflow: visible` 组合使用无法按预期工作。 更多信息


Sass 混合宏助手

我们还提供了一些额外的实用程序混合宏,您可以在下一个原型项目中使用它们。

Box 混合宏

此混合宏可帮助您轻松创建正方形、矩形或圆形。 Sass 参考 此处

.foo {
    @include box(1rem, 2rem); // Rectangle
}

.bar {
    @include box(1rem); // Square
}

.baz {
    @include box(1rem, $circle: true); // Circle
}

Rotate 混合宏

这些 Rotate 混合宏允许您将元素旋转到某个角度。 顺时针是默认方向,但在度数前添加 `-` 将使其逆时针旋转。

.foo {
    @include rotate(30); // 30 Degree
}

.bar {
    @include rotateX(60); // 60 Degree on X axis
}

.baz {
    @include rotateY(90); // 90 Degree on Y axis
}

.shaz {
    @include rotateZ(120); // 120 Degree on Z axis
}

关系混合宏(又名:nth:child 混合宏)

这些关系混合宏可帮助您通过简单的 Sass 混合宏管理 :nth-child 化元素的样式。

@include first($num) {} // applies style to first n children
@include first-child {} // applies style to first child only
@include last($num) {}  // applies style to last n children
@include last-child {}  // applies style to first child only
@include every($num) {} // applies style to every n children
@include first-last {}  // applies style to first and last child only
@include after-first($num) {} // applies style to all after nth child
@include from-last($num) {} // applies style to all after and including nth child
@include from-first-last($num) {} // applies style to nth child from first child and last child
@include all-but($num) {} // applies style to all except nth child
@include all-but-first-last($num) {} // applies style all except first and last child
@include unique {} // applies style to a child who has no siblings
@include not-unique {} // applies style to all children except a child who has no siblings
@include between($first, $last) {} // applies style to all except first and last child
@include even {} // applies style to all even children
@include even-between($first, $last) {} // applies style to all even children except first and last
@include odd {} // applies style to all odd children
@include odd-between($first, $last) {} // applies style to all odd children except first and last
@include number-between($num, $first, $last) {} // applies style to every n children from first child and last child

Sass 参考

变量

可以使用项目设置文件中的以下 Sass 变量自定义此组件的默认样式。

名称类型默认值描述
$prototype-arrow-directions 映射


包含所有 `arrow` 方向的映射

$prototype-arrow-size 数字 0.4375rem

箭头的宽度,默认为 `0.4375rem`。

$prototype-arrow-color 颜色 $black

箭头的颜色,默认为 `$black`。

$prototype-border-box-breakpoints 布尔值 $global-prototype-breakpoints

边框盒的响应断点。

$prototype-border-none-breakpoints 布尔值 $global-prototype-breakpoints

无边框的响应断点。

$prototype-bordered-breakpoints 布尔值 $global-prototype-breakpoints

带边框实用程序的响应断点。

$prototype-border-width 数字 rem-calc(1)

`prototype-border-width` 的默认值

$prototype-border-type 字符串 solid

`prototype-border-type` 的默认值

$prototype-border-color 颜色 $medium-gray

`prototype-border-color` 的默认值,默认为 `medium-gray`

$prototype-display-breakpoints 布尔值 $global-prototype-breakpoints

显示类的响应断点

$prototype-display 映射 inline
inline-block
block
table
table-cell

包含所有 `display` 类的映射

$prototype-font-breakpoints 布尔值 $global-prototype-breakpoints

字体样式类型的响应断点

$prototype-wide-letter-spacing 数字 rem-calc(4)

`font-wide` 的字母间距

$prototype-font-normal 数字 $global-weight-normal

`font-normal` 的默认粗细,默认为 `global-weight-normal`

$prototype-font-bold 数字 $global-weight-bold

`font-bold` 的默认粗细,默认为 `global-weight-bold`

$prototype-list-breakpoints 布尔值 $global-prototype-breakpoints

列表样式类型的响应断点

$prototype-style-type-unordered 映射 disc
circle
square

包含所有 `style-type-unordered` 类的映射

$prototype-style-type-ordered 映射 decimal
lower-alpha
lower-latin
lower-roman
upper-alpha
upper-latin
upper-roman

包含所有 `style-type-ordered` 类的映射

$prototype-overflow-breakpoints 布尔值 $global-prototype-breakpoints

溢出辅助类的响应断点

$prototype-overflow 映射 visible
hidden
scroll

包含所有 `overflow` 类的映射

$prototype-position-breakpoints 布尔值 $global-prototype-breakpoints

位置辅助类的响应断点

$prototype-position 映射 static
relative
absolute
fixed

包含所有 `position` 类的映射

$prototype-position-z-index 数字 975

固定定位的 z-index

$prototype-rounded-breakpoints 布尔值 $global-prototype-breakpoints

圆角实用程序的响应断点。

$prototype-border-radius 数字 rem-calc(3)

`prototype-border-radius` 的默认值

$prototype-separator-breakpoints 布尔值 $global-prototype-breakpoints

分隔符的响应断点。

$prototype-separator-align 字符串 center

分隔符的默认对齐方式。

$prototype-separator-height 数字 rem-calc(2)

分隔符的高度。

$prototype-separator-width 数字 3rem

分隔符的宽度。

$prototype-separator-background 颜色 $primary-color

分隔符的默认颜色。

$prototype-separator-margin-top 数字 $global-margin

分隔符的上边距。

$prototype-shadow-breakpoints 布尔值 $global-prototype-breakpoints

阴影实用程序的响应断点。

$prototype-box-shadow 数字 0 2px 5px 0 rgba(0, 0, 0, 0.16), 0 2px 10px 0 rgba(0, 0, 0, 0.12)

`prototype-box-shadow` 的默认值

$prototype-sizing-breakpoints 布尔值 $global-prototype-breakpoints

间距类(边距和填充)的响应断点

$prototype-sizing 映射 width
height

包含所有 `sizing` 类的映射

$prototype-sizes 映射 25: 25%
50: 50%
75: 75%
100: 100%

包含所有尺寸的映射。

$prototype-spacing-breakpoints 布尔值 $global-prototype-breakpoints

间距类(边距和填充)的响应断点

$prototype-spacers-count 数字 3

默认间隔计数器数量(边距和填充)

$prototype-decoration-breakpoints 布尔值 $global-prototype-breakpoints

文本装饰类的响应断点

$prototype-text-decoration 映射 overline
underline
line-through

包含所有 `text-decoration` 类的映射

$prototype-transformation-breakpoints 布尔值 $global-prototype-breakpoints

文本转换类的响应断点

$prototype-text-transformation 映射 lowercase
uppercase
capitalize

包含所有 `text-transformation` 类的映射

$prototype-utilities-breakpoints 布尔值 $global-prototype-breakpoints

文本实用程序的响应断点

$prototype-text-overflow 字符串 ellipsis

`text-overflow` 变量的默认值


混合宏

我们使用这些 mixin 来构建此组件的最终 CSS 输出。您可以自己使用 mixin 从我们的组件中构建自己的类结构。

border-box

@include border-box;

边框盒实用程序


border-none

@include border-none;

无边框实用程序


bordered

@include bordered($width, $type, $color);

带边框的实用程序:默认情况下为元素添加一个浅色边框。

参数类型默认值描述
$width 数字 $prototype-border-width

边框宽度

$type 字符串 $prototype-border-type

边框类型

$color 颜色 $prototype-border-color

边框颜色


box

@include box($width, $height, $circle);

Box Mixin:轻松创建正方形、矩形或圆形

参数类型默认值描述
$width 数字

盒子的宽度

$height 数字 $width

盒子的高度,默认为 $width 以便于制作正方形

$circle 布尔值 false

使盒子成为一个圆形,默认情况下为 false


display

@include display($display);

显示类,默认通过映射 $prototype-display 传递

参数类型默认值描述
$display 字符串

显示类


font-wide

@include font-wide($letter-spacing);

字体宽字母间距!

参数类型默认值描述
$letter-spacing 数字 $prototype-wide-letter-spacing

字体的宽字母间距


font-normal

@include font-normal($weight);

字体粗细正常,默认值通过 global-weight-normal 传递

参数类型默认值描述
$weight 数字 $prototype-font-normal

字体的粗细(正常)


font-bold

@include font-bold($weight);

字体粗细粗体,默认值通过 global-weight-bold 传递

参数类型默认值描述
$weight 数字 $prototype-font-bold

字体的粗细(粗体)


font-italic

@include font-italic;

字体样式斜体


style-type-unordered

@include style-type-unordered($style-type-unordered);

无序列表的样式类型,默认通过映射 $prototype-style-type-unordered 传递

参数类型默认值描述
$style-type-unordered 字符串

无序列表的样式类型


style-type-ordered

@include style-type-ordered($style-type-ordered);

有序列表的样式类型,默认通过映射 $prototype-style-type-ordered 传递

参数类型默认值描述
$style-type-ordered 字符串

有序列表的样式类型


overflow

@include overflow($overflow);

溢出类,默认通过映射 $prototype-overflow 传递

参数类型默认值描述
$overflow 字符串

溢出类


overflow-x

@include overflow-x($overflow);

水平轴上的溢出类,默认通过映射 $prototype-overflow 传递

参数类型默认值描述
$overflow 字符串

溢出类(水平轴)


overflow-y

@include overflow-y($overflow);

垂直轴上的溢出类,默认通过映射 $prototype-overflow 传递

参数类型默认值描述
$overflow 字符串

溢出类(垂直轴)


position

@include position($position, $top, $right, $bottom, $left);

定位类,默认通过映射 $prototype-position 传递,而所有偏移值都乘以 $global-position,默认情况下等于 1rem

参数类型默认值描述
$position 字符串

定位类,可以是 staticrelativeabsolutefixed

$top 数字 null

顶部偏移量

$right 数字 null

右侧偏移量

$bottom 数字 null

底部偏移量

$left 数字 null

左侧偏移量


position-fixed-top

@include position-fixed-top($z-index);

定位固定在顶部角落

参数类型默认值描述
$z-index 数字 $prototype-position-z-index

position-fixed-top 的 z-index


position-fixed-bottom

@include position-fixed-bottom($z-index);

定位固定在底部角落

参数类型默认值描述
$z-index 数字 $prototype-position-z-index

position-fixed-bottom 的 z-index


rotate

@include rotate($deg);

旋转 Mixin:将元素旋转到某个角度

参数类型默认值描述
$deg 数字

旋转角度


rotateX

@include rotateX($deg);

RotateX Mixin:将元素绕 X 轴旋转到某个角度

参数类型默认值描述
$deg 数字

旋转角度


rotateY

@include rotateY($deg);

RotateY Mixin:将元素绕 Y 轴旋转到某个角度

参数类型默认值描述
$deg 数字

旋转角度


rotateZ

@include rotateZ($deg);

RotateZ Mixin:将元素绕 Z 轴旋转到某个角度

参数类型默认值描述
$deg 数字

旋转角度


border-radius

@include border-radius($radius);

圆角实用程序(所有角落):默认情况下为元素添加圆角(所有角落)。

参数类型默认值描述
$radius 数字 $prototype-border-radius

边框半径(所有角落)


border-rounded

@include border-rounded;

圆形正方形实用程序或矩形实用程序(所有角落):默认情况下将元素的所有角落都变成圆角,以形成药丸形状。


separator

@include separator($align, $height, $width, $background, $top);

标题分隔符实用程序,主要用于设置节标题的样式

参数类型默认值描述
$align 字符串 $prototype-separator-align

分隔符对齐方式

$height 数字 $prototype-separator-height

宽度

$width 数字 $prototype-separator-width

高度

$background 颜色 $prototype-separator-background

背景

$top 数字 $prototype-separator-margin-top

上边距


shadow

@include shadow($shadow);

阴影实用程序:默认情况下为元素添加一个浅色阴影。

参数类型默认值描述
$shadow 数字 $prototype-box-shadow

组件的阴影


max-width-100

@include max-width-100;

最大宽度 100 实用程序。


max-height-100

@include max-height-100;

最大高度 100 实用程序。


margin

@include margin($top, $right, $bottom, $left);

边距辅助 mixin,所有值都乘以 $global-margin,默认情况下等于 1rem

参数类型默认值描述
$top 数字 null

上边距

$right 数字 null

右边距

$bottom 数字 null

下边距

$left 数字 null

左边距


padding

@include padding($top, $right, $bottom, $left);

填充辅助 mixin,所有值都乘以 $global-padding,默认情况下等于 1rem

参数类型默认值描述
$top 数字 null

上边距

$right 数字 null

右边距

$bottom 数字 null

下边距

$left 数字 null

左边距


margin-direction

@include margin-direction($dir, $spacer);

特定方向属性的边距类

参数类型默认值描述
$dir 字符串

方向

$spacer 数字

间隔符


padding-direction

@include padding-direction($dir, $spacer);

特定方向属性的填充类

参数类型默认值描述
$dir 字符串

方向

$spacer 数字

间隔符


text-decoration

@include text-decoration($decoration);

文本装饰,默认通过映射 $prototype-text-decoration 传递

参数类型默认值描述
$decoration 字符串

文本装饰


text-transform

@include text-transform($transformation);

文本转换,默认通过映射 $prototype-text-transformation 传递

参数类型默认值描述
$transformation 字符串

文本转换


text-hide

@include text-hide;

图像替换实用程序。text-hide


text-truncate

@include text-truncate($overflow);

截断文本,默认使用省略号。

参数类型默认值描述
$overflow 字符串 $prototype-text-overflow

文本截断


text-nowrap

@include text-nowrap;

不换行文本。text-nowrap


text-wrap

@include text-wrap;

换行文本。text-wrap


first

@include first($num) { }

从第一个到 $num 选择所有子元素。

参数类型默认值描述
$num 数字

子元素总数的前 n


first-child

@include first-child { }

选择第一个确切的子元素


last

@include last($num) { }

从最后一个到 $num 选择所有子元素。

参数类型默认值描述
$num 数字

子元素总数的最后 n


last-child

@include last-child { }

选择最后一个确切的子元素


every

@include every($num) { }

$num 个子元素选择一次。

参数类型默认值描述
$num 数字

所有子元素中的每 n


first-last

@include first-last { }

仅选择第一个和最后一个子元素。


after-first

@include after-first($num) { }

从第一个到 $num 选择后面的所有子元素。

参数类型默认值描述
$num 数字

子元素总数的前 n 个之后的子元素


from-last

@include from-last($num) { }

从最后一个开始选择 $num 个子元素之前的子元素。

参数类型默认值描述
$num 数字

从最后一个开始的 n 个子元素


from-first-last

@include from-first-last($num) { }

从第一个开始选择第 $num 个子元素,从最后一个开始选择第 $num 个子元素。

参数类型默认值描述
$num 数字

从第一个和最后一个开始调用的第 n 个数字


all-but

@include all-but($num) { }

选择除 $num 之外的所有子元素。

参数类型默认值描述
$num 数字

应从所有其他子元素中排除的第 n 个数字


all-but-first-last

@include all-but-first-last($num) { }

选择前 $num 个和后 $num 个之间的所有子元素。

参数类型默认值描述
$num 数字

从第一个和最后一个开始排除的第 n 个数字


unique

@include unique { }

仅在子元素唯一时才选择它。这意味着如果至少有 2 个子元素,则不会应用该样式。


not-unique

@include not-unique { }

仅在子元素不唯一时才选择它们。这意味着如果至少有 2 个子元素,则将应用该样式。


between

@include between($first, $last) { }

选择 $first$last 之间的所有子元素。

参数类型默认值描述
$first 数字

第一个 nth 数字

$last 数字

最后一个 nth 数字


even

@include even { }

选择所有偶数子元素。


even-between

@include even-between($first, $last) { }

选择 $first$last 之间的所有偶数子元素。

参数类型默认值描述
$first 数字

第一个 nth 数字

$last 数字

最后一个 nth 数字


odd

@include odd { }

选择所有奇数子元素。


odd-between

@include odd-between($first, $last) { }

选择 $first$last 之间的所有奇数子元素。

参数类型默认值描述
$first 数字

第一个 nth 数字

$last 数字

最后一个 nth 数字


number-between

@include number-between($num, $first, $last) { }

选择 $first$last 之间的所有 $num 个子元素。

参数类型默认值描述
$num 数字

$first$last 之间的每 n 个数字。

$first 数字

第一个 n 数字

$last 数字

最后一个 n 数字