حقل إدخال يتيح للمستخدمين إدخال وقت.
متاحة لإضافات Google Workspace وتطبيقات Google Chat
const dateTimePicker = CardService.newTimePicker() .setTitle('Enter the time.') .setFieldName('time_field') // Set default value as 3:30 AM. .setHours(3) .setMinutes(30) .setOnChangeAction( CardService.newAction().setFunctionName('handleDateTimeChange'), );
الطُرق
| الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
|---|---|---|
add | Widget | تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر. |
set | Time | تضبط هذه السمة اسم الحقل الذي يحدّد أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم. |
set | Time | تضبط هذه السمة قيمة الساعات التي تمّت تعبئتها مسبقًا والمطلوب ضبطها في حقل الإدخال. |
set | Widget | تضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها. |
set | Time | تضبط هذه السمة قيمة الدقائق التي تمّت تعبئتها مسبقًا والمطلوب ضبطها في حقل الإدخال. |
set | Time | يضبط هذا الخيار Action ينفّذه النص البرمجي كلما تغيّرت قيمة أداة الاختيار. |
set | Time | تضبط هذه السمة العنوان المعروض أعلى حقل الإدخال. |
set | Widget | تضبط هذه السمة مستوى ظهور الأداة. |
مستندات تفصيلية
add
تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
event | Event | تمثّل هذه السمة Event المطلوب إضافتها. |
الإرجاع
Widget — العنصر، للتسلسل.
set
تضبط هذه السمة اسم الحقل الذي يحدّد أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم. يظهر اسم الحقل للمستخدم. مطلوب، ويجب أن يكون اسم الحقل المحدّد فريدًا.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
field | String | اسم مصدر الإدخال هذا |
الإرجاع
Time: أداة الاختيار هذه مخصّصة لربط السلاسل.
set
تضبط هذه السمة قيمة الساعات التي تمّ ملؤها مسبقًا والمطلوب ضبطها في حقل الإدخال.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
hours | Integer | قيمة الساعة التلقائية التي يتم وضعها في حقل الإدخال، وتتراوح من 0 إلى 23. ويتم تمثيله دائمًا كسلسلة في مَعلمات معاودة الاتصال الخاصة بالنموذج. |
الإرجاع
Time: أداة الاختيار هذه مخصّصة لربط السلاسل.
set
تضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها. لا يمكن تعديل التطبيقات المصغّرة إلا في الإضافات.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
id | String | معرّف الأداة، ويجب ألا يتجاوز 64 حرفًا وأن يكون بالتنسيق `[a-zA-Z0-9-]+`. |
الإرجاع
Widget: هذا الكائن، للتسلسل
set
تضبط هذه السمة قيمة الدقائق التي تمّت تعبئتها مسبقًا والمطلوب ضبطها في حقل الإدخال.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
minutes | Integer | قيمة الدقائق التلقائية التي يتم وضعها في الإدخال، وتتراوح من 0 إلى 59 ويتم تمثيله دائمًا كسلسلة في مَعلمات معاودة الاتصال الخاصة بالنموذج. |
الإرجاع
Time: أداة الاختيار هذه مخصّصة لربط السلاسل.
set
يضبط هذا الخيار Action ينفّذه النص البرمجي كلما تغيّرت قيمة أداة الاختيار.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
action | Action | الإجراء المطلوب اتّخاذه |
الإرجاع
Time: أداة الاختيار هذه مخصّصة لربط السلاسل.
set
تضبط هذه السمة العنوان المعروض أعلى حقل الإدخال.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
title | String | تمثّل هذه السمة عنوان حقل الإدخال. |
الإرجاع
Time: أداة الاختيار هذه مخصّصة لربط السلاسل.
set
تضبط هذه السمة مستوى ظهور الأداة. القيمة التلقائية هي VISIBLE.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
visibility | Visibility | Visibility الأداة |
الإرجاع
Widget — العنصر، للتسلسل.