卡片 React 元件
卡片與清單檢視一樣,是另一個包含和整理資訊的好方法。卡片包含獨特的相關資料,例如,一張照片、文字和一個關於單一主題的連結。卡片通常是進入更複雜和詳細資訊的入口。
卡片 React 元件表示 卡片 元件。
卡片元件
包含下列元件
卡片
卡片標題
卡片內容
卡片頁尾
卡片屬性
屬性 | 類型 | 預設值 | 說明 |
---|---|---|---|
<Card> 屬性 | |||
標題 | 字串 | 卡片標題內容 | |
內容 | 字串 | 卡片內容 | |
頁尾 | 字串 | 卡片頁尾內容 | |
內距 | 布林值 | true | 在卡片內容上增加額外的內部內距 |
外框 | 布林值 | false | 製作卡片外框 - 帶有邊框 |
外框 iOS | 布林值 | false | 以 iOS 主題製作卡片外框 |
外框 MD | 布林值 | false | 以 MD 主題製作卡片外框 |
凸起 | 布林值 | false | 製作凸起的卡片 - 帶有陰影 |
標題分隔線 | 布林值 | false | 為卡片標題新增分隔線 (邊框) |
頁尾分隔線 | 布林值 | false | 為卡片頁尾新增分隔線 (邊框) |
可展開 | 布林值 | false | 啟用可展開卡片 |
可展開動畫寬度 | 布林值 | false | 啟用卡片內容寬度也可以動畫化和回應式,但可能會影響效能 |
可展開開啟 | 布林值 | false | 布林值屬性,表示可展開卡片是否開啟 |
動畫 | 布林值 | true | 指定是否以動畫開啟可展開卡片 |
開啟時隱藏導覽列 | 布林值 | 可展開卡片開啟時將隱藏導覽列。預設繼承相同的 應用程式卡片參數。 | |
開啟時隱藏工具列 | 布林值 | 可展開卡片開啟時將隱藏工具列。預設繼承相同的 應用程式卡片參數。 | |
滑動關閉 | 布林值 | 允許以滑動關閉可展開卡片。預設繼承相同的 應用程式卡片參數。 | |
背景 | 布林值 | 啟用可展開卡片背景圖層。預設繼承相同的 應用程式卡片參數。 | |
背景元素 | 字串 | 允許指定自訂可展開卡片背景元素。這應該是背景元素的 CSS 選擇器,例如,.card-backdrop.custom-backdrop | |
背景點擊關閉 | 布林值 | 啟用後,可展開卡片會在背景點擊時關閉。預設繼承相同的 應用程式卡片參數。 | |
<CardContent> 屬性 | |||
內距 | 布林值 | true | 增加額外的內部內距 |
卡片事件
事件 | 說明 |
---|---|
<Card> 事件 | |
cardBeforeOpen | 可展開卡片開始其開啟動畫之前,會觸發事件。event.detail.prevent 包含一個函式,在呼叫時會阻止卡片開啟 |
cardOpen | 可展開卡片開始其開啟動畫時,會觸發事件 |
cardOpened | 可展開卡片完成其開啟動畫後,會觸發事件 |
cardClose | 可展開卡片開始其關閉動畫時,會觸發事件 |
cardClosed | 可展開卡片完成其關閉動畫後,會觸發事件 |
卡片插槽
<Card>
元件具有以下插槽
default
- 元素會插入為卡片內容元素的子元素content
- 與default
相同header
- 元素會插入為卡片標頭元素的子元素footer
- 元素會插入為卡片頁尾元素的子元素
<Card>
<span slot="header">Header</span>
<span slot="content">Content</span>
<span slot="footer">Footer</span>
</Card>
呈現為
<div class="card">
<div class="card-header">
<span>Header</span>
</div>
<div class="card-content">
<span>Content</span>
</div>
<div class="card-footer">
<span>Footer</span>
</div>
</div>
範例
cards.jsx
import React from 'react';
import {
Navbar,
Page,
Block,
BlockTitle,
Card,
CardHeader,
CardContent,
CardFooter,
List,
ListItem,
Link,
} from 'framework7-react';
export default () => (
<Page>
<Navbar title="Cards" />
<Block>
<p>
Cards are a great way to contain and organize your information, especially when combined
with List Views. Cards can contain unique related data, like for example photos, text or
links about a particular subject. Cards are typically an entry point to more complex and
detailed information.
</p>
</Block>
<BlockTitle>Simple Cards</BlockTitle>
<Card content="This is a simple card with plain text, but cards can also contain their own header, footer, list view, image, or any other element." />
<Card
title="Card header"
content="Card with header and footer. Card headers are used to display card titles and footers for additional information or just for custom actions."
footer="Card footer"
/>
<Card content="Another card. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse feugiat sem est, non tincidunt ligula volutpat sit amet. Mauris aliquet magna justo. " />
<BlockTitle>Outline Cards</BlockTitle>
<Card
outline
content="This is a simple card with plain text, but cards can also contain their own header, footer, list view, image, or any other element."
/>
<Card
outline
title="Card header"
content="Card with header and footer. Card headers are used to display card titles and footers for additional information or just for custom actions."
footer="Card footer"
/>
<Card
outline
content="Another card. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse feugiat sem est, non tincidunt ligula volutpat sit amet. Mauris aliquet magna justo. "
/>
<BlockTitle>Outline With Dividers</BlockTitle>
<Card
outline
headerDivider
footerDivider
title="Card header"
content="Card with header and footer. Card headers are used to display card titles and footers for additional information or just for custom actions."
footer="Card footer"
/>
<BlockTitle>Raised Cards</BlockTitle>
<Card
raised
content="This is a simple card with plain text, but cards can also contain their own header, footer, list view, image, or any other element."
/>
<Card
raised
title="Card header"
content="Card with header and footer. Card headers are used to display card titles and footers for additional information or just for custom actions."
footer="Card footer"
/>
<Card
raised
content="Another card. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse feugiat sem est, non tincidunt ligula volutpat sit amet. Mauris aliquet magna justo. "
/>
<BlockTitle>Styled Cards</BlockTitle>
<Card outlineMd className="demo-card-header-pic">
<CardHeader
valign="bottom"
style={{
backgroundImage: 'url(https://cdn.framework7.io/placeholder/nature-1000x600-3.jpg)',
}}
>
Journey To Mountains
</CardHeader>
<CardContent>
<p className="date">Posted on January 21, 2015</p>
<p>
Quisque eget vestibulum nulla. Quisque quis dui quis ex ultricies efficitur vitae non
felis. Phasellus quis nibh hendrerit...
</p>
</CardContent>
<CardFooter>
<Link>Like</Link>
<Link>Read more</Link>
</CardFooter>
</Card>
<Card className="demo-card-header-pic">
<CardHeader
valign="bottom"
style={{
backgroundImage: 'url(https://cdn.framework7.io/placeholder/people-1000x600-6.jpg)',
}}
>
Journey To Mountains
</CardHeader>
<CardContent>
<p className="date">Posted on January 21, 2015</p>
<p>
Quisque eget vestibulum nulla. Quisque quis dui quis ex ultricies efficitur vitae non
felis. Phasellus quis nibh hendrerit...
</p>
</CardContent>
<CardFooter>
<Link>Like</Link>
<Link>Read more</Link>
</CardFooter>
</Card>
<BlockTitle>Cards With List View</BlockTitle>
<Card>
<CardContent padding={false}>
<List>
<ListItem link="#">Link 1</ListItem>
<ListItem link="#">Link 2</ListItem>
<ListItem link="#">Link 3</ListItem>
<ListItem link="#">Link 4</ListItem>
<ListItem link="#">Link 5</ListItem>
</List>
</CardContent>
</Card>
<Card title="New Releases:">
<CardContent padding={false}>
<List mediaList>
<ListItem title="Yellow Submarine" subtitle="Beatles">
<img
slot="media"
src="https://cdn.framework7.io/placeholder/fashion-88x88-4.jpg"
width="44"
/>
</ListItem>
<ListItem title="Don't Stop Me Now" subtitle="Queen">
<img
slot="media"
src="https://cdn.framework7.io/placeholder/fashion-88x88-5.jpg"
width="44"
/>
</ListItem>
<ListItem title="Billie Jean" subtitle="Michael Jackson">
<img
slot="media"
src="https://cdn.framework7.io/placeholder/fashion-88x88-6.jpg"
width="44"
/>
</ListItem>
</List>
</CardContent>
<CardFooter>
<span>January 20, 2015</span>
<span>5 comments</span>
</CardFooter>
</Card>
</Page>
);
cards-expandable.jsx
import React from 'react';
import { Navbar, Page, Block, Card, CardHeader, CardContent, Link, Button } from 'framework7-react';
export default () => (
<Page>
<Navbar title="Cards Expandable" />
<Block>
<p>
In addition to usual <a href="/cards/">Cards</a> there are also Expandable Cards that allow
to store more information and illustrations about particular subject.
</p>
</Block>
<div className="demo-expandable-cards">
<Card expandable>
<CardContent padding={false}>
<div className="bg-color-red" style={{ height: '300px' }}>
<CardHeader textColor="white" className="display-block">
Framework7
<br />
<small style={{ opacity: 0.7 }}>Build Mobile Apps</small>
</CardHeader>
<Link
cardClose
color="white"
className="card-opened-fade-in"
style={{ position: 'absolute', right: '15px', top: '15px' }}
iconF7="xmark_circle_fill"
/>
</div>
<div className="card-content-padding">
<p>
Framework7 - is a free and open source HTML mobile framework to develop hybrid mobile
apps or web apps with iOS or Android (Material) native look and feel. It is also an
indispensable prototyping apps tool to show working app prototype as soon as possible
in case you need to. Framework7 is created by Vladimir Kharlampidi.
</p>
<p>
The main approach of the Framework7 is to give you an opportunity to create iOS and
Android (Material) apps with HTML, CSS and JavaScript easily and clear. Framework7 is
full of freedom. It doesn't limit your imagination or offer ways of any solutions
somehow. Framework7 gives you freedom!
</p>
<p>
Framework7 is not compatible with all platforms. It is focused only on iOS and Android
(Material) to bring the best experience and simplicity.
</p>
<p>
Framework7 is definitely for you if you decide to build iOS and Android hybrid app
(Cordova or Capacitor) or web app that looks like and feels as great native iOS or
Android (Material) apps.
</p>
<p>
<Button fill round large cardClose color="red">
Close
</Button>
</p>
</div>
</CardContent>
</Card>
<Card expandable>
<CardContent padding={false}>
<div className="bg-color-yellow" style={{ height: '300px' }}>
<CardHeader textColor="black" className="display-block">
Framework7
<br />
<small style={{ opacity: 0.7 }}>Build Mobile Apps</small>
</CardHeader>
<Link
cardClose
color="black"
className="card-opened-fade-in"
style={{ position: 'absolute', right: '15px', top: '15px' }}
iconF7="xmark_circle_fill"
/>
</div>
<div className="card-content-padding">
<p>
Framework7 - is a free and open source HTML mobile framework to develop hybrid mobile
apps or web apps with iOS or Android (Material) native look and feel. It is also an
indispensable prototyping apps tool to show working app prototype as soon as possible
in case you need to. Framework7 is created by Vladimir Kharlampidi.
</p>
<p>
The main approach of the Framework7 is to give you an opportunity to create iOS and
Android (Material) apps with HTML, CSS and JavaScript easily and clear. Framework7 is
full of freedom. It doesn't limit your imagination or offer ways of any solutions
somehow. Framework7 gives you freedom!
</p>
<p>
Framework7 is not compatible with all platforms. It is focused only on iOS and Android
(Material) to bring the best experience and simplicity.
</p>
<p>
Framework7 is definitely for you if you decide to build iOS and Android hybrid app
(Cordova or Capacitor) or web app that looks like and feels as great native iOS or
Android (Material) apps.
</p>
<p>
<Button fill round large cardClose color="yellow" textColor="black">
Close
</Button>
</p>
</div>
</CardContent>
</Card>
<Card expandable>
<CardContent padding={false}>
<div
style={{
background: 'url(./img/beach.jpg) no-repeat center bottom',
backgroundSize: 'cover',
height: '240px',
}}
/>
<Link
cardClose
color="white"
className="card-opened-fade-in"
style={{ position: 'absolute', right: '15px', top: '15px' }}
iconF7="xmark_circle_fill"
/>
<CardHeader style={{ height: '60px' }}>Beach, Goa</CardHeader>
<div className="card-content-padding">
<p>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam cursus rhoncus cursus.
Etiam lorem est, consectetur vitae tempor a, volutpat eget purus. Duis urna lectus,
vehicula at quam id, sodales dapibus turpis. Suspendisse potenti. Proin condimentum
luctus nulla, et rhoncus ante rutrum eu. Maecenas ut tincidunt diam. Vestibulum
lacinia dui ligula, sit amet pulvinar nisl blandit luctus. Vestibulum aliquam ligula
nulla, tincidunt rhoncus tellus interdum at. Phasellus mollis ipsum at mollis
tristique. Maecenas sit amet tempus justo. Duis dolor elit, mollis quis viverra quis,
vehicula eu ante. Integer a molestie risus. Vestibulum eu sollicitudin massa, sit amet
dictum sem. Aliquam nisi tellus, maximus eget placerat in, porta vel lorem. Aenean
tempus sodales nisl in cursus. Curabitur tincidunt turpis in nisl ornare euismod eget
at libero.
</p>
<p>
Suspendisse ligula eros, congue in nulla pellentesque, imperdiet blandit sapien. Morbi
nisi sem, efficitur a rutrum porttitor, feugiat vel enim. Fusce eget vehicula odio, et
luctus neque. Donec mattis a nulla laoreet commodo. Integer eget hendrerit augue, vel
porta libero. Morbi imperdiet, eros at ultricies rutrum, eros urna auctor enim, eget
laoreet massa diam vitae lorem. Proin eget urna ultrices, semper ligula aliquam,
dignissim eros. Donec vitae augue eu sapien tristique elementum a nec nulla. Aliquam
erat volutpat. Curabitur condimentum, metus blandit lobortis fringilla, enim mauris
venenatis neque, et venenatis lorem urna ut justo. Maecenas neque enim, congue ac
tempor quis, tincidunt ut mi. Donec venenatis ante non consequat molestie. Quisque ut
rhoncus ligula. Vestibulum sodales maximus justo sit amet ornare. Nullam pulvinar
eleifend nisi sit amet molestie.
</p>
<p>
<Button fill round large cardClose>
Close
</Button>
</p>
</div>
</CardContent>
</Card>
<Card expandable>
<CardContent padding={false}>
<div
style={{
background: 'url(./img/monkey.jpg) no-repeat center top',
backgroundSize: 'cover',
height: '400px',
}}
>
<CardHeader textColor="white">Monkeys</CardHeader>
<Link
cardClose
color="white"
className="card-opened-fade-in"
style={{ position: 'absolute', right: '15px', top: '15px' }}
iconF7="xmark_circle_fill"
/>
</div>
<div className="card-content-padding">
<p>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam cursus rhoncus cursus.
Etiam lorem est, consectetur vitae tempor a, volutpat eget purus. Duis urna lectus,
vehicula at quam id, sodales dapibus turpis. Suspendisse potenti. Proin condimentum
luctus nulla, et rhoncus ante rutrum eu. Maecenas ut tincidunt diam. Vestibulum
lacinia dui ligula, sit amet pulvinar nisl blandit luctus. Vestibulum aliquam ligula
nulla, tincidunt rhoncus tellus interdum at. Phasellus mollis ipsum at mollis
tristique. Maecenas sit amet tempus justo. Duis dolor elit, mollis quis viverra quis,
vehicula eu ante. Integer a molestie risus. Vestibulum eu sollicitudin massa, sit amet
dictum sem. Aliquam nisi tellus, maximus eget placerat in, porta vel lorem. Aenean
tempus sodales nisl in cursus. Curabitur tincidunt turpis in nisl ornare euismod eget
at libero.
</p>
<p>
Suspendisse ligula eros, congue in nulla pellentesque, imperdiet blandit sapien. Morbi
nisi sem, efficitur a rutrum porttitor, feugiat vel enim. Fusce eget vehicula odio, et
luctus neque. Donec mattis a nulla laoreet commodo. Integer eget hendrerit augue, vel
porta libero. Morbi imperdiet, eros at ultricies rutrum, eros urna auctor enim, eget
laoreet massa diam vitae lorem. Proin eget urna ultrices, semper ligula aliquam,
dignissim eros. Donec vitae augue eu sapien tristique elementum a nec nulla. Aliquam
erat volutpat. Curabitur condimentum, metus blandit lobortis fringilla, enim mauris
venenatis neque, et venenatis lorem urna ut justo. Maecenas neque enim, congue ac
tempor quis, tincidunt ut mi. Donec venenatis ante non consequat molestie. Quisque ut
rhoncus ligula. Vestibulum sodales maximus justo sit amet ornare. Nullam pulvinar
eleifend nisi sit amet molestie.
</p>
<p>
<Button fill round large cardClose>
Close
</Button>
</p>
</div>
</CardContent>
</Card>
</div>
</Page>
);