docs(contacts): fix jsdoc
This commit is contained in:
parent
62241105c8
commit
7f24f89fc4
@ -1,12 +1,47 @@
|
|||||||
import { CordovaInstance, InstanceProperty, Plugin, getPromise, InstanceCheck, checkAvailability, CordovaCheck, IonicNativePlugin } from '@ionic-native/core';
|
import {
|
||||||
|
checkAvailability,
|
||||||
|
CordovaCheck,
|
||||||
|
CordovaInstance,
|
||||||
|
getPromise,
|
||||||
|
InstanceCheck,
|
||||||
|
InstanceProperty,
|
||||||
|
IonicNativePlugin,
|
||||||
|
Plugin
|
||||||
|
} from '@ionic-native/core';
|
||||||
|
|
||||||
declare const window: any,
|
declare const window: any, navigator: any;
|
||||||
navigator: any;
|
|
||||||
|
|
||||||
export type ContactFieldType = '*' | 'addresses' | 'birthday' | 'categories' | 'country' | 'department' | 'displayName' | 'emails' | 'name.familyName' | 'name.formatted' | 'name.givenName' | 'name.honorificPrefix' | 'name.honorificSuffix' | 'id' | 'ims' | 'locality' | 'name.middleName' | 'name' | 'nickname' | 'note' | 'organizations' | 'phoneNumbers' | 'photos' | 'postalCode' | 'region' | 'streetAddress' | 'title' | 'urls';
|
export type ContactFieldType =
|
||||||
|
| '*'
|
||||||
|
| 'addresses'
|
||||||
|
| 'birthday'
|
||||||
|
| 'categories'
|
||||||
|
| 'country'
|
||||||
|
| 'department'
|
||||||
|
| 'displayName'
|
||||||
|
| 'emails'
|
||||||
|
| 'name.familyName'
|
||||||
|
| 'name.formatted'
|
||||||
|
| 'name.givenName'
|
||||||
|
| 'name.honorificPrefix'
|
||||||
|
| 'name.honorificSuffix'
|
||||||
|
| 'id'
|
||||||
|
| 'ims'
|
||||||
|
| 'locality'
|
||||||
|
| 'name.middleName'
|
||||||
|
| 'name'
|
||||||
|
| 'nickname'
|
||||||
|
| 'note'
|
||||||
|
| 'organizations'
|
||||||
|
| 'phoneNumbers'
|
||||||
|
| 'photos'
|
||||||
|
| 'postalCode'
|
||||||
|
| 'region'
|
||||||
|
| 'streetAddress'
|
||||||
|
| 'title'
|
||||||
|
| 'urls';
|
||||||
|
|
||||||
export interface IContactProperties {
|
export interface IContactProperties {
|
||||||
|
|
||||||
/** A globally unique identifier. */
|
/** A globally unique identifier. */
|
||||||
id?: string;
|
id?: string;
|
||||||
|
|
||||||
@ -48,7 +83,6 @@ export interface IContactProperties {
|
|||||||
|
|
||||||
/** An array of web pages associated with the contact. */
|
/** An array of web pages associated with the contact. */
|
||||||
urls?: IContactField[];
|
urls?: IContactField[];
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -74,7 +108,9 @@ export class Contact implements IContactProperties {
|
|||||||
[key: string]: any;
|
[key: string]: any;
|
||||||
|
|
||||||
constructor() {
|
constructor() {
|
||||||
if (checkAvailability('navigator.contacts', 'create', 'Contacts') === true) {
|
if (
|
||||||
|
checkAvailability('navigator.contacts', 'create', 'Contacts') === true
|
||||||
|
) {
|
||||||
this._objectInstance = navigator.contacts.create();
|
this._objectInstance = navigator.contacts.create();
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@ -90,7 +126,9 @@ export class Contact implements IContactProperties {
|
|||||||
}
|
}
|
||||||
|
|
||||||
@CordovaInstance()
|
@CordovaInstance()
|
||||||
remove(): Promise<any> { return; }
|
remove(): Promise<any> {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
@InstanceCheck()
|
@InstanceCheck()
|
||||||
save(): Promise<any> {
|
save(): Promise<any> {
|
||||||
@ -124,7 +162,7 @@ export declare const ContactError: {
|
|||||||
PENDING_OPERATION_ERROR: number;
|
PENDING_OPERATION_ERROR: number;
|
||||||
IO_ERROR: number;
|
IO_ERROR: number;
|
||||||
NOT_SUPPORTED_ERROR: number;
|
NOT_SUPPORTED_ERROR: number;
|
||||||
PERMISSION_DENIED_ERROR: number
|
PERMISSION_DENIED_ERROR: number;
|
||||||
};
|
};
|
||||||
|
|
||||||
export interface IContactName {
|
export interface IContactName {
|
||||||
@ -146,12 +184,14 @@ export interface IContactName {
|
|||||||
* @hidden
|
* @hidden
|
||||||
*/
|
*/
|
||||||
export class ContactName implements IContactName {
|
export class ContactName implements IContactName {
|
||||||
constructor(public formatted?: string,
|
constructor(
|
||||||
|
public formatted?: string,
|
||||||
public familyName?: string,
|
public familyName?: string,
|
||||||
public givenName?: string,
|
public givenName?: string,
|
||||||
public middleName?: string,
|
public middleName?: string,
|
||||||
public honorificPrefix?: string,
|
public honorificPrefix?: string,
|
||||||
public honorificSuffix?: string) { }
|
public honorificSuffix?: string
|
||||||
|
) {}
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface IContactField {
|
export interface IContactField {
|
||||||
@ -167,9 +207,11 @@ export interface IContactField {
|
|||||||
* @hidden
|
* @hidden
|
||||||
*/
|
*/
|
||||||
export class ContactField implements IContactField {
|
export class ContactField implements IContactField {
|
||||||
constructor(public type?: string,
|
constructor(
|
||||||
|
public type?: string,
|
||||||
public value?: string,
|
public value?: string,
|
||||||
public pref?: boolean) { }
|
public pref?: boolean
|
||||||
|
) {}
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface IContactAddress {
|
export interface IContactAddress {
|
||||||
@ -195,14 +237,16 @@ export interface IContactAddress {
|
|||||||
* @hidden
|
* @hidden
|
||||||
*/
|
*/
|
||||||
export class ContactAddress implements IContactAddress {
|
export class ContactAddress implements IContactAddress {
|
||||||
constructor(public pref?: boolean,
|
constructor(
|
||||||
|
public pref?: boolean,
|
||||||
public type?: string,
|
public type?: string,
|
||||||
public formatted?: string,
|
public formatted?: string,
|
||||||
public streetAddress?: string,
|
public streetAddress?: string,
|
||||||
public locality?: string,
|
public locality?: string,
|
||||||
public region?: string,
|
public region?: string,
|
||||||
public postalCode?: string,
|
public postalCode?: string,
|
||||||
public country?: string) { }
|
public country?: string
|
||||||
|
) {}
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface IContactOrganization {
|
export interface IContactOrganization {
|
||||||
@ -228,7 +272,7 @@ export class ContactOrganization implements IContactOrganization {
|
|||||||
public department?: string,
|
public department?: string,
|
||||||
public title?: string,
|
public title?: string,
|
||||||
public pref?: boolean
|
public pref?: boolean
|
||||||
) { }
|
) {}
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Search options to filter navigator.contacts. */
|
/** Search options to filter navigator.contacts. */
|
||||||
@ -249,10 +293,12 @@ export interface IContactFindOptions {
|
|||||||
* @hidden
|
* @hidden
|
||||||
*/
|
*/
|
||||||
export class ContactFindOptions implements IContactFindOptions {
|
export class ContactFindOptions implements IContactFindOptions {
|
||||||
constructor(public filter?: string,
|
constructor(
|
||||||
|
public filter?: string,
|
||||||
public multiple?: boolean,
|
public multiple?: boolean,
|
||||||
public desiredFields?: string[],
|
public desiredFields?: string[],
|
||||||
public hasPhoneNumber?: boolean) { }
|
public hasPhoneNumber?: boolean
|
||||||
|
) {}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -293,10 +339,19 @@ export class ContactFindOptions implements IContactFindOptions {
|
|||||||
plugin: 'cordova-plugin-contacts',
|
plugin: 'cordova-plugin-contacts',
|
||||||
pluginRef: 'navigator.contacts',
|
pluginRef: 'navigator.contacts',
|
||||||
repo: 'https://github.com/apache/cordova-plugin-contacts',
|
repo: 'https://github.com/apache/cordova-plugin-contacts',
|
||||||
platforms: ['Android', 'BlackBerry 10', 'Browser', 'Firefox OS', 'iOS', 'Ubuntu', 'Windows', 'Windows 8', 'Windows Phone']
|
platforms: [
|
||||||
|
'Android',
|
||||||
|
'BlackBerry 10',
|
||||||
|
'Browser',
|
||||||
|
'Firefox OS',
|
||||||
|
'iOS',
|
||||||
|
'Ubuntu',
|
||||||
|
'Windows',
|
||||||
|
'Windows 8',
|
||||||
|
'Windows Phone'
|
||||||
|
]
|
||||||
})
|
})
|
||||||
export class Contacts extends IonicNativePlugin {
|
export class Contacts extends IonicNativePlugin {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Create a single contact.
|
* Create a single contact.
|
||||||
* @returns {Contact} Returns a Contact object
|
* @returns {Contact} Returns a Contact object
|
||||||
@ -307,16 +362,24 @@ export class Contacts extends IonicNativePlugin {
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* Search for contacts in the Contacts list.
|
* Search for contacts in the Contacts list.
|
||||||
* @param fields {ContactFieldType[]} Contact fields to be used as a search qualifier
|
* @param {ContactFieldType[]} fields Contact fields to be used as a search qualifier
|
||||||
* @param options {IContactFindOptions} Optional options for the query
|
* @param {IContactFindOptions} [options] Optional options for the query
|
||||||
* @returns {Promise<Contact[]>} Returns a Promise that resolves with the search results (an array of Contact objects)
|
* @returns {Promise<Contact[]>} Returns a Promise that resolves with the search results (an array of Contact objects)
|
||||||
*/
|
*/
|
||||||
@CordovaCheck()
|
@CordovaCheck()
|
||||||
find(fields: ContactFieldType[], options?: IContactFindOptions): Promise<Contact[]> {
|
find(
|
||||||
|
fields: ContactFieldType[],
|
||||||
|
options?: IContactFindOptions
|
||||||
|
): Promise<Contact[]> {
|
||||||
return getPromise((resolve: Function, reject: Function) => {
|
return getPromise((resolve: Function, reject: Function) => {
|
||||||
navigator.contacts.find(fields, (contacts: any[]) => {
|
navigator.contacts.find(
|
||||||
|
fields,
|
||||||
|
(contacts: any[]) => {
|
||||||
resolve(contacts.map(processContact));
|
resolve(contacts.map(processContact));
|
||||||
}, reject, options);
|
},
|
||||||
|
reject,
|
||||||
|
options
|
||||||
|
);
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -327,10 +390,12 @@ export class Contacts extends IonicNativePlugin {
|
|||||||
@CordovaCheck()
|
@CordovaCheck()
|
||||||
pickContact(): Promise<Contact> {
|
pickContact(): Promise<Contact> {
|
||||||
return getPromise((resolve: Function, reject: Function) => {
|
return getPromise((resolve: Function, reject: Function) => {
|
||||||
navigator.contacts.pickContact((contact: any) => resolve(processContact(contact)), reject);
|
navigator.contacts.pickContact(
|
||||||
|
(contact: any) => resolve(processContact(contact)),
|
||||||
|
reject
|
||||||
|
);
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
Loading…
Reference in New Issue
Block a user