يتم استخدام PickerBuilder لإنشاء عناصر Picker. ما لم يُذكر خلاف ذلك، يكون نوع الإرجاع للطرق أدناه هو PickerBuilder، ما يتيح لك ربط طلب بآخر.
أمثلة
أنشئ Picker أساسيًا باستخدام نمط الإنشاء.
const picker = new google.pickerPickerBuilder()
.setOAuthToken('TOKEN_FOR_USER')
.setAppId('1234567890') // Cloud Project number
.addView(google.picker.ViewId.DOCS)
.setCallback((data) => {
console.log(data);
})
.build();
التوقيع
export class PickerBuilder
التفاصيل
| النهائي | لا |
|---|
الطُرق
| الاسم | الوصف |
|---|---|
addView(viewOrViewId) |
إضافة طريقة عرض إلى جزء التنقّل |
addViewGroup(viewGroup) |
أضِف ViewGroup إلى لوحة التنقّل ذات المستوى الأعلى. |
build() |
أنشئ عنصر Picker. |
disableFeature(feature) |
إيقاف ميزة في أداة الاختيار |
enableFeature(feature) |
تفعيل ميزة أداة اختيار |
getRelayUrl() |
احصل على عنوان URL الخاص بخدمة الترحيل، والذي يُستخدم في gadgets.rpc. |
getTitle() |
الحصول على عنوان مربّع الحوار |
hideTitleBar() |
إيقاف عرض شريط العناوين لإعادة التفعيل، استخدِم setTitle مع عنوان غير فارغ أو undefined. |
isFeatureEnabled(feature) |
تحقَّق ممّا إذا كان أداة اختيار Feature مفعّلة. |
setAppId(appId) |
تضبط هذه السمة معرّف التطبيق الذي يحتاج إلى الوصول إلى ملفات المستخدم من خلال Drive API. |
setCallback(method) |
اضبط طريقة رد الاتصال. يتم استدعاء هذا الإجراء عندما يختار المستخدم عناصر أو يلغي العملية. تتلقّى طريقة رد الاتصال عنصر رد اتصال واحدًا. يمكن الاطّلاع على بنية عنصر معاودة الاتصال في دليل JSON. |
setDeveloperKey(key) |
تضبط هذه السمة مفتاح Browser API الذي تم الحصول عليه من Google Developers Console. راجِع دليل المطوّر لمعرفة تفاصيل حول كيفية الحصول على مفتاح Browser API. |
setDocument(document) |
اضبط المستند. |
setLocale(locale) |
اضبط اللغة الخاصة بأداة الاختيار. اللغة هي رمز لغة وفق معيار ISO 639. إذا كانت اللغة غير متاحة، يتم استخدام اللغة الإنجليزية (الولايات المتحدة). |
setMaxItems(max) |
تضبط هذه السمة الحد الأقصى لعدد العناصر التي يمكن للمستخدم اختيارها. |
setOAuthToken(token) |
تضبط هذه السمة رمزًا مميزًا لبروتوكول OAuth لاستخدامه في مصادقة المستخدم الحالي. |
setOrigin(origin) |
تضبط هذه السمة مصدر مربّع حوار أداة الاختيار. يجب ضبط المصدر على window.location.protocol + '//' + window.location.host لأعلى صفحة، إذا كان تطبيقك يعمل في إطار iframe. |
setRelayUrl(url) |
اضبط عنوان URL الخاص بالإرسال، والذي يُستخدم في gadgets.rpc. |
setSelectableMimeTypes(type) |
اضبط قائمة أنواع MIME التي يمكن اختيارها. استخدِم الفواصل للفصل بين أنواع MIME إذا كان مطلوبًا أكثر من نوع واحد. في حال عدم ضبط أنواع MIME، سيتم عرض الملفات من جميع أنواع MIME في طريقة العرض. |
setSize(width, height) |
اضبط حجم مربّع الحوار المفضّل. سيتم توسيط مربّع الحوار تلقائيًا. يبلغ الحد الأدنى لحجمها (566,350) والحد الأقصى لحجمها (1051,650). |
setTitle(title) |
اضبط عنوان مربع الحوار. |
toUri() |
تعرض هذه الدالة معرّف الموارد المنتظم (URI) الذي أنشأته أداة الإنشاء هذه. |