تُستخدَم 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. راجِع دليل المطوّر للحصول على تفاصيل حول كيفية الحصول على مفتاح واجهة برمجة تطبيقات المتصفّح. |
setDocument(document) |
اضبط المستند. |
setLocale(locale) |
اضبط لغة أداة الاختيار. اللغة هي رمز لغة وفقًا لمعيار ISO 639. إذا لم تكن اللغة متاحة، يتم استخدام en-US. |
setMaxItems(max) |
لضبط الحد الأقصى لعدد العناصر التي يمكن للمستخدم اختيارها |
setOAuthToken(token) |
تُستخدَم لضبط رمز مميّز لبروتوكول OAuth من أجل مصادقة المستخدم الحالي. |
setOrigin(origin) |
لضبط مصدر مربّع حوار المنتقي. يجب ضبط المصدر على window.location.protocol + '//' + window.location.host للصفحة العلوية، إذا كان تطبيقك يعمل في إطار iframe. |
setRelayUrl(url) |
ضبط عنوان URL الخاص بالإرسال، والذي يتم استخدامه لـ tool.rpc. |
setSelectableMimeTypes(type) |
يمكنك ضبط قائمة أنواع MIME التي ستكون قابلة للاختيار. استخدِم الفواصل للفصل بين أنواع MIME إذا كان هناك أكثر من نوع مطلوب. إذا لم يتم تحديد أنواع MIME، فسيتم عرض ملفات من جميع أنواع MIME في طريقة العرض. |
setSize(width, height) |
اضبط حجم مربّع الحوار المفضّل. سيتم وضع مربّع الحوار في المنتصف تلقائيًا. الحد الأدنى لحجمها هو (566,350) والحد الأقصى هو (1051,650). |
setTitle(title) |
اضبط عنوان مربّع الحوار. |
toUri() |
تعرِض هذه السمة معرّف الموارد المنتظم الذي أنشأه هذا المنشئ. |