diff options
Diffstat (limited to 'core/java/android/webkit/WebTextView.java')
-rw-r--r-- | core/java/android/webkit/WebTextView.java | 566 |
1 files changed, 566 insertions, 0 deletions
diff --git a/core/java/android/webkit/WebTextView.java b/core/java/android/webkit/WebTextView.java new file mode 100644 index 0000000..4a8fa3c --- /dev/null +++ b/core/java/android/webkit/WebTextView.java @@ -0,0 +1,566 @@ +/* + * Copyright (C) 2007 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package android.webkit; + +import android.content.Context; +import android.graphics.Rect; +import android.text.Editable; +import android.text.InputFilter; +import android.text.Selection; +import android.text.Spannable; +import android.text.TextUtils; +import android.text.method.MovementMethod; +import android.view.inputmethod.EditorInfo; +import android.view.inputmethod.InputMethodManager; +import android.view.KeyCharacterMap; +import android.view.KeyEvent; +import android.view.MotionEvent; +import android.view.View; +import android.view.ViewGroup; +import android.widget.AbsoluteLayout.LayoutParams; +import android.widget.ArrayAdapter; +import android.widget.AutoCompleteTextView; +import android.widget.TextView; + +import java.util.ArrayList; + +/** + * WebTextView is a specialized version of EditText used by WebView + * to overlay html textfields (and textareas) to use our standard + * text editing. + */ +/* package */ class WebTextView extends AutoCompleteTextView { + + private WebView mWebView; + private boolean mSingle; + private int mWidthSpec; + private int mHeightSpec; + private int mNodePointer; + // FIXME: This is a hack for blocking unmatched key ups, in particular + // on the enter key. The method for blocking unmatched key ups prevents + // the shift key from working properly. + private boolean mGotEnterDown; + // mScrollToAccommodateCursor being set to false prevents us from scrolling + // the cursor on screen when using the trackball to select a textfield. + private boolean mScrollToAccommodateCursor; + private int mMaxLength; + // Keep track of the text before the change so we know whether we actually + // need to send down the DOM events. + private String mPreChange; + // Array to store the final character added in onTextChanged, so that its + // KeyEvents may be determined. + private char[] mCharacter = new char[1]; + // This is used to reset the length filter when on a textfield + // with no max length. + // FIXME: This can be replaced with TextView.NO_FILTERS if that + // is made public/protected. + private static final InputFilter[] NO_FILTERS = new InputFilter[0]; + + /** + * Create a new WebTextView. + * @param context The Context for this WebTextView. + * @param webView The WebView that created this. + */ + /* package */ WebTextView(Context context, WebView webView) { + super(context); + mWebView = webView; + mMaxLength = -1; + setImeOptions(EditorInfo.IME_ACTION_NONE); + // Allow webkit's drawing to show through + setWillNotDraw(true); + } + + @Override + public boolean dispatchKeyEvent(KeyEvent event) { + if (event.isSystem()) { + return super.dispatchKeyEvent(event); + } + // Treat ACTION_DOWN and ACTION MULTIPLE the same + boolean down = event.getAction() != KeyEvent.ACTION_UP; + int keyCode = event.getKeyCode(); + Spannable text = (Spannable) getText(); + int oldLength = text.length(); + // Normally the delete key's dom events are sent via onTextChanged. + // However, if the length is zero, the text did not change, so we + // go ahead and pass the key down immediately. + if (KeyEvent.KEYCODE_DEL == keyCode && 0 == oldLength) { + sendDomEvent(event); + return true; + } + + if ((mSingle && KeyEvent.KEYCODE_ENTER == keyCode)) { + if (isPopupShowing()) { + return super.dispatchKeyEvent(event); + } + if (!down) { + // Hide the keyboard, since the user has just submitted this + // form. The submission happens thanks to the two calls + // to sendDomEvent. + InputMethodManager.getInstance(mContext) + .hideSoftInputFromWindow(getWindowToken(), 0); + sendDomEvent(new KeyEvent(KeyEvent.ACTION_DOWN, keyCode)); + sendDomEvent(event); + } + return super.dispatchKeyEvent(event); + } else if (KeyEvent.KEYCODE_DPAD_CENTER == keyCode) { + // Note that this handles center key and trackball. + if (isPopupShowing()) { + return super.dispatchKeyEvent(event); + } + if (!mWebView.nativeCursorMatchesFocus()) { + return down ? mWebView.onKeyDown(keyCode, event) : mWebView + .onKeyUp(keyCode, event); + } + // Center key should be passed to a potential onClick + if (!down) { + mWebView.shortPressOnTextField(); + } + // Pass to super to handle longpress. + return super.dispatchKeyEvent(event); + } + boolean isArrowKey = false; + switch(keyCode) { + case KeyEvent.KEYCODE_DPAD_LEFT: + case KeyEvent.KEYCODE_DPAD_RIGHT: + case KeyEvent.KEYCODE_DPAD_UP: + case KeyEvent.KEYCODE_DPAD_DOWN: + if (!mWebView.nativeCursorMatchesFocus()) { + return down ? mWebView.onKeyDown(keyCode, event) : mWebView + .onKeyUp(keyCode, event); + + } + isArrowKey = true; + break; + } + + // Ensure there is a layout so arrow keys are handled properly. + if (getLayout() == null) { + measure(mWidthSpec, mHeightSpec); + } + int oldStart = Selection.getSelectionStart(text); + int oldEnd = Selection.getSelectionEnd(text); + + boolean maxedOut = mMaxLength != -1 && oldLength == mMaxLength; + // If we are at max length, and there is a selection rather than a + // cursor, we need to store the text to compare later, since the key + // may have changed the string. + String oldText; + if (maxedOut && oldEnd != oldStart) { + oldText = text.toString(); + } else { + oldText = ""; + } + if (super.dispatchKeyEvent(event)) { + // If the WebTextView handled the key it was either an alphanumeric + // key, a delete, or a movement within the text. All of those are + // ok to pass to javascript. + + // UNLESS there is a max length determined by the html. In that + // case, if the string was already at the max length, an + // alphanumeric key will be erased by the LengthFilter, + // so do not pass down to javascript, and instead + // return true. If it is an arrow key or a delete key, we can go + // ahead and pass it down. + if (KeyEvent.KEYCODE_ENTER == keyCode) { + // For multi-line text boxes, newlines will + // trigger onTextChanged for key down (which will send both + // key up and key down) but not key up. + mGotEnterDown = true; + } + if (maxedOut && !isArrowKey && keyCode != KeyEvent.KEYCODE_DEL) { + if (oldEnd == oldStart) { + // Return true so the key gets dropped. + mScrollToAccommodateCursor = true; + return true; + } else if (!oldText.equals(getText().toString())) { + // FIXME: This makes the text work properly, but it + // does not pass down the key event, so it may not + // work for a textfield that has the type of + // behavior of GoogleSuggest. That said, it is + // unlikely that a site would combine the two in + // one textfield. + Spannable span = (Spannable) getText(); + int newStart = Selection.getSelectionStart(span); + int newEnd = Selection.getSelectionEnd(span); + mWebView.replaceTextfieldText(0, oldLength, span.toString(), + newStart, newEnd); + mScrollToAccommodateCursor = true; + return true; + } + } + /* FIXME: + * In theory, we would like to send the events for the arrow keys. + * However, the TextView can arbitrarily change the selection (i.e. + * long press followed by using the trackball). Therefore, we keep + * in sync with the TextView via onSelectionChanged. If we also + * send the DOM event, we lose the correct selection. + if (isArrowKey) { + // Arrow key does not change the text, but we still want to send + // the DOM events. + sendDomEvent(event); + } + */ + mScrollToAccommodateCursor = true; + return true; + } + // Ignore the key up event for newlines. This prevents + // multiple newlines in the native textarea. + if (mGotEnterDown && !down) { + return true; + } + // if it is a navigation key, pass it to WebView + if (isArrowKey) { + // WebView check the trackballtime in onKeyDown to avoid calling + // native from both trackball and key handling. As this is called + // from WebTextView, we always want WebView to check with native. + // Reset trackballtime to ensure it. + mWebView.resetTrackballTime(); + return down ? mWebView.onKeyDown(keyCode, event) : mWebView + .onKeyUp(keyCode, event); + } + return false; + } + + /** + * Create a fake touch up event at (x,y) with respect to this WebTextView. + * This is used by WebView to act as though a touch event which happened + * before we placed the WebTextView actually hit it, so that it can place + * the cursor accordingly. + */ + /* package */ void fakeTouchEvent(float x, float y) { + // We need to ensure that there is a Layout, since the Layout is used + // in determining where to place the cursor. + if (getLayout() == null) { + measure(mWidthSpec, mHeightSpec); + } + // Create a fake touch up, which is used to place the cursor. + MotionEvent ev = MotionEvent.obtain(0, 0, MotionEvent.ACTION_UP, + x, y, 0); + onTouchEvent(ev); + ev.recycle(); + } + + /** + * Determine whether this WebTextView currently represents the node + * represented by ptr. + * @param ptr Pointer to a node to compare to. + * @return boolean Whether this WebTextView already represents the node + * pointed to by ptr. + */ + /* package */ boolean isSameTextField(int ptr) { + return ptr == mNodePointer; + } + + @Override + protected void onSelectionChanged(int selStart, int selEnd) { + if (mWebView != null) { + mWebView.setSelection(selStart, selEnd); + } + } + + @Override + protected void onTextChanged(CharSequence s,int start,int before,int count){ + super.onTextChanged(s, start, before, count); + String postChange = s.toString(); + // Prevent calls to setText from invoking onTextChanged (since this will + // mean we are on a different textfield). Also prevent the change when + // going from a textfield with a string of text to one with a smaller + // limit on text length from registering the onTextChanged event. + if (mPreChange == null || mPreChange.equals(postChange) || + (mMaxLength > -1 && mPreChange.length() > mMaxLength && + mPreChange.substring(0, mMaxLength).equals(postChange))) { + return; + } + mPreChange = postChange; + // This was simply a delete or a cut, so just delete the selection. + if (before > 0 && 0 == count) { + mWebView.deleteSelection(start, start + before); + // For this and all changes to the text, update our cache + updateCachedTextfield(); + return; + } + // Find the last character being replaced. If it can be represented by + // events, we will pass them to native (after replacing the beginning + // of the changed text), so we can see javascript events. + // Otherwise, replace the text being changed (including the last + // character) in the textfield. + TextUtils.getChars(s, start + count - 1, start + count, mCharacter, 0); + KeyCharacterMap kmap = + KeyCharacterMap.load(KeyCharacterMap.BUILT_IN_KEYBOARD); + KeyEvent[] events = kmap.getEvents(mCharacter); + boolean cannotUseKeyEvents = null == events; + int charactersFromKeyEvents = cannotUseKeyEvents ? 0 : 1; + if (count > 1 || cannotUseKeyEvents) { + String replace = s.subSequence(start, + start + count - charactersFromKeyEvents).toString(); + mWebView.replaceTextfieldText(start, start + before, replace, + start + count - charactersFromKeyEvents, + start + count - charactersFromKeyEvents); + } else { + // This corrects the selection which may have been affected by the + // trackball or auto-correct. + mWebView.setSelection(start, start + before); + } + if (!cannotUseKeyEvents) { + int length = events.length; + for (int i = 0; i < length; i++) { + // We never send modifier keys to native code so don't send them + // here either. + if (!KeyEvent.isModifierKey(events[i].getKeyCode())) { + sendDomEvent(events[i]); + } + } + } + updateCachedTextfield(); + } + + @Override + public boolean onTrackballEvent(MotionEvent event) { + if (isPopupShowing()) { + return super.onTrackballEvent(event); + } + if (event.getAction() != MotionEvent.ACTION_MOVE) { + return false; + } + // If the Cursor is not on the text input, webview should handle the + // trackball + if (!mWebView.nativeCursorMatchesFocus()) { + return mWebView.onTrackballEvent(event); + } + Spannable text = (Spannable) getText(); + MovementMethod move = getMovementMethod(); + if (move != null && getLayout() != null && + move.onTrackballEvent(this, text, event)) { + // Selection is changed in onSelectionChanged + return true; + } + // If the user is in a textfield, and the movement method is not + // handling the trackball events, it means they are at the end of the + // field and continuing to move the trackball. In this case, we should + // not scroll the cursor on screen bc the user may be attempting to + // scroll the page, possibly in the opposite direction of the cursor. + mScrollToAccommodateCursor = false; + return false; + } + + /** + * Remove this WebTextView from its host WebView, and return + * focus to the host. + */ + /* package */ void remove() { + // hide the soft keyboard when the edit text is out of focus + InputMethodManager.getInstance(mContext).hideSoftInputFromWindow( + getWindowToken(), 0); + mWebView.removeView(this); + mWebView.requestFocus(); + mScrollToAccommodateCursor = false; + } + + /* package */ void enableScrollOnScreen(boolean enable) { + mScrollToAccommodateCursor = enable; + } + + /* package */ void bringIntoView() { + if (getLayout() != null) { + bringPointIntoView(Selection.getSelectionEnd(getText())); + } + } + + @Override + public boolean requestRectangleOnScreen(Rect rectangle) { + if (mScrollToAccommodateCursor) { + return super.requestRectangleOnScreen(rectangle); + } + return false; + } + + /** + * Send the DOM events for the specified event. + * @param event KeyEvent to be translated into a DOM event. + */ + private void sendDomEvent(KeyEvent event) { + mWebView.passToJavaScript(getText().toString(), event); + } + + /** + * Always use this instead of setAdapter, as this has features specific to + * the WebTextView. + */ + public void setAdapterCustom(AutoCompleteAdapter adapter) { + if (adapter != null) { + setInputType(EditorInfo.TYPE_TEXT_FLAG_AUTO_COMPLETE); + adapter.setTextView(this); + } + super.setAdapter(adapter); + } + + /** + * This is a special version of ArrayAdapter which changes its text size + * to match the text size of its host TextView. + */ + public static class AutoCompleteAdapter extends ArrayAdapter<String> { + private TextView mTextView; + + public AutoCompleteAdapter(Context context, ArrayList<String> entries) { + super(context, com.android.internal.R.layout + .search_dropdown_item_1line, entries); + } + + /** + * {@inheritDoc} + */ + public View getView(int position, View convertView, ViewGroup parent) { + TextView tv = + (TextView) super.getView(position, convertView, parent); + if (tv != null && mTextView != null) { + tv.setTextSize(mTextView.getTextSize()); + } + return tv; + } + + /** + * Set the TextView so we can match its text size. + */ + private void setTextView(TextView tv) { + mTextView = tv; + } + } + + /** + * Determine whether to use the system-wide password disguising method, + * or to use none. + * @param inPassword True if the textfield is a password field. + */ + /* package */ void setInPassword(boolean inPassword) { + if (inPassword) { + setInputType(EditorInfo.TYPE_CLASS_TEXT | EditorInfo. + TYPE_TEXT_VARIATION_PASSWORD); + } + } + + /* package */ void setMaxLength(int maxLength) { + mMaxLength = maxLength; + if (-1 == maxLength) { + setFilters(NO_FILTERS); + } else { + setFilters(new InputFilter[] { + new InputFilter.LengthFilter(maxLength) }); + } + } + + /** + * Set the pointer for this node so it can be determined which node this + * WebTextView represents. + * @param ptr Integer representing the pointer to the node which this + * WebTextView represents. + */ + /* package */ void setNodePointer(int ptr) { + mNodePointer = ptr; + } + + /** + * Determine the position and size of WebTextView, and add it to the + * WebView's view heirarchy. All parameters are presumed to be in + * view coordinates. Also requests Focus and sets the cursor to not + * request to be in view. + * @param x x-position of the textfield. + * @param y y-position of the textfield. + * @param width width of the textfield. + * @param height height of the textfield. + */ + /* package */ void setRect(int x, int y, int width, int height) { + LayoutParams lp = (LayoutParams) getLayoutParams(); + if (null == lp) { + lp = new LayoutParams(width, height, x, y); + } else { + lp.x = x; + lp.y = y; + lp.width = width; + lp.height = height; + } + if (getParent() == null) { + mWebView.addView(this, lp); + } else { + setLayoutParams(lp); + } + // Set up a measure spec so a layout can always be recreated. + mWidthSpec = MeasureSpec.makeMeasureSpec(width, MeasureSpec.EXACTLY); + mHeightSpec = MeasureSpec.makeMeasureSpec(height, MeasureSpec.EXACTLY); + requestFocus(); + } + + /** + * Set whether this is a single-line textfield or a multi-line textarea. + * Textfields scroll horizontally, and do not handle the enter key. + * Textareas behave oppositely. + * Do NOT call this after calling setInPassword(true). This will result in + * removing the password input type. + */ + public void setSingleLine(boolean single) { + int inputType = EditorInfo.TYPE_CLASS_TEXT + | EditorInfo.TYPE_TEXT_VARIATION_WEB_EDIT_TEXT; + if (!single) { + inputType |= EditorInfo.TYPE_TEXT_FLAG_MULTI_LINE + | EditorInfo.TYPE_TEXT_FLAG_CAP_SENTENCES + | EditorInfo.TYPE_TEXT_FLAG_AUTO_CORRECT; + } + mSingle = single; + setHorizontallyScrolling(single); + setInputType(inputType); + } + + /** + * Set the text for this WebTextView, and set the selection to (start, end) + * @param text Text to go into this WebTextView. + * @param start Beginning of the selection. + * @param end End of the selection. + */ + /* package */ void setText(CharSequence text, int start, int end) { + mPreChange = text.toString(); + setText(text); + Spannable span = (Spannable) getText(); + int length = span.length(); + if (end > length) { + end = length; + } + if (start < 0) { + start = 0; + } else if (start > length) { + start = length; + } + Selection.setSelection(span, start, end); + } + + /** + * Set the text to the new string, but use the old selection, making sure + * to keep it within the new string. + * @param text The new text to place in the textfield. + */ + /* package */ void setTextAndKeepSelection(String text) { + mPreChange = text.toString(); + Editable edit = (Editable) getText(); + edit.replace(0, edit.length(), text); + updateCachedTextfield(); + } + + /** + * Update the cache to reflect the current text. + */ + /* package */ void updateCachedTextfield() { + mWebView.updateCachedTextfield(getText().toString()); + } +} |