/** * @file lv_ta.c * */ /********************* * INCLUDES *********************/ #include "lv_textarea.h" #if LV_USE_TEXTAREA != 0 #include #include "../misc/lv_assert.h" #include "../core/lv_group.h" #include "../core/lv_refr.h" #include "../core/lv_indev.h" #include "../draw/lv_draw.h" #include "../misc/lv_anim.h" #include "../misc/lv_txt.h" #include "../misc/lv_math.h" /********************* * DEFINES *********************/ #define MY_CLASS &lv_textarea_class /*Test configuration*/ #ifndef LV_TEXTAREA_DEF_CURSOR_BLINK_TIME #define LV_TEXTAREA_DEF_CURSOR_BLINK_TIME 400 /*ms*/ #endif #ifndef LV_TEXTAREA_DEF_PWD_SHOW_TIME #define LV_TEXTAREA_DEF_PWD_SHOW_TIME 1500 /*ms*/ #endif #define LV_TEXTAREA_PWD_BULLET_UNICODE 0x2022 #define IGNORE_KERNING '\0' /********************** * TYPEDEFS **********************/ /********************** * STATIC PROTOTYPES **********************/ static void lv_textarea_constructor(const lv_obj_class_t * class_p, lv_obj_t * obj); static void lv_textarea_destructor(const lv_obj_class_t * class_p, lv_obj_t * obj); static void lv_textarea_event(const lv_obj_class_t * class_p, lv_event_t * e); static void label_event_cb(lv_event_t * e); static void cursor_blink_anim_cb(void * obj, int32_t show); static void pwd_char_hider_anim(void * obj, int32_t x); static void pwd_char_hider_anim_ready(lv_anim_t * a); static void pwd_char_hider(lv_obj_t * obj); static bool char_is_accepted(lv_obj_t * obj, uint32_t c); static void start_cursor_blink(lv_obj_t * obj); static void refr_cursor_area(lv_obj_t * obj); static void update_cursor_position_on_click(lv_event_t * e); static lv_res_t insert_handler(lv_obj_t * obj, const char * txt); static void draw_placeholder(lv_event_t * e); static void draw_cursor(lv_event_t * e); static void auto_hide_characters(lv_obj_t * obj); static inline bool is_valid_but_non_printable_char(const uint32_t letter); /********************** * STATIC VARIABLES **********************/ const lv_obj_class_t lv_textarea_class = { .constructor_cb = lv_textarea_constructor, .destructor_cb = lv_textarea_destructor, .event_cb = lv_textarea_event, .group_def = LV_OBJ_CLASS_GROUP_DEF_TRUE, .width_def = LV_DPI_DEF * 2, .height_def = LV_DPI_DEF, .instance_size = sizeof(lv_textarea_t), .base_class = &lv_obj_class }; static const char * ta_insert_replace; /********************** * MACROS **********************/ /********************** * GLOBAL FUNCTIONS **********************/ lv_obj_t * lv_textarea_create(lv_obj_t * parent) { LV_LOG_INFO("begin"); lv_obj_t * obj = lv_obj_class_create_obj(MY_CLASS, parent); lv_obj_class_init_obj(obj); return obj; } /*====================== * Add/remove functions *=====================*/ void lv_textarea_add_char(lv_obj_t * obj, uint32_t c) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; if(ta->one_line && (c == '\n' || c == '\r')) { LV_LOG_INFO("Text area: line break ignored in one-line mode"); return; } uint32_t u32_buf[2]; u32_buf[0] = c; u32_buf[1] = 0; const char * letter_buf = (char *)&u32_buf; #if LV_BIG_ENDIAN_SYSTEM if(c != 0) while(*letter_buf == 0) ++letter_buf; #endif lv_res_t res = insert_handler(obj, letter_buf); if(res != LV_RES_OK) return; uint32_t c_uni = _lv_txt_encoded_next((const char *)&c, NULL); if(char_is_accepted(obj, c_uni) == false) { LV_LOG_INFO("Character is not accepted by the text area (too long text or not in the accepted list)"); return; } if(ta->pwd_mode) pwd_char_hider(obj); /*Make sure all the current text contains only '*'*/ /*If the textarea is empty, invalidate it to hide the placeholder*/ if(ta->placeholder_txt) { const char * txt = lv_label_get_text(ta->label); if(txt[0] == '\0') lv_obj_invalidate(obj); } lv_label_ins_text(ta->label, ta->cursor.pos, letter_buf); /*Insert the character*/ lv_textarea_clear_selection(obj); /*Clear selection*/ if(ta->pwd_mode) { /*+2: the new char + \0*/ size_t realloc_size = strlen(ta->pwd_tmp) + strlen(letter_buf) + 1; ta->pwd_tmp = lv_mem_realloc(ta->pwd_tmp, realloc_size); LV_ASSERT_MALLOC(ta->pwd_tmp); if(ta->pwd_tmp == NULL) return; _lv_txt_ins(ta->pwd_tmp, ta->cursor.pos, (const char *)letter_buf); /*Auto hide characters*/ auto_hide_characters(obj); } /*Move the cursor after the new character*/ lv_textarea_set_cursor_pos(obj, lv_textarea_get_cursor_pos(obj) + 1); lv_event_send(obj, LV_EVENT_VALUE_CHANGED, NULL); } void lv_textarea_add_text(lv_obj_t * obj, const char * txt) { LV_ASSERT_OBJ(obj, MY_CLASS); LV_ASSERT_NULL(txt); lv_textarea_t * ta = (lv_textarea_t *)obj; if(ta->pwd_mode) pwd_char_hider(obj); /*Make sure all the current text contains only '*'*/ /*Add the character one-by-one if not all characters are accepted or there is character limit.*/ if(lv_textarea_get_accepted_chars(obj) || lv_textarea_get_max_length(obj)) { uint32_t i = 0; while(txt[i] != '\0') { uint32_t c = _lv_txt_encoded_next(txt, &i); lv_textarea_add_char(obj, _lv_txt_unicode_to_encoded(c)); } return; } lv_res_t res = insert_handler(obj, txt); if(res != LV_RES_OK) return; /*If the textarea is empty, invalidate it to hide the placeholder*/ if(ta->placeholder_txt) { const char * txt_act = lv_label_get_text(ta->label); if(txt_act[0] == '\0') lv_obj_invalidate(obj); } /*Insert the text*/ lv_label_ins_text(ta->label, ta->cursor.pos, txt); lv_textarea_clear_selection(obj); if(ta->pwd_mode) { size_t realloc_size = strlen(ta->pwd_tmp) + strlen(txt) + 1; ta->pwd_tmp = lv_mem_realloc(ta->pwd_tmp, realloc_size); LV_ASSERT_MALLOC(ta->pwd_tmp); if(ta->pwd_tmp == NULL) return; _lv_txt_ins(ta->pwd_tmp, ta->cursor.pos, txt); /*Auto hide characters*/ auto_hide_characters(obj); } /*Move the cursor after the new text*/ lv_textarea_set_cursor_pos(obj, lv_textarea_get_cursor_pos(obj) + _lv_txt_get_encoded_length(txt)); lv_event_send(obj, LV_EVENT_VALUE_CHANGED, NULL); } void lv_textarea_del_char(lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; uint32_t cur_pos = ta->cursor.pos; if(cur_pos == 0) return; char del_buf[2] = {LV_KEY_DEL, '\0'}; lv_res_t res = insert_handler(obj, del_buf); if(res != LV_RES_OK) return; char * label_txt = lv_label_get_text(ta->label); /*Delete a character*/ _lv_txt_cut(label_txt, ta->cursor.pos - 1, 1); /*Refresh the label*/ lv_label_set_text(ta->label, label_txt); lv_textarea_clear_selection(obj); /*If the textarea became empty, invalidate it to hide the placeholder*/ if(ta->placeholder_txt) { const char * txt = lv_label_get_text(ta->label); if(txt[0] == '\0') lv_obj_invalidate(obj); } if(ta->pwd_mode) { _lv_txt_cut(ta->pwd_tmp, ta->cursor.pos - 1, 1); ta->pwd_tmp = lv_mem_realloc(ta->pwd_tmp, strlen(ta->pwd_tmp) + 1); LV_ASSERT_MALLOC(ta->pwd_tmp); if(ta->pwd_tmp == NULL) return; } /*Move the cursor to the place of the deleted character*/ lv_textarea_set_cursor_pos(obj, ta->cursor.pos - 1); lv_event_send(obj, LV_EVENT_VALUE_CHANGED, NULL); } void lv_textarea_del_char_forward(lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); uint32_t cp = lv_textarea_get_cursor_pos(obj); lv_textarea_set_cursor_pos(obj, cp + 1); if(cp != lv_textarea_get_cursor_pos(obj)) lv_textarea_del_char(obj); } /*===================== * Setter functions *====================*/ void lv_textarea_set_text(lv_obj_t * obj, const char * txt) { LV_ASSERT_OBJ(obj, MY_CLASS); LV_ASSERT_NULL(txt); lv_textarea_t * ta = (lv_textarea_t *)obj; /*Clear the existing selection*/ lv_textarea_clear_selection(obj); /*Add the character one-by-one if not all characters are accepted or there is character limit.*/ if(lv_textarea_get_accepted_chars(obj) || lv_textarea_get_max_length(obj)) { lv_label_set_text(ta->label, ""); lv_textarea_set_cursor_pos(obj, LV_TEXTAREA_CURSOR_LAST); if(ta->pwd_mode) { ta->pwd_tmp[0] = '\0'; /*Clear the password too*/ } uint32_t i = 0; while(txt[i] != '\0') { uint32_t c = _lv_txt_encoded_next(txt, &i); lv_textarea_add_char(obj, _lv_txt_unicode_to_encoded(c)); } } else { lv_label_set_text(ta->label, txt); lv_textarea_set_cursor_pos(obj, LV_TEXTAREA_CURSOR_LAST); } /*If the textarea is empty, invalidate it to hide the placeholder*/ if(ta->placeholder_txt) { const char * txt_act = lv_label_get_text(ta->label); if(txt_act[0] == '\0') lv_obj_invalidate(obj); } if(ta->pwd_mode) { ta->pwd_tmp = lv_mem_realloc(ta->pwd_tmp, strlen(txt) + 1); LV_ASSERT_MALLOC(ta->pwd_tmp); if(ta->pwd_tmp == NULL) return; strcpy(ta->pwd_tmp, txt); /*Auto hide characters*/ auto_hide_characters(obj); } lv_event_send(obj, LV_EVENT_VALUE_CHANGED, NULL); } void lv_textarea_set_placeholder_text(lv_obj_t * obj, const char * txt) { LV_ASSERT_OBJ(obj, MY_CLASS); LV_ASSERT_NULL(txt); lv_textarea_t * ta = (lv_textarea_t *)obj; size_t txt_len = strlen(txt); if((txt_len == 0) && (ta->placeholder_txt)) { lv_mem_free(ta->placeholder_txt); ta->placeholder_txt = NULL; } else { /*Allocate memory for the placeholder_txt text*/ /*NOTE: Using special realloc behavior, malloc-like when data_p is NULL*/ ta->placeholder_txt = lv_mem_realloc(ta->placeholder_txt, txt_len + 1); LV_ASSERT_MALLOC(ta->placeholder_txt); if(ta->placeholder_txt == NULL) { LV_LOG_ERROR("lv_textarea_set_placeholder_text: couldn't allocate memory for placeholder"); return; } strcpy(ta->placeholder_txt, txt); ta->placeholder_txt[txt_len] = '\0'; } lv_obj_invalidate(obj); } void lv_textarea_set_cursor_pos(lv_obj_t * obj, int32_t pos) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; if((uint32_t)ta->cursor.pos == (uint32_t)pos) return; uint32_t len = _lv_txt_get_encoded_length(lv_label_get_text(ta->label)); if(pos < 0) pos = len + pos; if(pos > (int32_t)len || pos == LV_TEXTAREA_CURSOR_LAST) pos = len; ta->cursor.pos = pos; /*Position the label to make the cursor visible*/ lv_obj_update_layout(obj); lv_point_t cur_pos; const lv_font_t * font = lv_obj_get_style_text_font(obj, LV_PART_MAIN); lv_label_get_letter_pos(ta->label, pos, &cur_pos); /*The text area needs to have it's final size to see if the cursor is out of the area or not*/ /*Check the top*/ lv_coord_t font_h = lv_font_get_line_height(font); if(cur_pos.y < lv_obj_get_scroll_top(obj)) { lv_obj_scroll_to_y(obj, cur_pos.y, LV_ANIM_ON); } /*Check the bottom*/ lv_coord_t h = lv_obj_get_content_height(obj); if(cur_pos.y + font_h - lv_obj_get_scroll_top(obj) > h) { lv_obj_scroll_to_y(obj, cur_pos.y - h + font_h, LV_ANIM_ON); } /*Check the left*/ if(cur_pos.x < lv_obj_get_scroll_left(obj)) { lv_obj_scroll_to_x(obj, cur_pos.x, LV_ANIM_ON); } /*Check the right*/ lv_coord_t w = lv_obj_get_content_width(obj); if(cur_pos.x + font_h - lv_obj_get_scroll_left(obj) > w) { lv_obj_scroll_to_x(obj, cur_pos.x - w + font_h, LV_ANIM_ON); } ta->cursor.valid_x = cur_pos.x; start_cursor_blink(obj); refr_cursor_area(obj); } void lv_textarea_set_cursor_click_pos(lv_obj_t * obj, bool en) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; ta->cursor.click_pos = en ? 1U : 0U; } void lv_textarea_set_password_mode(lv_obj_t * obj, bool en) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; if(ta->pwd_mode == en) return; ta->pwd_mode = en ? 1U : 0U; /*Pwd mode is now enabled*/ if(en) { char * txt = lv_label_get_text(ta->label); size_t len = strlen(txt); ta->pwd_tmp = lv_mem_alloc(len + 1); LV_ASSERT_MALLOC(ta->pwd_tmp); if(ta->pwd_tmp == NULL) return; strcpy(ta->pwd_tmp, txt); pwd_char_hider(obj); lv_textarea_clear_selection(obj); } /*Pwd mode is now disabled*/ else { lv_textarea_clear_selection(obj); lv_label_set_text(ta->label, ta->pwd_tmp); lv_mem_free(ta->pwd_tmp); ta->pwd_tmp = NULL; } refr_cursor_area(obj); } void lv_textarea_set_password_bullet(lv_obj_t * obj, const char * bullet) { LV_ASSERT_OBJ(obj, MY_CLASS); LV_ASSERT_NULL(bullet); lv_textarea_t * ta = (lv_textarea_t *)obj; if(!bullet && (ta->pwd_bullet)) { lv_mem_free(ta->pwd_bullet); ta->pwd_bullet = NULL; } else { size_t txt_len = strlen(bullet); /*Allocate memory for the pwd_bullet text*/ /*NOTE: Using special realloc behavior, malloc-like when data_p is NULL*/ ta->pwd_bullet = lv_mem_realloc(ta->pwd_bullet, txt_len + 1); LV_ASSERT_MALLOC(ta->pwd_bullet); if(ta->pwd_bullet == NULL) { LV_LOG_ERROR("lv_textarea_set_password_bullet: couldn't allocate memory for bullet"); return; } strcpy(ta->pwd_bullet, bullet); ta->pwd_bullet[txt_len] = '\0'; } lv_obj_invalidate(obj); } void lv_textarea_set_one_line(lv_obj_t * obj, bool en) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; if(ta->one_line == en) return; ta->one_line = en ? 1U : 0U; lv_coord_t width = en ? LV_SIZE_CONTENT : lv_pct(100); lv_coord_t min_width_value = en ? lv_pct(100) : 0; lv_obj_set_width(ta->label, width); lv_obj_set_style_min_width(ta->label, min_width_value, 0); if(en) { lv_obj_set_height(obj, LV_SIZE_CONTENT); } else { lv_obj_remove_local_style_prop(obj, LV_STYLE_HEIGHT, LV_PART_MAIN); } lv_obj_scroll_to(obj, 0, 0, LV_ANIM_OFF); } void lv_textarea_set_accepted_chars(lv_obj_t * obj, const char * list) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; ta->accepted_chars = list; } void lv_textarea_set_max_length(lv_obj_t * obj, uint32_t num) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; ta->max_length = num; } void lv_textarea_set_insert_replace(lv_obj_t * obj, const char * txt) { LV_ASSERT_OBJ(obj, MY_CLASS); LV_UNUSED(obj); ta_insert_replace = txt; } void lv_textarea_set_text_selection(lv_obj_t * obj, bool en) { LV_ASSERT_OBJ(obj, MY_CLASS); #if LV_LABEL_TEXT_SELECTION lv_textarea_t * ta = (lv_textarea_t *)obj; ta->text_sel_en = en; if(!en) lv_textarea_clear_selection(obj); #else LV_UNUSED(obj); /*Unused*/ LV_UNUSED(en); /*Unused*/ #endif } void lv_textarea_set_password_show_time(lv_obj_t * obj, uint16_t time) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; ta->pwd_show_time = time; } void lv_textarea_set_align(lv_obj_t * obj, lv_text_align_t align) { LV_LOG_WARN("Deprecated: use the normal text_align style property instead"); lv_obj_set_style_text_align(obj, align, 0); switch(align) { default: case LV_TEXT_ALIGN_LEFT: lv_obj_align(lv_textarea_get_label(obj), LV_ALIGN_TOP_LEFT, 0, 0); break; case LV_TEXT_ALIGN_RIGHT: lv_obj_align(lv_textarea_get_label(obj), LV_ALIGN_TOP_RIGHT, 0, 0); break; case LV_TEXT_ALIGN_CENTER: lv_obj_align(lv_textarea_get_label(obj), LV_ALIGN_TOP_MID, 0, 0); break; } } /*===================== * Getter functions *====================*/ const char * lv_textarea_get_text(const lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; const char * txt; if(ta->pwd_mode == 0) { txt = lv_label_get_text(ta->label); } else { txt = ta->pwd_tmp; } return txt; } const char * lv_textarea_get_placeholder_text(lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; if(ta->placeholder_txt) return ta->placeholder_txt; else return ""; } lv_obj_t * lv_textarea_get_label(const lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; return ta->label; } uint32_t lv_textarea_get_cursor_pos(const lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; return ta->cursor.pos; } bool lv_textarea_get_cursor_click_pos(lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; return ta->cursor.click_pos ? true : false; } bool lv_textarea_get_password_mode(const lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; return ta->pwd_mode == 1U; } const char * lv_textarea_get_password_bullet(lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; if(ta->pwd_bullet) return ta->pwd_bullet; lv_font_glyph_dsc_t g; const lv_font_t * font = lv_obj_get_style_text_font(obj, LV_PART_MAIN); /*If the textarea's font has the bullet character use it else fallback to "*"*/ if(lv_font_get_glyph_dsc(font, &g, LV_TEXTAREA_PWD_BULLET_UNICODE, 0)) return LV_SYMBOL_BULLET; return "*"; } bool lv_textarea_get_one_line(const lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; return ta->one_line == 1U; } const char * lv_textarea_get_accepted_chars(lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; return ta->accepted_chars; } uint32_t lv_textarea_get_max_length(lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; return ta->max_length; } bool lv_textarea_text_is_selected(const lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); #if LV_LABEL_TEXT_SELECTION lv_textarea_t * ta = (lv_textarea_t *)obj; if((lv_label_get_text_selection_start(ta->label) != LV_DRAW_LABEL_NO_TXT_SEL || lv_label_get_text_selection_end(ta->label) != LV_DRAW_LABEL_NO_TXT_SEL)) { return true; } else { return false; } #else LV_UNUSED(obj); /*Unused*/ return false; #endif } bool lv_textarea_get_text_selection(lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); #if LV_LABEL_TEXT_SELECTION lv_textarea_t * ta = (lv_textarea_t *)obj; return ta->text_sel_en; #else LV_UNUSED(obj); /*Unused*/ return false; #endif } uint16_t lv_textarea_get_password_show_time(lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; return ta->pwd_show_time; } /*===================== * Other functions *====================*/ void lv_textarea_clear_selection(lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); #if LV_LABEL_TEXT_SELECTION lv_textarea_t * ta = (lv_textarea_t *)obj; if(lv_label_get_text_selection_start(ta->label) != LV_DRAW_LABEL_NO_TXT_SEL || lv_label_get_text_selection_end(ta->label) != LV_DRAW_LABEL_NO_TXT_SEL) { lv_label_set_text_sel_start(ta->label, LV_DRAW_LABEL_NO_TXT_SEL); lv_label_set_text_sel_end(ta->label, LV_DRAW_LABEL_NO_TXT_SEL); } #else LV_UNUSED(obj); /*Unused*/ #endif } void lv_textarea_cursor_right(lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); uint32_t cp = lv_textarea_get_cursor_pos(obj); cp++; lv_textarea_set_cursor_pos(obj, cp); } void lv_textarea_cursor_left(lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); uint32_t cp = lv_textarea_get_cursor_pos(obj); if(cp > 0) { cp--; lv_textarea_set_cursor_pos(obj, cp); } } void lv_textarea_cursor_down(lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; lv_point_t pos; /*Get the position of the current letter*/ lv_label_get_letter_pos(ta->label, lv_textarea_get_cursor_pos(obj), &pos); /*Increment the y with one line and keep the valid x*/ lv_coord_t line_space = lv_obj_get_style_text_line_space(obj, LV_PART_MAIN); const lv_font_t * font = lv_obj_get_style_text_font(obj, LV_PART_MAIN); lv_coord_t font_h = lv_font_get_line_height(font); pos.y += font_h + line_space + 1; pos.x = ta->cursor.valid_x; /*Do not go below the last line*/ if(pos.y < lv_obj_get_height(ta->label)) { /*Get the letter index on the new cursor position and set it*/ uint32_t new_cur_pos = lv_label_get_letter_on(ta->label, &pos); lv_coord_t cur_valid_x_tmp = ta->cursor.valid_x; /*Cursor position set overwrites the valid position*/ lv_textarea_set_cursor_pos(obj, new_cur_pos); ta->cursor.valid_x = cur_valid_x_tmp; } } void lv_textarea_cursor_up(lv_obj_t * obj) { LV_ASSERT_OBJ(obj, MY_CLASS); lv_textarea_t * ta = (lv_textarea_t *)obj; lv_point_t pos; /*Get the position of the current letter*/ lv_label_get_letter_pos(ta->label, lv_textarea_get_cursor_pos(obj), &pos); /*Decrement the y with one line and keep the valid x*/ lv_coord_t line_space = lv_obj_get_style_text_line_space(obj, LV_PART_MAIN); const lv_font_t * font = lv_obj_get_style_text_font(obj, LV_PART_MAIN); lv_coord_t font_h = lv_font_get_line_height(font); pos.y -= font_h + line_space - 1; pos.x = ta->cursor.valid_x; /*Get the letter index on the new cursor position and set it*/ uint32_t new_cur_pos = lv_label_get_letter_on(ta->label, &pos); lv_coord_t cur_valid_x_tmp = ta->cursor.valid_x; /*Cursor position set overwrites the valid position*/ lv_textarea_set_cursor_pos(obj, new_cur_pos); ta->cursor.valid_x = cur_valid_x_tmp; } /********************** * STATIC FUNCTIONS **********************/ static void lv_textarea_constructor(const lv_obj_class_t * class_p, lv_obj_t * obj) { LV_UNUSED(class_p); LV_TRACE_OBJ_CREATE("begin"); lv_textarea_t * ta = (lv_textarea_t *)obj; ta->pwd_mode = 0; ta->pwd_tmp = NULL; ta->pwd_bullet = NULL; ta->pwd_show_time = LV_TEXTAREA_DEF_PWD_SHOW_TIME; ta->accepted_chars = NULL; ta->max_length = 0; ta->cursor.show = 1; /*It will be set to zero later (with zero value lv_textarea_set_cursor_pos(obj, 0); wouldn't do anything as there is no difference)*/ ta->cursor.pos = 1; ta->cursor.click_pos = 1; ta->cursor.valid_x = 0; ta->one_line = 0; #if LV_LABEL_TEXT_SELECTION ta->text_sel_en = 0; #endif ta->label = NULL; ta->placeholder_txt = NULL; ta->label = lv_label_create(obj); lv_obj_set_width(ta->label, lv_pct(100)); lv_label_set_text(ta->label, ""); lv_obj_add_event_cb(ta->label, label_event_cb, LV_EVENT_ALL, NULL); lv_obj_add_flag(obj, LV_OBJ_FLAG_SCROLL_ON_FOCUS); lv_textarea_set_cursor_pos(obj, 0); start_cursor_blink(obj); LV_TRACE_OBJ_CREATE("finished"); } static void lv_textarea_destructor(const lv_obj_class_t * class_p, lv_obj_t * obj) { LV_UNUSED(class_p); lv_textarea_t * ta = (lv_textarea_t *)obj; if(ta->pwd_tmp != NULL) { lv_mem_free(ta->pwd_tmp); ta->pwd_tmp = NULL; } if(ta->pwd_bullet != NULL) { lv_mem_free(ta->pwd_bullet); ta->pwd_bullet = NULL; } if(ta->placeholder_txt != NULL) { lv_mem_free(ta->placeholder_txt); ta->placeholder_txt = NULL; } } static void lv_textarea_event(const lv_obj_class_t * class_p, lv_event_t * e) { LV_UNUSED(class_p); lv_res_t res; /*Call the ancestor's event handler*/ res = lv_obj_event_base(MY_CLASS, e); if(res != LV_RES_OK) return; lv_event_code_t code = lv_event_get_code(e); lv_obj_t * obj = lv_event_get_target(e); if(code == LV_EVENT_FOCUSED) { start_cursor_blink(obj); } else if(code == LV_EVENT_KEY) { uint32_t c = *((uint32_t *)lv_event_get_param(e)); /*uint32_t because can be UTF-8*/ if(c == LV_KEY_RIGHT) lv_textarea_cursor_right(obj); else if(c == LV_KEY_LEFT) lv_textarea_cursor_left(obj); else if(c == LV_KEY_UP) lv_textarea_cursor_up(obj); else if(c == LV_KEY_DOWN) lv_textarea_cursor_down(obj); else if(c == LV_KEY_BACKSPACE) lv_textarea_del_char(obj); else if(c == LV_KEY_DEL) lv_textarea_del_char_forward(obj); else if(c == LV_KEY_HOME) lv_textarea_set_cursor_pos(obj, 0); else if(c == LV_KEY_END) lv_textarea_set_cursor_pos(obj, LV_TEXTAREA_CURSOR_LAST); else if(c == LV_KEY_ENTER && lv_textarea_get_one_line(obj)) lv_event_send(obj, LV_EVENT_READY, NULL); else { lv_textarea_add_char(obj, c); } } else if(code == LV_EVENT_PRESSED || code == LV_EVENT_PRESSING || code == LV_EVENT_PRESS_LOST || code == LV_EVENT_RELEASED) { update_cursor_position_on_click(e); } else if(code == LV_EVENT_DRAW_MAIN) { draw_placeholder(e); } else if(code == LV_EVENT_DRAW_POST) { draw_cursor(e); } } static void label_event_cb(lv_event_t * e) { lv_event_code_t code = lv_event_get_code(e); lv_obj_t * label = lv_event_get_target(e); lv_obj_t * ta = lv_obj_get_parent(label); if(code == LV_EVENT_STYLE_CHANGED || code == LV_EVENT_SIZE_CHANGED) { lv_label_set_text(label, NULL); refr_cursor_area(ta); start_cursor_blink(ta); } } /** * Called to blink the cursor * @param ta pointer to a text area * @param hide 1: hide the cursor, 0: show it */ static void cursor_blink_anim_cb(void * obj, int32_t show) { lv_textarea_t * ta = (lv_textarea_t *)obj; if(show != ta->cursor.show) { ta->cursor.show = show ? 1U : 0U; lv_area_t area_tmp; lv_area_copy(&area_tmp, &ta->cursor.area); area_tmp.x1 += ta->label->coords.x1; area_tmp.y1 += ta->label->coords.y1; area_tmp.x2 += ta->label->coords.x1; area_tmp.y2 += ta->label->coords.y1; lv_obj_invalidate_area(obj, &area_tmp); } } /** * Dummy function to animate char hiding in pwd mode. * Does nothing, but a function is required in car hiding anim. * (pwd_char_hider callback do the real job) * @param ta unused * @param x unused */ static void pwd_char_hider_anim(void * obj, int32_t x) { LV_UNUSED(obj); LV_UNUSED(x); } /** * Call when an animation is ready to convert all characters to '*' * @param a pointer to the animation */ static void pwd_char_hider_anim_ready(lv_anim_t * a) { lv_obj_t * obj = a->var; pwd_char_hider(obj); } /** * Hide all characters (convert them to '*') * @param ta pointer to text area object */ static void pwd_char_hider(lv_obj_t * obj) { lv_textarea_t * ta = (lv_textarea_t *)obj; if(ta->pwd_mode == 0) { return; } /* When ta->label is empty we get 0 back */ char * txt = lv_label_get_text(ta->label); uint32_t enc_len = _lv_txt_get_encoded_length(txt); if(enc_len == 0) return; const char * bullet = lv_textarea_get_password_bullet(obj); const size_t bullet_len = strlen(bullet); char * txt_tmp = lv_mem_buf_get(enc_len * bullet_len + 1); uint32_t i; for(i = 0; i < enc_len; i++) { lv_memcpy(&txt_tmp[i * bullet_len], bullet, bullet_len); } txt_tmp[i * bullet_len] = '\0'; lv_label_set_text(ta->label, txt_tmp); lv_mem_buf_release(txt_tmp); refr_cursor_area(obj); } /** * Test a unicode character if it is accepted or not. Checks max length and accepted char list. * @param ta pointer to a test area object * @param c a unicode character * @return true: accepted; false: rejected */ static bool char_is_accepted(lv_obj_t * obj, uint32_t c) { lv_textarea_t * ta = (lv_textarea_t *)obj; /*Too many characters?*/ if(ta->max_length > 0 && _lv_txt_get_encoded_length(lv_textarea_get_text(obj)) >= ta->max_length) { return false; } if(ta->accepted_chars == NULL || ta->accepted_chars[0] == '\0') return true; /*Accepted character?*/ uint32_t i = 0; while(ta->accepted_chars[i] != '\0') { uint32_t a = _lv_txt_encoded_next(ta->accepted_chars, &i); if(a == c) return true; /*Accepted*/ } return false; /*The character wasn't in the list*/ } static void start_cursor_blink(lv_obj_t * obj) { lv_textarea_t * ta = (lv_textarea_t *)obj; uint32_t blink_time = lv_obj_get_style_anim_time(obj, LV_PART_CURSOR); if(blink_time == 0) { lv_anim_del(obj, cursor_blink_anim_cb); ta->cursor.show = 1; } else { lv_anim_t a; lv_anim_init(&a); lv_anim_set_var(&a, ta); lv_anim_set_exec_cb(&a, cursor_blink_anim_cb); lv_anim_set_time(&a, blink_time); lv_anim_set_playback_time(&a, blink_time); lv_anim_set_values(&a, 1, 0); lv_anim_set_path_cb(&a, lv_anim_path_step); lv_anim_set_repeat_count(&a, LV_ANIM_REPEAT_INFINITE); lv_anim_start(&a); } } static void refr_cursor_area(lv_obj_t * obj) { lv_textarea_t * ta = (lv_textarea_t *)obj; const lv_font_t * font = lv_obj_get_style_text_font(obj, LV_PART_MAIN); lv_coord_t line_space = lv_obj_get_style_text_line_space(obj, LV_PART_MAIN); uint32_t cur_pos = lv_textarea_get_cursor_pos(obj); const char * txt = lv_label_get_text(ta->label); uint32_t byte_pos = _lv_txt_encoded_get_byte_id(txt, cur_pos); uint32_t letter = _lv_txt_encoded_next(&txt[byte_pos], NULL); /* Letter height and width */ const lv_coord_t letter_h = lv_font_get_line_height(font); /*Set letter_w (set not 0 on non printable but valid chars)*/ uint32_t letter_space = letter; if(is_valid_but_non_printable_char(letter)) { letter_space = ' '; } lv_coord_t letter_w = lv_font_get_glyph_width(font, letter_space, IGNORE_KERNING); lv_point_t letter_pos; lv_label_get_letter_pos(ta->label, cur_pos, &letter_pos); lv_text_align_t align = lv_obj_calculate_style_text_align(ta->label, LV_PART_MAIN, lv_label_get_text(ta->label)); /*If the cursor is out of the text (most right) draw it to the next line*/ if(((letter_pos.x + ta->label->coords.x1) + letter_w > ta->label->coords.x2) && (ta->one_line == 0 && align != LV_TEXT_ALIGN_RIGHT)) { letter_pos.x = 0; letter_pos.y += letter_h + line_space; if(letter != '\0') { byte_pos += _lv_txt_encoded_size(&txt[byte_pos]); letter = _lv_txt_encoded_next(&txt[byte_pos], NULL); } uint32_t tmp = letter; if(is_valid_but_non_printable_char(letter)) { tmp = ' '; } letter_w = lv_font_get_glyph_width(font, tmp, IGNORE_KERNING); } /*Save the byte position. It is required to draw `LV_CURSOR_BLOCK`*/ ta->cursor.txt_byte_pos = byte_pos; /*Calculate the cursor according to its type*/ lv_coord_t border_width = lv_obj_get_style_border_width(obj, LV_PART_CURSOR); lv_coord_t top = lv_obj_get_style_pad_top(obj, LV_PART_CURSOR) + border_width; lv_coord_t bottom = lv_obj_get_style_pad_bottom(obj, LV_PART_CURSOR) + border_width; lv_coord_t left = lv_obj_get_style_pad_left(obj, LV_PART_CURSOR) + border_width; lv_coord_t right = lv_obj_get_style_pad_right(obj, LV_PART_CURSOR) + border_width; lv_area_t cur_area; cur_area.x1 = letter_pos.x - left; cur_area.y1 = letter_pos.y - top; cur_area.x2 = letter_pos.x + right + letter_w - 1; cur_area.y2 = letter_pos.y + bottom + letter_h - 1; /*Save the new area*/ lv_area_t area_tmp; lv_area_copy(&area_tmp, &ta->cursor.area); area_tmp.x1 += ta->label->coords.x1; area_tmp.y1 += ta->label->coords.y1; area_tmp.x2 += ta->label->coords.x1; area_tmp.y2 += ta->label->coords.y1; lv_obj_invalidate_area(obj, &area_tmp); lv_area_copy(&ta->cursor.area, &cur_area); lv_area_copy(&area_tmp, &ta->cursor.area); area_tmp.x1 += ta->label->coords.x1; area_tmp.y1 += ta->label->coords.y1; area_tmp.x2 += ta->label->coords.x1; area_tmp.y2 += ta->label->coords.y1; lv_obj_invalidate_area(obj, &area_tmp); } static void update_cursor_position_on_click(lv_event_t * e) { lv_indev_t * click_source = lv_indev_get_act(); if(click_source == NULL) return; lv_obj_t * obj = lv_event_get_target(e); lv_textarea_t * ta = (lv_textarea_t *)obj; if(ta->cursor.click_pos == 0) return; if(lv_indev_get_type(click_source) == LV_INDEV_TYPE_KEYPAD || lv_indev_get_type(click_source) == LV_INDEV_TYPE_ENCODER) { return; } lv_area_t label_coords; lv_obj_get_coords(ta->label, &label_coords); lv_point_t point_act, vect_act; lv_indev_get_point(click_source, &point_act); lv_indev_get_vect(click_source, &vect_act); if(point_act.x < 0 || point_act.y < 0) return; /*Ignore event from keypad*/ lv_point_t rel_pos; rel_pos.x = point_act.x - label_coords.x1; rel_pos.y = point_act.y - label_coords.y1; const lv_event_code_t code = lv_event_get_code(e); lv_coord_t label_width = lv_obj_get_width(ta->label); uint16_t char_id_at_click = 0; #if LV_LABEL_TEXT_SELECTION lv_label_t * label_data = (lv_label_t *)ta->label; bool click_outside_label = false; /*Check if the click happened on the left side of the area outside the label*/ if(rel_pos.x < 0) { char_id_at_click = 0; click_outside_label = true; } /*Check if the click happened on the right side of the area outside the label*/ else if(rel_pos.x >= label_width) { char_id_at_click = LV_TEXTAREA_CURSOR_LAST; click_outside_label = true; } else { char_id_at_click = lv_label_get_letter_on(ta->label, &rel_pos); click_outside_label = !lv_label_is_char_under_pos(ta->label, &rel_pos); } if(ta->text_sel_en) { if(!ta->text_sel_in_prog && !click_outside_label && code == LV_EVENT_PRESSED) { /*Input device just went down. Store the selection start position*/ ta->sel_start = char_id_at_click; ta->sel_end = LV_LABEL_TEXT_SELECTION_OFF; ta->text_sel_in_prog = 1; lv_obj_clear_flag(obj, LV_OBJ_FLAG_SCROLL_CHAIN); } else if(ta->text_sel_in_prog && code == LV_EVENT_PRESSING) { /*Input device may be moving. Store the end position*/ ta->sel_end = char_id_at_click; } else if(ta->text_sel_in_prog && (code == LV_EVENT_PRESS_LOST || code == LV_EVENT_RELEASED)) { /*Input device is released. Check if anything was selected.*/ lv_obj_add_flag(obj, LV_OBJ_FLAG_SCROLL_CHAIN); } } if(ta->text_sel_in_prog || code == LV_EVENT_PRESSED) lv_textarea_set_cursor_pos(obj, char_id_at_click); if(ta->text_sel_in_prog) { /*If the selected area has changed then update the real values and*/ /*Invalidate the text area.*/ if(ta->sel_start > ta->sel_end) { if(label_data->sel_start != ta->sel_end || label_data->sel_end != ta->sel_start) { label_data->sel_start = ta->sel_end; label_data->sel_end = ta->sel_start; lv_obj_invalidate(obj); } } else if(ta->sel_start < ta->sel_end) { if(label_data->sel_start != ta->sel_start || label_data->sel_end != ta->sel_end) { label_data->sel_start = ta->sel_start; label_data->sel_end = ta->sel_end; lv_obj_invalidate(obj); } } else { if(label_data->sel_start != LV_DRAW_LABEL_NO_TXT_SEL || label_data->sel_end != LV_DRAW_LABEL_NO_TXT_SEL) { label_data->sel_start = LV_DRAW_LABEL_NO_TXT_SEL; label_data->sel_end = LV_DRAW_LABEL_NO_TXT_SEL; lv_obj_invalidate(obj); } } /*Finish selection if necessary*/ if(code == LV_EVENT_PRESS_LOST || code == LV_EVENT_RELEASED) { ta->text_sel_in_prog = 0; } } #else /*Check if the click happened on the left side of the area outside the label*/ if(rel_pos.x < 0) { char_id_at_click = 0; } /*Check if the click happened on the right side of the area outside the label*/ else if(rel_pos.x >= label_width) { char_id_at_click = LV_TEXTAREA_CURSOR_LAST; } else { char_id_at_click = lv_label_get_letter_on(ta->label, &rel_pos); } if(code == LV_EVENT_PRESSED) lv_textarea_set_cursor_pos(obj, char_id_at_click); #endif } /* Returns LV_RES_OK when no operation were performed * Returns LV_RES_INV when a user defined text was inserted */ static lv_res_t insert_handler(lv_obj_t * obj, const char * txt) { ta_insert_replace = NULL; lv_event_send(obj, LV_EVENT_INSERT, (char *)txt); /* Drop txt if insert replace is set to '\0' */ if(ta_insert_replace && ta_insert_replace[0] == '\0') return LV_RES_INV; if(ta_insert_replace) { /*Add the replaced text directly it's different from the original*/ if(strcmp(ta_insert_replace, txt)) { lv_textarea_add_text(obj, ta_insert_replace); return LV_RES_INV; } } return LV_RES_OK; } static void draw_placeholder(lv_event_t * e) { lv_obj_t * obj = lv_event_get_target(e); lv_textarea_t * ta = (lv_textarea_t *)obj; lv_draw_ctx_t * draw_ctx = lv_event_get_draw_ctx(e); const char * txt = lv_label_get_text(ta->label); /*Draw the place holder*/ if(txt[0] == '\0' && ta->placeholder_txt && ta->placeholder_txt[0] != 0) { lv_draw_label_dsc_t ph_dsc; lv_draw_label_dsc_init(&ph_dsc); lv_obj_init_draw_label_dsc(obj, LV_PART_TEXTAREA_PLACEHOLDER, &ph_dsc); if(ta->one_line) ph_dsc.flag |= LV_TEXT_FLAG_EXPAND; lv_coord_t left = lv_obj_get_style_pad_left(obj, LV_PART_MAIN); lv_coord_t top = lv_obj_get_style_pad_top(obj, LV_PART_MAIN); lv_coord_t border_width = lv_obj_get_style_border_width(obj, LV_PART_MAIN); lv_area_t ph_coords; lv_area_copy(&ph_coords, &obj->coords); lv_area_move(&ph_coords, left + border_width, top + border_width); lv_draw_label(draw_ctx, &ph_dsc, &ph_coords, ta->placeholder_txt, NULL); } } static void draw_cursor(lv_event_t * e) { lv_obj_t * obj = lv_event_get_target(e); lv_textarea_t * ta = (lv_textarea_t *)obj; lv_draw_ctx_t * draw_ctx = lv_event_get_draw_ctx(e); const char * txt = lv_label_get_text(ta->label); if(ta->cursor.show == 0) return; lv_draw_rect_dsc_t cur_dsc; lv_draw_rect_dsc_init(&cur_dsc); lv_obj_init_draw_rect_dsc(obj, LV_PART_CURSOR, &cur_dsc); /*Draw he cursor according to the type*/ lv_area_t cur_area; lv_area_copy(&cur_area, &ta->cursor.area); cur_area.x1 += ta->label->coords.x1; cur_area.y1 += ta->label->coords.y1; cur_area.x2 += ta->label->coords.x1; cur_area.y2 += ta->label->coords.y1; lv_draw_rect(draw_ctx, &cur_dsc, &cur_area); lv_coord_t border_width = lv_obj_get_style_border_width(obj, LV_PART_CURSOR); lv_coord_t left = lv_obj_get_style_pad_left(obj, LV_PART_CURSOR) + border_width; lv_coord_t top = lv_obj_get_style_pad_top(obj, LV_PART_CURSOR) + border_width; char letter_buf[8] = {0}; lv_memcpy(letter_buf, &txt[ta->cursor.txt_byte_pos], _lv_txt_encoded_size(&txt[ta->cursor.txt_byte_pos])); cur_area.x1 += left; cur_area.y1 += top; /*Draw the letter over the cursor only if *the cursor has background or the letter has different color than the original. *Else the original letter is drawn twice which makes it look bolder*/ lv_color_t label_color = lv_obj_get_style_text_color(ta->label, 0); lv_draw_label_dsc_t cur_label_dsc; lv_draw_label_dsc_init(&cur_label_dsc); lv_obj_init_draw_label_dsc(obj, LV_PART_CURSOR, &cur_label_dsc); if(cur_dsc.bg_opa > LV_OPA_MIN || cur_label_dsc.color.full != label_color.full) { lv_draw_label(draw_ctx, &cur_label_dsc, &cur_area, letter_buf, NULL); } } static void auto_hide_characters(lv_obj_t * obj) { lv_textarea_t * ta = (lv_textarea_t *) obj; if(ta->pwd_show_time == 0) { pwd_char_hider(obj); } else { lv_anim_t a; lv_anim_init(&a); lv_anim_set_var(&a, ta); lv_anim_set_exec_cb(&a, pwd_char_hider_anim); lv_anim_set_time(&a, ta->pwd_show_time); lv_anim_set_values(&a, 0, 1); lv_anim_set_path_cb(&a, lv_anim_path_step); lv_anim_set_ready_cb(&a, pwd_char_hider_anim_ready); lv_anim_start(&a); } } static inline bool is_valid_but_non_printable_char(const uint32_t letter) { if(letter == '\0' || letter == '\n' || letter == '\r') { return true; } return false; } #endif