From: Paul Wisbey Date: Tue, 17 Nov 2015 17:36:54 +0000 (-0800) Subject: Merge "Adding TextField Popup behaviour to (Programming) Guide" into devel/master X-Git-Tag: dali_1.1.11~7 X-Git-Url: http://review.tizen.org/git/?p=platform%2Fcore%2Fuifw%2Fdali-toolkit.git;a=commitdiff_plain;h=18644a10e91e667563734dfa9fa8be6b85ffdc51;hp=4b3b7f4169b809c086e09323960271f187e3558a Merge "Adding TextField Popup behaviour to (Programming) Guide" into devel/master --- diff --git a/docs/content/images/text-controls/EmptyTextAndNoContentToPaste.png b/docs/content/images/text-controls/EmptyTextAndNoContentToPaste.png new file mode 100644 index 0000000..5a007c1 Binary files /dev/null and b/docs/content/images/text-controls/EmptyTextAndNoContentToPaste.png differ diff --git a/docs/content/images/text-controls/EmptyTextClipboardHasContent.png b/docs/content/images/text-controls/EmptyTextClipboardHasContent.png new file mode 100644 index 0000000..5f29f75 Binary files /dev/null and b/docs/content/images/text-controls/EmptyTextClipboardHasContent.png differ diff --git a/docs/content/images/text-controls/SelectAllWhitespace.png b/docs/content/images/text-controls/SelectAllWhitespace.png new file mode 100644 index 0000000..30e326a Binary files /dev/null and b/docs/content/images/text-controls/SelectAllWhitespace.png differ diff --git a/docs/content/images/text-controls/SelectWhitespaceAfterText.png b/docs/content/images/text-controls/SelectWhitespaceAfterText.png new file mode 100644 index 0000000..c0d2fad Binary files /dev/null and b/docs/content/images/text-controls/SelectWhitespaceAfterText.png differ diff --git a/docs/content/images/text-controls/SelectingText.png b/docs/content/images/text-controls/SelectingText.png new file mode 100644 index 0000000..44a2ccb Binary files /dev/null and b/docs/content/images/text-controls/SelectingText.png differ diff --git a/docs/content/images/text-controls/TapAfterCopyingText.png b/docs/content/images/text-controls/TapAfterCopyingText.png new file mode 100644 index 0000000..eaa260b Binary files /dev/null and b/docs/content/images/text-controls/TapAfterCopyingText.png differ diff --git a/docs/content/shared-javascript-and-cpp-documentation/text-field.md b/docs/content/shared-javascript-and-cpp-documentation/text-field.md index 05bf048..e51c4ff 100644 --- a/docs/content/shared-javascript-and-cpp-documentation/text-field.md +++ b/docs/content/shared-javascript-and-cpp-documentation/text-field.md @@ -70,6 +70,28 @@ field.SetProperty( TextField::Property::HORIZONTAL_ALIGNMENT, "BEGIN" ); // "CEN field.HorizontalAlignment = "BEGIN"; // "CENTER" or "END" ~~~ +### Copy and Paste (Selection) + +Text can be selected by a long press or double tapping it. Depending on certain conditions a popup could be shown giving options including [CUT][COPY][PASTE], [SELECT ALL] or [CLIPBOARD]. Below these conditions will be explained. + +[CUT] or [COPY] send the selected text to the clipboard ready to be pasted directly or via the clipboard UI. Pressing [PASTE] will paste the top item from the clipboard (what has just been copied, possibly from another application). If the system supports a clipboard UI this can be displayed by pressing the [CLIPBOARD] button. + +Empty text means the user has not inputted any text, a TextField containing special characters or purely whitespace is not empty. + +Below shows how the popup will look depending on the state of the TextField + +| | | +|--|--| +| Condition: Long press/double tap when empty text but clipboard has content | Condition: Long press/double tap when TextField contains text | +|[PASTE][CLIPBOARD] buttons shown| [CUT][COPY], [SELECT ALL] unless all text selected and [PASTE][CLIPBOARD] if content to paste. | +| ![ ](../assets/img/text-controls/EmptyTextClipboardHasContent.png) ![ ](./EmptyTextClipboardHasContent.png) | ![ ](../assets/img/text-controls/SelectingText.png) ![ ](./SelectingText.png) | +| Condition: Long press/double tap popup when TextField contains just whitespace | Condition: Empty text & clipboard empty | +| Whitespace treated as regular text, [CUT][COPY] shown and [PASTE][CLIPBOARD] if content to paste. As all text is selected there is no need for [SELECT ALL] | No popup shown after longpress/double tap| +| ![ ](../assets/img/text-controls/SelectAllWhitespace.png) ![ ](./SelectAllWhitespace.png) | ![ ](../assets/img/text-controls/EmptyTextAndNoContentToPaste.png) ![ ](./EmptyTextAndNoContentToPaste.png)| +| Condition: Longpress/(double tap) on whitespace which is following text | Condition: Tapping text or panning grab handle | +| [PASTE][CLIPBOARD] shown if something to paste. [SELECT ALL] as more text to select | If content in clipboard [PASTE][CLIPBOARD] popup will be shown. | +| ![ ](../assets/img/text-controls/SelectWhitespaceAfterText.png) ![ ](./SelectWhitespaceAfterText.png) | ![ ](../assets/img/text-controls/TapAfterCopyingText.png) ![ ](./TapAfterCopyingText.png) | + ### TextField Decorations #### Color