リストReactコンポーネント

    リストビューは、アプリで頻繁に見られる汎用的で強力なユーザーインターフェイスコンポーネントです。リストビューは、セクション/グループに分割された複数の行のスクロール可能なリストでデータを表示します。

    リストビューには多くの目的があります。

    • 階層的に構造化されたデータをユーザーにナビゲートさせる。
    • アイテムのインデックス付きリストを表示する
    • 詳細情報やコントロールを視覚的にわかりやすいグループで表示する。
    • 選択可能なオプションのリストを表示する

    List Reactコンポーネントは、Framework7のリストビューコンポーネントを表しています。

    リストコンポーネント

    以下のコンポーネントが含まれています。

    • List - メインのリストビュー要素
    • ListGroup - リストグループ要素

    リストのプロパティ

    PropTypeDefaultDescription
    <List> properties
    insetbooleanfalseリストブロックをインセットにする
    xsmallInsetbooleanアプリの幅が480px以上の場合、ブロックを挿入します。
    smallInsetbooleanブロックを挿入します アプリの幅が >= 568px のときにブロックを挿入します
    mediumInsetbooleanアプリの幅が >= 768px のときにブロックを挿入する
    largeInsetbooleanアプリの幅が >= 1024px のときにブロックを挿入します。
    xlargeInsetbooleanアプリの幅が>>1200pxのときにブロックを挿入します。
    mediaListbooleanfalseメディアリストを有効にします。
    linksListbooleanfalseシンプルな リンクリスト を有効にします。
    simpleListbooleanfalse簡略化したSimple Listを有効にします。
    sortablebooleanfalseソータブルリストを有効にする
    sortableOppositebooleanfalseソート可能なハンドラを反対側(LTRでは左)に表示する
    sortableTapHoldbooleanfalseアイテムのタップ&ホールド(長押し)でリストアイテムをソート可能にする。この場合、アプリはカスタムの taphold イベントに依存します。正しく動作させるためには、touch.tapHold: true も有効にしてください app parameter
    sortableEnabledbooleanfalseソート可能なリストのソートを有効にします。
    sortableMoveElementsboolean渡された場合、同じグローバルアプリパラメータ sortable.moveElements を上書きします。
    menuListbooleanメニューリストを有効にします。
    accordionbooleanfalseアコーディオンリストを有効にします。
    accordionOppositebooleanfalseアコーディオンのシェブロン・アイコンを反対側(LTRでは左側)に表示する。
    contactsListbooleanfalse連絡先リストのスタイリングに必要な追加クラスを有効にする
    formbooleanfalseリストブロックに
    ではなく<form>タグを使えるようにする
    formStoreDatabooleanfalse現在のフォームで フォームストレージを使用可能にする
    inlineLabelsbooleanfalseフォームの入力項目でインラインスタイルのラベルを有効にする
    noChevronbooleanfalse入れ子になったリストアイテムのリンクの "シェブロン "アイコンを削除する
    chevronCenterbooleanfalse入れ子になったメディアのリストアイテムの "シェブロン "アイコンを中央(垂直)に設定する
    noHairlinesbooleanfalse外側のヘアラインを削除しました。
    noHairlinesMdbooleanfalseMDテーマの外側のヘアラインを削除しました。
    noHairlinesIosbooleanfalseiOSテーマの外側のhairlinesが削除されました。
    noHairlinesAurorabooleanfalseAuroraテーマの外側のhairlinesを削除しました。
    noHairlinesBetweenbooleanfalseアイテム間の内側のhairlinesを削除しました。
    noHairlinesBetweenMdbooleanfalseMDテーマの場合、アイテム間の内側のヘアラインが削除されます。
    noHairlinesBetweenIosbooleanfalseiOSテーマでは、アイテム間の内側の航空券が削除されます。
    noHairlinesBetweenAurorabooleanfalseAurora テーマのアイテム間の内側の hairlines を削除しました。
    tabbooleanfalseブロックがタブとして使用される場合に「tab」クラスを追加しました。
    tabActivebooleanfalseブロックがTabとして使用されている場合に、"tab-active "クラスを追加し、アクティブなTabにします。
    virtualListbooleanfalseバーチャルリストを有効にする
    virtualListParamsobject仮想リストのパラメータを持つオブジェクトを有効にする
    <ListGroup> properties
    mediaListbooleanfalseこのグループのメディアリストを有効にする
    sortablebooleanfalseこのグループでソート可能なリストを有効にする
    sortableTapHoldbooleanfalseアイテムのタップ&ホールド(長押し)でリストアイテムをソートできるようにします。この場合、アプリはカスタムの taphold イベントに依存します。正しく動作させるためには、touch.tapHold: true が有効になっていることを確認してください app parameter
    simpleListbooleanfalseこのグループの簡易版簡易リストを有効にします。

    リストイベント

    EventDescription
    <List> events
    tabShowリストブロックのタブが表示されたときにイベントが発生します。
    tabHideList Block-Tabがinvisible/inactiveになるとイベントが発生します。
    submitリストがフォームとして使用されている場合、リストフォームの送信時にイベントが発生します(有効な form プロパティーを使用した場合)
    <List> Sortable specific events
    sortableEnableソート可能なモードが有効になると、イベントが発生します。
    sortableDisableソート可能なモードが無効になると、イベントが発生します。
    sortableSortイベントは、ユーザーが現在のソート要素を新しい位置にリリースした後に発生します。event.detail には、ソートされたリストアイテムの開始/新しいインデックス番号を持つ fromto` プロパティのオブジェクトが含まれます。
    <List> Virtual List specific events
    virtualItemBeforeInsertイベントは、アイテムが仮想ドキュメントフラグメントに追加される前に発生します。
    virtualItemsBeforeInsert現在のDOMリストが削除され、新しいドキュメントが挿入される前に、イベントが発生します。
    virtualItemsAfterInsertイベントは、アイテムを含む新しいドキュメントフラグメントが挿入された後に発生します。
    virtualBeforeClearイベントは、現在のDOMリストが削除され、新しいドキュメントフラグメントで置き換えられる前にトリガされます。

    リストスロット

    List Reactコンポーネント(<List>)には、カスタム要素用の追加スロットがあります。

    • before-list - 要素はリストビューの最初に挿入され、<ul>メインリストの直前に挿入されます。
    • after-list - 要素はリストビューの最後に挿入され、<ul> メインリストの直後に挿入されます。
    • list - 要素は <ul> メインのリスト要素の内側に挿入されます。

    バーチャルリスト

    バーチャルリストの使い方や例については、Virtual List React Componentのドキュメントをご覧ください。

    ソータブルリスト

    ソート可能なリストの使用方法と例については、Sortable React Componentのドキュメントを参照してください。

    アコーディオンリスト

    アコーディオンリストの使用方法と例については、Accordion React Componentのドキュメントを参照してください。

    Examples

    import React from 'react';
    import {
      Page,
      Navbar,
      BlockTitle,
      List,
      ListItem,
      Icon,
      ListGroup,
      Toggle,
      BlockFooter,
      Block,
    } from 'framework7-react';
    import './list-view.css';
    
    export default () => (
      
        
      <Page>
        <Navbar title="List View"></Navbar>
        <BlockTitle>Simple List</BlockTitle>
        <List simpleList>
          <ListItem title="Item 1"></ListItem>
          <ListItem title="Item 2"></ListItem>
          <ListItem title="Item 3"></ListItem>
        </List>
        <BlockTitle>Simple Links List</BlockTitle>
        <List>
          <ListItem title="Link 1" link="#"></ListItem>
          <ListItem title="Link 2" link="#"></ListItem>
          <ListItem title="Link 3" link="#"></ListItem>
        </List>
        <BlockTitle>Data list, with icons</BlockTitle>
        <List>
          <ListItem title="Ivan Petrov" after="CEO">
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
          <ListItem title="John Doe" badge="5">
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
          <ListItem title="Jenna Smith">
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
        </List>
        <BlockTitle>Links</BlockTitle>
        <List>
          <ListItem link="#" title="Ivan Petrov" after="CEO">
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
          <ListItem link="#" title="John Doe" after="Cleaner">
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
          <ListItem link="#" title="Jenna Smith">
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
        </List>
        <BlockTitle>Links, Header, Footer</BlockTitle>
        <List>
          <ListItem link="#" header="Name" title="John Doe" after="Edit">
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
          <ListItem link="#" header="Phone" title="+7 90 111-22-3344" after="Edit">
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
          <ListItem link="#" header="Email" title="john@doe" footer="Home" after="Edit">
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
          <ListItem link="#" header="Email" title="john@framework7" footer="Work" after="Edit">
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
        </List>
        <BlockTitle>Links, no icons</BlockTitle>
        <List>
          <ListItem link="#" title="Ivan Petrov"></ListItem>
          <ListItem link="#" title="John Doe"></ListItem>
          <ListItem divider title="Divider Here"></ListItem>
          <ListItem link="#" title="Ivan Petrov"></ListItem>
          <ListItem link="#" title="Jenna Smith"></ListItem>
        </List>
        <BlockTitle>Grouped with sticky titles</BlockTitle>
        <List>
          <ListGroup>
            <ListItem title="A" groupTitle></ListItem>
            <ListItem title="Aaron "></ListItem>
            <ListItem title="Abbie"></ListItem>
            <ListItem title="Adam"></ListItem>
          </ListGroup>
          <ListGroup>
            <ListItem title="B" groupTitle></ListItem>
            <ListItem title="Bailey"></ListItem>
            <ListItem title="Barclay"></ListItem>
            <ListItem title="Bartolo"></ListItem>
          </ListGroup>
          <ListGroup>
            <ListItem title="C" groupTitle></ListItem>
            <ListItem title="Caiden"></ListItem>
            <ListItem title="Calvin"></ListItem>
            <ListItem title="Candy"></ListItem>
          </ListGroup>
        </List>
        <BlockTitle>Mixed and nested</BlockTitle>
        <List>
          <ListItem link="#" title="Ivan Petrov" after="CEO">
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
          <ListItem link="#" title="Two icons here">
            <Icon slot="media" icon="demo-list-icon"></Icon>
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
          <ListItem title="No icons here"></ListItem>
          <li>
            <ul>
              <ListItem link="#" title="Ivan Petrov" after="CEO">
                <Icon slot="media" icon="demo-list-icon"></Icon>
              </ListItem>
              <ListItem link="#" title="Two icons here">
                <Icon slot="media" icon="demo-list-icon"></Icon>
                <Icon slot="media" icon="demo-list-icon"></Icon>
              </ListItem>
              <ListItem title="No icons here"></ListItem>
              <ListItem link="#" title="Ultra long text goes here, no, it is really really long">
                <Icon slot="media" icon="demo-list-icon"></Icon>
              </ListItem>
              <ListItem title="With toggle">
                <Icon slot="media" icon="demo-list-icon"></Icon>
                <Toggle slot="after"></Toggle>
              </ListItem>
            </ul>
          </li>
          <ListItem link="#" title="Ultra long text goes here, no, it is really really long">
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
          <ListItem title="With toggle">
            <Icon slot="media" icon="demo-list-icon"></Icon>
            <Toggle slot="after"></Toggle>
          </ListItem>
        </List>
        <BlockTitle>Mixed, inset</BlockTitle>
        <List>
          <ListItem link="#" title="Ivan Petrov" after="CEO">
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
          <ListItem link="#" title="Two icons here">
            <Icon slot="media" icon="demo-list-icon"></Icon>
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
          <ListItem link="#" title="Ultra long text goes here, no, it is really really long">
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
          <ListItem title="With toggle">
            <Icon slot="media" icon="demo-list-icon"></Icon>
            <Toggle slot="after"></Toggle>
          </ListItem>
          <BlockFooter>
            <p>Here comes some useful information about list above</p>
          </BlockFooter>
        </List>
        <BlockTitle>Tablet inset</BlockTitle>
        <List mediumInset>
          <ListItem link="#" title="Ivan Petrov" after="CEO">
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
          <ListItem link="#" title="Two icons here">
            <Icon slot="media" icon="demo-list-icon"></Icon>
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
          <ListItem link="#" title="Ultra long text goes here, no, it is really really long">
            <Icon slot="media" icon="demo-list-icon"></Icon>
          </ListItem>
          <BlockFooter>
            <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, users, etc.
          </p>
        </Block>
        <BlockTitle>Songs</BlockTitle>
        <List mediaList>
          <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"
              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"
              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"
              src="https://cdn.framework7.io/placeholder/people-160x160-3.jpg"
              width="80"
            />
          </ListItem>
        </List>
        <BlockTitle>Mail App</BlockTitle>
        <List mediaList>
          <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>
          <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>
          <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>
          <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."
          ></ListItem>
        </List>
        <BlockTitle>Something more simple</BlockTitle>
        <List mediaList>
          <ListItem title="Yellow Submarine" subtitle="Beatles">
            <img
              slot="media"
              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"
              src="https://cdn.framework7.io/placeholder/fashion-88x88-2.jpg"
              width="44"
            />
          </ListItem>
          <ListItem title="Billie Jean" subtitle="Michael Jackson">
            <img
              slot="media"
              src="https://cdn.framework7.io/placeholder/fashion-88x88-3.jpg"
              width="44"
            />
          </ListItem>
        </List>
        <BlockTitle>Inset</BlockTitle>
        <List mediaList inset>
          <ListItem link="#" title="Yellow Submarine" subtitle="Beatles">
            <img
              slot="media"
              src="https://cdn.framework7.io/placeholder/fashion-88x88-4.jpg"
              width="44"
            />
          </ListItem>
          <ListItem link="#" 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 link="#" title="Billie Jean" subtitle="Michael Jackson">
            <img
              slot="media"
              src="https://cdn.framework7.io/placeholder/fashion-88x88-6.jpg"
              width="44"
            />
          </ListItem>
        </List>
      </Page>
        
      
    );
    /* list-view.css */
    .demo-list-icon,
    .icon-f7 {
      background: #ccc;
      display: block;
      position: relative;
    }
    .ios .demo-list-icon,
    .ios .icon-f7,
    .ios .icon-vi {
      width: 29px;
      height: 29px;
      border-radius: 6px;
      box-sizing: border-box;
    }
    .md .demo-list-icon,
    .md .icon-f7,
    .md .icon-vi {
      width: 24px;
      height: 24px;
      border-radius: 4px;
    }
    .aurora .demo-list-icon,
    .aurora .icon-f7,
    .aurora .icon-vi {
      width: 18px;
      height: 18px;
      border-radius: 4px;
    }