uni-shared.d.ts 15.2 KB
Newer Older
fxy060608's avatar
fxy060608 已提交
1 2
import { FontFaceDescriptors } from 'css-font-loading-module';

fxy060608's avatar
fxy060608 已提交
3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
export declare const ACTION_TYPE_ADD_EVENT = 8;

export declare const ACTION_TYPE_CREATE = 3;

export declare const ACTION_TYPE_EVENT = 20;

export declare const ACTION_TYPE_INSERT = 4;

export declare const ACTION_TYPE_PAGE_CREATE = 1;

export declare const ACTION_TYPE_PAGE_CREATED = 2;

export declare const ACTION_TYPE_REMOVE = 5;

export declare const ACTION_TYPE_REMOVE_ATTRIBUTE = 7;

export declare const ACTION_TYPE_REMOVE_EVENT = 9;

export declare const ACTION_TYPE_SET_ATTRIBUTE = 6;

export declare const ACTION_TYPE_SET_TEXT = 10;

/**
 * nodeId
 * event
 * flag
 */
export declare type AddEventAction = [
fxy060608's avatar
fxy060608 已提交
31 32 33 34
typeof ACTION_TYPE_ADD_EVENT,
number,
string | number,
number
fxy060608's avatar
fxy060608 已提交
35 36
];

fxy060608's avatar
fxy060608 已提交
37
export declare function addFont(family: string, source: string, desc?: FontFaceDescriptors): Promise<void>;
fxy060608's avatar
fxy060608 已提交
38

fxy060608's avatar
fxy060608 已提交
39 40 41 42
export declare const ATTR_CLASS = "class";

export declare const ATTR_STYLE = "style";

fxy060608's avatar
fxy060608 已提交
43 44
export declare const BACKGROUND_COLOR = "#f7f7f7";

fxy060608's avatar
fxy060608 已提交
45 46
export declare const BUILT_IN_TAGS: string[];

fxy060608's avatar
fxy060608 已提交
47 48 49
export declare function cache<T>(fn: (str: string) => T): (str: string) => T;

export declare function cacheStringFunction(fn: (string: string) => string): (str: string) => string;
fxy060608's avatar
fxy060608 已提交
50

Q
qiang 已提交
51 52 53 54 55 56 57
export declare function callOptions(options: Options, errMsg: string): void;

export declare function callOptions(options: Options, data: {
    [key: string]: any;
    errMsg: string;
}): void;

fxy060608's avatar
fxy060608 已提交
58 59
export declare const COMPONENT_NAME_PREFIX = "VUni";

fxy060608's avatar
fxy060608 已提交
60 61 62
export declare const COMPONENT_PREFIX: string;

export declare const COMPONENT_SELECTOR_PREFIX = "uni-";
fxy060608's avatar
fxy060608 已提交
63

fxy060608's avatar
fxy060608 已提交
64 65 66 67
/**
 * nodeId
 * tag
 * parentNodeId
fxy060608's avatar
fxy060608 已提交
68
 * refNodeId
fxy060608's avatar
fxy060608 已提交
69 70 71
 * nodeJson
 */
export declare type CreateAction = [
fxy060608's avatar
fxy060608 已提交
72 73 74 75
typeof ACTION_TYPE_CREATE,
number,
string | number,
number,
fxy060608's avatar
fxy060608 已提交
76
number,
fxy060608's avatar
fxy060608 已提交
77
Partial<UniNodeJSON | UniNodeJSONMinify>?
fxy060608's avatar
fxy060608 已提交
78 79
];

fxy060608's avatar
fxy060608 已提交
80 81
export declare function createRpx2Unit(unit: string, unitRatio: number, unitPrecision: number): (val: string) => string;

fxy060608's avatar
fxy060608 已提交
82 83
export declare const DATA_RE: RegExp;

fxy060608's avatar
fxy060608 已提交
84 85 86 87 88
export declare function debounce(fn: Function, delay: number): {
    (this: any): void;
    cancel(): void;
};

fxy060608's avatar
fxy060608 已提交
89 90 91 92 93 94 95 96 97 98 99
/**
 * Decode text using `decodeURIComponent`. Returns the original text if it
 * fails.
 *
 * @param text - string to decode
 * @returns decoded string
 */
export declare function decode(text: string | number): string;

export declare function decodedQuery(query?: Record<string, any>): Record<string, string>;

fxy060608's avatar
fxy060608 已提交
100 101 102 103 104 105
export declare const defaultRpx2Unit: {
    unit: string;
    unitRatio: number;
    unitPrecision: number;
};

fxy060608's avatar
fxy060608 已提交
106
declare type DictArray = [number, number][];
fxy060608's avatar
fxy060608 已提交
107

fxy060608's avatar
fxy060608 已提交
108 109 110 111 112 113
export declare const EventModifierFlags: {
    stop: number;
    prevent: number;
    self: number;
};

D
DCloud_LXH 已提交
114 115 116 117 118
export declare function formatDateTime({ date, mode }: {
    date?: Date | undefined;
    mode?: string | undefined;
}): string;

fxy060608's avatar
fxy060608 已提交
119 120
export declare function formatLog(module: string, ...args: any[]): string;

Q
qiang 已提交
121
export declare function getCustomDataset(el: HTMLElement | HTMLElementWithDataset): DOMStringMap & Record<string, any>;
Q
qiang 已提交
122

fxy060608's avatar
fxy060608 已提交
123 124
export declare function getEnvLocale(): string;

fxy060608's avatar
fxy060608 已提交
125 126
export declare function getLen(str?: string): number;

Q
qiang 已提交
127 128 129 130
declare interface HTMLElementWithDataset extends HTMLElement {
    __uniDataset?: Record<string, any>;
}

Q
qiang 已提交
131
export declare function initCustomDataset(): void;
Q
qiang 已提交
132

fxy060608's avatar
fxy060608 已提交
133 134 135 136 137 138 139
/**
 * nodeId
 * parentNodeId
 * refNodeId
 */
export declare type InsertAction = [typeof ACTION_TYPE_INSERT, number, number, number];

fxy060608's avatar
fxy060608 已提交
140 141
export declare const invokeArrayFns: (fns: Function[], arg?: any) => any;

fxy060608's avatar
fxy060608 已提交
142 143 144 145 146 147
export declare function isBuiltInComponent(tag: string): boolean;

export declare function isCustomElement(tag: string): boolean;

export declare function isNativeTag(tag: string): boolean;

fxy060608's avatar
fxy060608 已提交
148 149 150 151
export declare function isServiceCustomElement(_tag: string): boolean;

export declare function isServiceNativeTag(tag: string): boolean;

fxy060608's avatar
fxy060608 已提交
152 153
export declare interface IUniPageNode {
    pageId: number;
fxy060608's avatar
fxy060608 已提交
154
    pageNode: IUniPageNode | null;
fxy060608's avatar
fxy060608 已提交
155
    isUnmounted: boolean;
fxy060608's avatar
fxy060608 已提交
156 157
    genId: () => number;
    push: (...args: any[]) => void;
fxy060608's avatar
fxy060608 已提交
158
    onCreate: (thisNode: UniNode, nodeName: string | number) => UniNode;
fxy060608's avatar
fxy060608 已提交
159 160
    onInsertBefore: (thisNode: UniNode, newChild: UniNode, refChild: UniNode | null) => UniNode;
    onRemoveChild: (oldChild: UniNode) => UniNode;
fxy060608's avatar
fxy060608 已提交
161 162
    onAddEvent: (thisNode: UniNode, name: string, flag: number) => void;
    onRemoveEvent: (thisNode: UniNode, name: string) => void;
fxy060608's avatar
fxy060608 已提交
163 164 165 166
    onSetAttribute: (thisNode: UniNode, qualifiedName: string, value: unknown) => void;
    onRemoveAttribute: (thisNode: UniNode, qualifiedName: string) => void;
    onTextContent: (thisNode: UniNode, text: string) => void;
    onNodeValue: (thisNode: UniNode, val: string | null) => void;
fxy060608's avatar
fxy060608 已提交
167 168
}

fxy060608's avatar
fxy060608 已提交
169 170
export declare const NAVBAR_HEIGHT = 44;

fxy060608's avatar
fxy060608 已提交
171 172 173 174 175 176 177 178
export declare const NODE_TYPE_COMMENT = 8;

export declare const NODE_TYPE_ELEMENT = 1;

export declare const NODE_TYPE_PAGE = 0;

export declare const NODE_TYPE_TEXT = 3;

fxy060608's avatar
fxy060608 已提交
179 180
export declare function normalizeDataset(el: Element): any;

fxy060608's avatar
fxy060608 已提交
181 182
export declare function normalizeEventType(type: string, options?: AddEventListenerOptions): string;

fxy060608's avatar
fxy060608 已提交
183 184
export declare function normalizeTarget(el: HTMLElement): {
    id: string;
Q
qiang 已提交
185
    dataset: DOMStringMap & Record<string, any>;
fxy060608's avatar
fxy060608 已提交
186 187 188 189
    offsetTop: number;
    offsetLeft: number;
};

fxy060608's avatar
fxy060608 已提交
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
export declare const ON_ADD_TO_FAVORITES = "onAddToFavorites";

export declare const ON_APP_ENTER_BACKGROUND = "onAppEnterBackground";

export declare const ON_APP_ENTER_FOREGROUND = "onAppEnterForeground";

export declare const ON_BACK_PRESS = "onBackPress";

export declare const ON_ERROR = "onError";

export declare const ON_HIDE = "onHide";

export declare const ON_LAUNCH = "onLaunch";

export declare const ON_LOAD = "onLoad";

export declare const ON_NAVIGATION_BAR_BUTTON_TAP = "onNavigationBarButtonTap";

export declare const ON_NAVIGATION_BAR_SEARCH_INPUT_CHANGED = "onNavigationBarSearchInputChanged";

export declare const ON_NAVIGATION_BAR_SEARCH_INPUT_CLICKED = "onNavigationBarSearchInputClicked";

export declare const ON_NAVIGATION_BAR_SEARCH_INPUT_CONFIRMED = "onNavigationBarSearchInputConfirmed";

export declare const ON_NAVIGATION_BAR_SEARCH_INPUT_FOCUS_CHANGED = "onNavigationBarSearchInputFocusChanged";

export declare const ON_PAGE_NOT_FOUND = "onPageNotFound";

export declare const ON_PAGE_SCROLL = "onPageScroll";

export declare const ON_PULL_DOWN_REFRESH = "onPullDownRefresh";

export declare const ON_REACH_BOTTOM = "onReachBottom";

fxy060608's avatar
fxy060608 已提交
224 225
export declare const ON_REACH_BOTTOM_DISTANCE = 50;

fxy060608's avatar
fxy060608 已提交
226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245
export declare const ON_READY = "onReady";

export declare const ON_RESIZE = "onResize";

export declare const ON_SHARE_APP_MESSAGE = "onShareAppMessage";

export declare const ON_SHARE_TIMELINE = "onShareTimeline";

export declare const ON_SHOW = "onShow";

export declare const ON_TAB_ITEM_TAP = "onTabItemTap";

export declare const ON_THEME_CHANGE = "onThemeChange";

export declare const ON_UNHANDLE_REJECTION = "onUnhandledRejection";

export declare const ON_UNLOAD = "onUnload";

export declare const ON_WEB_INVOKE_APP_SERVICE = "onWebInvokeAppService";

fxy060608's avatar
fxy060608 已提交
246
export declare function once<T extends (...args: any[]) => any>(fn: T, ctx?: unknown): T;
fxy060608's avatar
fxy060608 已提交
247

Q
qiang 已提交
248 249 250 251 252 253
declare interface Options {
    success?: (res: any) => void;
    fail?: (res: any) => void;
    complete?: (res: any) => void;
}

fxy060608's avatar
fxy060608 已提交
254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281
export declare type PageAction = PageCreateAction | PageCreatedAction | PageUpdateAction;

export declare type PageCreateAction = [typeof ACTION_TYPE_PAGE_CREATE, PageCreateData];

export declare type PageCreatedAction = [typeof ACTION_TYPE_PAGE_CREATED];

export declare interface PageCreateData extends PageNodeOptions {
}

export declare interface PageNodeOptions {
    css: boolean;
    route: string;
    version: number;
    locale: string;
    platform: string;
    pixelRatio: number;
    windowWidth: number;
    disableScroll: boolean;
    onPageScroll: boolean;
    onPageReachBottom: boolean;
    onReachBottomDistance: number;
    statusbarHeight: number;
    windowTop: number;
    windowBottom: number;
}

export declare type PageUpdateAction = CreateAction | InsertAction | RemoveAction | AddEventAction | RemoveEventAction | SetAttributeAction | RemoveAttributeAction | SetTextAction;

fxy060608's avatar
fxy060608 已提交
282 283
export declare function parseEventName(name: string): [string, EventListenerOptions | undefined];

fxy060608's avatar
fxy060608 已提交
284 285 286 287 288 289 290 291 292
/**
 * https://github.com/vuejs/vue-router-next/blob/master/src/query.ts
 * @internal
 *
 * @param search - search string to parse
 * @returns a query object
 */
export declare function parseQuery(search: string): Record<string, any>;

fxy060608's avatar
fxy060608 已提交
293 294 295 296 297
export declare function parseUrl(url: string): {
    path: string;
    query: Record<string, any>;
};

fxy060608's avatar
fxy060608 已提交
298 299 300 301
export declare function passive(passive: boolean): {
    passive: boolean;
};

fxy060608's avatar
fxy060608 已提交
302 303
export declare const PLUS_RE: RegExp;

fxy060608's avatar
fxy060608 已提交
304 305
export declare function plusReady(callback: () => void): void;

fxy060608's avatar
fxy060608 已提交
306 307
export declare const PRIMARY_COLOR = "#007aff";

fxy060608's avatar
fxy060608 已提交
308 309 310 311 312 313 314 315 316 317
/**
 * nodeId
 */
export declare type RemoveAction = [typeof ACTION_TYPE_REMOVE, number];

/**
 * nodeId
 * name
 */
export declare type RemoveAttributeAction = [
fxy060608's avatar
fxy060608 已提交
318 319 320
typeof ACTION_TYPE_REMOVE_ATTRIBUTE,
number,
string | number
fxy060608's avatar
fxy060608 已提交
321 322 323 324 325 326 327
];

/**
 * nodeId
 * event
 */
export declare type RemoveEventAction = [
fxy060608's avatar
fxy060608 已提交
328 329 330
typeof ACTION_TYPE_REMOVE_EVENT,
number,
string | number
fxy060608's avatar
fxy060608 已提交
331 332
];

fxy060608's avatar
fxy060608 已提交
333 334
export declare function removeLeadingSlash(str: string): string;

fxy060608's avatar
fxy060608 已提交
335 336
export declare const RESPONSIVE_MIN_WIDTH = 768;

fxy060608's avatar
fxy060608 已提交
337 338
export declare type Rpx2UnitOptions = typeof defaultRpx2Unit;

fxy060608's avatar
fxy060608 已提交
339 340
export declare const sanitise: (val: unknown) => any;

fxy060608's avatar
fxy060608 已提交
341 342
export declare const SCHEME_RE: RegExp;

fxy060608's avatar
fxy060608 已提交
343 344 345
declare function scrollTo_2(scrollTop: number | string, duration: number): void;
export { scrollTo_2 as scrollTo }

fxy060608's avatar
fxy060608 已提交
346 347
export declare const SELECTED_COLOR = "#0062cc";

fxy060608's avatar
fxy060608 已提交
348 349 350 351 352 353
/**
 * nodeId
 * name
 * value
 */
export declare type SetAttributeAction = [
fxy060608's avatar
fxy060608 已提交
354 355 356 357
typeof ACTION_TYPE_SET_ATTRIBUTE,
number,
string | number,
unknown | number
fxy060608's avatar
fxy060608 已提交
358 359 360 361 362 363
];

/**
 * nodeId
 * text
 */
fxy060608's avatar
fxy060608 已提交
364
export declare type SetTextAction = [
fxy060608's avatar
fxy060608 已提交
365 366 367
typeof ACTION_TYPE_SET_TEXT,
number,
string | number
fxy060608's avatar
fxy060608 已提交
368
];
fxy060608's avatar
fxy060608 已提交
369

fxy060608's avatar
fxy060608 已提交
370 371 372 373 374 375
export declare function stringifyQuery(obj?: Record<string, any>, encodeStr?: typeof encodeURIComponent): string;

export declare const TABBAR_HEIGHT = 50;

export declare const TAGS: string[];

fxy060608's avatar
fxy060608 已提交
376 377 378 379 380 381
export declare const UNI_SSR = "__uniSSR";

export declare const UNI_SSR_DATA = "data";

export declare const UNI_SSR_GLOBAL_DATA = "globalData";

fxy060608's avatar
fxy060608 已提交
382 383
export declare const UNI_SSR_STORE = "store";

fxy060608's avatar
fxy060608 已提交
384 385
export declare const UNI_SSR_TITLE = "title";

fxy060608's avatar
fxy060608 已提交
386 387
export declare class UniBaseNode extends UniNode {
    attributes: Record<string, unknown>;
fxy060608's avatar
fxy060608 已提交
388
    style: null | string | Record<string, string | string[]>;
fxy060608's avatar
fxy060608 已提交
389
    protected _html: string | null;
fxy060608's avatar
fxy060608 已提交
390
    constructor(nodeType: UniNodeType, nodeName: string, container: UniElement | IUniPageNode);
fxy060608's avatar
fxy060608 已提交
391 392 393 394 395 396 397 398 399
    get className(): string;
    set className(val: string);
    get innerHTML(): string;
    set innerHTML(html: string);
    addEventListener(type: string, listener: UniEventListener, options?: AddEventListenerOptions): void;
    removeEventListener(type: string, callback: UniEventListener, options?: EventListenerOptions): void;
    getAttribute(qualifiedName: string): unknown;
    removeAttribute(qualifiedName: string): void;
    setAttribute(qualifiedName: string, value: unknown): void;
fxy060608's avatar
fxy060608 已提交
400
    toJSON({ attr, normalize, }?: {
fxy060608's avatar
fxy060608 已提交
401 402
        attr?: boolean;
        children?: boolean;
fxy060608's avatar
fxy060608 已提交
403
        normalize?: (val: any, includeValue?: boolean) => any | number;
fxy060608's avatar
fxy060608 已提交
404
    }): Partial<UniNodeJSON>;
fxy060608's avatar
fxy060608 已提交
405 406 407
}

export declare class UniCommentNode extends UniNode {
fxy060608's avatar
fxy060608 已提交
408 409 410 411 412 413 414 415
    constructor(text: string, container: UniElement | IUniPageNode);
    toJSON(opts?: {
        attr?: boolean;
    }): {
        i?: undefined;
    } | {
        i: number;
    };
fxy060608's avatar
fxy060608 已提交
416 417 418 419 420 421
}

declare type UniCSSStyleDeclarationJSON = string | null | Record<string, string | string[]> | [string, Record<string, string | string[]>];

export declare class UniElement extends UniBaseNode {
    tagName: string;
fxy060608's avatar
fxy060608 已提交
422
    constructor(nodeName: string, container: UniElement | IUniPageNode);
fxy060608's avatar
fxy060608 已提交
423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440
}

export declare class UniEvent {
    type: string;
    bubbles: boolean;
    cancelable: boolean;
    defaultPrevented: boolean;
    timeStamp: number;
    _stop: boolean;
    _end: boolean;
    constructor(type: string, opts: UniEventOptions);
    preventDefault(): void;
    stopImmediatePropagation(): void;
    stopPropagation(): void;
}

export declare interface UniEventListener {
    (evt: UniEvent): void;
fxy060608's avatar
fxy060608 已提交
441
    modifiers?: string[];
fxy060608's avatar
fxy060608 已提交
442 443 444 445 446 447 448 449
}

declare interface UniEventOptions {
    bubbles: boolean;
    cancelable: boolean;
}

declare class UniEventTarget {
fxy060608's avatar
fxy060608 已提交
450
    listeners: Record<string, UniEventListener[]>;
fxy060608's avatar
fxy060608 已提交
451 452
    dispatchEvent(evt: UniEvent): boolean;
    addEventListener(type: string, listener: UniEventListener, options?: AddEventListenerOptions): void;
fxy060608's avatar
fxy060608 已提交
453
    removeEventListener(type: string, callback: UniEventListener, options?: AddEventListenerOptions): void;
fxy060608's avatar
fxy060608 已提交
454 455 456 457 458 459 460 461 462 463 464 465 466 467 468
}

export declare class UniInputElement extends UniElement {
    get value(): string | number;
    set value(val: string | number);
}

export declare class UniNode extends UniEventTarget {
    nodeId?: number;
    nodeType: UniNodeType;
    nodeName: string;
    childNodes: UniNode[];
    pageNode: IUniPageNode | null;
    parentNode: UniNode | null;
    protected _text: string | null;
fxy060608's avatar
fxy060608 已提交
469
    constructor(nodeType: UniNodeType, nodeName: string, container: UniElement | IUniPageNode);
fxy060608's avatar
fxy060608 已提交
470 471 472
    get firstChild(): UniNode | null;
    get lastChild(): UniNode | null;
    get nextSibling(): UniNode | null;
fxy060608's avatar
fxy060608 已提交
473 474
    get nodeValue(): string | null;
    set nodeValue(_val: string | null);
fxy060608's avatar
fxy060608 已提交
475 476 477 478
    get textContent(): string;
    set textContent(text: string);
    get parentElement(): UniElement | null;
    get previousSibling(): UniNode | null;
fxy060608's avatar
fxy060608 已提交
479
    appendChild(newChild: UniNode): UniNode;
fxy060608's avatar
fxy060608 已提交
480
    cloneNode(deep?: boolean): UniNode;
fxy060608's avatar
fxy060608 已提交
481 482
    insertBefore(newChild: UniNode, refChild: UniNode | null): UniNode;
    removeChild(oldChild: UniNode): UniNode;
fxy060608's avatar
fxy060608 已提交
483 484 485 486 487 488 489 490 491 492
}

export declare interface UniNodeJSON {
    /**
     * nodeId
     */
    i: number;
    /**
     * nodeName
     */
fxy060608's avatar
fxy060608 已提交
493
    n: string | number;
fxy060608's avatar
fxy060608 已提交
494 495 496 497
    /**
     * attributes
     */
    a: Record<string, unknown>;
fxy060608's avatar
fxy060608 已提交
498 499 500 501
    /**
     * listeners
     */
    e: Record<string, number>;
fxy060608's avatar
fxy060608 已提交
502 503 504
    /**
     * style
     */
fxy060608's avatar
fxy060608 已提交
505
    s?: UniCSSStyleDeclarationJSON;
fxy060608's avatar
fxy060608 已提交
506 507 508 509 510 511
    /**
     * text
     */
    t?: string;
}

fxy060608's avatar
fxy060608 已提交
512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538
declare interface UniNodeJSONMinify {
    /**
     * nodeId
     */
    i: number;
    /**
     * nodeName
     */
    n: string | number;
    /**
     * attributes
     */
    a: DictArray;
    /**
     * listeners
     */
    e: DictArray;
    /**
     * style
     */
    s?: DictArray;
    /**
     * text
     */
    t?: number;
}

fxy060608's avatar
fxy060608 已提交
539 540 541 542 543 544
declare type UniNodeType = typeof NODE_TYPE_PAGE | typeof NODE_TYPE_ELEMENT | typeof NODE_TYPE_TEXT | typeof NODE_TYPE_COMMENT;

export declare class UniTextAreaElement extends UniInputElement {
}

export declare class UniTextNode extends UniBaseNode {
fxy060608's avatar
fxy060608 已提交
545
    constructor(text: string, container: UniElement | IUniPageNode);
fxy060608's avatar
fxy060608 已提交
546 547 548 549
    get nodeValue(): string;
    set nodeValue(text: string);
}

fxy060608's avatar
fxy060608 已提交
550 551
export declare function updateElementStyle(element: HTMLElement, styles: Partial<CSSStyleDeclaration>): void;

fxy060608's avatar
fxy060608 已提交
552 553
export declare const WEB_INVOKE_APPSERVICE = "WEB_INVOKE_APPSERVICE";

fxy060608's avatar
fxy060608 已提交
554
export { }