gapi.cloudsearch.widget.searchbox.Builder
הכלי ליצירת תיבת חיפוש. משתמשים ב-builder ולא קוראים ישירות ל-constructor של תיבת החיפוש.
יצרן
בנאי
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 |
אפשר לשנות את ברירת המחדל של חלק מהשיטות. הערך לא יכול להיות 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
זה