跳到主要内容
版本:v6

CSS 实用工具

Ionic Framework 提供了一组 CSS 实用工具类,可用于任何元素,以修改文本、元素放置或调整内边距和外边距。

important

如果你的应用不是使用可用的 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>
ClassStyle RuleDescription
.ion-text-lefttext-align: left行内内容对齐到行框的左边缘。
.ion-text-righttext-align: right行内内容对齐到行框的右边缘。
.ion-text-starttext-align: start如果方向为从左到右,则与 text-left 相同;如果方向为从右到左,则与 text-right 相同。
.ion-text-endtext-align: end如果方向为从左到右,则与 text-right 相同;如果方向为从右到左,则与 text-left 相同。
.ion-text-centertext-align: center行内内容在行框中居中。
.ion-text-justifytext-align: justify行内内容两端对齐。文本应间隔开,使其左右边缘与行框的左右边缘对齐,最后一行除外。
.ion-text-wrapwhite-space: normal空白序列被合并。源代码中的换行符被视为其他空白。根据需要换行以填充行框。
.ion-text-nowrapwhite-space: nowrapnormal 一样合并空白,但禁止文本内的换行(文本换行)。

文本转换

<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>
ClassStyle RuleDescription
.ion-text-uppercasetext-transform: uppercase强制所有字符转换为大写。
.ion-text-lowercasetext-transform: lowercase强制所有字符转换为小写。
.ion-text-capitalizetext-transform: capitalize强制每个单词的首字母转换为大写。

响应式文本类

上面列出的所有文本类都有额外的类,可根据屏幕大小修改文本。在每个类中使用 text-{breakpoint}- 代替 text-,以仅在特定屏幕大小上使用该类,其中 {breakpoint}Ionic 断点中列出的断点名称之一。

下表显示了默认行为,其中 {modifier} 为以下任意值:leftrightstartendcenterjustifywrapnowrapuppercaselowercasecapitalize,如上所述。

ClassDescription
.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>
ClassStyle RuleDescription
.ion-float-leftfloat: left元素将浮动在其包含块的左侧。
.ion-float-rightfloat: right元素将浮动在其包含块的右侧。
.ion-float-startfloat: left / float: right如果方向为从左到右,则与 float-left 相同;如果方向为从右到左,则与 float-right 相同。
.ion-float-endfloat: left / float: right如果方向为从左到右,则与 float-right 相同;如果方向为从右到左,则与 float-left 相同。

响应式浮动类

上面列出的所有浮动类都有额外的类,可根据屏幕大小修改浮动。在每个类中使用 float-{breakpoint}- 代替 float-,以仅在特定屏幕大小上使用该类,其中 {breakpoint}Ionic 断点中列出的断点名称之一。

下表显示了默认行为,其中 {modifier} 为以下任意值:leftrightstartend,如上所述。

ClassDescription
.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>
ClassStyle RuleDescription
.ion-hidedisplay: none元素将被隐藏。

响应式显示类

还有额外的类可根据屏幕大小修改可见性。在所有屏幕大小上使用 .ion-hide 之外,还可以使用 .ion-hide-{breakpoint}-{dir} 来仅在特定屏幕大小上使用该类,其中 {breakpoint}Ionic 断点中列出的断点名称之一,{dir} 表示元素应在指定断点以上(up)还是以下(down)隐藏。

ClassDescription
.ion-hide-sm-{dir}min-width: 576pxup)或 max-width: 576pxdown)时对元素应用修饰符。
.ion-hide-md-{dir}min-width: 768pxup)或 max-width: 768pxdown)时对元素应用修饰符。
.ion-hide-lg-{dir}min-width: 992pxup)或 max-width: 992pxdown)时对元素应用修饰符。
.ion-hide-xl-{dir}min-width: 1200pxup)或 max-width: 1200pxdown)时对元素应用修饰符。

内容空间

内边距

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>
ClassStyle RuleDescription
.ion-paddingpadding: 16px为所有边应用内边距。
.ion-padding-toppadding-top: 16px为顶部应用内边距。
.ion-padding-startpadding-start: 16px为起始边应用内边距。
.ion-padding-endpadding-end: 16px为结束边应用内边距。
.ion-padding-bottompadding-bottom: 16px为底部应用内边距。
.ion-padding-verticalpadding: 16px 0为顶部和底部应用内边距。
.ion-padding-horizontalpadding: 0 16px为左侧和右侧应用内边距。
.ion-no-paddingpadding: 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>
ClassStyle RuleDescription
.ion-marginmargin: 16px为所有边应用外边距。
.ion-margin-topmargin-top: 16px为顶部应用外边距。
.ion-margin-startmargin-start: 16px为左侧应用外边距。
.ion-margin-endmargin-end: 16px为右侧应用外边距。
.ion-margin-bottommargin-bottom: 16px为底部应用外边距。
.ion-margin-verticalmargin: 16px 0为顶部和底部应用外边距。
.ion-margin-horizontalmargin: 0 16px为左侧和右侧应用外边距。
.ion-no-marginmargin: 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>
ClassStyle RuleDescription
.ion-justify-content-startjustify-content: flex-start项目在主轴方向向起始端靠拢。
.ion-justify-content-endjustify-content: flex-end项目在主轴方向向末端靠拢。
.ion-justify-content-centerjustify-content: center项目在主轴方向居中。
.ion-justify-content-aroundjustify-content: space-around项目在主轴方向均匀分布,周围空间相等。
.ion-justify-content-betweenjustify-content: space-between项目在主轴方向均匀分布。
.ion-justify-content-evenlyjustify-content: space-evenly项目分布均匀,任意两个项目之间的间距相等。
.ion-align-items-startalign-items: flex-start项目在交叉轴方向向起始端靠拢。
.ion-align-items-endalign-items: flex-end项目在交叉轴方向向末端靠拢。
.ion-align-items-centeralign-items: center项目在交叉轴方向居中。
.ion-align-items-baselinealign-items: baseline项目对齐,使其基线对齐。
.ion-align-items-stretchalign-items: stretch项目拉伸以填充容器。
.ion-nowrapflex-wrap: nowrap项目全部在一行上。
.ion-wrapflex-wrap: wrap项目将换行到多行,从上到下。
.ion-wrap-reverseflex-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>
ClassStyle RuleDescription
.ion-align-self-startalign-self: flex-start项目在交叉轴方向向起始端靠拢。
.ion-align-self-endalign-self: flex-end项目在交叉轴方向向末端靠拢。
.ion-align-self-centeralign-self: center项目在交叉轴方向居中。
.ion-align-self-baselinealign-self: baseline项目对齐,使其基线与其他项目基线对齐。
.ion-align-self-stretchalign-self: stretch项目拉伸以填充容器。
.ion-align-self-autoalign-self: auto项目根据父元素的 align-items 值定位。

边框显示

.ion-no-border 实用工具类可用于移除 Ionic 组件的边框。该类可应用于 ion-headerion-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>
ClassDescription
.ion-no-border元素将没有边框。

Ionic 断点

Ionic 在媒体查询中使用断点,以根据屏幕大小不同地样式化应用程序。以下断点名称用于上述实用工具类中,当宽度满足条件时将应用该类。

断点名称宽度
xs0
sm576px
md768px
lg992px
xl1200px