timelinesなるものを使ってみた!
棒線がつながっているあれ!
棒線と丸がつながっているあれ、タイムラインと呼ぶみたいです。
タイムライン」とは、「時系列にしたがって経過し変化する情報を表示したもの」という意味だとか?
こちらのタイムラインとは何か記事に詳しく書かれています。
今回使用するpackage
packageについてですが、どうやらまだ試作品ということですかね?
でもLike数は多い!
解説を日本語に翻訳
Flutterのためのパワフルで使いやすいタイムラインパッケージ! 🚀
警告: このパッケージは初期段階です。安定性を保証するためのテストはまだ十分ではありません。一部のAPIは変更される可能性があります。
ページ下のWidgetの解説
タイムライン
タイムラインコンポーネントにはScrollViewに似たTimelineとFlexに似たFixedTimelineの2つのウィジェットがあります。
また、コンストラクターもScrollViewやFlexと同様です。
主な違いは TimelineTheme を祖先として持っていることです。
tileBuilder コンストラクタは TimelineTileBuilder を使ってより強力な機能を提供します。
TimelineTileBuilderが必要ない場合は、ListView、Column、Rowなどの他のflutter widgetを使うことができる。
flutterウィジェットを使う場合でも、TimelineThemeを使うことができます。
結論
どう使えばいいのか?
数ヶ月前までわからなかったのですが、Listを使ってTimelineTileBuilderにデータを与えて、描画すれば外部のデータを渡すことができるようです。
今回は簡単なサンプルを作ってみました。
今回のファイル構成
lib
├── firebase_options.dart
├── main.dart
└── model
├── flow.dart
├── flow.freezed.dart
├── flow.g.dart
└── provider.dart
modelディレクトリに、Listを使ってTimelineTileBuilderに渡すロジックが書かれています。
ListViewBuilderと同じようなものだと思ってください。
やることは一緒で、Listを使えばClassのプロパティのnameやnumberといった値を渡せる。
他には、これが電車に関係したアプリだったら、Classにstationとか書けば、今ここの駅にいますよというのがわかるようになりますね。
今回は、Classを使ってモデルを作るのに、便利なFreezedを使用します。toJOSNやformJSONを自分で作らなくて良くなるので楽です。
後は、StreamProviderを使ってFireStoreの全ての値を渡して画面に表示するだけです。
TimelineTileBuilderが今回は、ListViewBuilderと同じ役割を果たします。
必要なpackageを追加する
name: timelineview_app
description: A new Flutter project.
# The following line prevents the package from being accidentally published to
# pub.dev using `flutter pub publish`. This is preferred for private packages.
publish_to: 'none' # Remove this line if you wish to publish to pub.dev
# The following defines the version and build number for your application.
# A version number is three numbers separated by dots, like 1.2.43
# followed by an optional build number separated by a +.
# Both the version and the builder number may be overridden in flutter
# build by specifying --build-name and --build-number, respectively.
# In Android, build-name is used as versionName while build-number used as versionCode.
# Read more about Android versioning at https://developer.android.com/studio/publish/versioning
# In iOS, build-name is used as CFBundleShortVersionString while build-number is used as CFBundleVersion.
# Read more about iOS versioning at
# https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
# In Windows, build-name is used as the major, minor, and patch parts
# of the product and file versions while build-number is used as the build suffix.
version: 1.0.0+1
environment:
sdk: '>=2.18.0 <3.0.0'
# Dependencies specify other packages that your package needs in order to work.
# To automatically upgrade your package dependencies to the latest versions
# consider running `flutter pub upgrade --major-versions`. Alternatively,
# dependencies can be manually updated by changing the version numbers below to
# the latest version available on pub.dev. To see which dependencies have newer
# versions available, run `flutter pub outdated`.
dependencies:
flutter:
sdk: flutter
# The following adds the Cupertino Icons font to your application.
# Use with the CupertinoIcons class for iOS style icons.
cupertino_icons: ^1.0.2
timelineview: ^1.0.2
timelines: ^0.1.0
flutter_riverpod: ^2.1.1
firebase_core: ^2.4.0
cloud_firestore: ^4.2.0
json_annotation: ^4.7.0
freezed_annotation: ^2.2.0
dev_dependencies:
flutter_test:
sdk: flutter
# The "flutter_lints" package below contains a set of recommended lints to
# encourage good coding practices. The lint set provided by the package is
# activated in the `analysis_options.yaml` file located at the root of your
# package. See that file for information about deactivating specific lint
# rules and activating additional ones.
flutter_lints: ^2.0.0
json_serializable: ^6.5.4
freezed: ^2.3.2
build_runner: ^2.3.3
# For information on the generic Dart part of this file, see the
# following page: https://dart.dev/tools/pub/pubspec
# The following section is specific to Flutter packages.
flutter:
# The following line ensures that the Material Icons font is
# included with your application, so that you can use the icons in
# the material Icons class.
uses-material-design: true
# To add assets to your application, add an assets section, like this:
# assets:
# - images/a_dot_burr.jpeg
# - images/a_dot_ham.jpeg
# An image asset can refer to one or more resolution-specific "variants", see
# https://flutter.dev/assets-and-images/#resolution-aware
# For details regarding adding assets from package dependencies, see
# https://flutter.dev/assets-and-images/#from-packages
# To add custom fonts to your application, add a fonts section here,
# in this "flutter" section. Each entry in this list should have a
# "family" key with the font family name, and a "fonts" key with a
# list giving the asset and other descriptors for the font. For
# example:
# fonts:
# - family: Schyler
# fonts:
# - asset: fonts/Schyler-Regular.ttf
# - asset: fonts/Schyler-Italic.ttf
# style: italic
# - family: Trajan Pro
# fonts:
# - asset: fonts/TrajanPro.ttf
# - asset: fonts/TrajanPro_Bold.ttf
# weight: 700
#
# For details regarding fonts from package dependencies,
# see https://flutter.dev/custom-fonts/#from-packages
Listで使うモデルクラス
import 'package:freezed_annotation/freezed_annotation.dart';
import 'package:flutter/foundation.dart';
part 'flow.freezed.dart';
part 'flow.g.dart';
class FlowChart with _$FlowChart {
const factory FlowChart({
required String name,
required int number,
}) = _FlowChart;
factory FlowChart.fromJson(Map<String, dynamic> json) =>
_$FlowChartFromJson(json);
}
コマンドを実行してファイルを自動生成する
flutter pub run build_runner build
Providerを定義する
FireStoreのデータを取得するProvider
StreamProviderで全てのデータを取得する。number1から順番に表示したいので、orderByを使う。
import 'dart:developer';
import 'package:cloud_firestore/cloud_firestore.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:timelineview_app/model/flow.dart';
/// リストでFlowChartクラスを型に使いプロパティを使えるようにする.
final usersStreamProvider = StreamProvider<List<FlowChart>>((ref) {
// FireStoreの全てのデータを取得.
// 昇順で表示できるようにorderByを使用。[1~3]の順にダミーデータを表示.
final collection = FirebaseFirestore.instance
.collection('users')
.orderBy('number', descending: false);
// データ(Map型)を取得.
final stream = collection.snapshots().map(
// CollectionのデータからUserクラスを生成する.
(e) => e.docs.map((e) => FlowChart.fromJson(e.data())).toList(),
);
return stream;
});
今回使用するダミーデータ
今回は画面に描画するのが目的なので、usersというコレクションを作成して、ドキュメントを3つ作成しnameフィールドと、numberフィールドを用意します。
Listで画面にFireStoreのデータを表示するときは、先ほど作成したFlowChartクラスのプロパティを使用します。
FireStoreのダミーデータのデータ型
name: string
number: int
スクリーンショット
画面にデータを描画する
main.dartに、timelinesのコードを書いて、画面に描画してみましょう。
Indicatorと呼ばれている表示板の物体?、線を点々にしたり、丸を四角にできます。
種類が色々あるので、好みのものに変えて、楽しんでください!
公式のコード
ContainerIndicator
四角の物体を作る.
ContainerIndicator(
child: Container(
width: 15.0,
height: 15.0,
color: Colors.blue,
),
)
DashedLineConnector
破線を作る。
SizedBox(
height: 20.0,
child: DashedLineConnector(),
)
今回は、標準的な丸と棒線にしました。
このコードを使って、ダミーのデータを描画してもらいます。
import 'package:firebase_core/firebase_core.dart';
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:timelines/timelines.dart';
import 'package:timelineview_app/firebase_options.dart';
import 'package:timelineview_app/model/provider.dart';
void main() async {
WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp(
options: DefaultFirebaseOptions.currentPlatform,
);
runApp(ProviderScope(child: const MyApp()));
}
class MyApp extends StatelessWidget {
const MyApp({Key? key}) : super(key: key);
Widget build(BuildContext context) {
return MaterialApp(
title: 'Flutter Demo',
theme: ThemeData(
primarySwatch: Colors.cyan,
),
home: const MyHomePage(),
);
}
}
class MyHomePage extends ConsumerWidget {
const MyHomePage({Key? key}) : super(key: key);
Widget build(BuildContext context, WidgetRef ref) {
// StreamProviderを読み取る(取得できる型は `AsyncValue<T>`)
final users = ref.watch(usersStreamProvider);
return Scaffold(
appBar: AppBar(
title: Text('timeline'),
),
// AsyncValue は `.when` を使ってハンドリングする
body: users.when(
// 処理中は `loading` で指定したWidgetが表示される
loading: () => const CircularProgressIndicator(),
// エラーが発生した場合に表示されるWidgetを指定
error: (error, stack) => Text('Error: $error'),
// 取得した `users` が `data` で使用できる
data: (user) {
return Column(
children: [
SizedBox(height: 50),
Expanded(
child: Timeline.tileBuilder(
// ListViewBuilderと同じように使用.
builder: TimelineTileBuilder.fromStyle(
contentsAlign: ContentsAlign.alternating,
contentsBuilder: (context, index) => Padding(
padding: const EdgeInsets.all(24.0),
child: Column(// 縦に番号と名前を並べる.
children: [
Text(user[index].number.toString()),// numberプロパティ.
Card(
child: Container(
padding: EdgeInsets.all(8.0),
child: Text(user[index].name))),// nameプロパティ.
],
),
),
itemCount: user.length,// Listで渡されたデータを数える.
),
),
),
],
);
}),
);
}
}
こんな感じで表示することができました
やってみた感想
以前は何故できなかったのだろうと考えてわかったのですが、単純にListとWidgetの知識がないからでした。
学べる環境が整っていればもっと速く覚えられたのではないかな〜と思っております。
Discussion