ion-list-header
列表标头是用于描述 list.txt 内容的块元素。与 物品分隔线 不同,列表标头只能在 items 列表的顶部使用一次。
¥List headers are block elements that are used to describe the contents of a list. Unlike item dividers, list headers should only be used once at the top of a list of items.
基本用法
¥Basic Usage
<ion-list>
<ion-list-header>
<ion-label>Video Games</ion-label>
</ion-list-header>
<ion-item>
<ion-label>Pokémon Yellow</ion-label>
</ion-item>
<ion-item>
<ion-label>Mega Man X</ion-label>
</ion-item>
<ion-item>
<ion-label>The Legend of Zelda</ion-label>
</ion-item>
<ion-item>
<ion-label>Pac-Man</ion-label>
</ion-item>
<ion-item>
<ion-label>Super Mario World</ion-label>
</ion-item>
</ion-list>
列表标题中的按钮
¥Buttons in List Headers
放置在列表标题中的 button 对于显示列表的一部分并使用按钮重定向到完整列表非常有用。
¥A button placed in a list header can be useful for showing part of a list and redirecting to the full list with the button.
<ion-list>
<ion-list-header>
<ion-label>Video Games</ion-label>
<ion-button>See All</ion-button>
</ion-list-header>
<ion-item>
<ion-label>Pokémon Yellow</ion-label>
</ion-item>
<ion-item>
<ion-label>Mega Man X</ion-label>
</ion-item>
<ion-item>
<ion-label>The Legend of Zelda</ion-label>
</ion-item>
<ion-item>
<ion-label>Pac-Man</ion-label>
</ion-item>
<ion-item>
<ion-label>Super Mario World</ion-label>
</ion-item>
</ion-list>
列表标题行
¥List Header Lines
默认情况下,列表标题不显示底部边框。lines
属性可以修改为 "full"
或 "inset"
,它们将分别显示全宽边框或带有左内边距的插入边框。
¥List headers do not show a bottom border by default. The lines
property can be modified to "full"
or "inset"
which will show a full width border or an inset border with left padding, respectively.
<ion-list>
<ion-list-header>
<ion-label>Default</ion-label>
</ion-list-header>
<ion-item>
<ion-label>Item</ion-label>
</ion-item>
<ion-item>
<ion-label>Item</ion-label>
</ion-item>
</ion-list>
<ion-list>
<ion-list-header lines="inset">
<ion-label>Inset</ion-label>
</ion-list-header>
<ion-item>
<ion-label>Item</ion-label>
</ion-item>
<ion-item>
<ion-label>Item</ion-label>
</ion-item>
</ion-list>
<ion-list>
<ion-list-header lines="full">
<ion-label>Full</ion-label>
</ion-list-header>
<ion-item>
<ion-label>Item</ion-label>
</ion-item>
<ion-item>
<ion-label>Item</ion-label>
</ion-item>
</ion-list>
主题化
¥Theming
颜色
¥Colors
<ion-list-header>
<ion-label>Default</ion-label>
</ion-list-header>
<ion-list-header color="primary">
<ion-label>Primary</ion-label>
</ion-list-header>
<ion-list-header color="secondary">
<ion-label>Secondary</ion-label>
</ion-list-header>
<ion-list-header color="tertiary">
<ion-label>Tertiary</ion-label>
</ion-list-header>
<ion-list-header color="success">
<ion-label>Success</ion-label>
</ion-list-header>
<ion-list-header color="warning">
<ion-label>Warning</ion-label>
</ion-list-header>
<ion-list-header color="danger">
<ion-label>Danger</ion-label>
</ion-list-header>
<ion-list-header color="light">
<ion-label>Light</ion-label>
</ion-list-header>
<ion-list-header color="medium">
<ion-label>Medium</ion-label>
</ion-list-header>
<ion-list-header color="dark">
<ion-label>Dark</ion-label>
</ion-list-header>
CSS 自定义属性
¥CSS Custom Properties
- src/app/example.component.css
- src/app/example.component.html
ion-list-header {
--background: #19422d;
--color: #fff;
--border-width: 0 0 4px 0;
--border-color: #f24aec;
--border-style: double;
}
属性
¥Properties
color
Description | The color to use from your application's color palette. Default options are: "primary" , "secondary" , "tertiary" , "success" , "warning" , "danger" , "light" , "medium" , and "dark" . For more information on colors, see theming. |
Attribute | color |
Type | "danger" | "dark" | "light" | "medium" | "primary" | "secondary" | "success" | "tertiary" | "warning" | string | undefined |
Default | undefined |
lines
Description | How the bottom border should be displayed on the list header. |
Attribute | lines |
Type | "full" | "inset" | "none" | undefined |
Default | undefined |
mode
Description | The mode determines which platform styles to use. |
Attribute | mode |
Type | "ios" | "md" |
Default | undefined |
事件
¥Events
No events available for this component.
方法
¥Methods
No public methods available for this component.
CSS 阴影部分
¥CSS Shadow Parts
No CSS shadow parts available for this component.
CSS 自定义属性
¥CSS Custom Properties
- iOS
- MD
Name | Description |
---|---|
--background | Background of the list header |
--border-color | Color of the list header border |
--border-style | Style of the list header border |
--border-width | Width of the list header border |
--color | Color of the list header text |
--inner-border-width | Width of the inner list header border |
Name | Description |
---|---|
--background | Background of the list header |
--border-color | Color of the list header border |
--border-style | Style of the list header border |
--border-width | Width of the list header border |
--color | Color of the list header text |
--inner-border-width | Width of the inner list header border |
插槽
¥Slots
No slots available for this component.