List Item React Component(リスト アイテム リアクト コンポーネント
リストアイテムコンポーネント
以下のコンポーネントが含まれています。
ListItem
- メインのリストアイテム要素ListItemRow
- カスタムレイアウト用のリストアイテムの行要素ListItemCell
- カスタムレイアウト用のリストアイテムのセル要素
リストアイテムのプロパティ
Prop | Type | Default | Description |
---|---|---|---|
<ListItem> properties | |||
title | string | リストアイテムのタイトル | |
subtitle | string | リストアイテムのサブタイトル(メディアリストの場合のみ) | |
text | string | リストアイテムのテキスト(メディアリストの場合のみ) | |
header | string | リストアイテムのヘッダーテキスト | |
footer | string | リストアイテムのフッターテキスト | |
media | string | リストアイテムのメディアイメージのURL | |
after | string | リストアイテムのラベル | |
badge | string number | リストアイテムのバッジ | |
badgeColor | string | リストアイテムのバッジの色。デフォルトの色のいずれかです。 | |
mediaItem | boolean | 現在のリストアイテムのメディアリストアイテムを有効にする | |
divider | boolean | リストアイテムをリストアイテムディバイダーに変換する | |
groupTitle | boolean | リストアイテムをリストグループのタイトルに変換する | |
target | boolean | リストアイテムのリンク先属性 | |
noChevron | boolean | false | リストアイテムリンクの "シェブロン "アイコンを削除する |
chevronCenter | boolean | false | メディアリストアイテムの "シェブロン "アイコンを中央(縦方向)に設定する |
tooltip | string | リストボタンのtooltipテキストを、ボタンのホバー/プレス時に表示する。 | |
tooltipTrigger | string | hover | どのようにしてツールチップを開くかを定義します。hover, click, manual` のいずれかです。 |
<ListItem> Menu List specific properties | |||
selected | boolean | メニューのリストアイテムが選択されているかどうか(現在アクティブかどうか) | |
<ListItem> Swipeout specific properties | |||
swipeout | boolean | リストアイテムを スワイプアウトリストアイテム に変換します。 | |
swipeoutOpened | boolean | スワイプアクションを開くべきかどうかを定義します。なお、同時に開くことができるスワイプアウトアイテムは1つだけです。 | |
<ListItem> Accordion specific properties | |||
accordionItem | boolean | false | リストアイテムをアコーディオンリストアイテムに変換します。 |
accordionItemOpened | boolean | false | アコーディオンアイテムを開かせる |
<ListItem> Sortable List specific properties | |||
sortable | boolean | 特定のリストアイテムのソートを無効にすることができます(false の場合)。この機能は、リストの最初か最後のアイテムに対してのみ動作し、途中のアイテムのソートを無効にすると正しく動作しないことに注意してください。 | |
<ListItem> Virtual List specific properties | |||
virtualListIndex | number | 仮想リストで使用する場合、リストアイテムのインデックスを(コレクション全体から)渡すことができます。変更された正しいインデックスを知るために、Sortableと一緒に使用すると便利です。 | |
<ListItem> Smart Select specific properties | |||
smartSelect | boolean | false | スマートセレクトの動作を有効にする |
smartSelectParams | object | スマートセレクトのパラメータを持つオブジェクト。 | |
<ListItem> Checkboxes & Radios specific properties | |||
checkbox | boolean | false | チェックボックス・アイテムを有効にする |
radio | boolean | false | ラジオボタンを有効にする |
radioIcon | string | ラジオアイコンの位置を、リストアイテムの最初または最後に指定することができます。startまたは end`を指定します。デフォルトでは、iOSテーマではリストアイテムの最後に、MDとAuroraテーマではリストアイテムの最初にラジオアイコンが表示されます。 | |
checked | boolean | false | チェックボックス/ラジオ入力のチェックの有無 |
defaultChecked | boolean | チェックボックスが制御されていないコンポーネントである場合に、チェックボックス入力をチェックするかどうかを定義します。 | |
indeterminate | boolean | チェックボックスの入力が不確定な状態であるかどうかを定義します。 | |
name | string | チェックボックス/ラジオ入力の名前 | |
value | string number | チェックボックス/ラジオ入力の値 | |
readonly | boolean | false | チェックボックス/ラジオの入力が読み取り専用かどうか |
disabled | boolean | false | チェックボックス/ラジオ入力が無効であるかどうか |
required | boolean | false | チェックボックス/無線入力が必須であるかどうか |
<ListItem> navigation/router related properties | |||
link | boolean string | 文字列として指定された場合は、リンクとリンク先のURLを有効にします。href` propと同じです。 | |
tabLink | string boolean | タブリンクを有効にして、対象となるタブのCSSセレクタを指定する(文字列として指定された場合)。 | |
tabLinkActive | boolean | このタブリンクをアクティブにする | |
href | string boolean | # | ロードするページのURL。href="false" のブール値の場合は、href タグは追加されません。 |
target | string | リンク・ターゲット属性の値、例えば、_blank 、_self など。 | |
view | string | ページを読み込むためのViewのCSSセレクタ。または、現在のビューで読み込むためのcurrent 。 | |
external | boolean | Framework7のリンク・クリック・ハンドラのバイパスを有効にする | |
back | boolean | バックナビゲーションリンクを有効にする | |
openIn | string | モーダルまたはパネルとしてのオープン・ページ・ルートを可能にする。popup 、loginScreen 、sheet 、popover またはpanel とすることができる。 | |
force | boolean | 履歴の中の前のページを無視してページを強制的にロードする (back propと一緒に使用する) | |
reloadCurrent | boolean | 現在のアクティブなページの代わりに新しいページをリロードする | |
reloadPrevious | boolean | 履歴の前のページをルートからの新しいページで置き換える | |
reloadAll | boolean | 新しいページをロードし、履歴とDOMからすべての前のページを削除する | |
reloadDetail | boolean | マスター詳細ビューで詳細ページを再読み込みする | |
animate | boolean | ページのアニメーションを無効にする | |
transition | string | カスタムページトランジションの名前 | |
ignoreCache | boolean | キャッシングを無視する | |
routeTabId | string | Routable Tab id | |
routeProps | object | 対象となるルートコンポーネントに渡される追加のプロップを持つオブジェクト。 | |
preventRouter | boolean | false | 設定されている場合は、Framework7のルーターでは処理されません。 |
<ListItem> action related properties | |||
panelOpen | string boolean | クリック時に開くパネルのCSSセレクタ。または、DOM内に左または右のパネルしかない場合は、left またはright になります。 | |
panelClose | string boolean | クリックでパネルを閉じる | |
panelToggle | string boolean | クリックされたときにパネルを閉じるかどうかのCSSセレクタ。また、DOMに左または右のパネルしかない場合には、left またはright とすることができる。 | |
actionsOpen | string boolean | クリックされたときに開くアクション・シートの CSS セレクタ | |
actionsClose | string boolean | クリックされたときに閉じるアクション・シートのCSSセレクタを指定する。または、現在開いているアクションシートを閉じるためのブール値のプロパティ | |
popupOpen | string boolean | クリック時に開くポップアップのCSSセレクタ | |
popupClose | string boolean | クリックにより閉じるポップアップのCSSセレクタ。または、現在開かれているポップアップを閉じるためのboolean特性 | |
popoverOpen | string boolean | クリックで開くポップオーバーのCSSセレクタ | |
popoverClose | string boolean | クリックにより閉じるポップアップのCSSセレクタ。または、現在開かれているポップオーバーを閉じるためのboolean特性 | |
sheetOpen | string boolean | クリックで開くシートモーダルのCSSセレクタ | |
sheetClose | string boolean | クリックにより閉じるシート・モーダルのCSSセレクタ。または、現在開かれているシートモーダルを閉じるためのboolean特性 | |
loginScreenOpen | string boolean | クリックしたときに開くログイン画面のCSSセレクタ | |
loginScreenClose | string boolean | クリックされたときに閉じるログイン画面のCSSセレクタ あるいは、現在開かれているログイン画面を閉じるためのboolean特性 | |
sortableEnable | string boolean | クリックした際に有効となるソート可能なリストのCSSセレクタ | |
sortableDisable | string boolean | クリックした際に無効となるソート可能なリストのCSSセレクタ。あるいは、現在開かれているソート可能リストを閉じるためのboolean特性 | |
sortableToggle | string boolean | クリックした際に切り替えられるソート可能リストのCSSセレクタ。あるいは、現在開かれている/閉じられているソート可能なリストをトグルするためのboolean特性 | |
searchbarEnable | string boolean | クリックした際に有効となる拡張検索バーのCSSセレクタ。あるいは、最初に見つかった検索バーを有効にするためのboolean特性 | |
searchbarDisable | string boolean | クリックすると無効になる拡張可能な検索バーのCSSセレクタ。あるいは、最初に見つかった検索バーを無効にするためのboolean特性 | |
searchbarToggle | string boolean | クリックしたときに切り替えられる拡張検索バーのCSSセレクタ。あるいは、最初に見つかった検索バーをトグルするためのboolean特性 | |
searchbarClear | string boolean | クリックするとクリアされる拡張検索バーのCSSセレクタ。あるいは、最初に見つかった検索バーをクリアするためのboolean特性 | |
cardOpen | string boolean | クリックしたときに開く拡張カードのCSSセレクタ。あるいは、最初に見つかった拡張カードを開くためのブール値 | |
cardClose | string boolean | クリックした際に閉じる拡張カードのCSSセレクタ。または、現在開かれている拡張カードを閉じるためのboolean型プロパティ | |
cardPreventOpen | boolean | このプロパティを持つ要素をクリックしても、その親の拡張カードは開きません。 | |
menuClose | boolean | クリックするとメニューのドロップダウンを閉じる |
リストアイテムイベント
Event | Description |
---|---|
<ListItem> events | |
click | ユーザーがリストアイテムをクリックしたときに発生するイベントです。 |
change | リストアイテムの入力(ラジオやチェックボックス)に「変更」イベントが発生するとイベントが発生します。 |
swipeout | スワイプアウト要素を移動させるとイベントが発生します。ハンドラの第一引数には、現在の開いた状態の進捗率を表す progress オブジェクトが含まれます。 |
swipeoutOpen | スワイプアウト要素がオープニングアニメーションを開始すると、イベントが発生します。 |
swipeoutOpened | スワイプアウト要素のオープニングアニメーションが完了すると、イベントが発生します。 |
swipeoutClose | イベントはスワイプアウト要素が閉じるアニメーションを開始するときに発生します。 |
swipeoutClosed | イベントはスワイプアウト要素が閉じるアニメーションを完了した後にトリガされます。 |
swipeoutDelete | スワイプアウト要素が削除アニメーションを開始すると、イベントが発生します。 |
swipeoutDeleted | イベントは、swipeout 要素が削除アニメーションを完了した後、DOM から削除される直前に発生します。 |
accordionBeforeOpen | イベントは、アコーディオンコンテンツが開くアニメーションを開始する直前に発生します。ハンドラの第1引数には、呼ばれたときにアコーディオンが開かないようにするためのprevent 関数が渡されます。 |
accordionOpen | イベントは、アコーディオンコンテンツが開くアニメーションを開始するときに発生します。 |
accordionOpened | イベントは、アコーディオンコンテンツがオープニングアニメーションを完了した後に発生します。 |
accordionBeforeClose | イベントは、アコーディオンコンテンツが閉じるアニメーションを開始する直前にトリガーされます。ハンドラの第1引数には、呼ばれたときにアコーディオンが閉じないようにするための prevent 関数が渡されます。 |
accordionClose | イベントは、アコーディオンコンテンツが閉じるアニメーションを開始するときにトリガーされます。 |
accordionClosed | イベントは、アコーディオンコンテンツが閉じるアニメーションを完了した後に発生します。 |
リストアイテムのスロット
リストアイテムのReactコンポーネント(<ListItem>
)には、カスタム要素用の追加スロットがあります。
root-start
-<li>
要素の先頭に要素が挿入されます。root
/root-end
- 要素は<li>
要素の最後に挿入されます。content-start
- 要素が<div class="item-content">
要素の先頭に挿入されます。content
/content-end
- 要素は<div class="item-content">
要素の最後に挿入されます。inner-start
- 要素は、` 要素の最初に挿入されます。default
/inner
/inner-end
-` エレメントの最後に挿入されます。media
- 要素は、` 要素の内部に挿入されます。before-title
-` 要素の前に表示されます。title
-` 要素の内側に挿入されます。after-title
-` 要素の後に挿入されます。subtitle
-` 要素の中に挿入されます。text
-` 要素の中に挿入されます。header
-` 要素の中に挿入されます。footer
-