校務通系列介面與函式共用

長期校務通相關系列的app，介面與相關功能都極為相似，將相關的介面與函式庫，製作此套件以方便維護。

展示網頁

套件使用要求

Flutter v1.20 以上

共用項目

資源
- 主題切換
- 圖示
  - Outline
  - Filled
- 圖片資源(97KB)
工具類
元件
頁面(pages)
頁面骨架(scaffold)
- 課表
- 成績
- 首頁
- 空堂教室查詢
- 登入頁
- 圖片瀏覽器
- PDF
- 使用者資訊
- 校園最新消息
- 學校電話

Getting Started

在 pubspec.yaml 中加入 package

    # 官方多國語套件
    flutter_localizations:
        sdk: flutter
    ap_common: ^0.12.1

執行加入套件

  $ flutter package get

主題色設定

支援列表

淺色主題
深色主題

在 MaterialApp 上一層加入主題色模式(ThemeMode)設定否則無法正常顯示
此功能只支援flutter v1.9 以上的SDK

    ThemeMode themeMode = ThemeMode.system;

    @override
      Widget build(BuildContext context) {
        return ApTheme(
            themeMode,
            child: MaterialApp(
              theme: ApTheme.light,
              darkTheme: ApTheme.dark,
              themeMode: themeMode,
            ),
        );
    }

多國語言支援列表

使用官方的 flutter_localization 實作，預設使用英文(en)

繁體中文(zh-TW)
英文(en)

在 MaterialApp 加入多國語言支援

    ThemeMode themeMode = ThemeMode.system;
    Locale locale;

    @override
      Widget build(BuildContext context) {
        return MaterialApp(
              // 在此設定使用的語言，否則會按照系統提供語言，若為不支援語言 預設為英文
              localeResolutionCallback:
                    (Locale locale, Iterable<Locale> supportedLocales) {
                  String languageCode = Preferences.getString(
                    ApConstants.PREF_LANGUAGE_CODE,
                    ApSupportLanguageConstants.SYSTEM,
                  );
                  if (languageCode == ApSupportLanguageConstants.SYSTEM)
                    return this.locale = ApLocalizations.delegate.isSupported(locale)
                        ? locale
                        : Locale('en');
                  else
                    return Locale(
                      languageCode,
                      languageCode == ApSupportLanguageConstants.ZH ? 'TW' : null,
                    );
                },
              localizationsDelegates: [
                  ApLocalizations.delegate,
              ],
              locale: locale,
              supportedLocales: [
                const Locale('en'), // English
                const Locale('zh', 'TW'), // Traditional Chinese
              ],
            );
    }

本地通知支援

使用 flutter_local_notification 實作

目前只支援 Android 、 iOS 、 macOS 系統，並有以下限制

Android 4.1+. 使用 NotificationCompat APIs 所以能跑在較舊的 Android 裝置
iOS 8.0+. iOS 10 以下使用 UILocalNotification APIs. iOS 10 以上(包含)使用 UserNotification APIs (aka the User Notifications Framework)
macOS 10.11+. 在 macOS 10.14 以下使用 NSUserNotification APIs 在 macOS 10.14 以下使用 UserNotification APIs (aka the User Notifications Framework)

Android

需在原生專案中的 app/scr/main/AndroidManifest.xml 中

加入 RECEIVE_BOOT_COMPLETED 及 VIBRATE 權限

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
<uses-permission android:name="android.permission.VIBRATE" />

確保App更新保持規劃通知保持運作，需加入

<receiver android:name="com.dexterous.flutterlocalnotifications.ScheduledNotificationBootReceiver">
    <intent-filter>
        <action android:name="android.intent.action.BOOT_COMPLETED"/>
        <action android:name="android.intent.action.MY_PACKAGE_REPLACED"/>
    </intent-filter>
</receiver>
<receiver android:name="com.dexterous.flutterlocalnotifications.ScheduledNotificationReceiver" />

更多 AndroidManifest.xml 設定可參考

並在 app/scr/main/res/drawable 加入 ic_stat_name.png，此圖是在通知顯示時在狀態列(status bar)顯示的圖案

iOS

在 Runner 中的 AppDelegate.m/AppDelegate.swift

加入下列程式碼在 didFinishLaunchingWithOptions 方法下

Objective-C:

if (@available(iOS 10.0, *)) {
  [UNUserNotificationCenter currentNotificationCenter].delegate = (id<UNUserNotificationCenterDelegate>) self;
}
if(![[NSUserDefaults standardUserDefaults]objectForKey:@"Notification"]){
    [[UIApplication sharedApplication] cancelAllLocalNotifications];
    [[NSUserDefaults standardUserDefaults]setBool:YES forKey:@"Notification"];
}

Swift:

if #available(iOS 10.0, *) {
  UNUserNotificationCenter.current().delegate = self as? UNUserNotificationCenterDelegate
}
if(!UserDefaults.standard.bool(forKey: "Notification")) {
    UIApplication.shared.cancelAllLocalNotifications()
    UserDefaults.standard.set(true, forKey: "Notification")
}

開啟 Xcode 在 Runner 中的 Signing & Capabilities 加入 Push Notification 的權限

課表加入行事曆App

Android

無須設定

iOS

在 ios/Runner/Info.plist dict 中加入

  <key>NSCalendarsUsageDescription</key>
	<string>Feature calendar would be add schedule to calendar app</string>

工具類

共用函式

showToast

顯示 Android 風格的 toast 提示字�，使用 Package toast 實作

參數名稱	型態	描述
context	BuildContext	Flutter Widget context
message	String	Header點擊事件
gravity	int	顯示位置，預設為 `Toast.Bottom`

pushCupertinoStyle

以 Cupertino 風格開啟頁面

參數名稱	型態	描述
context	BuildContext	Flutter Widget context
page	Widget	開啟頁面

handleDioError

處理 Dio 套件中的錯誤，並以 showToast 顯示相關提示字

參數名稱	型態	描述
context	BuildContext	Flutter Widget context
dioError	DioError	Dio 錯誤類別
gravity	int	toast 顯示位置

launchUrl

開啟 URL，以 url_launcher 實作

參數名稱	型態	描述
url	String	URL

callPhone

播打電話，會將#xxx(yyy)格式更改成tel:xxx,yyy，以 url_launcher 實作

參數名稱	型態	描述
url	String	URL

shareTo

呼叫原生分享功能，分享格式 ${分享內容}\n\nSend from ${App名稱} ${作業系統名稱}，以 share 實作

參數名稱	型態	描述
content	String	分享內容

launchFbFansPage

開啟 Facebook 粉絲專頁，會先以 app link 方式開啟，失敗才會以瀏覽器開啟，以 url_launcher 實作

參數名稱	型態	描述
context	BuildContext	Flutter Widget context
fansPageId	String	粉絲專頁 id

showAppReviewDialog

詢問是否評分，同意並呼叫 openAppReview 開啟原生評分功能

參數名稱	型態	描述
context	BuildContext	Flutter Widget context
defaultUrl	String	無原生API則開啟網址

openAppReview

開啟原生評分功能，若無原生API則開啟 defaultUrl，以 in_app_review 呼叫原生評分功能，以 url_launcher 開啟連結

參數名稱	型態	描述
defaultUrl	String	無原生API則開啟網址

Notification 工具

//TODO 文件

Dialog 工具

showDefault

開啟簡易的一般對話框

參數名稱	型態	描述
context	BuildContext	Flutter Widget context
title	String	標題
content	String	內容

showAnnouncementRule

開啟最新消息規則

參數名稱	型態	描述
context	BuildContext	Flutter Widget context
onRightButtonClick	Function	點擊 `聯絡粉專` 事件

showNewVersionContent

開啟新版本資訊，利用 versionInfo 中的 code 計算目前版本號，Android 為 Version Code，iOS 和 macOS 為 Builder Number，若超過版本號，則判斷 versionInfo 中的 isForceUpdate 是否強制更新開啟新版本資訊

參數名稱	型態	描述
context	BuildContext	Flutter Widget context
versionInfo	VersionInfo	版本資訊
appName	String	App 名稱
iOSAppId	String	iOS App Id
defaultUrl	String	若無法開啟商店平台(Play Store 或 Apple Store)，則開啟此網址

VersionInfo

參數名稱	型態	描述
code	int	版本號，Android 為 `Version Code`，iOS 和 macOS 為 `Builder Number`
isForceUpdate	VersionInfo	是否強制更新
content	String	更新內容

SharePreferences 工具

封裝 Flutter 官方維護的 shared_preferences

widgets

此項目必須加入主題色設定，否則會無法正常使用

抽屜 ApDrawer

提供校務通v3風格抽屜，Flutter 原生的 Drawer 封裝
另提供

DrawerItem
DrawerSubItem

參數名稱	型態	描述
userInfo	UserInfo	使用者資訊，會在Header顯示 `照片`、`名字`、`學號`
onTapHeader	Function	Header點擊事件
imageAsset	Function	Header 右邊的圖片，使用 Asset Image 載入
widgets	List	抽屜主體的Widget List，屬於Flutter原生API
imageHeroTag	String	Header中的圖片支援Flutter Hero，可自訂 Tag 對應畫面的tag，預設為 `tag_student_picture`
displayPicture	bool	是否顯示照片，`true`時顯示 `ApIcon` 中的 `person`

網路圖片 ApNetworkImage

由 Plugin CachedNetworkImage 封裝，此套件因為在未支援平台會錯誤，故此封裝

參數名稱	型態	描述
url	String	圖片來源網址

一般對話框 DefaultDialog

提供校務通v3風格對話框，使用 Flutter 官方的 AlertDialog 封裝

參數名稱	型態	描述
title	String	對話框標題
contentWidget	Widget	對話框內容的 Widget
actionText	String	按鍵的文字
actionFunction	Function	按鍵點擊事件

選項對話框中選項 DialogOption

對話框 SimpleOptionDialog 使用的選項，也可自訂Dialog 使用它

參數名稱	型態	描述
text	String	內容文字
check	bool	是否顯示打勾的圖示
onPressed	Function	點擊事件

頁面提示 HintContent

提供校務通v3風格的提示內容

參數名稱	型態	描述
icon	IconData	圖示
content	String	內容文字

選項選擇器 ItemPiccker

將 SimpleOptionDialog 功能整合至一個元件，點擊時會顯示 SimpleOptionDialog

參數名稱	型態	描述
items	List	選項列表，純文字顯示
dialogTitle	String	`SimpleOptionDialog` 的標題
currentIndex	int	目前的選項的索引值
onSelected	Function(int index)	`SimpleOptionDialog` 點擊事件，回傳索引值

選項對話框 SimpleOptionDialog

提供選項對話框，項目以 DialogOption 顯示，透過 index 顯示目前選取的項目

參數名稱	型態	描述
title	String	標題
items	List	選項列表，純文字顯示
index	int	目前的選項的索引值
onSelected	Function(int index)	點擊事件，回傳索引值

進度對話框 ProgressDialog

參數名稱	型態	描述
content	String	內容文字

設定頁元件 SettingPageWidget

提供校務通設定頁通常會使用到的元件

SettingTitle

設定頁小標題

參數名稱	型態	描述
text	String	內容文字

SettingSwitch

設定頁的 Switch 元件，使用 Flutter 中的 SwitchListTile 封裝

設定頁小標題

參數名稱	型態	描述
text	String	內容文字
subText	String	內容文字說明
value	bool	是否開啟
onChanged	String	點擊事件

SettingItem

設定頁的項目元件，使用 Flutter 中的 ListTile 封裝

設定頁小標題

參數名稱	型態	描述
text	String	內容文字
subText	String	內容文字說明
onTap	String	點擊事件

CheckCourseNotifyItem

目前上課提醒的封裝元件，顯示目前上課提醒的項目，使用 SettingItem 封裝

設定頁小標題

參數名稱	型態	描述

是或否對話框 YesNoDialog

提供校務通v3風格對話框，使用 Flutter 官方的 AlertDialog 封裝

參數名稱	型態	描述
title	String	對話框標題
contentWidget	Widget	對話框內容的 Widget
contentWidgetPadding	Widget	對話框內容的 Widget 的內縮間距
leftActionText	String	左邊按鍵的文字
rightActionText	String	右邊按鍵的文字
leftActionFunction	Function	左邊按鍵點擊事件
rightActionFunction	Function	右邊按鍵點擊事件

Pages

此項目必須加入多國語言設定，否則會無法正常使用

關於我們 AboutUsPage

提供校務通系列的歷任作者及社群介紹，可在此頁面放置自己專案的License，期望您使用這份套件時可以加入此頁面，以及PR這個頁面加入您的資訊，我會同步到所有校務通專案中

參數名稱	型態	描述
assetImage	String	頂端 Header 的圖片，採Asset Image 載入
fbFanPageUrl	String	Facebook 粉絲專頁網址
fbFanPageId	String	Facebook 粉絲專頁id，點擊facebook logo時優先以 app link 的方法開啟
githubUrl	String	GitHub 網址
githubName	String	GitHub 的 username 或 Oraganization GitHub logo時優先以 app link 的方法開啟
email	String	聯絡 email
appLicense	String	App的License
actions	List	右上角的元件列表，為Flutter Scaffold原生的API
logEvent	Function(String name, String value)	可搜集使用者行為的事件
setCurrentScreen	Function	可搜集目前畫面的事件

開放原始碼 OpenSourcePage

列出校務通系統有使用到的開放原始碼的License

Scaffold

首頁骨架 ScoreScaffold

提供校務通首頁(Home Page)骨架

支援響應式介面
- shortestSide >= 680 會開啟平板模式
- 平板模式開啟時 BottomNavigationBar 會隱藏
- 平板模式開啟時 Scaffold 中的 最新消息 與 BottomNavigationBar 會被 content 設定的 Widget 取代，目的是可實作不跳頁顯示內容，詳細可參考 example
正中間由 announcements 顯示輪播資訊
可註冊 HomePageScaffoldState 存取 Snacker Bar 的行為，詳細可參考 example

手機介面

平板 or 桌面版介面

參數名稱	型態	描述
state	CourseState	必要欄位，總共有 `loading` `finish` `error` `empty` `offlineEmpty` `custom` 的狀態，只有`finish`才會顯示課表介面，其餘都是顯示錯誤狀況
title	String	Scaffold 標題
announcements	List	最新消息列表
isLogin	bool	控制下方的Snacker Bar是否顯示要登入
actions	List	在右上角可顯示元件列表，為Flutter Scaffold原生的API
onTabTapped	Function(int index)	底下`BottomNavigationBar`點擊時的事件，回傳點擊的索引值
bottomNavigationBarItems	List	底下`BottomNavigationBar`的元素，為Flutter Scaffold原生的API
drawer	Widget	左方的抽屜(Drawer)元件，為Flutter Scaffold原生的API
content	Widget	使用平板介面時，右方會顯示Content的內容，`null`時則顯示首頁
actions	List	右上角的元件列表，為Flutter Scaffold原生的API
floatingActionButton	Widget	Material Design 的 FloatingActionButton 位置放的元件，為Flutter Scaffold原生的API
onImageTapped	Function(Announcement announcement)	點擊最新消息的圖片事件，回傳`Announcement`
autoPlay	Function	是否自動輪播最新消息，預設值為 `true`
autoPlayDuration	bool	最新消息自動輪播的時間間距，預設值為 `5秒`

AnnouncementData

參數名稱	型態	描述
data	List	最新消息列表

Announcement

參數名稱	型態	描述
title	String	標題
id	Date	最新消息id
nextId	Location	下一個最新消息id
lastId	int	最後一個最新消息的id
weight	int	權重 `HomeScaffold` 會從權重大的排序顯示
imgUrl	int	圖片網址
url	int	連結
description	int	描述會在 `AnnouncementContentPage` 顯示
publishTime	int	發布時間，格式 `YYYY-MM-DDTHH:mm::ss`
expireTime	int	過期時間 `HomeScaffold` 會讓超過此時間的最新消息不顯示，格式 `YYYY-MM-DDTHH:mm::ss`

課表骨架 CourseScaffold

提供顯示課表(Course Table)骨架，另將課表CourseContent與課程列表CourseList另拆成兩個Ｗidget

支援響應式介面
- longestSide >= 880 顯示平板模式
支援上課通知 (Android & iOS & MacOS)
將課表加入至行事曆App (Android & iOS)
提供學期列表的區域，預設只提供學期資料SemesterData，即可使用相關的 Callback
CourseContent中的顏色由CourseData中的updateIndex() 找出該課堂在 CourseList 的索引值決定，順序為Material Design的500系列顏色

手機介面

平板 or 桌面版介面

參數名稱	型態	描述
state	CourseState	必要欄位，總共有 `loading` `finish` `error` `empty` `offlineEmpty` `custom` 的狀態，只有`finish`才會顯示課表介面，其餘都是顯示錯誤狀況
customStateHint	String	當 [state] 是 `custom` 時，會顯示此字串
title	String	Scaffold 標題
courseData	SourseData	課表資料，會利用其中的課表`CourseContent`與課程列表`CourseList`顯示
itemPicker	Widget	使用自訂元件實作學期選擇器，[itemPicker] 與 [semesterData] 擇一使用
semesterData	List	學期列表
onSelect	Function(int index)	學期列表點擊事件，回傳[semesterData]的索引值，[semesterData] 不為 Null 時才有效
isShowSearchButton	String	是否顯示搜尋按鍵，預設值為 `true`
onSearchButtonClick	Function	搜尋按鍵點擊事件
onRefresh	Function	下拉更新事件
actions	List	右上角的元件
customHint	String	學期選擇器與課表中間的提示字
enableNotifyControl	bool	是否顯示上課通知按鍵，預設值為 `true`
notifyData	Function	上課通知資料
autoNotifySave	bool	是否自動儲存上課更新資料，預設值為 `true`
onNotifyClick	Function	上課通知按鍵點擊事件
courseNotifySaveKey	String	若`autoNotifySave`有開啟，儲存的Preference key
enableAddToCalendar	bool	是否顯示課表加入行事曆按鍵，預設值為 `true`
androidResourceIcon	String	Android的原生資源圖示

CourseData

參數名稱	型態	描述
courses	List	課表詳細資訊列表，課程列表 `CourseList` 會使用到此部分
courseTables	CourseTable	課表內容 `CourseContent` 會使用到此部分

CourseDetail

此類別會影響課程列表中的介面

參數名稱	型態	描述
code	String	課程代碼
title	String	課程名稱
className	String	課程班級
group	String	課程分組
units	String	學分數
hours	String	上課時數(單位：小時)
required	String	課程類型，選修、必修等等，右上角藍字
times	String	上課節次
location	Location	上課位置
instructors	List	授課老師

Coursetables

參數名稱	型態	描述
monday	List	星期一的課程
tuesday	List	星期二的課程
wednesday	List	星期三的課程
thursday	List	星期四的課程
friday	List	星期五的課程
saturday	List	星期六的課程
sunday	List	星期日的課程
timeCodes	List	所有節次

Course

參數名稱	型態	描述
title	String	課程名稱
date	Date	上課時間
location	Location	上課位置
detailIndex	int	對應`CourseDetail`的索引值
instructors	List	授課老師

Date

參數名稱	型態	描述
startTime	String	開始時間，格式 `HH:mm`
endTime	String	結束時間，格式 `HH:mm`
section	String	節次，對應 `CourseTable` 中的 `timeCodes`

成績骨架 ScoreScaffold

提供顯示成績(Score)骨架，顯示 ScoreData 中的成績列表List<Score>資訊

支援響應式介面
- longestSide >= 880 顯示平板模式
- 平板模式時，列表於詳細資訊會水平顯示
提供學期列表的區域，預設只提供學期資料SemesterData，即可使用相關的 Callback

手機介面

平板 or 桌面版介面

參數名稱	型態	描述
state	ScoreState	必要欄位，總共有 `loading` `finish` `error` `empty` `offlineEmpty` `custom` 的狀態，只有`finish`才會顯示課表介面，其餘都是顯示錯誤狀況
customStateHint	String	當 [state] 是 `custom` 時，會顯示此字串
title	String	Scaffold 標題
scoreData	ScoreData	成績資料，會利用其中的 `List<Score>` 顯示成績
itemPicker	Widget	使用自訂元件實作學期選擇器，[itemPicker] 與 [semesterData] 擇一使用
semesterData	SemesterData	學期列表
onSelect	Function(int index)	學期列表點擊事件，回傳[semesterData]的索引值，[semesterData] 不為 Null 時才有效
isShowSearchButton	String	是否顯示搜尋按鍵，預設值為 `true`
onSearchButtonClick	Function	搜尋按鍵點擊事件
onRefresh	Function	下拉更新事件
actions	List	右上角的元件
customHint	String	學期選擇器與課表中間的提示字
middleTitle	String	成績列表第一列的標題，預設為 `ApLocalizations` 的 `midtermScore`
finalTitle	String	成績列表第二列的標題，預設為 `ApLocalizations` 的 `finalScore`
middleScoreBuilder	Widget Function(int index)	成績列表第一列Builder，`Null`時預設顯示為 `Score` 參數中的 `midtermScore`
finalScoreBuilder	Widget Function(int index)	成績列表第二列Builder，`Null`時預設顯示為 `Score` 參數中的 `finalScore`
details	List	第二區塊，列表顯示其中的資訊

登入骨架 LoginScaffold

提供校務通v3版本登入頁面骨架

支援響應式介面
- 利用手機水平與垂直顯示區隔，水平模式視為平板模式
- 平板模式時，Logo 與 forms 會水平顯示
forms 會包裝在 Flutter v1.20 支援的 AutofillGroup 使區塊內的TextFeild 支援自動填入(Autofill)
提供校務通風格的元件
- ApButton : RaisedButton封裝
- ApFlatButton : FlatButton封裝
- ApTextFeild : TextFeild封裝
- ApCheckBox : CheckBox封裝

手機介面

平板 or 桌面版介面 or 手機水平模式

參數名稱	型態	描述
logoSource	String	必要欄位，Logo的來源，由 `loginMode` 決定Logo顯示方式
form	List	必要欄位，骨架正中間的表單資訊，採自由實作
logoMode	LogoMode	LogoMode，logoMode 為 `text`時顯示 `logoSource` 的資訊，logoMode 為 `image` 時載入 `logoSource` 路徑的 asset image
enableKeyboardDoneButton	bool	是否顯示鍵盤完成按鍵，會顯示在虛擬鍵盤正上方

圖片瀏覽器骨架 ImageViewerScaffold

以 Package photo_view 封裝的圖片瀏覽器，可設定複數的圖片，透過TabBarView瀏覽，若 imageViewers 的數量為1時則不顯示Tab

參數名稱	型態	描述
title	String	Scaffold 標題
imageViewers	List	圖片瀏覽器物件，載入assetName的圖片
actions	List	右上角的元件列表，為Flutter Scaffold原生的API

PDF骨架 PdfScaffold

以 Plugin native_pdf_view 封裝的PDF瀏覽器，只支援Android iOS Web macOS 平台

手機介面，不包含 AppBar 及 BottomNavigationBar 的區塊

參數名稱	型態	描述
byteList	Uint8List	PDF 的 Raw Data

使用者資訊骨架 UserInfoScaffold

提供使用者資訊骨架

可點擊右上角的icon，切換顯示Qr Code 或 Bar Code
Qr Code 或 Bar Code 顯示時內容是學號
部分欄位為 Null 時則不顯示

手機介面

參數名稱	型態	描述
userInfo	UserInfo	使用者資訊物件
heroTag	String	照片的 Hero Tag，預設為 `tag_student_picture`
actions	List	右上角的元件列表，為Flutter Scaffold原生的API
onRefresh	Future Function()	下拉更新事件，需回傳更新後的使用者資訊
enableBarCode	bool	是否顯示Bar Code

UserInfo

參數名稱	型態	描述
educationSystem	String	學制
department	String	科系
className	String	班級名稱
id	String	學號
name	String	名字
pictureUrl	String	照片網址，但 `UserInfoScaffold` 不使用此載入圖片
email	String	電子信箱
pictureBytes	Uint8List	照片Raw Data，`UserInfoScaffold` 使用此載入圖片

校園最新消息骨架 NotificationScaffold

提供校園最新消息列表的骨架

點擊時會開啟 Notification 中的 link 設定的連結
長按時會啟動原生的分享功能，使用 share 實作
此骨架沒有使用Scaffold包裝

手機介面，不包含 AppBar 及 BottomNavigationBar 的區塊

參數名稱	型態	描述
state	NotificationState	必要欄位，總共有 `loading` `finish` `error` `empty` `offlineEmpty` 的狀態，只有`finish`才會顯示，其餘都是顯示錯誤狀況
notificationList	List	校園最新消息列表
onRefresh	Function	下拉更新事件
onLoadingMore	Function	滾動最底事件
logEvent	Function(String name, String value)	可搜集使用者行為的事件
setCurrentScreen	Function	可搜集目前畫面的事件

Notifications

參數名稱	型態	描述
link	String	連結
info	Info	校園最新消息資訊

Info

參數名稱	型態	描述
id	String	id
title	String	標題
deparment	String	發布處室
date	String	日期格式 `YYYY-MM-DD`

學校電話骨架 PhoneScaffold

提供電話列表的骨架

點擊會撥打PhoneModel 中的 number
此骨架沒有使用Scaffold包裝
PhoneModel 中的 number 為 Null 時則作為標題區隔

手機介面，不包含 AppBar 及 BottomNavigationBar 的區塊

參數名稱	型態	描述
state	NotificationState	必要欄位，總共有 `loading` `finish` `error` 的狀態，只有`finish`才會顯示，其餘都是顯示錯誤狀況
notificationList	List	電話列表
logEvent	Function(String name, String value)	可搜集使用者行為的事件
setCurrentScreen	Function	可搜集目前畫面的事件

PhoneModel

參數名稱	型態	描述
name	String	名稱
number	String	電話號碼

Name		Name	Last commit message	Last commit date
Latest commit History 730 Commits
.github/workflows		.github/workflows
assets		assets
example		example
images		images
lib		lib
test		test
.gitignore		.gitignore
.metadata		.metadata
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
RELEASE_NOTE.md		RELEASE_NOTE.md
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml

參數名稱	型態	描述
announcement	Announcement	最新消息
logEvent	Function(String name, String value)	可搜集使用者行為的事件
setCurrentScreen	Function	可搜集目前畫面的事件

License

ryanxuan930/ap_common

Folders and files

Latest commit

History

Repository files navigation

校務通系列介面與函式共用

相關專案

套件使用要求

共用項目

Getting Started

主題色設定

多國語言支援列表

本地通知支援

Android

iOS

課表加入行事曆App

Android

iOS

工具類

共用函式

showToast

pushCupertinoStyle

handleDioError

launchUrl

callPhone

shareTo

launchFbFansPage

showAppReviewDialog

openAppReview

Notification 工具

Dialog 工具

showDefault

showAnnouncementRule

showNewVersionContent

VersionInfo

SharePreferences 工具

widgets

抽屜 ApDrawer

網路圖片 ApNetworkImage

一般對話框 DefaultDialog

選項對話框中選項 DialogOption

頁面提示 HintContent

選項選擇器 ItemPiccker

選項對話框 SimpleOptionDialog

進度對話框 ProgressDialog

設定頁元件 SettingPageWidget

SettingTitle

SettingSwitch

SettingItem

CheckCourseNotifyItem

是或否對話框 YesNoDialog

Pages

關於我們 AboutUsPage

開放原始碼 OpenSourcePage

最新消息詳細資訊 AnnouncementContentPage

Scaffold

首頁骨架 ScoreScaffold

AnnouncementData

Announcement

課表骨架 CourseScaffold

CourseData

CourseDetail

Coursetables

Course

Date

成績骨架 ScoreScaffold

登入骨架 LoginScaffold

圖片瀏覽器骨架 ImageViewerScaffold

PDF骨架 PdfScaffold

使用者資訊骨架 UserInfoScaffold

UserInfo

校園最新消息骨架 NotificationScaffold

Notifications

Info

學校電話骨架 PhoneScaffold

PhoneModel

About

Resources

License

Packages