快應(yīng)用 script腳本

用來(lái)定義頁(yè)面數(shù)據(jù)和實(shí)現(xiàn)生命周期接口

語(yǔ)法

支持 ES6 語(yǔ)法

模塊聲明

可以通過(guò) import 引入功能模塊，在代碼中調(diào)用模塊方法（具體參看接口部分文檔說(shuō)明）

import fetch from "@system.fetch"

代碼引用

JS 代碼引用推薦使用 import 來(lái)導(dǎo)入, 例如：

import utils from '../Common/utils.js'

注意： 快應(yīng)用環(huán)境不是 node 環(huán)境，不要引用 node 原生模塊，如 import fs from 'fs'

對(duì)象

頁(yè)面級(jí)組件

自定義組件

prop 驗(yàn)證

在自定義組件中，可將 props 定義為帶驗(yàn)證需求的對(duì)象。其中，key 為屬性名，value 為屬性對(duì)應(yīng)的驗(yàn)證需求。驗(yàn)證失敗則輸出錯(cuò)誤提示日志，增加 prop 驗(yàn)證有利于規(guī)范自定義組件的使用

定義：

示例：

<script>
  export default {
    props: {
      // 單一類型檢查的簡(jiǎn)寫
      propA: Number,
      // 多種可能類型的簡(jiǎn)寫
      propB: [String, Number],
      // 必填的字符串
      propC: {
        type: String,
        required: true
      },
      // 帶默認(rèn)值的數(shù)字
      propD: {
        type: Number,
        default: 100
      },
      // 帶有默認(rèn)值的對(duì)象
      propE: {
        type: Object,
        default () {
          return { message: 'hello' }
        }
      },
      // 自定義驗(yàn)證函數(shù)
      propF: {
        validator (value) {
          return value === 'hello'
        }
      }
    }
  }
</script>

計(jì)算屬性 1050+

• 類型：{ [key: string]: Function | { get: Function, set: Function } }
• 詳細(xì)：計(jì)算屬性將被混入到 Vm 實(shí)例中。所有 getter 和 setter 的 this 上下文自動(dòng)地綁定為 Vm 實(shí)例。計(jì)算屬性的結(jié)果會(huì)被緩存，除非依賴的響應(yīng)式屬性變化才會(huì)重新計(jì)算。注意，如果某個(gè)依賴 (比如非響應(yīng)式屬性) 在該實(shí)例范疇之外，則計(jì)算屬性是不會(huì)被更新的。

示例：

export default {
  data: {
    firstName: 'Quick',
    lastName: 'App'
  },
  computed: {
    fullName: {
      get() {
        return `${this.firstName} ${this.lastName}`
      },
      set(value) {
        const names = value.split(' ')
        this.firstName = names[0]
        this.lastName = names[names.length - 1]
      }
    }
  },
  onReady() {
    console.log(this.fullName) // Quick App
    this.fullName = 'John Doe'
    console.log(this.firstName) // John
    console.log(this.lastName) // Doe
  }
}

公共對(duì)象

應(yīng)用對(duì)象

可通過(guò)$app訪問(wèn)

頁(yè)面對(duì)象

可通過(guò)$page訪問(wèn)

方法

數(shù)據(jù)方法

公共方法

事件方法

頁(yè)面方法

可通過(guò)$page訪問(wèn)

生命周期接口

頁(yè)面生命周期

頁(yè)面的生命周期接口的調(diào)用順序：

• 打開頁(yè)面A：onInit() -> onReady() -> onShow()
• 在頁(yè)面A打開頁(yè)面B：onHide()
• 從頁(yè)面B返回頁(yè)面A：onShow()
• A頁(yè)面返回：onBackPress() -> onHide() -> onDestroy()

應(yīng)用生命周期

消息通道(BroadcastChannel) 正式版本可用

用來(lái)實(shí)現(xiàn)不同頁(yè)面之間的相互通信。

接口說(shuō)明

在BroadcastChannel的構(gòu)造函數(shù)中,只支持接受一個(gè)參數(shù),就是"頻道名稱"(channel name)

比如：

const test = new BroadcastChannel('channel')

BroadcastChannel 定義的接口如下：

declare interface BroadcastChannel = {
  name: string,
  postMessage: (message: any) => void;
  onmessage: (event: MessageEvent) => void;
  close: () => void;
}

消息對(duì)象（MessageEvent）的類型定義如下：

declare interface MessageEvent = {
  type: string, // "message"
  data: any
}

對(duì)參數(shù)的說(shuō)明：

用法

假設(shè)在我們的應(yīng)用中，有A、B、C三個(gè)頁(yè)面

在頁(yè)面 A 中：

const pageA = new BroadcastChannel('channel1')
pageA.postMessage('haha!')

在頁(yè)面 B 中：

const pageB = new BroadcastChannel('channel1')

在頁(yè)面 C 中：

const pageC = new BroadcastChannel('channel1')
pageC.onmessage = function (event) {
  console.log(event.data)
  pageC.postMessage('hello, i am here!')
}

這樣,頁(yè)面 A 、B 、C 都創(chuàng)建一個(gè)監(jiān)聽了 'channel1' 頻道的 BroadcastChannel 對(duì)象，它們之間可以通過(guò)這個(gè)對(duì)象實(shí)現(xiàn)互相通信。

當(dāng) pageA 發(fā)布了 'haha!' 消息時(shí)，pageC 將收到一個(gè)消息事件，其 data 字段等于 'haha!'，然后也向頻道中回復(fù)一條消息。注意：自己不會(huì)收到自己發(fā)的消息。

但是 pageB 并不會(huì)收到這些消息，因?yàn)樗麤](méi)有實(shí)現(xiàn)onmessage 方法，相當(dāng)于沒(méi)有接收頻道中的消息，所以他實(shí)際上不是一個(gè)訂閱者。

注意:在pageA銷毀channel當(dāng)前不與頁(yè)面context進(jìn)行上下文綁定，需要主動(dòng)關(guān)閉消息通道，如下所示:

const pageA = new BroadcastChannel('tom')
pageA.close();