shims-uni-app.d.ts 9.8 KB
Newer Older
fxy060608's avatar
fxy060608 已提交
1 2 3 4 5 6 7 8 9 10 11 12
declare namespace Page {
  interface PageInstance {
    $page: {
      id: number
      path: string
      route: string
      fullPath: string
      options: Record<string, any>
      meta: UniApp.PageRouteMeta
    }
  }
}
fxy060608's avatar
fxy060608 已提交
13
declare namespace UniApp {
fxy060608's avatar
fxy060608 已提交
14 15
  type ClassObj = Record<string, boolean>
  type StyleObj = Record<string, any>
fxy060608's avatar
fxy060608 已提交
16
  type PLATFORM = keyof PagesJsonPagePlatformStyle
fxy060608's avatar
fxy060608 已提交
17 18 19 20 21 22 23 24
  interface LayoutWindowOptions {
    matchMedia?: {
      minWidth?: number
    }
    style?: Record<string, any>
  }

  interface UniConfig {
fxy060608's avatar
fxy060608 已提交
25
    ready?: boolean
fxy060608's avatar
fxy060608 已提交
26 27
    router: {
      strict: boolean
fxy060608's avatar
fxy060608 已提交
28
      base: string
fxy060608's avatar
fxy060608 已提交
29
    }
fxy060608's avatar
fxy060608 已提交
30 31 32
    nvue: {
      'flex-direction': 'column' | 'row'
    }
fxy060608's avatar
fxy060608 已提交
33 34 35 36
    globalStyle: {
      navigationBar: PageNavigationBar
      refreshOptions?: PageRefreshOptions
    }
fxy060608's avatar
fxy060608 已提交
37 38 39
    topWindow?: LayoutWindowOptions
    leftWindow?: LayoutWindowOptions
    rightWindow?: LayoutWindowOptions
fxy060608's avatar
fxy060608 已提交
40 41 42 43 44 45
    networkTimeout: {
      connectSocket: number
      downloadFile: number
      request: number
      uploadFile: number
    }
fxy060608's avatar
fxy060608 已提交
46
    tabBar?: TabBarOptions
fxy060608's avatar
fxy060608 已提交
47
    subPackages?: { root: string }[]
Q
qiang 已提交
48
    qqMapKey?: string
fxy060608's avatar
fxy060608 已提交
49
  }
fxy060608's avatar
fxy060608 已提交
50

fxy060608's avatar
fxy060608 已提交
51 52
  interface UniRoute {
    path: string
fxy060608's avatar
fxy060608 已提交
53
    alias?: string
fxy060608's avatar
fxy060608 已提交
54 55
    meta: PageRouteMeta
    component?: any
D
DCloud_LXH 已提交
56
    loader: () => Promise<any>
fxy060608's avatar
fxy060608 已提交
57 58 59 60
  }

  type UniRoutes = UniRoute[]

fxy060608's avatar
fxy060608 已提交
61
  interface PageNavigationBarButton {
fxy060608's avatar
fxy060608 已提交
62
    type:
fxy060608's avatar
fxy060608 已提交
63 64 65 66 67 68 69 70
      | 'none'
      | 'forward'
      | 'back'
      | 'share'
      | 'favorite'
      | 'home'
      | 'menu'
      | 'close'
fxy060608's avatar
fxy060608 已提交
71
    color: string
fxy060608's avatar
fxy060608 已提交
72
    background?: string
fxy060608's avatar
fxy060608 已提交
73
    badgeText?: string
fxy060608's avatar
fxy060608 已提交
74 75
    colorPressed?: string
    float?: 'right' | 'left'
fxy060608's avatar
fxy060608 已提交
76 77
    fontWeight?: any
    fontSize: string
fxy060608's avatar
fxy060608 已提交
78
    fontSrc?: string
fxy060608's avatar
fxy060608 已提交
79
    fontFamily?: string
fxy060608's avatar
fxy060608 已提交
80
    select?: boolean
fxy060608's avatar
fxy060608 已提交
81
    text: string
fxy060608's avatar
fxy060608 已提交
82
    width?: string
fxy060608's avatar
fxy060608 已提交
83
    redDot?: boolean
fxy060608's avatar
fxy060608 已提交
84
  }
fxy060608's avatar
fxy060608 已提交
85 86

  interface PageNavigationBarSearchInput {
fxy060608's avatar
fxy060608 已提交
87
    color?: string
fxy060608's avatar
fxy060608 已提交
88 89 90 91 92 93 94 95 96
    autoFocus?: boolean
    align?: 'center' | 'left' | 'right'
    backgroundColor?: string
    borderRadius?: string
    placeholder?: string
    placeholderColor?: string
    disabled?: boolean
  }

fxy060608's avatar
fxy060608 已提交
97
  interface PageNavigationBar {
fxy060608's avatar
fxy060608 已提交
98
    type?: 'default' | 'transparent' | 'float' | 'none'
fxy060608's avatar
fxy060608 已提交
99
    titleSize?: string
fxy060608's avatar
fxy060608 已提交
100
    titleText?: string
fxy060608's avatar
fxy060608 已提交
101 102
    titleImage?: string
    titleColor?: '#000' | '#fff'
fxy060608's avatar
fxy060608 已提交
103 104 105 106 107 108 109
    timingFunc?: string
    duration?: string
    backgroundColor?: string
    titlePenetrate?: 'YES' | 'NO'
    shadowColorType?: 'grey' | 'blue' | 'green' | 'orange' | 'red' | 'yellow'
    backButton?: boolean
    buttons?: PageNavigationBarButton[]
fxy060608's avatar
fxy060608 已提交
110 111
    searchInput?: PageNavigationBarSearchInput
    style?: 'default' | 'custom'
fxy060608's avatar
fxy060608 已提交
112 113
    loading?: boolean
    coverage?: string
fxy060608's avatar
fxy060608 已提交
114 115 116 117 118 119 120 121 122
  }
  interface PageRefreshOptions {
    support: boolean
    color: string
    style: 'circle' | string
    height: number
    range: number
    offset: number
  }
fxy060608's avatar
fxy060608 已提交
123 124 125

  interface PagesJsonPagePlatformStyle {
    h5?: PagesJsonPageStyle
fxy060608's avatar
fxy060608 已提交
126
    app?: PagesJsonPageStyle
fxy060608's avatar
fxy060608 已提交
127 128 129 130 131 132 133 134 135
    'mp-alipay'?: PagesJsonPageStyle
    'mp-baidu'?: PagesJsonPageStyle
    'mp-qq'?: PagesJsonPageStyle
    'mp-toutiao'?: PagesJsonPageStyle
    'mp-weixin'?: PagesJsonPageStyle
    'quickapp-webview'?: PagesJsonPageStyle
  }

  interface PagesJsonPageStyle extends PagesJsonPagePlatformStyle {
fxy060608's avatar
fxy060608 已提交
136
    disableScroll?: boolean
fxy060608's avatar
fxy060608 已提交
137 138 139
    enablePullDownRefresh?: boolean
    navigationBar: PageNavigationBar
    refreshOptions?: PageRefreshOptions
fxy060608's avatar
fxy060608 已提交
140
    onReachBottomDistance?: number
fxy060608's avatar
fxy060608 已提交
141 142
  }
  interface PageRouteMeta extends PagesJsonPageStyle {
fxy060608's avatar
fxy060608 已提交
143
    id: number
fxy060608's avatar
fxy060608 已提交
144
    route: string
fxy060608's avatar
fxy060608 已提交
145
    isNVue?: boolean
fxy060608's avatar
fxy060608 已提交
146 147 148 149 150 151 152 153
    isQuit?: boolean
    isEntry?: boolean
    isTabBar?: boolean
    tabBarIndex?: number
    windowTop?: number
    topWindow?: boolean
    leftWindow?: boolean
    rightWindow?: boolean
fxy060608's avatar
fxy060608 已提交
154 155
  }

fxy060608's avatar
fxy060608 已提交
156 157
  interface PagesJsonPageOptions {
    path: string
fxy060608's avatar
fxy060608 已提交
158
    style: PagesJsonPageStyle
fxy060608's avatar
fxy060608 已提交
159 160 161 162 163 164
  }
  interface PagesJsonSubpackagesOptions {
    root: string
    pages: PagesJsonPageOptions[]
  }

fxy060608's avatar
fxy060608 已提交
165 166 167 168 169 170
  interface PagesJsonWindowOptions extends PagesJsonPageOptions {
    matchMedia: {
      minWidth: number
    }
  }

fxy060608's avatar
fxy060608 已提交
171 172 173 174
  interface PagesJson {
    pages: PagesJsonPageOptions[]
    subpackages?: PagesJsonSubpackagesOptions[]
    subPackages?: PagesJsonSubpackagesOptions[]
fxy060608's avatar
fxy060608 已提交
175
    globalStyle: PagesJsonPageStyle
fxy060608's avatar
fxy060608 已提交
176
    tabBar?: TabBarOptions
fxy060608's avatar
fxy060608 已提交
177 178 179
    topWindow?: PagesJsonWindowOptions
    leftWindow?: PagesJsonWindowOptions
    rightWindow?: PagesJsonWindowOptions
fxy060608's avatar
fxy060608 已提交
180 181 182 183 184 185
    easycom?: {
      autoscan?: boolean
      custom?: {
        [name: string]: string
      }
    }
fxy060608's avatar
fxy060608 已提交
186
  }
fxy060608's avatar
fxy060608 已提交
187

fxy060608's avatar
fxy060608 已提交
188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226
  interface TabBarItemBaseOptions {
    pagePath: string
    text: string
    iconPath?: string
    selectedIconPath?: string
    redDot?: boolean
    badge?: string
  }

  interface TabBarNormalItemOptions extends TabBarItemBaseOptions {
    type: 'normal'
  }
  interface TabBarMidButtonOptions extends TabBarItemBaseOptions {
    type: 'midButton'
    width?: string
    height?: string
    iconWidth?: string
    backgroundImage?: string
  }

  type TabBarItemOptions = TabBarNormalItemOptions | TabBarMidButtonOptions

  interface TabBarOptions {
    position?: 'bottom' | 'top'
    color: string
    selectedColor: string
    backgroundColor: string
    borderStyle?: 'black' | 'white'
    list: TabBarItemOptions[]
    blurEffect?: 'none' | 'dark' | 'extralight' | 'light'
    fontSize?: string
    iconWidth?: string
    spacing?: string
    height?: string
    midButton?: TabBarMidButtonOptions
    selectedIndex?: number
    shown: boolean
  }

fxy060608's avatar
fxy060608 已提交
227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262
  type OnApiLike = (callback: (result: unknown) => void) => void
  interface UniServiceJSBridge {
    /**
     * 监听 service 层的自定义事件。事件由 emit 触发,回调函数会接收所有传入事件触发函数的额外参数。
     * @param event
     * @param callback
     */
    on(event: string | string[], callback: Function): void
    /**
     * 监听 service 层的自定义事件。仅触发一次,在第一次触发之后移除监听器。
     * @param event
     * @param callback
     */
    once(event: string, callback: Function): void
    /**
     * 移除 service 层的自定义事件监听器。
     * 如果没有提供参数,则移除所有的事件监听器;
     * 如果只提供了事件,则移除该事件所有的监听器;
     * 如果同时提供了事件与回调,则只移除这个回调的监听器。
     * @param event
     * @param callback
     */
    off(event?: string | string[], callback?: Function): void
    /**
     * 触发 Service 层的事件。附加参数都会传给监听器回调。
     * @param event
     * @param args
     */
    emit(event: string, ...args: any[]): void
    /**
     * 触发 Service 层事件类型API(on开头)回调。
     * @param name
     * @param res
     */
    invokeOnCallback<T extends OnApiLike>(
      name: string,
fxy060608's avatar
fxy060608 已提交
263
      res?: Parameters<Parameters<T>[0]>[0]
fxy060608's avatar
fxy060608 已提交
264
    ): void
fxy060608's avatar
fxy060608 已提交
265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291
    /**
     * 订阅 View 的自定义事件,回调函数会接收所有传入事件触发函数的额外参数。
     * @param event
     * @param callback
     */
    subscribe(event: string, callback: Function): void
    /**
     * 取消订阅 View 的自定义事件
     * 如果没有提供参数,则移除所有的事件监听器;
     * 如果只提供了事件,则移除该事件所有的监听器;
     * 如果同时提供了事件与回调,则只移除这个回调的监听器。
     * @param event
     * @param callback
     */
    unsubscribe(event: string, callback?: Function): void
    /**
     * 执行  Service 层 API 回调
     * @param callbackId
     * @param args
     */
    invokeCallbackHandler(callbackId: number, args: unknown): void
    /**
     * 向 View 层发送事件
     * @param event
     * @param args
     * @param pageId
     */
fxy060608's avatar
fxy060608 已提交
292
    publishHandler(event: string, args: unknown, pageId: number): void
fxy060608's avatar
fxy060608 已提交
293 294 295 296 297 298 299
    /**
     * 接收 View 层事件(通常由 View 层调用,并暴露至全局 UniServiceJSBridge 对象中)
     * @param event
     * @param args
     * @param pageId
     */
    subscribeHandler(event: string, args: unknown, pageId: number): void
fxy060608's avatar
fxy060608 已提交
300
  }
fxy060608's avatar
fxy060608 已提交
301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358
  interface UniViewJSBridge {
    /**
     * 监听 View 的自定义事件。事件由 emit 触发,回调函数会接收所有传入事件触发函数的额外参数。
     * @param event
     * @param callback
     */
    on(event: string | string[], callback: Function): void
    /**
     * 监听 View 的自定义事件。仅触发一次,在第一次触发之后移除监听器。
     * @param event
     * @param callback
     */
    once(event: string, callback: Function): void
    /**
     * 移除 View 的自定义事件监听器。
     * 如果没有提供参数,则移除所有的事件监听器;
     * 如果只提供了事件,则移除该事件所有的监听器;
     * 如果同时提供了事件与回调,则只移除这个回调的监听器。
     * @param event
     * @param callback
     */
    off(event?: string | string[], callback?: Function): void
    /**
     * 触发 View 的事件。附加参数都会传给监听器回调。
     * @param event
     * @param args
     */
    emit(event: string, ...args: any[]): void
    /**
     * 订阅 Service 的自定义事件,回调函数会接收所有传入事件触发函数的额外参数。
     * @param event
     * @param callback
     */
    subscribe(event: string, callback: Function): void
    /**
     * 取消订阅 Service 的自定义事件
     * 如果没有提供参数,则移除所有的事件监听器;
     * 如果只提供了事件,则移除该事件所有的监听器;
     * 如果同时提供了事件与回调,则只移除这个回调的监听器。
     * @param event
     * @param callback
     */
    unsubscribe(event: string, callback?: Function): void
    /**
     * 接收 Service 层事件(通常由 Service 层调用,并暴露至全局 UniViewJSBridge 对象中)
     * @param event
     * @param args
     * @param pageId
     */
    subscribeHandler(event: string, args: unknown, pageId: number): void
    /**
     * 向 Service 层发送事件
     * @param event
     * @param args
     * @param pageId
     */
    publishHandler(event: string, args: unknown, pageId?: number): void
  }
fxy060608's avatar
fxy060608 已提交
359
}