CSS 实用工具
Ionic Framework 提供了一组 CSS 实用工具类,可用于任何元素,以修改文本、元素放置或调整内边距和外边距。
如果你的应用不是使用可用的 Ionic Framework 启动器启动的,则需要在全局样式表的可选部分中列出的样式表,才能使这些样式正常工作。
文本修改
文本对齐
<ion-grid>
<ion-row>
<ion-col>
<div class="ion-text-start">
<h3>text-start</h3>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ac vehicula lorem.
</div>
</ion-col>
<ion-col>
<div class="ion-text-end">
<h3>text-end</h3>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ac vehicula lorem.
</div>
</ion-col>
<ion-col>
<div class="ion-text-center">
<h3>text-center</h3>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ac vehicula lorem.
</div>
</ion-col>
</ion-row>
<ion-row>
<ion-col>
<div class="ion-text-justify">
<h3>text-justify</h3>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ac vehicula lorem.
</div>
</ion-col>
<ion-col>
<div class="ion-text-wrap">
<h3>text-wrap</h3>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ac vehicula lorem.
</div>
</ion-col>
<ion-col>
<div class="ion-text-nowrap">
<h3>text-nowrap</h3>
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
</div>
</ion-col>
</ion-row>
</ion-grid>
| Class | Style Rule | Description |
|---|---|---|
.ion-text-left | text-align: left | 行内内容对齐到行框的左边缘。 |
.ion-text-right | text-align: right | 行内内容对齐到行框的右边缘。 |
.ion-text-start | text-align: start | 如果方向为从左到右,则与 text-left 相同;如果方向为从右到左,则与 text-right 相同。 |
.ion-text-end | text-align: end | 如果方向为从左到右,则与 text-right 相同;如果方向为从右到左,则与 text-left 相同。 |
.ion-text-center | text-align: center | 行内内容在行框中居中。 |
.ion-text-justify | text-align: justify | 行内内容两端对齐。文本应间隔开,使其左右边缘与行框的左右边缘对齐,最后一行除外。 |
.ion-text-wrap | white-space: normal | 空白序列被合并。源代码中的换行符被视为其他空白。根据需要换行以填充行框。 |
.ion-text-nowrap | white-space: nowrap | 与 normal 一样合并空白,但禁止文本内的换行(文本换行)。 |
文本转换
<ion-grid>
<ion-row>
<ion-col>
<div class="ion-text-uppercase">
<h3>text-uppercase</h3>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ac vehicula lorem.
</div>
</ion-col>
<ion-col>
<div class="ion-text-lowercase">
<h3>text-lowercase</h3>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ac vehicula lorem.
</div>
</ion-col>
<ion-col>
<div class="ion-text-capitalize">
<h3>text-capitalize</h3>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ac vehicula lorem.
</div>
</ion-col>
</ion-row>
</ion-grid>
| Class | Style Rule | Description |
|---|---|---|
.ion-text-uppercase | text-transform: uppercase | 强制所有字符转换为大写。 |
.ion-text-lowercase | text-transform: lowercase | 强制所有字符转换为小写。 |
.ion-text-capitalize | text-transform: capitalize | 强制每个单词的首字母转换为大写。 |
响应式文本类
上面列出的所有文本类都有额外的类,可根据屏幕大小修改文本。在每个类中使用 text-{breakpoint}- 代替 text-,以仅在特定屏幕大小上使用该类,其中 {breakpoint} 是 Ionic 断点中列出的断点名称之一。
下表显示了默认行为,其中 {modifier} 为以下任意值:left、right、start、end、center、justify、wrap、nowrap、uppercase、lowercase 或 capitalize,如上所述。
| Class | Description |
|---|---|
.ion-text-{modifier} | 在所有屏幕大小上对元素应用修饰符。 |
.ion-text-sm-{modifier} | 当 min-width: 576px 时对元素应用修饰符。 |
.ion-text-md-{modifier} | 当 min-width: 768px 时对元素应用修饰符。 |
.ion-text-lg-{modifier} | 当 min-width: 992px 时对元素应用修饰符。 |
.ion-text-xl-{modifier} | 当 min-width: 1200px 时对元素应用修饰符。 |
元素放置
浮动元素
float CSS 属性指定元素应沿其容器的左侧或右侧放置,文本和内联元素将环绕它。这样,元素被从网页的正常流中取出,但仍作为流的一部分,与绝对定位不同。
<ion-grid>
<ion-row>
<ion-col class="ion-float-left">
<div>
<h3>float-left</h3>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ac vehicula lorem.
</div>
</ion-col>
<ion-col class="ion-float-right">
<div>
<h3>float-right</h3>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ac vehicula lorem.
</div>
</ion-col>
</ion-row>
</ion-grid>
| Class | Style Rule | Description |
|---|---|---|
.ion-float-left | float: left | 元素将浮动在其包含块的左侧。 |
.ion-float-right | float: right | 元素将浮动在其包含块的右侧。 |
.ion-float-start | float: left / float: right | 如果方向为从左到右,则与 float-left 相同;如果方向为从右到左,则与 float-right 相同。 |
.ion-float-end | float: left / float: right | 如果方向为从左到右,则与 float-right 相同;如果方向为从右到左,则与 float-left 相同。 |
响应式浮动类
上面列出的所有浮动类都有额外的类,可根据屏幕大小修改浮动。在每个类中使用 float-{breakpoint}- 代替 float-,以仅在特定屏幕大小上使用该类,其中 {breakpoint} 是 Ionic 断点中列出的断点名称之一。
下表显示了默认行为,其中 {modifier} 为以下任意值:left、right、start 或 end,如上所述。
| Class | Description |
|---|---|
.ion-float-{modifier} | 在所有屏幕大小上对元素应用修饰符。 |
.ion-float-sm-{modifier} | 当 min-width: 576px 时对元素应用修饰符。 |
.ion-float-md-{modifier} | 当 min-width: 768px 时对元素应用修饰符。 |
.ion-float-lg-{modifier} | 当 min-width: 992px 时对元素应用修饰符。 |
.ion-float-xl-{modifier} | 当 min-width: 1200px 时对元素应用修饰符。 |
元素显示
display CSS 属性设置元素是作为块级还是内联框处理,以及用于其子元素的布局(如流式布局、网格或 flex)。它也可以用于完全从布局中隐藏元素。
<ion-grid>
<ion-row>
<ion-col class="ion-hide">
<div>
<h3>hidden</h3>
你看不到我。
</div>
</ion-col>
<ion-col>
<div>
<h3>not-hidden</h3>
你能看到我!
</div>
</ion-col>
</ion-row>
</ion-grid>
| Class | Style Rule | Description |
|---|---|---|
.ion-hide | display: none | 元素将被隐藏。 |
响应式显示类
还有额外的类可根据屏幕大小修改可见性。在所有屏幕大小上使用 .ion-hide 之外,还可以使用 .ion-hide-{breakpoint}-{dir} 来仅在特定屏幕大小上使用该类,其中 {breakpoint} 是 Ionic 断点中列出的断点名称之一,{dir} 表示元素应在指定断点以上(up)还是以下(down)隐藏。
| Class | Description |
|---|---|
.ion-hide-sm-{dir} | 当 min-width: 576px(up)或 max-width: 576px(down)时对元素应用修饰符。 |
.ion-hide-md-{dir} | 当 min-width: 768px(up)或 max-width: 768px(down)时对元素应用修饰符。 |
.ion-hide-lg-{dir} | 当 min-width: 992px(up)或 max-width: 992px(down)时对元素应用修饰符。 |
.ion-hide-xl-{dir} | 当 min-width: 1200px(up)或 max-width: 1200px(down)时对元素应用修饰符。 |
内容空间
内边距
padding 类设置元素的内边距区域。内边距区域是元素内容与其边框之间的空间。
默认应用的 padding 值为 16px,由 --ion-padding 变量设置。有关如何更改这些值的更多信息,请参见 CSS 变量部分。
<ion-grid>
<ion-row>
<ion-col class="ion-padding">
<div>padding</div>
</ion-col>
<ion-col class="ion-padding-top">
<div>padding-top</div>
</ion-col>
<ion-col class="ion-padding-start">
<div>padding-start</div>
</ion-col>
<ion-col class="ion-padding-end">
<div>padding-end</div>
</ion-col>
</ion-row>
<ion-row>
<ion-col class="ion-padding-bottom">
<div>padding-bottom</div>
</ion-col>
<ion-col class="ion-padding-vertical">
<div>padding-vertical</div>
</ion-col>
<ion-col class="ion-padding-horizontal">
<div>padding-horizontal</div>
</ion-col>
<ion-col class="ion-no-padding">
<div>no-padding</div>
</ion-col>
</ion-row>
</ion-grid>
| Class | Style Rule | Description |
|---|---|---|
.ion-padding | padding: 16px | 为所有边应用内边距。 |
.ion-padding-top | padding-top: 16px | 为顶部应用内边距。 |
.ion-padding-start | padding-start: 16px | 为起始边应用内边距。 |
.ion-padding-end | padding-end: 16px | 为结束边应用内边距。 |
.ion-padding-bottom | padding-bottom: 16px | 为底部应用内边距。 |
.ion-padding-vertical | padding: 16px 0 | 为顶部和底部应用内边距。 |
.ion-padding-horizontal | padding: 0 16px | 为左侧和右侧应用内边距。 |
.ion-no-padding | padding: 0 | 所有边不应用内边距。 |
外边距
margin 区域通过一个空白区域扩展边框区域,用于将元素与其相邻元素分隔开。
默认应用的 margin 值为 16px,由 --ion-margin 变量设置。有关如何更改这些值的更多信息,请参见 CSS 变量部分。
<ion-grid>
<ion-row>
<ion-col class="ion-margin">
<div>margin</div>
</ion-col>
<ion-col class="ion-margin-top">
<div>margin-top</div>
</ion-col>
<ion-col class="ion-margin-start">
<div>margin-start</div>
</ion-col>
<ion-col class="ion-margin-end">
<div>margin-end</div>
</ion-col>
</ion-row>
<ion-row>
<ion-col class="ion-margin-bottom">
<div>margin-bottom</div>
</ion-col>
<ion-col class="ion-margin-vertical">
<div>margin-vertical</div>
</ion-col>
<ion-col class="ion-margin-horizontal">
<div>margin-horizontal</div>
</ion-col>
<ion-col class="ion-no-margin">
<div>no-margin</div>
</ion-col>
</ion-row>
</ion-grid>
| Class | Style Rule | Description |
|---|---|---|
.ion-margin | margin: 16px | 为所有边应用外边距。 |
.ion-margin-top | margin-top: 16px | 为顶部应用外边距。 |
.ion-margin-start | margin-start: 16px | 为左侧应用外边距。 |
.ion-margin-end | margin-end: 16px | 为右侧应用外边距。 |
.ion-margin-bottom | margin-bottom: 16px | 为底部应用外边距。 |
.ion-margin-vertical | margin: 16px 0 | 为顶部和底部应用外边距。 |
.ion-margin-horizontal | margin: 0 16px | 为左侧和右侧应用外边距。 |
.ion-no-margin | margin: 0 | 所有边不应用外边距。 |
Flex 属性
Flex 容器属性
<ion-grid>
<ion-row class="ion-justify-content-start">
<ion-col size="3">
<div>1 of 2</div>
</ion-col>
<ion-col size="3">
<div>2 of 2</div>
</ion-col>
</ion-row>
<ion-row class="ion-justify-content-center">
<ion-col size="3">
<div>1 of 2</div>
</ion-col>
<ion-col size="3">
<div>2 of 2</div>
</ion-col>
</ion-row>
<ion-row class="ion-justify-content-end">
<ion-col size="3">
<div>1 of 2</div>
</ion-col>
<ion-col size="3">
<div>2 of 2</div>
</ion-col>
</ion-row>
<ion-row class="ion-justify-content-around">
<ion-col size="3">
<div>1 of 2</div>
</ion-col>
<ion-col size="3">
<div>2 of 2</div>
</ion-col>
</ion-row>
<ion-row class="ion-justify-content-between">
<ion-col size="3">
<div>1 of 2</div>
</ion-col>
<ion-col size="3">
<div>2 of 2</div>
</ion-col>
</ion-row>
<ion-row class="ion-justify-content-evenly">
<ion-col size="3">
<div>1 of 2</div>
</ion-col>
<ion-col size="3">
<div>2 of 2</div>
</ion-col>
</ion-row>
</ion-grid>
<ion-grid>
<ion-row class="ion-align-items-start">
<ion-col>
<div>1 of 4</div>
</ion-col>
<ion-col>
<div>2 of 4</div>
</ion-col>
<ion-col>
<div>3 of 4</div>
</ion-col>
<ion-col>
<div>4 of 4 # # #</div>
</ion-col>
</ion-row>
<ion-row class="ion-align-items-end">
<ion-col>
<div>1 of 4</div>
</ion-col>
<ion-col>
<div>2 of 4</div>
</ion-col>
<ion-col>
<div>3 of 4</div>
</ion-col>
<ion-col>
<div>4 of 4 # # #</div>
</ion-col>
</ion-row>
<ion-row class="ion-align-items-center">
<ion-col>
<div>1 of 4</div>
</ion-col>
<ion-col>
<div>2 of 4</div>
</ion-col>
<ion-col>
<div>3 of 4</div>
</ion-col>
<ion-col>
<div>4 of 4 # # #</div>
</ion-col>
</ion-row>
<ion-row class="ion-align-items-baseline">
<ion-col>
<div>1 of 4</div>
</ion-col>
<ion-col>
<div>2 of 4</div>
</ion-col>
<ion-col>
<div>3 of 4</div>
</ion-col>
<ion-col>
<div>4 of 4 # # #</div>
</ion-col>
</ion-row>
<ion-row class="ion-align-items-stretch">
<ion-col>
<div>1 of 4</div>
</ion-col>
<ion-col>
<div>2 of 4</div>
</ion-col>
<ion-col>
<div>3 of 4</div>
</ion-col>
<ion-col>
<div>4 of 4 # # #</div>
</ion-col>
</ion-row>
</ion-grid>
| Class | Style Rule | Description |
|---|---|---|
.ion-justify-content-start | justify-content: flex-start | 项目在主轴方向向起始端靠拢。 |
.ion-justify-content-end | justify-content: flex-end | 项目在主轴方向向末端靠拢。 |
.ion-justify-content-center | justify-content: center | 项目在主轴方向居中。 |
.ion-justify-content-around | justify-content: space-around | 项目在主轴方向均匀分布,周围空间相等。 |
.ion-justify-content-between | justify-content: space-between | 项目在主轴方向均匀分布。 |
.ion-justify-content-evenly | justify-content: space-evenly | 项目分布均匀,任意两个项目之间的间距相等。 |
.ion-align-items-start | align-items: flex-start | 项目在交叉轴方向向起始端靠拢。 |
.ion-align-items-end | align-items: flex-end | 项目在交叉轴方向向末端靠拢。 |
.ion-align-items-center | align-items: center | 项目在交叉轴方向居中。 |
.ion-align-items-baseline | align-items: baseline | 项目对齐,使其基线对齐。 |
.ion-align-items-stretch | align-items: stretch | 项目拉伸以填充容器。 |
.ion-nowrap | flex-wrap: nowrap | 项目全部在一行上。 |
.ion-wrap | flex-wrap: wrap | 项目将换行到多行,从上到下。 |
.ion-wrap-reverse | flex-wrap: wrap-reverse | 项目将换行到多行,从下到上。 |
Flex 项目属性
<ion-grid>
<ion-row>
<ion-col class="ion-align-self-start">
<div>1 of 4</div>
</ion-col>
<ion-col class="ion-align-self-center">
<div>2 of 4</div>
</ion-col>
<ion-col class="ion-align-self-end">
<div>3 of 4</div>
</ion-col>
<ion-col>
<div>4 of 4 # # #</div>
</ion-col>
</ion-row>
</ion-grid>
| Class | Style Rule | Description |
|---|---|---|
.ion-align-self-start | align-self: flex-start | 项目在交叉轴方向向起始端靠拢。 |
.ion-align-self-end | align-self: flex-end | 项目在交叉轴方向向末端靠拢。 |
.ion-align-self-center | align-self: center | 项目在交叉轴方向居中。 |
.ion-align-self-baseline | align-self: baseline | 项目对齐,使其基线与其他项目基线对齐。 |
.ion-align-self-stretch | align-self: stretch | 项目拉伸以填充容器。 |
.ion-align-self-auto | align-self: auto | 项目根据父元素的 align-items 值定位。 |
边框显示
.ion-no-border 实用工具类可用于移除 Ionic 组件的边框。该类可应用于 ion-header 和 ion-footer 组件。
<ion-header class="ion-no-border">
<ion-toolbar>
<ion-title>页眉 - 无边框</ion-title>
</ion-toolbar>
</ion-header>
<ion-footer class="ion-no-border">
<ion-toolbar>
<ion-title>页脚 - 无边框</ion-title>
</ion-toolbar>
</ion-footer>
| Class | Description |
|---|---|
.ion-no-border | 元素将没有边框。 |
Ionic 断点
Ionic 在媒体查询中使用断点,以根据屏幕大小不同地样式化应用程序。以下断点名称用于上述实用工具类中,当宽度满足条件时将应用该类。
| 断点名称 | 宽度 |
|---|---|
xs | 0 |
sm | 576px |
md | 768px |
lg | 992px |
xl | 1200px |