TextTimer
通過文本顯示計(jì)時(shí)信息并控制其計(jì)時(shí)器狀態(tài)的組件。
說明:
開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
該組件從API Version 8開始支持。后續(xù)版本如有新增內(nèi)容,則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。
子組件
無
接口
TextTimer(options?: { isCountDown?: boolean, count?: number, controller?: TextTimerController })
參數(shù):
| 參數(shù)名 | 參數(shù)類型 | 必填 | 參數(shù)描述 |
|---|---|---|---|
| isCountDown | boolean | 否 | 是否倒計(jì)時(shí)。默認(rèn)值:false |
| count | number | 否 | 倒計(jì)時(shí)時(shí)間(isCountDown為true時(shí)生效),單位為毫秒。最長不超過86400000毫秒(24小時(shí))。 0默認(rèn)值:60000 |
| controller | [TextTimerController] | 否 | TextTimer控制器。 |
屬性
| 名稱 | 參數(shù)類型 | 描述 |
|---|---|---|
| format | string | 自定義格式,需至少包含一個(gè)HH、mm、ss、SS中的關(guān)鍵字。如使用yy、MM、dd等日期格式,則使用默認(rèn)值。默認(rèn)值:'HH:mm:ss.SS' |
事件
| 名稱 | 功能描述 |
|---|---|
| onTimer(event: (utc: number, elapsedTime: number) => void) | 時(shí)間文本發(fā)生變化時(shí)觸發(fā)。utc:Linux時(shí)間戳,即自1970年1月1日起經(jīng)過的時(shí)間,單位為設(shè)置格式的最小單位。elapsedTime:計(jì)時(shí)器經(jīng)過的時(shí)間,單位為設(shè)置格式的最小單位。**說明:**鎖屏狀態(tài)和應(yīng)用后臺(tái)狀態(tài)下不會(huì)觸發(fā)該事件。HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿 |

TextTimerController
TextTimer組件的控制器,用于控制文本計(jì)時(shí)器。一個(gè)TextTimer組件僅支持綁定一個(gè)控制器。
導(dǎo)入對(duì)象
textTimerController: TextTimerController = new TextTimerController()
start
start()
計(jì)時(shí)開始。
pause
pause()
計(jì)時(shí)暫停。
reset
reset()
重置計(jì)時(shí)器。
示例
// xxx.ets
@Entry
@Component
struct TextTimerExample {
textTimerController: TextTimerController = new TextTimerController()
@State format: string = 'mm:ss.SS'
build() {
Column() {
TextTimer({ isCountDown: true, count: 30000, controller: this.textTimerController })
.format(this.format)
.fontColor(Color.Black)
.fontSize(50)
.onTimer((utc: number, elapsedTime: number) = > {
console.info('textTimer notCountDown utc is:' + utc + ', elapsedTime: ' + elapsedTime)
})
Row() {
Button("start").onClick(() = > {
this.textTimerController.start()
})
Button("pause").onClick(() = > {
this.textTimerController.pause()
})
Button("reset").onClick(() = > {
this.textTimerController.reset()
})
}
}
}
}

審核編輯 黃宇
聲明:本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人,不代表電子發(fā)燒友網(wǎng)立場。文章及其配圖僅供工程師學(xué)習(xí)之用,如有內(nèi)容侵權(quán)或者其他違規(guī)問題,請聯(lián)系本站處理。
舉報(bào)投訴
-
組件
+關(guān)注
關(guān)注
1文章
573瀏覽量
19025 -
鴻蒙
+關(guān)注
關(guān)注
60文章
2963瀏覽量
45917
發(fā)布評(píng)論請先 登錄
相關(guān)推薦
熱點(diǎn)推薦
HarmonyOS/OpenHarmony應(yīng)用開發(fā)-ArkTS的聲明式開發(fā)范式
軌跡。狀態(tài)與數(shù)據(jù)管理狀態(tài)數(shù)據(jù)管理作為基于ArkTS的聲明式開發(fā)范式的特色,通過功能不同的裝飾器給開發(fā)者提供了清晰的頁面更新渲染流程和管道。狀態(tài)管理包括UI組件狀態(tài)和應(yīng)用程序狀態(tài),兩者協(xié)
發(fā)表于 01-17 15:09
HarmonyOS/OpenHarmony應(yīng)用開發(fā)-聲明式開發(fā)范式組件匯總
組件是構(gòu)建頁面的核心,每個(gè)組件通過對(duì)數(shù)據(jù)和方法的簡單封裝,實(shí)現(xiàn)獨(dú)立的可視、可交互功能單元。組件之間相互獨(dú)立,隨取隨用,也可以在需求相同的地方重復(fù)使用。聲明
發(fā)表于 01-19 11:14
鴻蒙ArkTS聲明式組件:Marquee
跑馬燈組件,用于滾動(dòng)展示一段單行文本。僅當(dāng)文本內(nèi)容寬度超過跑馬燈組件寬度時(shí)滾動(dòng),不超過時(shí)不滾動(dòng)。
鴻蒙ArkTS聲明式組件:PatternLock
圖案密碼鎖組件,以九宮格圖案的方式輸入密碼,用于密碼驗(yàn)證場景。手指在PatternLock組件區(qū)域按下時(shí)開始進(jìn)入輸入狀態(tài),手指離開屏幕時(shí)結(jié)束輸入狀態(tài)完成密碼輸入。
鴻蒙ArkTS聲明式組件:TextTimer
評(píng)論