מחלקה: בונה

יצרן

בנאי

new Builder()

דוגמה

// Builds a search box.
function onload() {
  gapi.client.init({
    'apiKey': '<your api key>',
    'clientId': '<your client id>',
    // Add additional scopes if needed
    'scope': 'https://www.googleapis.com/auth/cloud_search.query',
    'hosted_domain': '<your G Suite domain>',
  });

  const searchBox = new gapi.cloudsearch.widget.searchbox.Builder()
    .setInput(document.getElementById('input'))
    .setAnchor(document.getElementById('input').parentElement)
    .build();
}
gapi.load('client:cloudsearch-widget', onload);

Methods

לבנות גרסת build

הפונקציה build() מחזירה SearchBox

החזרות

non-null SearchBox 

setAdapter

הפונקציה setAdapter(adapter) מחזירה Builder

נדרש. המתאם הזה מאפשר להתאים אישית את חוויית החיפוש של המשתמשים.

פרמטר

adapter

SearchBoxAdapter

אפשר לשנות את ברירת המחדל של חלק מהשיטות.

הערך לא יכול להיות null.

החזרות

non-null Builder זה

דוגמה

const adapter = {
 interceptSuggestRequest: function(request) {
    // Change the request
  }
}

builder.setAdapter(adapter).build();

setAnchor

הפונקציה setAnchor(anchor) מחזירה Builder

נדרש. חייב להיות HTMLElement תקין שיכול להכיל צמתים צאצאים. עוגן של שכבת-העל של החיפוש. שכבת-העל מתווספת בתור הצאצא האחרון ב-anchor. מיקום שכבת-העל הוא בתחתית העוגן.

פרמטר

עוגן

HTMLElement

הערך לא יכול להיות null.

הוצא משימוש
שימוש ב-setAnchorElement במקום זאת
החזרות

non-null Builder זה

setAnchorElement

הפונקציה setAnchorElement(anchorElement) מחזירה Builder

נדרש. חייב להיות HTMLElement תקין שיכול להכיל צמתים צאצאים. עוגן של שכבת-העל של החיפוש. שכבת-העל מתווספת בתור הצאצא האחרון ב-anchor. מיקום שכבת-העל הוא בתחתית העוגן.

פרמטר

anchorElement

HTMLElement

הערך לא יכול להיות null.

החזרות

non-null Builder זה

setHints

הפונקציה setHints(hints) מחזירה Builder

אופציונלי. הטיפים בתיבת החיפוש כשהקלט ריק. כשהקלט ריק, המערכת בוחרת רמז אקראי מהמערך.

פרמטר

רמזים

מערך מחרוזות

הערך לא יכול להיות null.

החזרות

non-null Builder זה

setInput

הפונקציה setInput(input) מחזירה Builder

נדרש. HTMLElement שבו המשתמש מזין את השאילתה. חייב להיות <input> או <textarea>

פרמטר

קלט

HTMLElement

הערך לא יכול להיות null.

הוצא משימוש
שימוש ב-setInputElement במקום זאת
החזרות

non-null Builder זה

setInputElement

הפונקציה setInputElement(inputElement) מחזירה Builder

נדרש. HTMLElement שבו המשתמש מזין את השאילתה. חייב להיות <input> או <textarea>

פרמטר

inputElement

HTMLElement

הערך לא יכול להיות null.

החזרות

non-null Builder זה

setResultsContainer

הפונקציה setResultsContainer(resultsContainer) מחזירה Builder

אופציונלי. מאגר להצגת תוצאות חיפוש. אם ההגדרה מוגדרת, התוצאות ייראו בקונטיינר של תוצאות החיפוש. אם לא תגדירו את ההגדרה הזו, התוצאות יוצגו בכתובת cloudsearch.google.com.

פרמטר

resultsContainer

gapi.cloudsearch.widget.resultscontainer.ResultsContainer

הערך לא יכול להיות null.

ראה גם
ResultsContainer
החזרות

non-null Builder זה

setSearchApplicationId

הפונקציה setSearchApplicationId(searchApplicationId) מחזירה Builder

אופציונלי. מגדיר את מזהה אפליקציית החיפוש שישמש לבקשות. התחילית של השם צריכה להיות 'searchapplications/‎'.

פרמטר

searchApplicationId

מחרוזת

החזרות

non-null Builder זה

setThrottleInterval

הפונקציה setThrottleInterval(throttleInterval) מחזירה Builder

אופציונלי. מרווח הזמן של המצערת באלפיניות השנייה בזמן שליחת הבקשה. תיבת החיפוש שולחת פחות מבקשה אחת בכל אלפיות השנייה של throttleInterval. אם הערך של throttleInternal קטן מ-200, תיבת החיפוש תתעלם מהערך ותשתמש ב-200 בתור מרווח הזמן במקום זאת.

פרמטר

throttleInterval

number

החזרות

non-null Builder זה