Class PickerBuilder

PickerBuilder משמש ליצירת אובייקטים מסוג Picker. למעט במקרים שבהם צוין אחרת, סוג ההחזרה של השיטות הבאות הוא מסוג PickerBuilder, ומאפשר לשרשר קריאה אחת אחרי השנייה.

דוגמאות

פיתוח Picker בסיסי באמצעות תבנית ה-builder.

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() בונים את אובייקט ה-Selecter.
disableFeature(feature) להשבית תכונה של בורר.
enableFeature(feature) מפעילים תכונה של בורר.
getRelayUrl() מאתרים את כתובת ה-URL של שרת הממסר, שמשמשת עבור sites.rpc.
getTitle() לקבל את הכותרת של תיבת הדו-שיח.
hideTitleBar() משביתים את הצגת סרגל הכותרת. כדי להפעיל מחדש, צריך להפעיל את הפונקציה setTitle עם שם לא ריק או את הפונקציה undefined.
isFeatureEnabled(feature) בודקים אם בורר Feature מופעל.
setAppId(appId) מגדיר את המזהה של האפליקציה שצריכה לגשת לקבצים של המשתמש דרך Drive API.
setCallback(method) מגדירים את שיטת הקריאה החוזרת. המערכת קוראת ל-method הזו כשהמשתמש בוחר פריטים או מבטל. שיטת הקריאה החוזרת מקבלת אובייקט קריאה חוזרת יחיד. המבנה של אובייקט ה-callback מתואר במדריך JSON.
setDeveloperKey(key) הגדרת מפתח Browser API שהתקבל מ-Google Developers Console. במדריך למפתחים מוסבר איך לקבל את מפתח ה-Browser API.
setDocument(document) מגדירים את המסמך.
setLocale(locale) מגדירים את האזור לבורר. האזור הוא קוד שפה לפי תקן ISO 639. אם השפה לא נתמכת, המערכת תשתמש ב-en-US.
setMaxItems(max) הגדרת המספר המקסימלי של פריטים שמשתמש יכול לבחור.
setOAuthToken(token) הגדרת אסימון OAuth לשימוש לאימות המשתמש הנוכחי.
setOrigin(origin) הגדרת המקור של תיבת הדו-שיח של הבורר. אם האפליקציה פועלת ב-iframe, יש להגדיר את המקור בתור window.location.protocol + '//' + window.location.host בדף העליון ביותר.
setRelayUrl(url) מגדירים את כתובת ה-URL של שרת הממסר, שמשמשת בגאדג'טים.rpc.
setSelectableMimeTypes(type) מגדירים את רשימת סוגי ה-MIME שאפשר יהיה לבחור. אם נדרשים יותר מסוג MIME אחד, צריך להפריד ביניהם באמצעות פסיקים. אם לא הגדרתם סוגי MIME, קבצים מכל סוגי MIME יוצגו בתצוגה.
setSize(width, height) מגדירים את הגודל המועדף של תיבת הדו-שיח. תיבת הדו-שיח תהיה ממוקמת במרכז באופן אוטומטי. הגודל המינימלי הוא (566,350) והגודל המקסימלי הוא (1051,650).
setTitle(title) מגדירים את כותרת תיבת הדו-שיח.
toUri() הפונקציה מחזירה את ה-URI שנוצר על ידי ה-builder הזה.