リスト React コンポーネント
リストビューは、アプリでよく見られる汎用性の高い強力なユーザーインターフェースコンポーネントです。リストビューは、セクション/グループに分割できる複数の行のスクロール可能なリストでデータを表示します。
リストビューには多くの目的があります
- ユーザーが階層的に構造化されたデータをナビゲートできるようにするため
- アイテムのインデックス付きリストを表示するため
- 詳細情報とコントロールを視覚的に区別できるグループで表示するため
- 選択可能なオプションのリストを表示するため
リストReactコンポーネントは、Framework7のリストビューコンポーネントを表します。
リストコンポーネント
以下のコンポーネントが含まれています
List
- メインのリストビュー要素ListGroup
- リストグループ要素
リストのプロパティ
プロパティ | タイプ | デフォルト | 説明 |
---|---|---|---|
<List> プロパティ | |||
inset | boolean | リストをインセットにします。テーマ固有のレイアウトには、`insetIos` と `insetMd` プロパティが使用できます | |
xsmallInset | boolean | アプリの幅が480px以上のときにリストをインセットにします。テーマ固有のレイアウトには、`xsmallInsetIos` と `xsmallInsetMd` プロパティが使用できます | |
smallInset | boolean | アプリの幅が568px以上のときにリストをインセットにします。テーマ固有のレイアウトには、`smallInsetIos` と `smallInsetMd` プロパティが使用できます | |
mediumInset | boolean | アプリの幅が768px以上のときにリストをインセットにします。テーマ固有のレイアウトには、`mediumInsetIos` と `mediumInsetMd` プロパティが使用できます | |
largeInset | boolean | アプリの幅が1024px以上のときにリストをインセットにします。テーマ固有のレイアウトには、`largeInsetIos` と `largeInsetMd` プロパティが使用できます | |
xlargeInset | boolean | アプリの幅が1200px以上のときにリストをインセットにします。テーマ固有のレイアウトには、`xlargeInsetIos` と `xlargeInsetMd` プロパティが使用できます | |
strong | boolean | リストに強調表示を追加します。テーマ固有のレイアウトには、`strongIos` と `strongMd` プロパティが使用できます | |
outline | boolean | リストをアウトライン(境界線付き)にします。テーマ固有のレイアウトには、`outlineIos` と `outlineMd` プロパティが使用できます | |
dividers | boolean | リストアイテムの間に区切り線(境界線)を追加します。テーマ固有のレイアウトには、`dividersIos` と `dividersMd` プロパティが使用できます | |
mediaList | boolean | false | メディアリストを有効にします |
linksList | boolean | false | 簡略化されたリンクリストを有効にします |
simpleList | boolean | false | 簡略化されたシンプルリストを有効にします |
sortable | boolean | false | ソート可能なリストを有効にします |
sortableOpposite | boolean | false | 反対側(LTRでは左側)にソート可能なハンドラーをレンダリングします |
sortableTapHold | boolean | false | アイテムのタップアンドホールド(長押し)でリストアイテムをソートできるようにします。この場合、アプリはカスタムの `taphold` イベントに依存します。正しく動作させるには、アプリパラメータ `touch.tapHold: true` も有効にしていることを確認してください |
sortableEnabled | boolean | false | ソート可能なリストのソートを有効にします |
sortableMoveElements | boolean | 渡されると、同じグローバルアプリパラメータ `sortable.moveElements` が上書きされます。 | |
menuList | boolean | メニューリストを有効にします | |
accordion | boolean | false | アコーディオンリストを有効にします |
accordionOpposite | boolean | false | 反対側(LTRでは左側)にアコーディオンシェブロンアイコンをレンダリングします |
contactsList | boolean | false | スタイリングに必要な追加クラスを追加することにより、連絡先リストを有効にします |
form | boolean | false | `<div>` の代わりに `<form>` タグをリストブロックで有効にします |
formStoreData | boolean | false | 現在のフォームのフォームストレージを有効にします |
noChevron | boolean | false | ネストされたリストアイテムリンクの「シェブロン」アイコンを削除します |
chevronCenter | boolean | false | ネストされたメディアリストアイテムの中央(垂直方向)に「シェブロン」アイコンを設定します |
tab | boolean | false | ブロックをタブとして使用する必要がある場合に追加の「タブ」クラスを追加します |
tabActive | boolean | false | ブロックをタブとして使用し、アクティブなタブにする場合に追加の「tab-active」クラスを追加します |
virtualList | boolean | false | 仮想リストを有効にします |
virtualListParams | object | 仮想リストパラメータを持つオブジェクト | |
<ListGroup> プロパティ | |||
mediaList | boolean | false | このグループのメディアリストを有効にします |
sortable | boolean | false | このグループのソート可能なリストを有効にします |
sortableTapHold | boolean | false | アイテムのタップアンドホールド(長押し)でリストアイテムをソートできるようにします。この場合、アプリはカスタムの `taphold` イベントに依存します。正しく動作させるには、アプリパラメータ `touch.tapHold: true` も有効にしていることを確認してください |
simpleList | boolean | false | このグループの簡略化されたシンプルリストを有効にします |
リストのイベント
イベント | 説明 |
---|---|
<List> イベント | |
tabShow | リストブロックタブが表示/アクティブになったときにイベントがトリガーされます |
tabHide | リストブロックタブが非表示/非アクティブになったときにイベントがトリガーされます |
submit | リストがフォームとして使用されている場合(`form` プロパティが有効になっている場合)、リストフォームの送信時にイベントがトリガーされます |
<List> ソート可能な特定のイベント | |
sortableEnable | ソートモードが有効になったときにイベントがトリガーされます |
sortableDisable | ソートモードが無効になったときにイベントがトリガーされます |
sortableSort | ユーザーが現在ソートされている要素を新しい位置にリリースした後にイベントがトリガーされます。 `event.detail` には、ソートされたリストアイテムの開始/新しいインデックス番号を持つ `from` と `to` プロパティを持つオブジェクトが含まれます |
<List> 仮想リストの特定のイベント | |
virtualItemBeforeInsert | アイテムが仮想ドキュメントフラグメントに追加される前にイベントがトリガーされます |
virtualItemsBeforeInsert | 現在のDOMリストが削除された後、新しいドキュメントが挿入される前にイベントがトリガーされます |
virtualItemsAfterInsert | アイテムが挿入された新しいドキュメントフラグメントの後にイベントがトリガーされます |
virtualBeforeClear | 現在のDOMリストが削除され、新しいドキュメントフラグメントに置き換えられる前にイベントがトリガーされます |
リストのスロット
リストReactコンポーネント(`<List>`)には、カスタム要素用の追加スロットがあります
- `before-list` - 要素はリストビューの先頭、`<ul>` メインリストの直前に挿入されます
- `after-list` - 要素はリストビューの末尾、`<ul>` メインリストの直後に挿入されます
- `list` - 要素は `<ul>` メインリスト要素の内部に挿入されます
仮想リスト
仮想リストの使用法と例については、仮想リストReactコンポーネントのドキュメントを参照してください。
ソート可能なリスト
ソート可能なリストの使用法と例については、ソート可能なReactコンポーネントのドキュメントを参照してください。
アコーディオンリスト
アコーディオンリストの使用法と例については、アコーディオンReactコンポーネントのドキュメントを参照してください。
例
list.jsx
import React from 'react';
import {
Navbar,
Page,
BlockTitle,
BlockFooter,
Block,
List,
ListItem,
ListGroup,
Icon,
Toggle,
} from 'framework7-react';
export default () => (
<Page>
<Navbar title="List View" />
<Block>
<p>
Framework7 allows you to be flexible with list views (table views). You can make them as
navigation menus, you can use there icons, inputs, and any elements inside of the list, and
even make them nested:
</p>
</Block>
<BlockTitle>Simple List</BlockTitle>
<List dividersIos simpleList>
<ListItem title="Item 1" />
<ListItem title="Item 2" />
<ListItem title="Item 3" />
</List>
<BlockTitle>Strong List</BlockTitle>
<List dividersIos simpleList strong>
<ListItem title="Item 1" />
<ListItem title="Item 2" />
<ListItem title="Item 3" />
</List>
<BlockTitle>Strong Outline List</BlockTitle>
<List dividersIos simpleList strong outline>
<ListItem title="Item 1" />
<ListItem title="Item 2" />
<ListItem title="Item 3" />
</List>
<BlockTitle>Strong Inset List</BlockTitle>
<List dividersIos simpleList strong inset>
<ListItem title="Item 1" />
<ListItem title="Item 2" />
<ListItem title="Item 3" />
</List>
<BlockTitle>Strong Outline Inset List</BlockTitle>
<List dividersIos simpleList strong outline inset>
<ListItem title="Item 1" />
<ListItem title="Item 2" />
<ListItem title="Item 3" />
</List>
<BlockTitle>Simple Links List</BlockTitle>
<List dividersIos outlineIos strongIos>
<ListItem title="Link 1" link="#" />
<ListItem title="Link 2" link="#" />
<ListItem title="Link 3" link="#" />
</List>
<BlockTitle>Data list, with icons</BlockTitle>
<List dividersIos outlineIos strongIos>
<ListItem title="Ivan Petrov" after="CEO">
<Icon slot="media" icon="icon-f7" />
</ListItem>
<ListItem title="John Doe" badge="5">
<Icon slot="media" icon="icon-f7" />
</ListItem>
<ListItem title="Jenna Smith">
<Icon slot="media" icon="icon-f7" />
</ListItem>
</List>
<BlockTitle>Links</BlockTitle>
<List dividersIos outlineIos strongIos>
<ListItem link="#" title="Ivan Petrov" after="CEO">
<Icon slot="media" icon="icon-f7" />
</ListItem>
<ListItem link="#" title="John Doe" after="Cleaner">
<Icon slot="media" icon="icon-f7" />
</ListItem>
<ListItem link="#" title="Jenna Smith">
<Icon slot="media" icon="icon-f7" />
</ListItem>
</List>
<BlockTitle>Links, Header, Footer</BlockTitle>
<List dividersIos outlineIos strongIos>
<ListItem link="#" header="Name" title="John Doe" after="Edit">
<Icon slot="media" icon="icon-f7" />
</ListItem>
<ListItem link="#" header="Phone" title="+7 90 111-22-3344" after="Edit">
<Icon slot="media" icon="icon-f7" />
</ListItem>
<ListItem link="#" header="Email" title="john@doe" footer="Home" after="Edit">
<Icon slot="media" icon="icon-f7" />
</ListItem>
<ListItem link="#" header="Email" title="john@framework7" footer="Work" after="Edit">
<Icon slot="media" icon="icon-f7" />
</ListItem>
</List>
<BlockTitle>Links, no icons</BlockTitle>
<List dividersIos outlineIos strongIos>
<ListItem link="#" title="Ivan Petrov" />
<ListItem link="#" title="John Doe" />
<ListItem groupTitle title="Group Title Here" />
<ListItem link="#" title="Ivan Petrov" />
<ListItem link="#" title="Jenna Smith" />
</List>
<BlockTitle>Grouped with sticky titles</BlockTitle>
<List dividersIos outlineIos strongIos>
<ListGroup>
<ListItem title="A" groupTitle />
<ListItem title="Aaron " />
<ListItem title="Abbie" />
<ListItem title="Adam" />
</ListGroup>
<ListGroup>
<ListItem title="B" groupTitle />
<ListItem title="Bailey" />
<ListItem title="Barclay" />
<ListItem title="Bartolo" />
</ListGroup>
<ListGroup>
<ListItem title="C" groupTitle />
<ListItem title="Caiden" />
<ListItem title="Calvin" />
<ListItem title="Candy" />
</ListGroup>
</List>
<BlockTitle>Mixed and nested</BlockTitle>
<List dividersIos outlineIos strongIos>
<ListItem link="#" title="Ivan Petrov" after="CEO">
<Icon slot="media" icon="icon-f7" />
</ListItem>
<ListItem link="#" title="Two icons here">
<Icon slot="media" icon="icon-f7" />
<Icon slot="media" icon="icon-f7" />
</ListItem>
<ListItem title="No icons here" />
<li>
<ul>
<ListItem link="#" title="Ivan Petrov" after="CEO">
<Icon slot="media" icon="icon-f7" />
</ListItem>
<ListItem link="#" title="Two icons here">
<Icon slot="media" icon="icon-f7" />
<Icon slot="media" icon="icon-f7" />
</ListItem>
<ListItem title="No icons here" />
<ListItem link="#" title="Ultra long text goes here, no, it is really really long">
<Icon slot="media" icon="icon-f7" />
</ListItem>
<ListItem title="With toggle">
<Icon slot="media" icon="icon-f7" />
<Toggle slot="after" />
</ListItem>
</ul>
</li>
<ListItem link="#" title="Ultra long text goes here, no, it is really really long">
<Icon slot="media" icon="icon-f7" />
</ListItem>
<ListItem title="With toggle">
<Icon slot="media" icon="icon-f7" />
<Toggle slot="after" />
</ListItem>
</List>
<BlockTitle>Tablet inset</BlockTitle>
<List dividersIos outlineIos strongIos mediumInset>
<ListItem link="#" title="Ivan Petrov" after="CEO">
<Icon slot="media" icon="icon-f7" />
</ListItem>
<ListItem link="#" title="Two icons here">
<Icon slot="media" icon="icon-f7" />
<Icon slot="media" icon="icon-f7" />
</ListItem>
<ListItem link="#" title="Ultra long text goes here, no, it is really really long">
<Icon slot="media" icon="icon-f7" />
</ListItem>
<BlockFooter slot="after-list">
<p>This list block will look like "inset" only on tablets (iPad)</p>
</BlockFooter>
</List>
<BlockTitle>Media Lists</BlockTitle>
<Block>
<p>
Media Lists are almost the same as Data Lists, but with a more flexible layout for
visualization of more complex data, like products, services, user, etc.
</p>
</Block>
<BlockTitle>Songs</BlockTitle>
<List dividersIos mediaList outlineIos strongIos>
<ListItem
link="#"
title="Yellow Submarine"
after="$15"
subtitle="Beatles"
text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla sagittis tellus ut turpis condimentum, ut dignissim lacus tincidunt. Cras dolor metus, ultrices condimentum sodales sit amet, pharetra sodales eros. Phasellus vel felis tellus. Mauris rutrum ligula nec dapibus feugiat. In vel dui laoreet, commodo augue id, pulvinar lacus."
>
<img
slot="media"
style={{ borderRadius: '8px' }}
src="https://cdn.framework7.io/placeholder/people-160x160-1.jpg"
width="80"
/>
</ListItem>
<ListItem
link="#"
title="Don't Stop Me Now"
after="$22"
subtitle="Queen"
text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla sagittis tellus ut turpis condimentum, ut dignissim lacus tincidunt. Cras dolor metus, ultrices condimentum sodales sit amet, pharetra sodales eros. Phasellus vel felis tellus. Mauris rutrum ligula nec dapibus feugiat. In vel dui laoreet, commodo augue id, pulvinar lacus."
>
<img
slot="media"
style={{ borderRadius: '8px' }}
src="https://cdn.framework7.io/placeholder/people-160x160-2.jpg"
width="80"
/>
</ListItem>
<ListItem
link="#"
title="Billie Jean"
after="$16"
subtitle="Michael Jackson"
text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla sagittis tellus ut turpis condimentum, ut dignissim lacus tincidunt. Cras dolor metus, ultrices condimentum sodales sit amet, pharetra sodales eros. Phasellus vel felis tellus. Mauris rutrum ligula nec dapibus feugiat. In vel dui laoreet, commodo augue id, pulvinar lacus."
>
<img
slot="media"
style={{ borderRadius: '8px' }}
src="https://cdn.framework7.io/placeholder/people-160x160-3.jpg"
width="80"
/>
</ListItem>
</List>
<BlockTitle>Mail App</BlockTitle>
<List dividersIos mediaList outlineIos strongIos>
<ListItem
link="#"
title="Facebook"
after="17:14"
subtitle="New messages from John Doe"
text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla sagittis tellus ut turpis condimentum, ut dignissim lacus tincidunt. Cras dolor metus, ultrices condimentum sodales sit amet, pharetra sodales eros. Phasellus vel felis tellus. Mauris rutrum ligula nec dapibus feugiat. In vel dui laoreet, commodo augue id, pulvinar lacus."
/>
<ListItem
link="#"
title="John Doe (via Twitter)"
after="17:11"
subtitle="John Doe (@_johndoe) mentioned you on Twitter!"
text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla sagittis tellus ut turpis condimentum, ut dignissim lacus tincidunt. Cras dolor metus, ultrices condimentum sodales sit amet, pharetra sodales eros. Phasellus vel felis tellus. Mauris rutrum ligula nec dapibus feugiat. In vel dui laoreet, commodo augue id, pulvinar lacus."
/>
<ListItem
link="#"
title="Facebook"
after="16:48"
subtitle="New messages from John Doe"
text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla sagittis tellus ut turpis condimentum, ut dignissim lacus tincidunt. Cras dolor metus, ultrices condimentum sodales sit amet, pharetra sodales eros. Phasellus vel felis tellus. Mauris rutrum ligula nec dapibus feugiat. In vel dui laoreet, commodo augue id, pulvinar lacus."
/>
<ListItem
link="#"
title="John Doe (via Twitter)"
after="15:32"
subtitle="John Doe (@_johndoe) mentioned you on Twitter!"
text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla sagittis tellus ut turpis condimentum, ut dignissim lacus tincidunt. Cras dolor metus, ultrices condimentum sodales sit amet, pharetra sodales eros. Phasellus vel felis tellus. Mauris rutrum ligula nec dapibus feugiat. In vel dui laoreet, commodo augue id, pulvinar lacus."
/>
</List>
<BlockTitle>Something more simple</BlockTitle>
<List dividersIos mediaList outlineIos strongIos>
<ListItem title="Yellow Submarine" subtitle="Beatles">
<img
slot="media"
style={{ borderRadius: '8px' }}
src="https://cdn.framework7.io/placeholder/fashion-88x88-1.jpg"
width="44"
/>
</ListItem>
<ListItem link="#" title="Don't Stop Me Now" subtitle="Queen">
<img
slot="media"
style={{ borderRadius: '8px' }}
src="https://cdn.framework7.io/placeholder/fashion-88x88-2.jpg"
width="44"
/>
</ListItem>
<ListItem title="Billie Jean" subtitle="Michael Jackson">
<img
slot="media"
style={{ borderRadius: '8px' }}
src="https://cdn.framework7.io/placeholder/fashion-88x88-3.jpg"
width="44"
/>
</ListItem>
</List>
</Page>
);