Fireship 에서 제공하는 함수들
These functions are provided to be used anywhere in the code as needed.
현재 클라우드 함수는 크게 아래와 같이 나뉘어져 있다.
- 글 summary 작성
- 사용자 like, 계정 삭제
- 푸시 메세지 전송
그리고, 개발자의 편리를 위해서 Firebase Extensons 로 만들어 놓았다. 설치는 이 링크: Functions for FireFlutter 0.0.2-alpha를 클릭하면 된다.
참고로, RTDB 의 데이터를 Firestore 로 미러링하는 것은 별도의 Exstensions 인데, Mirror Database to Firestore 을 쓰면 된다. 이 extensions 은 공용으로 꼭 FireFlutter 프로젝트 뿐만아니라, 언제 어디서든 필요할 때 사용 할 수 있는 Extensions 이다.
에러 표시 함수
주로 아래의 두가지 방식으로 에러를 화면에 표시 할 수 있다.
error함수는 showDialog 를 이용해서,ErrorDialog를 화면에 에러를 표시한다.errorToast는toast를 이용해서, 화면에 에러를 표시한다.
toast
Toast can be used to show a snackbar with a message.
Parameters:
- context
- required BuildContext
- the build context of the current widget
- title
- String
- title text of the snackbar
- message
- required String
- message to show as text
- icon
- Icon
- The icon to add in the snackbar
- duration
- Duration
- how long does the snackbar shows?
- default: const Duration(seconds: 8)
- onTap
- Function(Function)
- on tap function
- error
- bool
- is it an error message?
- hideCloseButton
- bool
- default: false
- backgroundColor
- Color
- foregroundColor
- Color
- runSpacing
- double
- default: 12
- spacing between the icon and the message
알림 다이얼로그 - AlertDialog
커스텀 디자인을 할 수 있다.
FireFlutterService.instance.init(
cloudFunctionRegion: 'asia-southeast1',
globalContext: () =>
router.routerDelegate.navigatorKey.currentContext!,
alertDialog: ({
required BuildContext context,
required String? title,
required String message,
}) {
return showDialog<void>(
context: globalContext,
builder: (context) => RohaAlertDialog(
title: title,
message: message,
),
);
},
);
import 'package:fireflutter/fireflutter.dart';
import 'package:flutter/material.dart';
import 'package:roha/font_awesome/lib/font_awesome_flutter.dart';
import 'package:roha/global.dart';
class RohaAlertDialog extends StatelessWidget {
const RohaAlertDialog({
super.key,
this.title,
required this.message,
});
final String? title;
final String message;
@override
Widget build(BuildContext context) {
return AlertDialog(
backgroundColor: Colors.transparent,
shadowColor: Colors.transparent,
surfaceTintColor: Colors.transparent,
content: Stack(
children: [
Container(
margin: const EdgeInsets.only(top: 20),
padding: const EdgeInsets.all(8),
width: double.infinity,
decoration: BoxDecoration(
color: context.colorScheme.background,
border: Border.all(
color: Colors.white,
width: 1.8,
),
borderRadius: BorderRadius.circular(24),
),
child: Container(
color: Colors.white,
child: Padding(
padding: const EdgeInsets.fromLTRB(24, 16, 24, 16),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisAlignment: MainAxisAlignment.center,
mainAxisSize: MainAxisSize.min,
children: [
if (title != null)
Text(
title!,
style: context.titleMedium,
),
spaceSm,
Text(
message,
style: context.labelMedium,
),
Row(
children: [
const Spacer(),
TextButton(
onPressed: () => Navigator.pop(
context,
),
child: Text(T.ok.tr),
),
],
),
],
),
),
),
),
Positioned(
left: 24,
child: Container(
height: 43,
width: 43,
decoration: BoxDecoration(
color: Colors.white,
border: Border.all(
color: context.colorScheme.background,
width: 1.8,
),
borderRadius: BorderRadius.circular(25),
),
child: Center(
child: FaIcon(
title == 'chatUsageGuide'.tr
? FontAwesomeIcons.solidMessageBot
: FontAwesomeIcons.solidCircleExclamation,
color: context.colorScheme.onBackground,
size: 22,
),
),
),
),
],
),
);
}
}
확인 다이얼로그 - Confirm Dialog
The confirm is a prompt that will let the user choose from yes or no.
final re = await confirm(
context: context,
title: 'Delete Account',
message: 'Are you sure you want to delete your account?'
);
The re in the example will be a nullable bool. If re is true means user chooses yes. If false means user chooses no. If null means neither user chooses yes nor no.
Parameters:
- [required] BuildContext context
- [required] String title
- title of the message
- [required] String message
- Add the question or confirmation message here.
아래와 같이 커스터마이징을 할 수 있다.
/// Dialog 커스텀 설정
FireFlutterService.instance.init(
confirmDialog: ({
required BuildContext context,
required String? title,
required String message,
}) async {
return await showDialog<bool?>(
context: context,
builder: (context) => SilverConfirmDialog(
title: title,
message: message,
),
);
},
);
/// Dialog UI 디자인
import 'package:flutter/material.dart';
import 'package:silvers/font_awesome/lib/font_awesome_flutter.dart';
import 'package:silvers/global.dart';
class SilverConfirmDialog extends StatelessWidget {
const SilverConfirmDialog({
super.key,
this.title,
required this.message,
});
final String? title;
final String message;
@override
Widget build(BuildContext context) {
return AlertDialog(
backgroundColor: Colors.transparent,
shadowColor: Colors.transparent,
surfaceTintColor: Colors.transparent,
content: Stack(
children: [
Container(
margin: const EdgeInsets.only(top: 20),
padding: const EdgeInsets.all(8),
width: double.infinity,
decoration: BoxDecoration(
color: context.onPrimary,
border: Border.all(
color: context.colorScheme.primary,
width: 1.8,
),
borderRadius: BorderRadius.circular(24),
),
child: Container(
color: context.colorScheme.primaryContainer.withAlpha(50),
child: Padding(
padding: const EdgeInsets.fromLTRB(24, 30, 24, 16),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisAlignment: MainAxisAlignment.center,
mainAxisSize: MainAxisSize.min,
children: [
if (title != null)
Text(
title!,
style: context.titleMedium,
),
const SizedBox(height: 8),
Text(
message,
style: context.labelSmall,
),
Row(
children: [
const Spacer(),
TextButton(
onPressed: () => Navigator.pop(context, false),
child: const Text('거절'),
),
TextButton(
onPressed: () => Navigator.pop(context, true),
child: const Text('확인'),
),
],
),
],
),
),
),
),
Positioned(
left: 20,
child: Container(
height: 42,
width: 42,
decoration: BoxDecoration(
color: context.colorScheme.primaryContainer,
border: Border.all(
color: context.colorScheme.primary,
width: 1.8,
),
borderRadius: BorderRadius.circular(16),
),
child: Center(
child: FaIcon(
FontAwesomeIcons.exclamation,
color: context.colorScheme.primary,
size: 20,
),
),
),
),
],
),
);
}
}
/// 호출하기
TextButton(
onPressed: () async {
final re = await confirm(
context: context,
title: '확인 또는 거절',
message: '확인 또는 거절을 설명....');
print("confirm dialog closed with: $re");
},
child: const Text('Confirm Dialog'),
);
에러 다이얼로그 표시
아래와 같이 표시 할 수 있다.
return TextButton(
onPressed: () async {
await error(
context: context, title: '에러 제목', message: '에러를 설명할 메시지...');
print("error dialog closed");
},
child: const Text('Error Dialog'),
);
아래와 같이 커스텀 디자인을 할 수 있다.
FireFlutterService.instance.init(
errorDialog: ({
required BuildContext context,
required String? title,
required String message,
}) async {
return await showDialog<bool?>(
context: globalContext,
builder: (context) => SilverErrorDialog(
title: title,
message: message,
),
);
},
);
import 'package:flutter/material.dart';
import 'package:silvers/font_awesome/lib/font_awesome_flutter.dart';
import 'package:silvers/global.dart';
class SilverErrorDialog extends StatelessWidget {
const SilverErrorDialog({
super.key,
this.title,
required this.message,
});
final String? title;
final String message;
@override
Widget build(BuildContext context) {
return AlertDialog(
backgroundColor: Colors.transparent,
shadowColor: Colors.transparent,
surfaceTintColor: Colors.transparent,
content: Stack(
children: [
Container(
margin: const EdgeInsets.only(top: 20),
padding: const EdgeInsets.all(8),
width: double.infinity,
decoration: BoxDecoration(
color: context.onPrimary,
border: Border.all(
color: context.colorScheme.error,
width: 1.8,
),
borderRadius: BorderRadius.circular(24),
),
child: Container(
color: context.colorScheme.errorContainer.withAlpha(50),
child: Padding(
padding: const EdgeInsets.fromLTRB(24, 30, 24, 16),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisAlignment: MainAxisAlignment.center,
mainAxisSize: MainAxisSize.min,
children: [
if (title != null)
Text(
title!,
style: context.titleMedium,
),
const SizedBox(height: 8),
Text(
message,
style: context.labelSmall,
),
Row(
children: [
const Spacer(),
TextButton(
onPressed: () => Navigator.pop(context, true),
child: const Text('확인'),
),
],
),
],
),
),
),
),
Positioned(
left: 20,
child: Container(
height: 42,
width: 42,
decoration: BoxDecoration(
color: context.colorScheme.errorContainer,
border: Border.all(
color: context.colorScheme.error,
width: 1.8,
),
borderRadius: BorderRadius.circular(16),
),
child: Center(
child: FaIcon(
FontAwesomeIcons.exclamation,
color: context.colorScheme.error,
size: 20,
),
),
),
),
],
),
);
}
}
입력 박스 - Input Dialog
The input function can be used to ask for an input from user.
final re = await input(
context: context,
title: 'Name',
subtitle: 'Enter your lovely name',
hintText: 'Last Name, First Name',
);
Parameters:
- [required] BuildContext context
- [required] String title
- The title of the prompt
- String subtitle
- The subtitle or additional info for input box
- [required] String hintText
- hintText for the input box
- String initialValue
- the default input value
InputDialog 도 ErrorDialog 처럼 커스텀 디자인을 할 수 있다.
FireFlutterService.instance.init(
cloudFunctionRegion: 'asia-southeast1',
globalContext: () =>
router.routerDelegate.navigatorKey.currentContext!,
inputDialog: ({
required BuildContext context,
required String title,
required String? subtitle,
required String hintText,
required String? initialValue,
required int? minLines,
required int? maxLines,
}) async {
return await showDialog<String?>(
context: globalContext,
builder: (context) => RohaInputDialog(
title: title,
subtitle: subtitle,
hintText: hintText,
minLines: minLines,
maxLines: maxLines,
initialValue: initialValue,
));
});
import 'package:fireflutter/fireflutter.dart';
import 'package:flutter/material.dart';
import 'package:roha/font_awesome/lib/font_awesome_flutter.dart';
import 'package:roha/global.dart';
class RohaInputDialog extends StatelessWidget {
const RohaInputDialog(
{super.key,
required this.title,
required this.subtitle,
required this.hintText,
required this.minLines,
required this.maxLines,
required this.initialValue});
final String title;
final String? subtitle;
final String hintText;
final int? minLines;
final int? maxLines;
final String? initialValue;
@override
Widget build(BuildContext context) {
final controller = TextEditingController(text: initialValue);
return AlertDialog(
backgroundColor: Colors.transparent,
shadowColor: Colors.transparent,
surfaceTintColor: Colors.transparent,
content: Stack(
children: [
Container(
margin: const EdgeInsets.only(top: 20),
padding: const EdgeInsets.all(8),
width: double.infinity,
decoration: BoxDecoration(
color: context.colorScheme.background,
border: Border.all(
color: Colors.white,
width: 1.8,
),
borderRadius: BorderRadius.circular(24),
),
child: Padding(
padding: const EdgeInsets.fromLTRB(24, 16, 24, 16),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: [
Text(
title,
style: Theme.of(context).textTheme.titleMedium,
),
spaceSm,
...[
Text(
subtitle!,
style: context.labelMedium,
),
spaceSm,
],
TextField(
controller: controller,
decoration: InputDecoration(
hintText: hintText,
),
minLines: minLines,
maxLines: maxLines,
),
spaceSm,
Row(
mainAxisAlignment: MainAxisAlignment.end,
children: [
TextButton(
onPressed: () {
if (controller.text.isNotEmpty) {
Navigator.pop(context, controller.text);
}
},
child: Text(T.ok.tr),
),
TextButton(
onPressed: () => Navigator.pop(context),
child: Text(T.cancel.tr),
),
],
)
],
),
),
),
Positioned(
left: 24,
child: Container(
height: 43,
width: 43,
decoration: BoxDecoration(
color: Colors.white,
border: Border.all(
color: context.colorScheme.background,
width: 1.8,
),
borderRadius: BorderRadius.circular(25),
),
child: Center(
child: FaIcon(
FontAwesomeIcons.solidCircleExclamation,
color: context.colorScheme.error,
size: 24,
),
),
),
),
],
),
);
}
}
로케일 - 언어
아래와 같이 언어 정보를 가져 올 수 있다. currentLocale 은 devicelocale 의 Devicelocale.currentLocale 을 짧게 표현한 것으로 현재 핸드폰의 언어를 가져온다. preferredLanguages 는 핸드폰에 설정된(추가된) 언어 목록을 가져온다.
참고로, Devicelocale.currentLocale 과 Devicelocale.preferredLanguages 는 en-PH 과 같이 로케일 전체 문자열을 리턴하지만 currentLocale 과 preferredLanguages 는 en 과 같이 두 글자 언어 코드만 리턴한다.
(() async {
final locale = await currentLocale;
print('locale: $locale');
final locales = await preferredLanguages;
print('locales: $locales');
})();
결과