@dcloudio/uni-app-x 0.5.5 → 0.5.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcloudio/uni-app-x",
-  "version": "0.5.5",
+  "version": "0.5.7",
   "description": "uni-app x types",
   "typings": "index.d.ts",
   "author": "DCloud",

package/types/app.d.ts

@@ -137,6 +137,7 @@ interface AppInstance<T extends AnyObject = {}> {
   /**
    * 全局对象
    * 文档：[https://uniapp.dcloud.io/collocation/App?id=globaldata](https://uniapp.dcloud.io/collocation/App?id=globaldata)
+   * @autodoc false
    * @uniPlatform {
    *  "app": {
    *    "android": {
@@ -205,6 +206,7 @@ interface AppInstance<T extends AnyObject = {}> {
    * 应用初始化完成时触发，全局只触发一次。
    *
    * @tutorial [https://uniapp.dcloud.io/collocation/frame/lifecycle](https://uniapp.dcloud.io/collocation/frame/lifecycle)
+   * @autodoc false
    * @uniPlatform {
    *  "app": {
    *    "android": {
@@ -266,13 +268,14 @@ interface AppInstance<T extends AnyObject = {}> {
    *  }
    *}
    */
-  onLaunch?(options?: OnLaunchOptions): void;
+  onLaunch?(options: OnLaunchOptions): void;
   /**
    * 生命周期回调 监听应用显示
    *
    * 应用启动，或从后台进入前台显示时触发
    *
    * @tutorial [https://uniapp.dcloud.io/collocation/frame/lifecycle](https://uniapp.dcloud.io/collocation/frame/lifecycle)
+   * @autodoc false
    * @uniPlatform {
    *  "app": {
    *    "android": {
@@ -334,13 +337,14 @@ interface AppInstance<T extends AnyObject = {}> {
    *  }
    *}
    */
-  onShow?(options?: OnShowOptions): void;
+  onShow?(options: OnShowOptions): void;
   /**
    * 生命周期回调 监听应用隐藏
    *
    * 应用从前台进入后台时触发
    *
    * @tutorial [https://uniapp.dcloud.io/collocation/frame/lifecycle](https://uniapp.dcloud.io/collocation/frame/lifecycle)
+   * @autodoc false
    * @uniPlatform {
    *  "app": {
    *    "android": {
@@ -409,6 +413,7 @@ interface AppInstance<T extends AnyObject = {}> {
    * @param error 错误信息，包含堆栈
    *
    * @tutorial [https://uniapp.dcloud.io/collocation/frame/lifecycle](https://uniapp.dcloud.io/collocation/frame/lifecycle)
+   * @autodoc false
    * @uniPlatform {
    *  "app": {
    *    "android": {
@@ -481,6 +486,7 @@ interface AppInstance<T extends AnyObject = {}> {
    * 2. 如果 `onPageNotFound` 回调中又重定向到另一个不存在的页面，将推入微信客户端原生的页面不存在提示页面，并且不再回调 `onPageNotFound`。
    *
    * @tutorial [https://uniapp.dcloud.io/collocation/frame/lifecycle](https://uniapp.dcloud.io/collocation/frame/lifecycle)
+   * @autodoc false
    * @uniPlatform {
    *  "app": {
    *    "android": {
@@ -617,9 +623,9 @@ interface AppInstance<T extends AnyObject = {}> {
    *  }
    *}
    */
-    
+
     //   onUnhandledRejection?(options: UniNamespace.OnUnhandledRejectionCallbackResult): void;
-    
+
   /**
    * 监听系统主题变化
    *
@@ -696,13 +702,14 @@ interface AppInstance<T extends AnyObject = {}> {
    */
 
     //   onThemeChange?(options: UniNamespace.OnThemeChangeCallbackResult): void;
-    
+
   /**
    * 监听 nvue 页面消息
    *
    * nvue 页面使用 `uni.postMessage` 发送消息时触发
    *
    * @tutorial [https://uniapp.dcloud.io/collocation/frame/lifecycle](https://uniapp.dcloud.io/collocation/frame/lifecycle)
+   * @autodoc false
    * @uniPlatform {
    *  "app": {
    *    "android": {
@@ -778,6 +785,7 @@ interface AppInstance<T extends AnyObject = {}> {
    * 监听应用退出。app-uvue-android 3.9+
    *
    * @tutorial [https://uniapp.dcloud.io/collocation/frame/lifecycle](https://uniapp.dcloud.io/collocation/frame/lifecycle)
+   * @autodoc false
    * @uniPlatform {
    *  "app": {
    *    "android": {
@@ -853,6 +861,7 @@ interface AppInstance<T extends AnyObject = {}> {
    * 最后一个页面按下Android back键，常用于自定义退出。app-uvue-android 3.9+
    *
    * @tutorial [https://uniapp.dcloud.io/collocation/frame/lifecycle](https://uniapp.dcloud.io/collocation/frame/lifecycle)
+   * @autodoc false 
    * @uniPlatform {
    *  "app": {
    *    "android": {
@@ -932,9 +941,9 @@ type AppConstructor = <T extends AnyObject & AppInstance>(
 
 
 /**
- * `getApp()` 函数用于获取当前应用实例。
- * @tutorial https://uniapp.dcloud.net.cn/uni-app-x/api/getapp.html#getapp
+ * `getApp()` 函数用于获取当前应用实例，可通过应用实例调用 App.uvue methods 中定义的方法。
+ * @tutorial https://uniapp.dcloud.net.cn/tutorial/page.html#getapp
  */
-type GetApp = <T extends AnyObject>() => AppInstance<T> & T;
+type GetApp = () => AppInstance;
 
 declare const getApp: GetApp;

package/types/native/AsyncApiResult.d.ts

@@ -2,6 +2,6 @@
  * @package io.dcloud.uniapp
  * @autodoc false
  */
-interface AsyncApiResult {
+declare interface AsyncApiResult {
   errMsg: string
 }

package/types/native/CSSStyleDeclaration.d.ts

@@ -9,12 +9,12 @@ declare class CSSStyleDeclaration {
  * @param name CSS样式名称
  * @param value 要设置的新CSS样式值
  */
-  setProperty(name: string|HBuilderX.cssPropertyString, value: any|null): void
+  setProperty(name: string|string.cssPropertyString, value: any|null): void
 
 /**
  * 获取CSS指定的样式值，如果指定的样式不存在则返回null。
  * @param property 要获取的CSS样式名称
  */
-  getPropertyValue(property: string|HBuilderX.cssPropertyString): any|null
+  getPropertyValue(property: string|string.cssPropertyString): any|null
 
 }

package/types/native/DrawableContext.d.ts

@@ -12,7 +12,7 @@ declare class DrawableContext {
 	 * 设置填充颜色
 	 * @defaultValue #000 (黑色)
 	 */
-	fillStyle : string
+	fillStyle : string.ColorString
 	/**
 	 * 指定如何绘制每一条线条末端的属性，可选值：`butt`线段末端以方形结束；`round`线段末端以圆形结束；`square`线段末端以方形结束，但是会增加一个一半宽度的矩形区域。
 	 * @defaultValue butt
@@ -36,7 +36,7 @@ declare class DrawableContext {
 	 * 设置边框的颜色
 	 * @defaultValue #000 (黑色)
 	 */
-	strokeStyle : string
+	strokeStyle : string.ColorString
 	/**
 	 * 设置文本的对齐方式，可取值：`left`左对齐；`center`居中对齐；`right`右对齐。
 	 * @defaultValue left

package/types/native/Element.d.ts

@@ -1,120 +1,127 @@
 /// <reference path="./Event.d.ts" />
+/// <reference path='./SnapshotOptions.d.ts' />
 
 /**
+ * UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。
  * @package io.dcloud.uniapp.runtime
  */
-interface Element {
+declare interface Element {
   /**
-   * 获取当前元素的的第一个子元素，如果元素是无子元素，则返回 null。
+   * 只读属性 获取当前元素的的第一个子元素，如果元素是无子元素，则返回 null。
    */
   firstChild: Element | null
 
   /**
-   * 获取当前元素的最后一个子元素，如果没有子元素，则返回 null。
+   * 只读属性 获取当前元素的最后一个子元素，如果没有子元素，则返回 null。
    */
   lastChild: Element | null
 
   /**
-   * 获取当前元素在 DOM 树中的父元素，如果没有父元素（如未添加到DOM树中），则返回null。
+   * 只读属性 获取当前元素在 DOM 树中的父元素，如果没有父元素（如未添加到DOM树中），则返回null。
    * @autodoc false
    */
   parentNode: Element | null
 
   /**
-   * 获取当前元素在 DOM 树中的父元素，如果没有父元素（如未添加到DOM树中），则返回null。
+   * 只读属性 获取当前元素在 DOM 树中的父元素，如果没有父元素（如未添加到DOM树中），则返回null。
    */
   parentElement: Element | null
 
   /**
-   * 获取当前元素的前一个同级元素，没有则返回null。
+   * 只读属性 获取当前元素的前一个同级元素，没有则返回null。
    */
   previousSibling: Element | null
 
   /**
-   * 获取在 DOM 树中紧跟在其后面的同级元素，如果指定的元素为最后一个元素，则返回 null。
+   * 只读属性 获取在 DOM 树中紧跟在其后面的同级元素，如果指定的元素为最后一个元素，则返回 null。
+   * @autodoc false
    */
   nextSibling: Element | null
 
   /**
-   * 获取在 DOM 树中紧跟在其后面的同级元素，如果指定的元素为最后一个元素，则返回 null。
-   * @autodoc false
+   * 只读属性 获取在 DOM 树中紧跟在其后面的同级元素，如果指定的元素为最后一个元素，则返回 null。
    */
   nextElementSibling: Element | null
 
   /**
-   * 获取当前元素包含的子元素的集合
+   * 只读属性 获取当前元素包含的子元素的集合
    */
   children: Element[]
+
+  /**
+   * 只读属性 获取当前节点包含的子节点的集合
+   * @autodoc false
+   */
   childNodes: Element[]
 
   /**
-   * 获取当前元素的标签名
+   * 只读属性 获取当前元素的标签名
    */
   tagName: string
 
   /**
-   * 获取当前元素的元素名称
+   * 只读属性 获取当前元素的元素名称
    * @autodoc false
    */
   nodeName: string
 
   /**
-   * 获取元素上自定义数据属性（data-*）的集合
+   * 只读属性 获取元素上自定义数据属性（data-*）的集合
    */
   dataset: Map<string, any | null>
 
   /**
-   * 获取元素上所有属性元素的集合
+   * 只读属性 获取元素上所有属性元素的集合
    */
   attributes: Map<string, any | null>
 
   /**
-   * 获取元素的CSS样式对象
+   * 只读属性 获取元素的CSS样式对象
    */
   style: CSSStyleDeclaration
 
   /**
-   * 获取可滚动元素内容的总宽度，仅scroll-view、list-view组件支持，其他组件返回视图宽度
+   * 只读属性 获取可滚动元素内容的总宽度，仅scroll-view、list-view组件支持，其他组件返回视图宽度
    */
   scrollWidth: number
 
   /**
-   * 获取可滚动元素内容的总高度，仅scroll-view、list-view组件支持，其他组件返回视图高度
+   * 只读属性 获取可滚动元素内容的总高度，仅scroll-view、list-view组件支持，其他组件返回视图高度
    */
   scrollHeight: number
 
   /**
-    * 获取元素滚动条到元素左边的距离像素数，仅scroll-view、list-view组件支持。其他组件返回0
+    * 获取或修改元素滚动条到元素左边的距离像素数，仅scroll-view、list-view组件支持。其他组件返回0
     */
   scrollLeft: number
 
   /**
-   * 获取元素滚动条到元素顶部的距离像素数，仅scroll-view、list-view组件支持。其他组件返回0
+   * 获取或修改元素滚动条到元素顶部的距离像素数，仅scroll-view、list-view组件支持。其他组件返回0
    */
   scrollTop: number
 
   /**
-   * 元素的左边界偏移值 单位px
+   * 只读属性 元素的左边界偏移值 单位px
    */
   offsetLeft: number
 
   /**
-   * 元素的右边界偏移值 单位px
+   * 只读属性 元素的右边界偏移值 单位px
    */
   offsetTop: number
 
   /**
-   * 元素高度 单位px
+   * 只读属性 元素高度 单位px
    */
   offsetWidth: number
 
   /**
-   * 元素宽度 单位px
+   * 只读属性 元素宽度 单位px
    */
   offsetHeight: number
 
   /**
-   * 扩展属性
+   * 只读属性 扩展属性
    */
   ext: Map<string, any>
 
@@ -124,6 +131,29 @@ interface Element {
    */
   getNodeId(): string
 
+
+  /**
+   * 对当前组件进行截图，调用此方法会将当前组件（包含子节点）渲染结果导出成图片。
+   * 成功会返回图片对应的临时文件路径，目前默认png格式
+   *
+   * @param options 组件截图的参数对象
+   * @uniPlatform {
+   *    "app": {
+   *        "android": {
+   *            "osVer": "5.0",
+   *            "uniVer": "x",
+   *            "unixVer": "3.93"
+   *        },
+   *        "ios": {
+   *            "osVer": "x",
+   *            "uniVer": "x",
+   *            "unixVer": "x"
+   *   	  }
+   *    }
+   * }
+   */
+  takeSnapshot(options: TakeSnapshotOptions):void
+
   /**
    * 将一个元素添加到指定父元素的子元素列表的末尾处。如果将被插入的元素已经存在于当前文档的文档树中，那么将会它从原先的位置移动到新的位置。
    * @param {Element} aChild 插入子元素对象
@@ -140,15 +170,15 @@ interface Element {
   /**
    * 设置指定元素上的某个属性值。如果设置的属性已经存在，则更新该属性值；否则使用指定的名称和值添加一个新的属性。
    * @param {string} key 属性名称
-   * @param {any | null} value 属性值域 可为空
+   * @param {string} value 属性值域
    */
-  setAttribute(key: string, value: any | null): void
+  setAttribute(key: string, value: string): void
 
   /**
    * 获取元素指定的属性值，如果指定的属性不存在则返回null。
    * @param {string} key 属性名称
    */
-  getAttribute(key: string): any | null
+  getAttribute(key: string): string | null
 
   /**
    * 返回改元素是否包含有指定的属性，属性存在则返回true，否则返回false。
@@ -236,3 +266,4 @@ interface Element {
 }
 
 type INode = Element
+

package/types/native/IDocument.d.ts

@@ -1,15 +1,14 @@
 /// <reference path='./Element.d.ts' />
-/// <reference path='./ITabsNode.d.ts' />
 /// <reference path='./NodeData.d.ts' />
 
 /**
  * @package io.dcloud.uniapp.runtime
  * @autodoc false
  */
-interface IDocument extends Element {
+declare interface IDocument extends Element {
   body: Element
 
-  getRealDomNodeById<T>(tag: string): ITabsNode | null
+  getRealDomNodeById<T>(tag: string): T | null
 
   startRender(): unknown
 

package/types/native/IPage.d.ts

@@ -5,7 +5,7 @@
  * @package io.dcloud.uniapp.runtime
  * @autodoc false
  */
-interface IPage {
+declare interface IPage {
   /**
    * 页面id
    */

package/types/native/IUniError.d.ts

@@ -1,6 +1,6 @@
 /// <reference path="./AsyncApiResult.d.ts" />
 
-interface IUniError extends AsyncApiResult {
+declare interface IUniError extends AsyncApiResult {
 	/**
 	 * 统一错误码
 	 */

package/types/native/NodeData.d.ts

@@ -2,7 +2,7 @@
  * @package io.dcloud.uniapp.interfaces
  * @autodoc false
  */
-interface INodeData {
+declare interface INodeData {
   id: string
   name: string
   attrs?: Map<string, any | null>

package/types/native/SnapshotOptions.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 组件截图成功的返回数据
+ */
+declare type TakeSnapshotSuccess = {
+  /**
+   * 截图保存的临时文件路径
+   */
+  tempFilePath: string
+}
+
+/**
+ * 组件截图失败的返回数据
+ */
+declare type TakeSnapshotFail = {
+  errMsg: string
+}
+
+
+/**
+ * 成功回调函数定义
+ */
+declare type TakeSnapshotSuccessCallback = (res: TakeSnapshotSuccess) => void
+/**
+ * 失败回调函数定义
+ */
+declare type TakeSnapshotFailCallback = (res: TakeSnapshotFail) => void
+/**
+ * 完成回调函数定义
+ */
+declare type TakeSnapshotCompleteCallback = (res: any) => void
+
+/**
+ * 组件截图的参数配置选项
+ */
+declare class TakeSnapshotOptions{
+
+  /**
+   * 截图导出类型，目前仅支持 'file' 保存到临时文件目录
+   * @default "file"
+   */
+  type : string
+  /**
+   * 截图文件格式，目前仅支持 'png'
+   * @default "png"
+   */
+  format : string
+
+  /**
+   * 接口调用成功的回调函数
+   */
+  success?: TakeSnapshotSuccessCallback | null
+  /**
+   * 接口调用失败的回调函数
+   */
+  fail?: TakeSnapshotFailCallback | null
+  /**
+   * 接口调用结束的回调函数（调用成功、失败都会执行）
+   */
+  complete?: TakeSnapshotCompleteCallback | null
+
+}
+
+

package/types/native/UTSAndroidHookProxy.d.ts

@@ -0,0 +1,14 @@
+
+/**
+ * 安卓原应用初始化回调代理
+ * 注意：不支持调用uni api 仅适用于原生SDK初始化等
+ * @package io.dcloud.uts
+ * @autodoc false
+ */
+declare interface UTSAndroidHookProxy {
+      /**
+       * 安卓原生应用初始化时会调用此接口 可在此处进行相关资源数据初始化 和 模块注册逻辑
+       * @param application 安卓原生上下文
+       */
+      onCreate(application: Application): void
+}

package/types/native/UniAppManager.d.ts

@@ -8,7 +8,7 @@ declare const UniAppManager: {
   getCurrentApp(): CurrentApp
 }
 
-interface CurrentApp {
+declare interface CurrentApp {
   pageManager: {
     createPage(url: string, id: unknown, styles: unknown): IPage
   }

package/types/native/UniElement.d.ts

@@ -0,0 +1,140 @@
+/// <reference path='./Element.d.ts' />
+
+/**
+ * view元素对象
+ * @package io.dcloud.uniapp.runtime
+ * @autodoc false
+ */
+declare class UniElement implements Element {
+  firstChild: Element;
+  lastChild: Element;
+  parentNode: Element;
+  parentElement: Element;
+  previousSibling: Element;
+  nextSibling: Element;
+  nextElementSibling: Element;
+  children: Element[];
+  childNodes: Element[];
+  tagName: string;
+  nodeName: string;
+  dataset: Map<string, any>;
+  attributes: Map<string, any>;
+  style: CSSStyleDeclaration;
+  scrollWidth: number;
+  scrollHeight: number;
+  scrollLeft: number;
+  scrollTop: number;
+  offsetLeft: number;
+  offsetTop: number;
+  offsetWidth: number;
+  offsetHeight: number;
+  ext: Map<string, any>;
+  getNodeId(): string;
+  takeSnapshot(options: TakeSnapshotOptions): void;
+  appendChild(aChild: Element): void;
+  insertBefore(newChild: Element, refChild?: Element): void;
+  setAttribute(key: string, value: string): void;
+  getAttribute(key: string): string;
+  hasAttribute(key: string): boolean;
+  removeAttribute(key: string): void;
+  updateStyle(map: Map<string, any>): void;
+  getBoundingClientRect(): DOMRect;
+  getDrawableContext(): DrawableContext;
+  addEventListener<T extends Event, R>(type: string, callback: (event: T) => R): void;
+  removeEventListener<T extends Event, R>(type: string, callback?: (event: T) => R): void;
+  removeChild(aChild: Element): Element;
+  remove(): void;
+  dispatchEvent(type: string, value: Event): void;
+  scrollTo(x: number, y: number): void;
+  scrollBy(x: number, y: number): void;
+  focus(): void;
+  blur(): void;
+}
+
+/**
+ * view元素对象
+ * @package io.dcloud.uniapp.runtime
+ * @autodoc false
+ */
+declare interface UniViewElement extends UniElement {
+}
+
+/**
+ * scroll-view元素对象
+ * @package io.dcloud.uniapp.runtime
+ * @autodoc false
+ */
+declare interface UniScrollViewElement extends UniElement {
+}
+
+/**
+ * list-view元素对象
+ * @package io.dcloud.uniapp.runtime
+ * @autodoc false
+ */
+declare interface UniListViewElement extends UniScrollViewElement {
+}
+
+/**
+ * list-item元素对象
+ * @package io.dcloud.uniapp.runtime
+ * @autodoc false
+ */
+declare interface UniListItemElement extends UniElement {
+}
+
+/**
+ * swiper元素对象
+ * @package io.dcloud.uniapp.runtime
+ * @autodoc false
+ */
+declare interface UniSwiperElement extends UniElement {
+}
+
+/**
+ * swiper-item元素对象
+ * @package io.dcloud.uniapp.runtime
+ * @autodoc false
+ */
+declare interface UniSwiperItemElement extends UniElement {
+}
+
+/**
+ * image元素对象
+ * @package io.dcloud.uniapp.runtime
+ * @autodoc false
+ */
+declare interface UniImageElement extends UniElement {
+}
+
+/**
+ * input元素对象
+ * @package io.dcloud.uniapp.runtime
+ * @autodoc false
+ */
+declare interface UniInputElement extends UniElement {
+}
+
+/**
+ * textarea元素对象
+ * @package io.dcloud.uniapp.runtime
+ * @autodoc false
+ */
+declare interface UniTextareaElement extends UniElement {
+}
+
+/**
+ * rich-text元素对象
+ * @package io.dcloud.uniapp.runtime
+ * @autodoc false
+ */
+declare interface UniRichTextElement extends UniElement {
+}
+
+/**
+ * sticky-header元素对象
+ * @package io.dcloud.uniapp.runtime
+ * @autodoc false
+ */
+declare interface UniStickyHeaderElement extends UniElement {
+}