TextTimer
通過(guò)文本顯示計(jì)時(shí)信息并控制其計(jì)時(shí)器狀態(tài)的組件。
說(shuō)明:
開(kāi)發(fā)前請(qǐng)熟悉鴻蒙開(kāi)發(fā)指導(dǎo)文檔 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
該組件從API Version 8開(kāi)始支持。后續(xù)版本如有新增內(nèi)容,則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。
子組件
無(wú)
接口
TextTimer(options?: { isCountDown?: boolean, count?: number, controller?: TextTimerController })
參數(shù)名 | 參數(shù)類型 | 必填 | 參數(shù)描述 |
---|---|---|---|
isCountDown | boolean | 否 | 是否倒計(jì)時(shí)。默認(rèn)值:false |
count | number | 否 | 倒計(jì)時(shí)時(shí)間(isCountDown為true時(shí)生效),單位為毫秒。最長(zhǎng)不超過(guò)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)過(guò)的時(shí)間,單位為設(shè)置格式的最小單位。elapsedTime:計(jì)時(shí)器經(jīng)過(guò)的時(shí)間,單位為設(shè)置格式的最小單位。**說(shuō)明:**鎖屏狀態(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í)開(kāi)始。
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()
})
}
}
}
}
審核編輯 黃宇
-
組件
+關(guān)注
關(guān)注
1文章
503瀏覽量
17786 -
鴻蒙
+關(guān)注
關(guān)注
57文章
2303瀏覽量
42691
發(fā)布評(píng)論請(qǐng)先 登錄
相關(guān)推薦
評(píng)論