ui.Textbox.onChange
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک تماس برگشتی را ثبت می کند که هنگام تغییر متن در جعبه متن فراخوانی می شود.
به طور خاص، تماس برگشتی زمانی فراخوانی می شود که:
- کاربر یک مقدار جدید را تایپ می کند و سپس کادر متنی فوکوس خود را از دست می دهد یا کاربر enter را فشار می دهد.
- یک مقدار جدید به صورت برنامه ریزی شده با set('value', newValue) تنظیم می شود.
شناسه‌ای را برمی‌گرداند که می‌توان آن را به unlisten() برای لغو ثبت تماس برگشت داد.
| استفاده | برمی گرداند | Textbox. onChange (callback) | رشته |
| استدلال | تایپ کنید | جزئیات | این: ui.textbox | UI.Textbox | نمونه ui.Textbox. |
callback | تابع | زمانی که متن تغییر می‌کند، تماس پاسخ داده می‌شود. پاسخ تماس به متنی که در حال حاضر در جعبه متن و ویجت جعبه متن است ارسال می شود. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشی‌های سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبت‌شده Oracle و/یا شرکت‌های وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-24 به‌وقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-24 به‌وقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eTriggers a function when the textbox content is modified, either by user input or programmatically.\u003c/p\u003e\n"],["\u003cp\u003eThe registered function receives the current text and the textbox widget as arguments.\u003c/p\u003e\n"],["\u003cp\u003eProvides a method to unregister the function using a unique ID returned during registration.\u003c/p\u003e\n"],["\u003cp\u003eText change is triggered by user input (typing followed by focus loss or pressing Enter), or by programmatically setting a new value.\u003c/p\u003e\n"]]],[],null,["# ui.Textbox.onChange\n\n\u003cbr /\u003e\n\nRegisters a callback that's called when text in the textbox changes.\n\n\u003cbr /\u003e\n\nIn particular, the callback is called when:\n\n- The user types a new value and then either the textbox loses focus or the user presses enter.\n\n- A new value is set programmatically with set('value', newValue).\n\nReturns an ID which can be passed to unlisten() to unregister the callback.\n\n| Usage | Returns |\n|------------------------------|---------|\n| Textbox.onChange`(callback)` | String |\n\n| Argument | Type | Details |\n|--------------------|------------|------------------------------------------------------------------------------------------------------------------------------|\n| this: `ui.textbox` | ui.Textbox | The ui.Textbox instance. |\n| `callback` | Function | The callback to fire when the text changes. The callback is passed the text currently in the textbox and the textbox widget. |"]]
