diff options
author | Jan-Felix Schmakeit <jfschmakeit@google.com> | 2013-03-25 17:43:41 +1100 |
---|---|---|
committer | Jan-Felix Schmakeit <jfschmakeit@google.com> | 2013-08-31 02:47:58 +1000 |
commit | 6eb7d31e07b8ef797e2f012f74d5764584d246b4 (patch) | |
tree | 06f05061cba8bdb8b0b2f841978507846b47986e /views | |
parent | cfc743a1139b616191f422768d44eb8e1bc9bf27 (diff) | |
download | android-6eb7d31e07b8ef797e2f012f74d5764584d246b4.tar.gz |
Added TextLinkify sample
Change-Id: Ib325c12dffe9491f93ad763a85c2fa1bbf2d7ff1
Diffstat (limited to 'views')
18 files changed, 513 insertions, 0 deletions
diff --git a/views/TextLinkify/AndroidManifest.xml b/views/TextLinkify/AndroidManifest.xml new file mode 100644 index 00000000..0bf9b973 --- /dev/null +++ b/views/TextLinkify/AndroidManifest.xml @@ -0,0 +1,43 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- + Copyright 2013 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. +--> + +<manifest xmlns:android="http://schemas.android.com/apk/res/android" + package="com.example.android.views.textlinkify" + android:versionCode="1" + android:versionName="1.0" > + + <uses-sdk + android:minSdkVersion="4" + android:targetSdkVersion="17" /> + + <application + android:allowBackup="true" + android:icon="@drawable/ic_launcher" + android:label="@string/app_name" + android:theme="@style/AppTheme" > + <activity + android:name="com.example.android.views.textlinkify.MainActivity" + android:label="@string/app_name" > + <intent-filter> + <action android:name="android.intent.action.MAIN" /> + + <category android:name="android.intent.category.LAUNCHER" /> + </intent-filter> + </activity> + </application> + +</manifest> diff --git a/views/TextLinkify/TextLinkify/build.gradle b/views/TextLinkify/TextLinkify/build.gradle new file mode 100644 index 00000000..5bef5eeb --- /dev/null +++ b/views/TextLinkify/TextLinkify/build.gradle @@ -0,0 +1,18 @@ +buildscript { + repositories { + mavenCentral() + } + dependencies { + classpath 'com.android.tools.build:gradle:0.5.+' + } +} +apply plugin: 'android' + +dependencies { + compile "com.android.support:support-v4:18.0.+" +} + +android { + compileSdkVersion 18 + buildToolsVersion "18.0.0" +} diff --git a/views/TextLinkify/TextLinkify/src/main/AndroidManifest.xml b/views/TextLinkify/TextLinkify/src/main/AndroidManifest.xml new file mode 100644 index 00000000..0bf9b973 --- /dev/null +++ b/views/TextLinkify/TextLinkify/src/main/AndroidManifest.xml @@ -0,0 +1,43 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- + Copyright 2013 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. +--> + +<manifest xmlns:android="http://schemas.android.com/apk/res/android" + package="com.example.android.views.textlinkify" + android:versionCode="1" + android:versionName="1.0" > + + <uses-sdk + android:minSdkVersion="4" + android:targetSdkVersion="17" /> + + <application + android:allowBackup="true" + android:icon="@drawable/ic_launcher" + android:label="@string/app_name" + android:theme="@style/AppTheme" > + <activity + android:name="com.example.android.views.textlinkify.MainActivity" + android:label="@string/app_name" > + <intent-filter> + <action android:name="android.intent.action.MAIN" /> + + <category android:name="android.intent.category.LAUNCHER" /> + </intent-filter> + </activity> + </application> + +</manifest> diff --git a/views/TextLinkify/TextLinkify/src/main/java/com/example/android/views/textlinkify/MainActivity.java b/views/TextLinkify/TextLinkify/src/main/java/com/example/android/views/textlinkify/MainActivity.java new file mode 100644 index 00000000..9e5a7c9d --- /dev/null +++ b/views/TextLinkify/TextLinkify/src/main/java/com/example/android/views/textlinkify/MainActivity.java @@ -0,0 +1,138 @@ +/* + * Copyright 2013 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 com.example.android.views.textlinkify; + +import android.app.Activity; +import android.graphics.Typeface; +import android.os.Bundle; +import android.text.Html; +import android.text.SpannableString; +import android.text.Spanned; +import android.text.method.LinkMovementMethod; +import android.text.style.StyleSpan; +import android.text.style.URLSpan; +import android.widget.TextView; + +/** + * This sample demonstrates how clickable links can be added to a + * {@link TextView}. + * + * <p>This can be done in three ways: + * <ul> + * <li><b>Automatically:</b> Text added to a TextView can automatically be linkified by enabling + * autoLinking. In XML, use the android:autoLink property, programatically call + * {@link android.widget.TextView#setAutoLinkMask(int)} using an option from + * {@link android.text.util.Linkify}</li> + * + * <li><b>Parsing a String as HTML:</b> See {@link Html#fromHtml(String)})</li> + * + * <li><b>Manually by constructing a {@link android.text.SpannableString}:</b> Consisting of + * {@link android.text.style.StyleSpan} and {@link android.text.style.URLSpan} objects that + * are contained within a {@link android.text.SpannableString}</li> + * </ul></p> + * + */ +public class MainActivity extends Activity { + + @Override + protected void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + + setContentView(R.layout.activity_main); + + // BEGIN_INCLUDE(text_auto_linkify) + /* + * text_auto_linkify shows the android:autoLink property, which + * automatically linkifies things like URLs and phone numbers + * found in the text. No java code is needed to make this + * work. + * This can also be enabled programmatically by calling + * .setAutoLinkMask(Linkify.ALL) before the text is set on the TextView. + * + * See android.text.util.Linkify for other options, for example only + * auto-linking email addresses or phone numbers + */ + // END_INCLUDE(text_auto_linkify) + + // BEGIN_INCLUDE(text_html_resource) + /* + * text_html_resource has links specified by putting anchor tags (<a>) in the string + * resource. By default these links will appear but not + * respond to user input. To make them active, you need to + * call setMovementMethod() on the TextView object. + */ + TextView textViewResource = (TextView) findViewById(R.id.text_html_resource); + textViewResource.setText( + Html.fromHtml(getResources().getString(R.string.link_text_manual))); + textViewResource.setMovementMethod(LinkMovementMethod.getInstance()); + // END_INCLUDE(text_html_resource) + + // BEGIN_INCLUDE(text_html_program) + /* + * text_html_program shows creating text with links from HTML in the Java + * code, rather than from a string resource. Note that for a + * fixed string, using a (localizable) resource as shown above + * is usually a better way to go; this example is intended to + * illustrate how you might display text that came from a + * dynamic source (eg, the network). + */ + TextView textViewHtml = (TextView) findViewById(R.id.text_html_program); + textViewHtml.setText( + Html.fromHtml( + "<b>text_html_program: Constructed from HTML programmatically.</b>" + + " Text with a <a href=\"http://www.google.com\">link</a> " + + "created in the Java source code using HTML.")); + textViewHtml.setMovementMethod(LinkMovementMethod.getInstance()); + // END_INCLUDE(text_html_program) + + // BEGIN_INCLUDE(text_spannable) + /* + * text_spannable illustrates constructing a styled string containing a + * link without using HTML at all. Again, for a fixed string + * you should probably be using a string resource, not a + * hardcoded value. + */ + SpannableString ss = new SpannableString( + "text_spannable: Manually created spans. Click here to dial the phone."); + + /* + * Make the first 38 characters bold by applying a StyleSpan with bold typeface. + * + * Characters 45 to 49 (the word "here") is made clickable by applying a URLSpan + * pointing to a telephone number. Clicking it opens the "tel:" URL that starts the dialer. + * + * The SPAN_EXCLUSIVE_EXCLUSIVE flag defines this span as exclusive, which means + * that it will not expand to include text inserted on either side of this span. + */ + ss.setSpan(new StyleSpan(Typeface.BOLD), 0, 39, + Spanned.SPAN_INCLUSIVE_INCLUSIVE); + ss.setSpan(new URLSpan("tel:4155551212"), 40 + 6, 40 + 10, + Spanned.SPAN_EXCLUSIVE_EXCLUSIVE); + + TextView textViewSpan = (TextView) findViewById(R.id.text_spannable); + textViewSpan.setText(ss); + + /* + * Set the movement method to move between links in this TextView. + * This means that the user traverses through links in this TextView, automatically + * handling appropriate scrolling and key commands. + */ + textViewSpan.setMovementMethod(LinkMovementMethod.getInstance()); + // END_INCLUDE(text_spannable) + } + +} diff --git a/views/TextLinkify/TextLinkify/src/main/res/drawable-hdpi/ic_launcher.png b/views/TextLinkify/TextLinkify/src/main/res/drawable-hdpi/ic_launcher.png Binary files differnew file mode 100644 index 00000000..eae36bc1 --- /dev/null +++ b/views/TextLinkify/TextLinkify/src/main/res/drawable-hdpi/ic_launcher.png diff --git a/views/TextLinkify/TextLinkify/src/main/res/drawable-mdpi/ic_launcher.png b/views/TextLinkify/TextLinkify/src/main/res/drawable-mdpi/ic_launcher.png Binary files differnew file mode 100644 index 00000000..f727f489 --- /dev/null +++ b/views/TextLinkify/TextLinkify/src/main/res/drawable-mdpi/ic_launcher.png diff --git a/views/TextLinkify/TextLinkify/src/main/res/drawable-xhdpi/ic_launcher.png b/views/TextLinkify/TextLinkify/src/main/res/drawable-xhdpi/ic_launcher.png Binary files differnew file mode 100644 index 00000000..51199d30 --- /dev/null +++ b/views/TextLinkify/TextLinkify/src/main/res/drawable-xhdpi/ic_launcher.png diff --git a/views/TextLinkify/TextLinkify/src/main/res/drawable-xxhdpi/ic_launcher.png b/views/TextLinkify/TextLinkify/src/main/res/drawable-xxhdpi/ic_launcher.png Binary files differnew file mode 100644 index 00000000..c49ec6a7 --- /dev/null +++ b/views/TextLinkify/TextLinkify/src/main/res/drawable-xxhdpi/ic_launcher.png diff --git a/views/TextLinkify/TextLinkify/src/main/res/layout/activity_main.xml b/views/TextLinkify/TextLinkify/src/main/res/layout/activity_main.xml new file mode 100644 index 00000000..8f35a705 --- /dev/null +++ b/views/TextLinkify/TextLinkify/src/main/res/layout/activity_main.xml @@ -0,0 +1,72 @@ +<!-- + Copyright 2013 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. +--> + + <ScrollView + xmlns:android="http://schemas.android.com/apk/res/android" + xmlns:tools="http://schemas.android.com/tools" + android:layout_width="wrap_content" + android:layout_height="wrap_content" + tools:context=".MainActivity"> + + <LinearLayout + android:orientation="vertical" + android:layout_width="fill_parent" + android:layout_height="fill_parent" + android:paddingBottom="@dimen/activity_vertical_margin" + android:paddingLeft="@dimen/activity_horizontal_margin" + android:paddingRight="@dimen/activity_horizontal_margin" + android:paddingTop="@dimen/activity_vertical_margin"> + + + <TextView + android:layout_width="wrap_content" + android:layout_height="wrap_content" + android:text="@string/intro" /> + + <!-- text_auto_linkify automatically linkifies things like URLs and phone numbers. --> + <TextView + android:id="@+id/text_auto_linkify" + style="@style/LinkText" + android:layout_width="match_parent" + android:layout_height="wrap_content" + android:autoLink="all" + android:text="@string/link_text_auto" /> + + <!-- + text_html_resource uses a string resource containing explicit anchor tags (<a>) + to specify links. + --> + <TextView + android:id="@+id/text_html_resource" + style="@style/LinkText" + android:layout_width="match_parent" + android:layout_height="wrap_content"/> + + <!-- text_html_program builds the text in the Java code using HTML. --> + <TextView + android:id="@+id/text_html_program" + style="@style/LinkText" + android:layout_width="match_parent" + android:layout_height="wrap_content" /> + + <!-- text_spannable builds the text in the Java code without using HTML. --> + <TextView + android:id="@+id/text_spannable" + style="@style/LinkText" + android:layout_width="match_parent" + android:layout_height="wrap_content" /> + </LinearLayout> + </ScrollView> diff --git a/views/TextLinkify/TextLinkify/src/main/res/values-sw600dp/dimens.xml b/views/TextLinkify/TextLinkify/src/main/res/values-sw600dp/dimens.xml new file mode 100644 index 00000000..686fe891 --- /dev/null +++ b/views/TextLinkify/TextLinkify/src/main/res/values-sw600dp/dimens.xml @@ -0,0 +1,24 @@ +<!-- + Copyright 2013 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. +--> + +<resources> + + <!-- + Customize dimensions originally defined in res/values/dimens.xml (such as + screen margins) for sw600dp devices (e.g. 7" tablets) here. + --> + +</resources> diff --git a/views/TextLinkify/TextLinkify/src/main/res/values-sw720dp-land/dimens.xml b/views/TextLinkify/TextLinkify/src/main/res/values-sw720dp-land/dimens.xml new file mode 100644 index 00000000..560bd44e --- /dev/null +++ b/views/TextLinkify/TextLinkify/src/main/res/values-sw720dp-land/dimens.xml @@ -0,0 +1,25 @@ +<!-- + Copyright 2013 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. +--> + +<resources> + + <!-- + Customize dimensions originally defined in res/values/dimens.xml (such as + screen margins) for sw720dp devices (e.g. 10" tablets) in landscape here. + --> + <dimen name="activity_horizontal_margin">128dp</dimen> + +</resources> diff --git a/views/TextLinkify/TextLinkify/src/main/res/values-v11/styles.xml b/views/TextLinkify/TextLinkify/src/main/res/values-v11/styles.xml new file mode 100644 index 00000000..91f45232 --- /dev/null +++ b/views/TextLinkify/TextLinkify/src/main/res/values-v11/styles.xml @@ -0,0 +1,27 @@ +<!-- + Copyright 2013 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. +--> + +<resources> + + <!-- + Base application theme for API 11+. This theme completely replaces + AppBaseTheme from res/values/styles.xml on API 11+ devices. + --> + <style name="AppBaseTheme" parent="android:Theme.Holo.Light"> + <!-- API 11 theme customizations can go here. --> + </style> + +</resources> diff --git a/views/TextLinkify/TextLinkify/src/main/res/values/dimens.xml b/views/TextLinkify/TextLinkify/src/main/res/values/dimens.xml new file mode 100644 index 00000000..3b1975a0 --- /dev/null +++ b/views/TextLinkify/TextLinkify/src/main/res/values/dimens.xml @@ -0,0 +1,23 @@ +<!-- + Copyright 2013 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. +--> + +<resources> + + <!-- Default screen margins, per the Android Design guidelines. --> + <dimen name="activity_horizontal_margin">16dp</dimen> + <dimen name="activity_vertical_margin">16dp</dimen> + +</resources> diff --git a/views/TextLinkify/TextLinkify/src/main/res/values/strings.xml b/views/TextLinkify/TextLinkify/src/main/res/values/strings.xml new file mode 100644 index 00000000..371ee69a --- /dev/null +++ b/views/TextLinkify/TextLinkify/src/main/res/values/strings.xml @@ -0,0 +1,42 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- + Copyright 2013 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. +--> + +<resources> + + <string name="app_name">TextLinkify Sample</string> + <string name="intro">This sample illustrates how links can be added to a TextView. + \nThis can be done either automatically by setting the <i>autoLink</i> property + or explicitly.</string> + <string name="link_text_auto"><b>text_auto_linkify: Various kinds + of data that will be auto-linked.</b> + In this text are some things that are actionable. For instance, + you can click on http://www.google.com and it will launch the + web browser. You can click on google.com too. If you + click on (415) 555-1212 it should dial the phone. Or just write + foobar@example.com for an e-mail link. If you have a URI like + http://www.example.com/lala/foobar@example.com you should get the + full link not the e-mail address. Or you can put a location + like 1600 Amphitheatre Parkway, Mountain View, CA 94043. To summarize: + https://www.google.com, or 650-253-0000, somebody@example.com, + or 9606 North MoPac Expressway, Suite 400, Austin, TX 78759.</string> + <string name="link_text_manual"><![CDATA[<b>text_html_resource: + Explicit links using <a> markup.</b> + This has markup for a <a href="http://www.google.com">link</a> specified + via an <a> tag. Use a \"tel:\" URL + to <a href="tel:4155551212">dial a phone number</a>.]]></string> + +</resources> diff --git a/views/TextLinkify/TextLinkify/src/main/res/values/styles.xml b/views/TextLinkify/TextLinkify/src/main/res/values/styles.xml new file mode 100644 index 00000000..91da12c4 --- /dev/null +++ b/views/TextLinkify/TextLinkify/src/main/res/values/styles.xml @@ -0,0 +1,40 @@ +<!-- + Copyright 2013 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. +--> + +<resources xmlns:android="http://schemas.android.com/apk/res/android"> + + <!-- + Base application theme, dependent on API level. This theme is replaced + by AppBaseTheme from res/values-vXX/styles.xml on newer devices. + --> + <style name="AppBaseTheme" parent="android:Theme.Light"> + <!-- + Theme customizations available in newer API levels can go in + res/values-vXX/styles.xml, while customizations related to + backward-compatibility can go here. + --> + </style> + + <!-- Application theme. --> + <style name="AppTheme" parent="AppBaseTheme"> + <!-- All customizations that are NOT specific to a particular API-level can go here. --> + </style> + + <style name="LinkText"> + <item name="android:paddingTop">9dp</item> + <item name="android:paddingBottom">9dp</item> + </style> +</resources> diff --git a/views/TextLinkify/build.gradle b/views/TextLinkify/build.gradle new file mode 100644 index 00000000..495c5038 --- /dev/null +++ b/views/TextLinkify/build.gradle @@ -0,0 +1 @@ +// Top-level build file where you can add configuration options common to all sub-projects/modules. diff --git a/views/TextLinkify/settings.gradle b/views/TextLinkify/settings.gradle new file mode 100644 index 00000000..20429823 --- /dev/null +++ b/views/TextLinkify/settings.gradle @@ -0,0 +1,2 @@ +include ':TextLinkify' + diff --git a/views/TextLinkify/textLinkify.jd b/views/TextLinkify/textLinkify.jd new file mode 100644 index 00000000..ca39b7b2 --- /dev/null +++ b/views/TextLinkify/textLinkify.jd @@ -0,0 +1,15 @@ +page.title=Linkify Sample +@jd:body +<p>This sample demonstrates how clickable links can be added to a + <a href="http://developer.android.com/reference/android/widget/TextView.html">TextView</a>. + This can be done automatically (see + <a href="http://developer.android.com/reference/android/widget/TextView.html#setAutoLinkMask(int)"> +TextView#setAutoLinkMask(int)</a>), explicitly by parsing a String as + HTML (see + <a href="http://developer.android.com/reference/android/text/Html.html#fromHtml(java.lang.String)"> + Html#fromHtml(String)</a>) or using a + <a href="http://developer.android.com/reference/android/text/SpannableString.html">SpannableString +</a> consisting of + <a href="http://developer.android.com/reference/android/text/style/StyleSpan.html">StyleSpan</a> + and <a href="http://developer.android.com/reference/android/text/style/URLSpan.html">URLSpan</a> + objects. </p>
\ No newline at end of file |