diff --git a/progressfragment-native-sample/AndroidManifest.xml b/progressfragment-native-sample/AndroidManifest.xml new file mode 100644 index 0000000..1abd3c7 --- /dev/null +++ b/progressfragment-native-sample/AndroidManifest.xml @@ -0,0 +1,28 @@ + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/progressfragment-native-sample/build.gradle b/progressfragment-native-sample/build.gradle new file mode 100644 index 0000000..fed504c --- /dev/null +++ b/progressfragment-native-sample/build.gradle @@ -0,0 +1,23 @@ +apply plugin: 'android' + +dependencies { + compile project(':progressfragment-native') +} + +android { + compileSdkVersion 19 + buildToolsVersion '19.0.3' + + defaultConfig { + minSdkVersion 14 + targetSdkVersion 19 + } + + sourceSets { + main { + manifest.srcFile 'AndroidManifest.xml' + java.srcDirs = ['src'] + res.srcDirs = ['res'] + } + } +} \ No newline at end of file diff --git a/progressfragment-native-sample/pom.xml b/progressfragment-native-sample/pom.xml new file mode 100644 index 0000000..d1f43a2 --- /dev/null +++ b/progressfragment-native-sample/pom.xml @@ -0,0 +1,46 @@ + + 4.0.0 + + + com.devspark.progressfragment + parent + 1.4.0-SNAPSHOT + + + progressfragment-native-sample + apk + + Android ProgressFragment (Sample) + + + + + com.devspark.progressfragment + progressfragment-native + ${project.version} + apklib + + + + + src + + + com.jayway.maven.plugins.android.generation2 + android-maven-plugin + true + + + runLint + compile + + lint + + + + + + + \ No newline at end of file diff --git a/progressfragment-native-sample/project.properties b/progressfragment-native-sample/project.properties new file mode 100644 index 0000000..edab5c4 --- /dev/null +++ b/progressfragment-native-sample/project.properties @@ -0,0 +1,16 @@ +# This file is automatically generated by Android Tools. +# Do not modify this file -- YOUR CHANGES WILL BE ERASED! +# +# This file must be checked in Version Control Systems. +# +# To customize properties used by the Ant build system edit +# "ant.properties", and override values to adapt the script to your +# project structure. +# +# To enable ProGuard to shrink and obfuscate your code, uncomment this (available properties: sdk.dir, user.home): +#proguard.config=${sdk.dir}/tools/proguard/proguard-android.txt:proguard-project.txt + +# Project target. +target=android-19 +android.library.reference.1=../progressfragment-native + diff --git a/progressfragment-native-sample/res/drawable-hdpi/ic_launcher.png b/progressfragment-native-sample/res/drawable-hdpi/ic_launcher.png new file mode 100755 index 0000000..e47320b Binary files /dev/null and b/progressfragment-native-sample/res/drawable-hdpi/ic_launcher.png differ diff --git a/progressfragment-native-sample/res/drawable-hdpi/ic_menu_refresh.png b/progressfragment-native-sample/res/drawable-hdpi/ic_menu_refresh.png new file mode 100644 index 0000000..bfbfe62 Binary files /dev/null and b/progressfragment-native-sample/res/drawable-hdpi/ic_menu_refresh.png differ diff --git a/progressfragment-native-sample/res/drawable-mdpi/ic_launcher.png b/progressfragment-native-sample/res/drawable-mdpi/ic_launcher.png new file mode 100755 index 0000000..8af11db Binary files /dev/null and b/progressfragment-native-sample/res/drawable-mdpi/ic_launcher.png differ diff --git a/progressfragment-native-sample/res/drawable-mdpi/ic_menu_refresh.png b/progressfragment-native-sample/res/drawable-mdpi/ic_menu_refresh.png new file mode 100644 index 0000000..ad1fa1d Binary files /dev/null and b/progressfragment-native-sample/res/drawable-mdpi/ic_menu_refresh.png differ diff --git a/progressfragment-native-sample/res/drawable-nodpi/background_card.9.png b/progressfragment-native-sample/res/drawable-nodpi/background_card.9.png new file mode 100644 index 0000000..8cbd7af Binary files /dev/null and b/progressfragment-native-sample/res/drawable-nodpi/background_card.9.png differ diff --git a/progressfragment-native-sample/res/drawable-nodpi/emo_im_crying.png b/progressfragment-native-sample/res/drawable-nodpi/emo_im_crying.png new file mode 100644 index 0000000..3151125 Binary files /dev/null and b/progressfragment-native-sample/res/drawable-nodpi/emo_im_crying.png differ diff --git a/progressfragment-native-sample/res/drawable-nodpi/new_york.jpg b/progressfragment-native-sample/res/drawable-nodpi/new_york.jpg new file mode 100644 index 0000000..a279974 Binary files /dev/null and b/progressfragment-native-sample/res/drawable-nodpi/new_york.jpg differ diff --git a/progressfragment-native-sample/res/drawable-xhdpi/ic_launcher.png b/progressfragment-native-sample/res/drawable-xhdpi/ic_launcher.png new file mode 100755 index 0000000..307e198 Binary files /dev/null and b/progressfragment-native-sample/res/drawable-xhdpi/ic_launcher.png differ diff --git a/progressfragment-native-sample/res/drawable-xhdpi/ic_menu_refresh.png b/progressfragment-native-sample/res/drawable-xhdpi/ic_menu_refresh.png new file mode 100644 index 0000000..068e786 Binary files /dev/null and b/progressfragment-native-sample/res/drawable-xhdpi/ic_menu_refresh.png differ diff --git a/progressfragment-native-sample/res/drawable-xxhdpi/ic_launcher.png b/progressfragment-native-sample/res/drawable-xxhdpi/ic_launcher.png new file mode 100755 index 0000000..069cc2a Binary files /dev/null and b/progressfragment-native-sample/res/drawable-xxhdpi/ic_launcher.png differ diff --git a/progressfragment-native-sample/res/drawable-xxhdpi/ic_menu_refresh.png b/progressfragment-native-sample/res/drawable-xxhdpi/ic_menu_refresh.png new file mode 100644 index 0000000..abc55c8 Binary files /dev/null and b/progressfragment-native-sample/res/drawable-xxhdpi/ic_menu_refresh.png differ diff --git a/progressfragment-native-sample/res/layout/fragment_custom_progress.xml b/progressfragment-native-sample/res/layout/fragment_custom_progress.xml new file mode 100644 index 0000000..e757ea8 --- /dev/null +++ b/progressfragment-native-sample/res/layout/fragment_custom_progress.xml @@ -0,0 +1,73 @@ + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/progressfragment-native-sample/res/layout/view_content.xml b/progressfragment-native-sample/res/layout/view_content.xml new file mode 100644 index 0000000..b43dc1b --- /dev/null +++ b/progressfragment-native-sample/res/layout/view_content.xml @@ -0,0 +1,52 @@ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/progressfragment-native-sample/res/menu/refresh.xml b/progressfragment-native-sample/res/menu/refresh.xml new file mode 100644 index 0000000..fcbafdf --- /dev/null +++ b/progressfragment-native-sample/res/menu/refresh.xml @@ -0,0 +1,26 @@ + + + + + + + \ No newline at end of file diff --git a/progressfragment-native-sample/res/values/strings.xml b/progressfragment-native-sample/res/values/strings.xml new file mode 100644 index 0000000..575ee0a --- /dev/null +++ b/progressfragment-native-sample/res/values/strings.xml @@ -0,0 +1,48 @@ + + + + + Android-ProgressFragment-Native + Refresh + New York City + New York is the most populous city in the United States and the center of the New York + Metropolitan Area, one of the most populous urban agglomerations in the world. The city is referred to as New + York City or the City of New York to distinguish it from the State of New York, of which it is a part. A global + power city, New York exerts a significant impact upon commerce, finance, media, art, fashion, research, + technology, education, and entertainment. The home of the United Nations Headquarters, New York is an important + center for international diplomacy and has been described as the cultural capital of the world. + + No Data + Loading… + + + Apple Pie + Banana Bread + Cupcake + Donut + Eclair + Froyo + Gingerbread + Honeycomb + Ice Cream Sandwich + Jelly Bean + KitKat + + + + \ No newline at end of file diff --git a/progressfragment-native-sample/src/com/devspark/progressfragment/sample/CustomLayoutProgressFragment.java b/progressfragment-native-sample/src/com/devspark/progressfragment/sample/CustomLayoutProgressFragment.java new file mode 100644 index 0000000..8c9d29f --- /dev/null +++ b/progressfragment-native-sample/src/com/devspark/progressfragment/sample/CustomLayoutProgressFragment.java @@ -0,0 +1,104 @@ +/* + * Copyright (C) 2013 Evgeny Shishkin + * + * 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.devspark.progressfragment.sample; + +import android.os.Bundle; +import android.os.Handler; +import android.view.LayoutInflater; +import android.view.Menu; +import android.view.MenuInflater; +import android.view.MenuItem; +import android.view.View; +import android.view.ViewGroup; + +import com.devspark.progressfragment.ProgressFragment; + +/** + * Sample implementation of {@link com.devspark.progressfragment.ProgressFragment}. + * + * @author Evgeny Shishkin + */ +public class CustomLayoutProgressFragment extends ProgressFragment { + private View mContentView; + private Handler mHandler; + private Runnable mShowContentRunnable = new Runnable() { + + @Override + public void run() { + setContentEmpty(true); + setContentShown(true); + } + + }; + + public static CustomLayoutProgressFragment newInstance() { + CustomLayoutProgressFragment fragment = new CustomLayoutProgressFragment(); + return fragment; + } + + @Override + public void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + setHasOptionsMenu(true); + } + + @Override + public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { + mContentView = inflater.inflate(R.layout.view_content, null); + return inflater.inflate(R.layout.fragment_custom_progress, container, false); + } + + @Override + public void onActivityCreated(Bundle savedInstanceState) { + super.onActivityCreated(savedInstanceState); + // Setup content view + setContentView(mContentView); + // Setup text for empty content + setEmptyText(R.string.empty); + obtainData(); + } + + @Override + public void onDestroyView() { + super.onDestroyView(); + mHandler.removeCallbacks(mShowContentRunnable); + } + + @Override + public void onCreateOptionsMenu(Menu menu, MenuInflater inflater) { + inflater.inflate(R.menu.refresh, menu); + } + + @Override + public boolean onOptionsItemSelected(MenuItem item) { + switch (item.getItemId()) { + case R.id.menu_refresh: + obtainData(); + return true; + default: + return super.onOptionsItemSelected(item); + } + } + + private void obtainData() { + // Show indeterminate progress + setContentShown(false); + + mHandler = new Handler(); + mHandler.postDelayed(mShowContentRunnable, 3000); + } +} diff --git a/progressfragment-native-sample/src/com/devspark/progressfragment/sample/DefaultProgressFragment.java b/progressfragment-native-sample/src/com/devspark/progressfragment/sample/DefaultProgressFragment.java new file mode 100644 index 0000000..78f9a1f --- /dev/null +++ b/progressfragment-native-sample/src/com/devspark/progressfragment/sample/DefaultProgressFragment.java @@ -0,0 +1,103 @@ +/* + * Copyright (C) 2013 Evgeny Shishkin + * + * 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.devspark.progressfragment.sample; + +import android.os.Bundle; +import android.os.Handler; +import android.view.LayoutInflater; +import android.view.Menu; +import android.view.MenuInflater; +import android.view.MenuItem; +import android.view.View; +import android.view.ViewGroup; + +import com.devspark.progressfragment.ProgressFragment; + +/** + * Sample implementation of {@link com.devspark.progressfragment.ProgressFragment}. + * + * @author Evgeny Shishkin + */ +public class DefaultProgressFragment extends ProgressFragment { + private View mContentView; + private Handler mHandler; + private Runnable mShowContentRunnable = new Runnable() { + + @Override + public void run() { + setContentShown(true); + } + + }; + + public static DefaultProgressFragment newInstance() { + DefaultProgressFragment fragment = new DefaultProgressFragment(); + return fragment; + } + + @Override + public void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + setHasOptionsMenu(true); + } + + @Override + public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { + mContentView = inflater.inflate(R.layout.view_content, null); + return super.onCreateView(inflater, container, savedInstanceState); + } + + @Override + public void onActivityCreated(Bundle savedInstanceState) { + super.onActivityCreated(savedInstanceState); + // Setup content view + setContentView(mContentView); + // Setup text for empty content + setEmptyText(R.string.empty); + obtainData(); + } + + @Override + public void onDestroyView() { + super.onDestroyView(); + mHandler.removeCallbacks(mShowContentRunnable); + } + + @Override + public void onCreateOptionsMenu(Menu menu, MenuInflater inflater) { + inflater.inflate(R.menu.refresh, menu); + } + + @Override + public boolean onOptionsItemSelected(MenuItem item) { + switch (item.getItemId()) { + case R.id.menu_refresh: + obtainData(); + return true; + default: + return super.onOptionsItemSelected(item); + } + } + + private void obtainData() { + // Show indeterminate progress + setContentShown(false); + + mHandler = new Handler(); + mHandler.postDelayed(mShowContentRunnable, 3000); + } +} diff --git a/progressfragment-native-sample/src/com/devspark/progressfragment/sample/DefaultProgressGridFragment.java b/progressfragment-native-sample/src/com/devspark/progressfragment/sample/DefaultProgressGridFragment.java new file mode 100644 index 0000000..53000a2 --- /dev/null +++ b/progressfragment-native-sample/src/com/devspark/progressfragment/sample/DefaultProgressGridFragment.java @@ -0,0 +1,101 @@ +/* + * Copyright (C) 2013 Evgeny Shishkin + * + * 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.devspark.progressfragment.sample; + +import android.os.Bundle; +import android.os.Handler; +import android.view.Menu; +import android.view.MenuInflater; +import android.view.MenuItem; +import android.view.View; +import android.widget.ArrayAdapter; + +import com.devspark.progressfragment.ProgressGridFragment; + +/** + * Sample implementation of {@link com.devspark.progressfragment.ProgressGridFragment}. + * + * @author Evgeny Shishkin + */ +public class DefaultProgressGridFragment extends ProgressGridFragment { + private Handler mHandler; + private Runnable mShowContentRunnable = new Runnable() { + + @Override + public void run() { + setGridAdapter(new ArrayAdapter(getActivity(), + android.R.layout.simple_list_item_1, getResources().getStringArray(R.array.sweets))); + setGridShown(true); + } + + }; + + public static DefaultProgressGridFragment newInstance() { + DefaultProgressGridFragment fragment = new DefaultProgressGridFragment(); + return fragment; + } + + @Override + public void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + setHasOptionsMenu(true); + } + + @Override + public void onViewCreated(View view, Bundle savedInstanceState) { + super.onViewCreated(view, savedInstanceState); + getGridView().setNumColumns(2); + } + + @Override + public void onActivityCreated(Bundle savedInstanceState) { + super.onActivityCreated(savedInstanceState); + // Setup text for empty content + setEmptyText(R.string.empty); + obtainData(); + } + + @Override + public void onDestroyView() { + super.onDestroyView(); + mHandler.removeCallbacks(mShowContentRunnable); + } + + @Override + public void onCreateOptionsMenu(Menu menu, MenuInflater inflater) { + inflater.inflate(R.menu.refresh, menu); + } + + @Override + public boolean onOptionsItemSelected(MenuItem item) { + switch (item.getItemId()) { + case R.id.menu_refresh: + obtainData(); + return true; + default: + return super.onOptionsItemSelected(item); + } + } + + private void obtainData() { + // Show indeterminate progress + setGridShown(false); + + mHandler = new Handler(); + mHandler.postDelayed(mShowContentRunnable, 3000); + } +} diff --git a/progressfragment-native-sample/src/com/devspark/progressfragment/sample/DefaultProgressListFragment.java b/progressfragment-native-sample/src/com/devspark/progressfragment/sample/DefaultProgressListFragment.java new file mode 100644 index 0000000..c44f698 --- /dev/null +++ b/progressfragment-native-sample/src/com/devspark/progressfragment/sample/DefaultProgressListFragment.java @@ -0,0 +1,94 @@ +/* + * Copyright (C) 2013 Evgeny Shishkin + * + * 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.devspark.progressfragment.sample; + +import android.os.Bundle; +import android.os.Handler; +import android.view.Menu; +import android.view.MenuInflater; +import android.view.MenuItem; +import android.widget.ArrayAdapter; + +import com.devspark.progressfragment.ProgressListFragment; + +/** + * Sample implementation of {@link com.devspark.progressfragment.ProgressListFragment}. + * + * @author Evgeny Shishkin + */ +public class DefaultProgressListFragment extends ProgressListFragment { + private Handler mHandler; + private Runnable mShowContentRunnable = new Runnable() { + + @Override + public void run() { + setListAdapter(new ArrayAdapter(getActivity(), + android.R.layout.simple_list_item_1, getResources().getStringArray(R.array.sweets))); + setListShown(true); + } + + }; + + public static DefaultProgressListFragment newInstance() { + DefaultProgressListFragment fragment = new DefaultProgressListFragment(); + return fragment; + } + + @Override + public void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + setHasOptionsMenu(true); + } + + @Override + public void onActivityCreated(Bundle savedInstanceState) { + super.onActivityCreated(savedInstanceState); + // Setup text for empty content + setEmptyText(R.string.empty); + obtainData(); + } + + @Override + public void onDestroyView() { + super.onDestroyView(); + mHandler.removeCallbacks(mShowContentRunnable); + } + + @Override + public void onCreateOptionsMenu(Menu menu, MenuInflater inflater) { + inflater.inflate(R.menu.refresh, menu); + } + + @Override + public boolean onOptionsItemSelected(MenuItem item) { + switch (item.getItemId()) { + case R.id.menu_refresh: + obtainData(); + return true; + default: + return super.onOptionsItemSelected(item); + } + } + + private void obtainData() { + // Show indeterminate progress + setListShown(false); + + mHandler = new Handler(); + mHandler.postDelayed(mShowContentRunnable, 3000); + } +} diff --git a/progressfragment-native-sample/src/com/devspark/progressfragment/sample/EmptyContentProgressFragment.java b/progressfragment-native-sample/src/com/devspark/progressfragment/sample/EmptyContentProgressFragment.java new file mode 100644 index 0000000..3999909 --- /dev/null +++ b/progressfragment-native-sample/src/com/devspark/progressfragment/sample/EmptyContentProgressFragment.java @@ -0,0 +1,104 @@ +/* + * Copyright (C) 2013 Evgeny Shishkin + * + * 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.devspark.progressfragment.sample; + +import android.os.Bundle; +import android.os.Handler; +import android.view.LayoutInflater; +import android.view.Menu; +import android.view.MenuInflater; +import android.view.MenuItem; +import android.view.View; +import android.view.ViewGroup; + +import com.devspark.progressfragment.ProgressFragment; + +/** + * Sample implementation of {@link com.devspark.progressfragment.ProgressFragment}. + * + * @author Evgeny Shishkin + */ +public class EmptyContentProgressFragment extends ProgressFragment { + private View mContentView; + private Handler mHandler; + private Runnable mShowContentRunnable = new Runnable() { + + @Override + public void run() { + setContentEmpty(true); + setContentShown(true); + } + + }; + + public static EmptyContentProgressFragment newInstance() { + EmptyContentProgressFragment fragment = new EmptyContentProgressFragment(); + return fragment; + } + + @Override + public void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + setHasOptionsMenu(true); + } + + @Override + public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { + mContentView = inflater.inflate(R.layout.view_content, null); + return super.onCreateView(inflater, container, savedInstanceState); + } + + @Override + public void onActivityCreated(Bundle savedInstanceState) { + super.onActivityCreated(savedInstanceState); + // Setup content view + setContentView(mContentView); + // Setup text for empty content + setEmptyText(R.string.empty); + obtainData(); + } + + @Override + public void onDestroyView() { + super.onDestroyView(); + mHandler.removeCallbacks(mShowContentRunnable); + } + + @Override + public void onCreateOptionsMenu(Menu menu, MenuInflater inflater) { + inflater.inflate(R.menu.refresh, menu); + } + + @Override + public boolean onOptionsItemSelected(MenuItem item) { + switch (item.getItemId()) { + case R.id.menu_refresh: + obtainData(); + return true; + default: + return super.onOptionsItemSelected(item); + } + } + + private void obtainData() { + // Show indeterminate progress + setContentShown(false); + + mHandler = new Handler(); + mHandler.postDelayed(mShowContentRunnable, 3000); + } +} diff --git a/progressfragment-native-sample/src/com/devspark/progressfragment/sample/MainActivity.java b/progressfragment-native-sample/src/com/devspark/progressfragment/sample/MainActivity.java new file mode 100644 index 0000000..80fa7d1 --- /dev/null +++ b/progressfragment-native-sample/src/com/devspark/progressfragment/sample/MainActivity.java @@ -0,0 +1,65 @@ +/* + * Copyright (C) 2013 Evgeny Shishkin + * + * 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.devspark.progressfragment.sample; + +import android.app.ListActivity; +import android.content.Intent; +import android.os.Bundle; +import android.view.View; +import android.widget.ArrayAdapter; +import android.widget.ListView; + +/** + * @author Evgeny Shishkin + */ +public class MainActivity extends ListActivity { + + private String[] examples = new String[]{"Default", "Empty content", "Custom layout", "List", "Grid"}; + + @Override + protected void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + ArrayAdapter arrayAdapter = new ArrayAdapter(this, android.R.layout.simple_list_item_1, examples); + setListAdapter(arrayAdapter); + } + + @Override + protected void onListItemClick(ListView l, View v, int position, long id) { + Intent intent = new Intent(this, ProgressActivity.class); + intent.putExtra(ProgressActivity.EXTRA_TITLE, examples[position]); + switch (position) { + case 0: + intent.putExtra(ProgressActivity.EXTRA_FRAGMENT, ProgressActivity.FRAGMENT_DEFAULT); + break; + case 1: + intent.putExtra(ProgressActivity.EXTRA_FRAGMENT, ProgressActivity.FRAGMENT_EMPTY_CONTENT); + break; + case 2: + intent.putExtra(ProgressActivity.EXTRA_FRAGMENT, ProgressActivity.FRAGMENT_CUSTOM_LAYOUT); + break; + case 3: + intent.putExtra(ProgressActivity.EXTRA_FRAGMENT, ProgressActivity.FRAGMENT_LIST); + break; + case 4: + intent.putExtra(ProgressActivity.EXTRA_FRAGMENT, ProgressActivity.FRAGMENT_GRID); + break; + default: + break; + } + startActivity(intent); + } +} diff --git a/progressfragment-native-sample/src/com/devspark/progressfragment/sample/ProgressActivity.java b/progressfragment-native-sample/src/com/devspark/progressfragment/sample/ProgressActivity.java new file mode 100644 index 0000000..08601c8 --- /dev/null +++ b/progressfragment-native-sample/src/com/devspark/progressfragment/sample/ProgressActivity.java @@ -0,0 +1,108 @@ +/* + * Copyright (C) 2013 Evgeny Shishkin + * + * 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.devspark.progressfragment.sample; + +import android.app.ActionBar; +import android.app.Activity; +import android.app.Fragment; +import android.os.Build; +import android.os.Bundle; +import android.view.MenuItem; + +/** + * @author Evgeny Shishkin + */ +public class ProgressActivity extends Activity { + public static final String EXTRA_TITLE = "com.devspark.progressfragment.sample.extras.EXTRA_TITLE"; + public static final String EXTRA_FRAGMENT = "com.devspark.progressfragment.sample.extras.EXTRA_FRAGMENT"; + public static final int FRAGMENT_DEFAULT = 0; + public static final int FRAGMENT_EMPTY_CONTENT = 1; + public static final int FRAGMENT_CUSTOM_LAYOUT = 2; + public static final int FRAGMENT_LIST = 3; + public static final int FRAGMENT_GRID = 4; + + @Override + protected void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + setTitle(getIntent().getStringExtra(EXTRA_TITLE)); + if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) { + new ActionBarHelper().setDisplayHomeAsUpEnabled(true); + } + // Check what fragment is shown, replace if needed. + Fragment fragment = getFragmentManager().findFragmentById(android.R.id.content); + if (fragment == null) { + // Make new fragment to show. + int fragmentId = getIntent().getIntExtra(EXTRA_FRAGMENT, FRAGMENT_DEFAULT); + switch (fragmentId) { + case FRAGMENT_DEFAULT: + fragment = DefaultProgressFragment.newInstance(); + break; + case FRAGMENT_EMPTY_CONTENT: + fragment = EmptyContentProgressFragment.newInstance(); + break; + case FRAGMENT_CUSTOM_LAYOUT: + fragment = CustomLayoutProgressFragment.newInstance(); + break; + case FRAGMENT_LIST: + fragment = DefaultProgressListFragment.newInstance(); + break; + case FRAGMENT_GRID: + fragment = DefaultProgressGridFragment.newInstance(); + break; + default: + fragment = DefaultProgressFragment.newInstance(); + break; + + } + getFragmentManager().beginTransaction().add(android.R.id.content, fragment).commit(); + } + } + + @Override + public boolean onOptionsItemSelected(MenuItem item) { + switch (item.getItemId()) { + case android.R.id.home: + finish(); + return true; + default: + return super.onOptionsItemSelected(item); + } + } + + /** + * Helper for fix issue VerifyError on Android 1.6. On Android 1.6 virtual machine + * tries to resolve (verify) getActionBar function, and since there is no such function, + * Dalvik throws VerifyError. + */ + private class ActionBarHelper { + + /** + * Set whether home should be displayed as an "up" affordance. + * Set this to true if selecting "home" returns up by a single level in your UI + * rather than back to the top level or front page. + * + * @param showHomeAsUp true to show the user that selecting home will return one + * level up rather than to the top level of the app. + */ + private void setDisplayHomeAsUpEnabled(boolean showHomeAsUp) { + ActionBar actionBar = getActionBar(); + if (actionBar != null) { + actionBar.setDisplayHomeAsUpEnabled(showHomeAsUp); + } + } + } +} diff --git a/progressfragment-native-sample/web_hi_res_512.png b/progressfragment-native-sample/web_hi_res_512.png new file mode 100644 index 0000000..4c5bbc3 Binary files /dev/null and b/progressfragment-native-sample/web_hi_res_512.png differ diff --git a/progressfragment-native/AndroidManifest.xml b/progressfragment-native/AndroidManifest.xml new file mode 100644 index 0000000..fd7eb9e --- /dev/null +++ b/progressfragment-native/AndroidManifest.xml @@ -0,0 +1,9 @@ + + + + + + \ No newline at end of file diff --git a/progressfragment-native/build.gradle b/progressfragment-native/build.gradle new file mode 100644 index 0000000..8e1a130 --- /dev/null +++ b/progressfragment-native/build.gradle @@ -0,0 +1,22 @@ +apply plugin: 'android-library' + +android { + compileSdkVersion 19 + buildToolsVersion '19.0.3' + + defaultConfig { + minSdkVersion 13 + targetSdkVersion 19 + } + + sourceSets { + main { + manifest.srcFile 'AndroidManifest.xml' + java.srcDirs = ['src'] + res.srcDirs = ['res'] + } + } +} + +// Used to push in maven +apply from: '../maven_push.gradle' diff --git a/progressfragment-native/gradle.properties b/progressfragment-native/gradle.properties new file mode 100644 index 0000000..3e92d13 --- /dev/null +++ b/progressfragment-native/gradle.properties @@ -0,0 +1,3 @@ +POM_NAME=ProgressFragment Library +POM_ARTIFACT_ID=progressfragment-native +POM_PACKAGING=aar \ No newline at end of file diff --git a/progressfragment-native/pom.xml b/progressfragment-native/pom.xml new file mode 100644 index 0000000..b838597 --- /dev/null +++ b/progressfragment-native/pom.xml @@ -0,0 +1,65 @@ + + 4.0.0 + + + com.devspark.progressfragment + parent + 1.4.0-SNAPSHOT + + + progressfragment-native + apklib + + Android ProgressFragment (Library) + + + src + + + com.jayway.maven.plugins.android.generation2 + android-maven-plugin + true + + + runLint + compile + + lint + + + + + + + org.apache.maven.plugins + maven-source-plugin + + + attach-sources + + jar + + + + + + + org.apache.maven.plugins + maven-javadoc-plugin + + + attach-javadocs + + jar + + + true + + + + + + + \ No newline at end of file diff --git a/progressfragment-native/project.properties b/progressfragment-native/project.properties new file mode 100644 index 0000000..61afc8f --- /dev/null +++ b/progressfragment-native/project.properties @@ -0,0 +1,15 @@ +# This file is automatically generated by Android Tools. +# Do not modify this file -- YOUR CHANGES WILL BE ERASED! +# +# This file must be checked in Version Control Systems. +# +# To customize properties used by the Ant build system edit +# "ant.properties", and override values to adapt the script to your +# project structure. +# +# To enable ProGuard to shrink and obfuscate your code, uncomment this (available properties: sdk.dir, user.home): +#proguard.config=${sdk.dir}/tools/proguard/proguard-android.txt:proguard-project.txt + +android.library=true +# Project target. +target=android-19 diff --git a/progressfragment-native/res/layout/fragment_progress.xml b/progressfragment-native/res/layout/fragment_progress.xml new file mode 100644 index 0000000..c647690 --- /dev/null +++ b/progressfragment-native/res/layout/fragment_progress.xml @@ -0,0 +1,59 @@ + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/progressfragment-native/res/layout/fragment_progress_grid.xml b/progressfragment-native/res/layout/fragment_progress_grid.xml new file mode 100644 index 0000000..f9e4615 --- /dev/null +++ b/progressfragment-native/res/layout/fragment_progress_grid.xml @@ -0,0 +1,64 @@ + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/progressfragment-native/res/layout/fragment_progress_list.xml b/progressfragment-native/res/layout/fragment_progress_list.xml new file mode 100644 index 0000000..1b85ad9 --- /dev/null +++ b/progressfragment-native/res/layout/fragment_progress_list.xml @@ -0,0 +1,64 @@ + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/progressfragment-native/src/com/devspark/progressfragment/ProgressFragment.java b/progressfragment-native/src/com/devspark/progressfragment/ProgressFragment.java new file mode 100644 index 0000000..220656c --- /dev/null +++ b/progressfragment-native/src/com/devspark/progressfragment/ProgressFragment.java @@ -0,0 +1,295 @@ +/* + * Copyright (C) 2013 Evgeny Shishkin + * + * 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.devspark.progressfragment; + +import android.app.Fragment; +import android.os.Bundle; +import android.view.LayoutInflater; +import android.view.View; +import android.view.ViewGroup; +import android.view.animation.AnimationUtils; +import android.widget.TextView; + +/** + * The implementation of the fragment to display content. Based on {@link android.app.ListFragment}. + * If you are waiting for the initial data, you'll can displaying during this time an indeterminate progress indicator. + * + * @author Evgeny Shishkin + */ +public class ProgressFragment extends Fragment { + + private View mProgressContainer; + private View mContentContainer; + private View mContentView; + private View mEmptyView; + private boolean mContentShown; + private boolean mIsContentEmpty; + + public ProgressFragment() { + } + + /** + * Provide default implementation to return a simple view. Subclasses + * can override to replace with their own layout. If doing so, the + * returned view hierarchy must have a progress container whose id + * is {@link com.devspark.progressfragment.R.id#progress_container R.id.progress_container}, content container whose id + * is {@link com.devspark.progressfragment.R.id#content_container R.id.content_container} and can optionally + * have a sibling view id {@link android.R.id#empty android.R.id.empty} + * that is to be shown when the content is empty. + *

+ *

If you are overriding this method with your own custom content, + * consider including the standard layout {@link com.devspark.progressfragment.R.layout#fragment_progress} + * in your layout file, so that you continue to retain all of the standard + * behavior of ProgressFragment. In particular, this is currently the only + * way to have the built-in indeterminant progress state be shown. + */ + @Override + public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { + return inflater.inflate(R.layout.fragment_progress, container, false); + } + + /** + * Attach to view once the view hierarchy has been created. + */ + @Override + public void onViewCreated(View view, Bundle savedInstanceState) { + super.onViewCreated(view, savedInstanceState); + ensureContent(); + } + + /** + * Detach from view. + */ + @Override + public void onDestroyView() { + mContentShown = false; + mIsContentEmpty = false; + mProgressContainer = mContentContainer = mContentView = mEmptyView = null; + super.onDestroyView(); + } + + /** + * Return content view or null if the content view has not been initialized. + * + * @return content view or null + * @see #setContentView(android.view.View) + * @see #setContentView(int) + */ + public View getContentView() { + return mContentView; + } + + /** + * Set the content content from a layout resource. + * + * @param layoutResId Resource ID to be inflated. + * @see #setContentView(android.view.View) + * @see #getContentView() + */ + public void setContentView(int layoutResId) { + LayoutInflater layoutInflater = LayoutInflater.from(getActivity()); + View contentView = layoutInflater.inflate(layoutResId, null); + setContentView(contentView); + } + + /** + * Set the content view to an explicit view. If the content view was installed earlier, + * the content will be replaced with a new view. + * + * @param view The desired content to display. Value can't be null. + * @see #setContentView(int) + * @see #getContentView() + */ + public void setContentView(View view) { + ensureContent(); + if (view == null) { + throw new IllegalArgumentException("Content view can't be null"); + } + if (mContentContainer instanceof ViewGroup) { + ViewGroup contentContainer = (ViewGroup) mContentContainer; + if (mContentView == null) { + contentContainer.addView(view); + } else { + int index = contentContainer.indexOfChild(mContentView); + // replace content view + contentContainer.removeView(mContentView); + contentContainer.addView(view, index); + } + mContentView = view; + } else { + throw new IllegalStateException("Can't be used with a custom content view"); + } + } + + /** + * The default content for a ProgressFragment has a TextView that can be shown when + * the content is empty {@link #setContentEmpty(boolean)}. + * If you would like to have it shown, call this method to supply the text it should use. + * + * @param resId Identification of string from a resources + * @see #setEmptyText(CharSequence) + */ + public void setEmptyText(int resId) { + setEmptyText(getString(resId)); + } + + /** + * The default content for a ProgressFragment has a TextView that can be shown when + * the content is empty {@link #setContentEmpty(boolean)}. + * If you would like to have it shown, call this method to supply the text it should use. + * + * @param text Text for empty view + * @see #setEmptyText(int) + */ + public void setEmptyText(CharSequence text) { + ensureContent(); + if (mEmptyView != null && mEmptyView instanceof TextView) { + ((TextView) mEmptyView).setText(text); + } else { + throw new IllegalStateException("Can't be used with a custom content view"); + } + } + + /** + * Control whether the content is being displayed. You can make it not + * displayed if you are waiting for the initial data to show in it. During + * this time an indeterminant progress indicator will be shown instead. + * + * @param shown If true, the content view is shown; if false, the progress + * indicator. The initial value is true. + * @see #setContentShownNoAnimation(boolean) + */ + public void setContentShown(boolean shown) { + setContentShown(shown, true); + } + + /** + * Like {@link #setContentShown(boolean)}, but no animation is used when + * transitioning from the previous state. + * + * @param shown If true, the content view is shown; if false, the progress + * indicator. The initial value is true. + * @see #setContentShown(boolean) + */ + public void setContentShownNoAnimation(boolean shown) { + setContentShown(shown, false); + } + + /** + * Control whether the content is being displayed. You can make it not + * displayed if you are waiting for the initial data to show in it. During + * this time an indeterminant progress indicator will be shown instead. + * + * @param shown If true, the content view is shown; if false, the progress + * indicator. The initial value is true. + * @param animate If true, an animation will be used to transition to the + * new state. + */ + private void setContentShown(boolean shown, boolean animate) { + ensureContent(); + if (mContentShown == shown) { + return; + } + mContentShown = shown; + if (shown) { + if (animate) { + mProgressContainer.startAnimation(AnimationUtils.loadAnimation(getActivity(), android.R.anim.fade_out)); + mContentContainer.startAnimation(AnimationUtils.loadAnimation(getActivity(), android.R.anim.fade_in)); + } else { + mProgressContainer.clearAnimation(); + mContentContainer.clearAnimation(); + } + mProgressContainer.setVisibility(View.GONE); + mContentContainer.setVisibility(View.VISIBLE); + } else { + if (animate) { + mProgressContainer.startAnimation(AnimationUtils.loadAnimation(getActivity(), android.R.anim.fade_in)); + mContentContainer.startAnimation(AnimationUtils.loadAnimation(getActivity(), android.R.anim.fade_out)); + } else { + mProgressContainer.clearAnimation(); + mContentContainer.clearAnimation(); + } + mProgressContainer.setVisibility(View.VISIBLE); + mContentContainer.setVisibility(View.GONE); + } + } + + /** + * Returns true if content is empty. The default content is not empty. + * + * @return true if content is null or empty + * @see #setContentEmpty(boolean) + */ + public boolean isContentEmpty() { + return mIsContentEmpty; + } + + /** + * If the content is empty, then set true otherwise false. The default content is not empty. + * You can't call this method if the content view has not been initialized before + * {@link #setContentView(android.view.View)} and content view not null. + * + * @param isEmpty true if content is empty else false + * @see #isContentEmpty() + */ + public void setContentEmpty(boolean isEmpty) { + ensureContent(); + if (mContentView == null) { + throw new IllegalStateException("Content view must be initialized before"); + } + if (isEmpty) { + mEmptyView.setVisibility(View.VISIBLE); + mContentView.setVisibility(View.GONE); + } else { + mEmptyView.setVisibility(View.GONE); + mContentView.setVisibility(View.VISIBLE); + } + mIsContentEmpty = isEmpty; + } + + /** + * Initialization views. + */ + private void ensureContent() { + if (mContentContainer != null && mProgressContainer != null) { + return; + } + View root = getView(); + if (root == null) { + throw new IllegalStateException("Content view not yet created"); + } + mProgressContainer = root.findViewById(R.id.progress_container); + if (mProgressContainer == null) { + throw new RuntimeException("Your content must have a ViewGroup whose id attribute is 'R.id.progress_container'"); + } + mContentContainer = root.findViewById(R.id.content_container); + if (mContentContainer == null) { + throw new RuntimeException("Your content must have a ViewGroup whose id attribute is 'R.id.content_container'"); + } + mEmptyView = root.findViewById(android.R.id.empty); + if (mEmptyView != null) { + mEmptyView.setVisibility(View.GONE); + } + mContentShown = true; + // We are starting without a content, so assume we won't + // have our data right away and start with the progress indicator. + if (mContentView == null) { + setContentShown(false, false); + } + } + +} diff --git a/progressfragment-native/src/com/devspark/progressfragment/ProgressGridFragment.java b/progressfragment-native/src/com/devspark/progressfragment/ProgressGridFragment.java new file mode 100644 index 0000000..e5794a7 --- /dev/null +++ b/progressfragment-native/src/com/devspark/progressfragment/ProgressGridFragment.java @@ -0,0 +1,340 @@ +/* + * Copyright (C) 2013 Evgeny Shishkin + * + * 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.devspark.progressfragment; + +import android.app.Fragment; +import android.os.Bundle; +import android.os.Handler; +import android.view.LayoutInflater; +import android.view.View; +import android.view.ViewGroup; +import android.view.animation.AnimationUtils; +import android.widget.AdapterView; +import android.widget.GridView; +import android.widget.ListAdapter; +import android.widget.TextView; + +/** + * The implementation of the fragment to display grid view. Based on {@link android.app.ListFragment}. + * If you are waiting for the initial data, you'll can displaying during this time an indeterminate progress indicator. + * + * @author Evgeny Shishkin + */ +public class ProgressGridFragment extends Fragment { + + final private Handler mHandler = new Handler(); + final private Runnable mRequestFocus = new Runnable() { + public void run() { + mGridView.focusableViewAvailable(mGridView); + } + }; + final private AdapterView.OnItemClickListener mOnClickListener + = new AdapterView.OnItemClickListener() { + public void onItemClick(AdapterView parent, View v, int position, long id) { + onGridItemClick((GridView) parent, v, position, id); + } + }; + private ListAdapter mAdapter; + private GridView mGridView; + private View mEmptyView; + private TextView mStandardEmptyView; + private View mProgressContainer; + private View mGridContainer; + private CharSequence mEmptyText; + private boolean mGridShown; + + public ProgressGridFragment() { + } + + /** + * Provide default implementation to return a simple grid view. Subclasses + * can override to replace with their own layout. If doing so, the + * returned view hierarchy must have a GridView whose id + * is {@link com.devspark.progressfragment.R.id#grid R.id.grid} and can optionally + * have a sibling view id {@link android.R.id#empty android.R.id.empty} + * that is to be shown when the list is empty. + *

+ *

If you are overriding this method with your own custom content, + * consider including the standard layout {@link com.devspark.progressfragment.R.layout#fragment_progress_grid} + * in your layout file, so that you continue to retain all of the standard + * behavior of ProgressGridFragment. In particular, this is currently the only + * way to have the built-in indeterminant progress state be shown. + */ + @Override + public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { + return inflater.inflate(R.layout.fragment_progress_grid, container, false); + } + + /** + * Attach to grid view once the view hierarchy has been created. + */ + @Override + public void onViewCreated(View view, Bundle savedInstanceState) { + super.onViewCreated(view, savedInstanceState); + ensureList(); + } + + /** + * Detach from grid view. + */ + @Override + public void onDestroyView() { + mHandler.removeCallbacks(mRequestFocus); + mGridView = null; + mGridShown = false; + mEmptyView = mProgressContainer = mGridContainer = null; + mStandardEmptyView = null; + super.onDestroyView(); + } + + /** + * This method will be called when an item in the grid is selected. + * Subclasses should override. Subclasses can call + * getGridView().getItemAtPosition(position) if they need to access the + * data associated with the selected item. + * + * @param gridView The GridView where the click happened + * @param v The view that was clicked within the ListView + * @param position The position of the view in the list + * @param id The row id of the item that was clicked + */ + public void onGridItemClick(GridView gridView, View v, int position, long id) { + } + + /** + * Set the currently selected grid item to the specified + * position with the adapter's data + * + * @param position + */ + public void setSelection(int position) { + ensureList(); + mGridView.setSelection(position); + } + + /** + * Get the position of the currently selected grid item. + */ + public int getSelectedItemPosition() { + ensureList(); + return mGridView.getSelectedItemPosition(); + } + + /** + * Get the cursor row ID of the currently selected grid item. + */ + public long getSelectedItemId() { + ensureList(); + return mGridView.getSelectedItemId(); + } + + /** + * Get the activity's grid view widget. + */ + public GridView getGridView() { + ensureList(); + return mGridView; + } + + /** + * The default content for a ProgressGridFragment has a TextView that can + * be shown when the grid is empty. If you would like to have it + * shown, call this method to supply the text it should use. + * + * @param resId Identification of string from a resources + * @see #setEmptyText(CharSequence) + */ + public void setEmptyText(int resId) { + setEmptyText(getString(resId)); + } + + /** + * The default content for a ProgressGridFragment has a TextView that can + * be shown when the grid is empty. If you would like to have it + * shown, call this method to supply the text it should use. + * + * @param text Text for empty view + * @see #setEmptyText(int) + */ + public void setEmptyText(CharSequence text) { + ensureList(); + if (mStandardEmptyView == null) { + throw new IllegalStateException("Can't be used with a custom content view"); + } + mStandardEmptyView.setText(text); + if (mEmptyText == null) { + mGridView.setEmptyView(mStandardEmptyView); + } + mEmptyText = text; + } + + /** + * Control whether the grid is being displayed. You can make it not + * displayed if you are waiting for the initial data to show in it. During + * this time an indeterminant progress indicator will be shown instead. + *

+ *

Applications do not normally need to use this themselves. The default + * behavior of ProgressGridFragment is to start with the grid not being shown, only + * showing it once an adapter is given with {@link #setGridAdapter(android.widget.ListAdapter)}. + * If the grid at that point had not been shown, when it does get shown + * it will be do without the user ever seeing the hidden state. + * + * @param shown If true, the grid view is shown; if false, the progress + * indicator. The initial value is true. + */ + public void setGridShown(boolean shown) { + setGridShown(shown, true); + } + + /** + * Like {@link #setGridShown(boolean)}, but no animation is used when + * transitioning from the previous state. + */ + public void setGridShownNoAnimation(boolean shown) { + setGridShown(shown, false); + } + + /** + * Control whether the grid is being displayed. You can make it not + * displayed if you are waiting for the initial data to show in it. During + * this time an indeterminant progress indicator will be shown instead. + * + * @param shown If true, the grid view is shown; if false, the progress + * indicator. The initial value is true. + * @param animate If true, an animation will be used to transition to the + * new state. + */ + private void setGridShown(boolean shown, boolean animate) { + ensureList(); + if (mProgressContainer == null) { + throw new IllegalStateException("Can't be used with a custom content view"); + } + if (mGridShown == shown) { + return; + } + mGridShown = shown; + if (shown) { + if (animate) { + mProgressContainer.startAnimation(AnimationUtils.loadAnimation( + getActivity(), android.R.anim.fade_out)); + mGridContainer.startAnimation(AnimationUtils.loadAnimation( + getActivity(), android.R.anim.fade_in)); + } else { + mProgressContainer.clearAnimation(); + mGridContainer.clearAnimation(); + } + mProgressContainer.setVisibility(View.GONE); + mGridContainer.setVisibility(View.VISIBLE); + } else { + if (animate) { + mProgressContainer.startAnimation(AnimationUtils.loadAnimation( + getActivity(), android.R.anim.fade_in)); + mGridContainer.startAnimation(AnimationUtils.loadAnimation( + getActivity(), android.R.anim.fade_out)); + } else { + mProgressContainer.clearAnimation(); + mGridContainer.clearAnimation(); + } + mProgressContainer.setVisibility(View.VISIBLE); + mGridContainer.setVisibility(View.GONE); + } + } + + /** + * Get the ListAdapter associated with this activity's GridView. + */ + public ListAdapter getGridAdapter() { + return mAdapter; + } + + /** + * Provide the cursor for the grid view. + */ + public void setGridAdapter(ListAdapter adapter) { + boolean hadAdapter = mAdapter != null; + mAdapter = adapter; + if (mGridView != null) { + mGridView.setAdapter(adapter); + if (!mGridShown && !hadAdapter) { + // The grid was hidden, and previously didn't have an + // adapter. It is now time to show it. + setGridShown(true, getView().getWindowToken() != null); + } + } + } + + private void ensureList() { + if (mGridView != null) { + return; + } + View root = getView(); + if (root == null) { + throw new IllegalStateException("Content view not yet created"); + } + if (root instanceof GridView) { + mGridView = (GridView) root; + } else { + View emptyView = root.findViewById(android.R.id.empty); + if (emptyView != null) { + if (emptyView instanceof TextView) { + mStandardEmptyView = (TextView) emptyView; + } else { + mEmptyView = emptyView; + } + } else { + mStandardEmptyView.setVisibility(View.GONE); + } + mProgressContainer = root.findViewById(R.id.progress_container); + mGridContainer = root.findViewById(R.id.grid_container); + View rawGridView = root.findViewById(R.id.grid); + if (!(rawGridView instanceof GridView)) { + throw new RuntimeException( + "Content has view with id attribute 'R.id.grid' " + + "that is not a GridView class" + ); + } + mGridView = (GridView) rawGridView; + if (mGridView == null) { + throw new RuntimeException( + "Your content must have a GridView whose id attribute is " + + "'R.id.grid'" + ); + } + if (mEmptyView != null) { + mGridView.setEmptyView(mEmptyView); + } else if (mEmptyText != null) { + mStandardEmptyView.setText(mEmptyText); + mGridView.setEmptyView(mStandardEmptyView); + } + } + mGridShown = true; + mGridView.setOnItemClickListener(mOnClickListener); + if (mAdapter != null) { + ListAdapter adapter = mAdapter; + mAdapter = null; + setGridAdapter(adapter); + } else { + // We are starting without an adapter, so assume we won't + // have our data right away and start with the progress indicator. + if (mProgressContainer != null) { + setGridShown(false, false); + } + } + mHandler.post(mRequestFocus); + } + +} diff --git a/progressfragment-native/src/com/devspark/progressfragment/ProgressListFragment.java b/progressfragment-native/src/com/devspark/progressfragment/ProgressListFragment.java new file mode 100644 index 0000000..d340192 --- /dev/null +++ b/progressfragment-native/src/com/devspark/progressfragment/ProgressListFragment.java @@ -0,0 +1,340 @@ +/* + * Copyright (C) 2013 Evgeny Shishkin + * + * 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.devspark.progressfragment; + +import android.app.Fragment; +import android.os.Bundle; +import android.os.Handler; +import android.view.LayoutInflater; +import android.view.View; +import android.view.ViewGroup; +import android.view.animation.AnimationUtils; +import android.widget.AdapterView; +import android.widget.ListAdapter; +import android.widget.ListView; +import android.widget.TextView; + +/** + * The implementation of the fragment to display list view. Based on {@link android.app.ListFragment}. + * If you are waiting for the initial data, you'll can displaying during this time an indeterminate progress indicator. + * + * @author Evgeny Shishkin + */ +public class ProgressListFragment extends Fragment { + + final private Handler mHandler = new Handler(); + final private Runnable mRequestFocus = new Runnable() { + public void run() { + mListView.focusableViewAvailable(mListView); + } + }; + final private AdapterView.OnItemClickListener mOnClickListener + = new AdapterView.OnItemClickListener() { + public void onItemClick(AdapterView parent, View v, int position, long id) { + onListItemClick((ListView) parent, v, position, id); + } + }; + private ListAdapter mAdapter; + private ListView mListView; + private View mEmptyView; + private TextView mStandardEmptyView; + private View mProgressContainer; + private View mListContainer; + private CharSequence mEmptyText; + private boolean mListShown; + + public ProgressListFragment() { + } + + /** + * Provide default implementation to return a simple list view. Subclasses + * can override to replace with their own layout. If doing so, the + * returned view hierarchy must have a ListView whose id + * is {@link android.R.id#list android.R.id.list} and can optionally + * have a sibling view id {@link android.R.id#empty android.R.id.empty} + * that is to be shown when the list is empty. + *

+ *

If you are overriding this method with your own custom content, + * consider including the standard layout {@link com.devspark.progressfragment.R.layout#fragment_progress_list} + * in your layout file, so that you continue to retain all of the standard + * behavior of ListFragment. In particular, this is currently the only + * way to have the built-in indeterminant progress state be shown. + */ + @Override + public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { + return inflater.inflate(R.layout.fragment_progress_list, container, false); + } + + /** + * Attach to list view once the view hierarchy has been created. + */ + @Override + public void onViewCreated(View view, Bundle savedInstanceState) { + super.onViewCreated(view, savedInstanceState); + ensureList(); + } + + /** + * Detach from list view. + */ + @Override + public void onDestroyView() { + mHandler.removeCallbacks(mRequestFocus); + mListView = null; + mListShown = false; + mEmptyView = mProgressContainer = mListContainer = null; + mStandardEmptyView = null; + super.onDestroyView(); + } + + /** + * This method will be called when an item in the list is selected. + * Subclasses should override. Subclasses can call + * getListView().getItemAtPosition(position) if they need to access the + * data associated with the selected item. + * + * @param l The ListView where the click happened + * @param v The view that was clicked within the ListView + * @param position The position of the view in the list + * @param id The row id of the item that was clicked + */ + public void onListItemClick(ListView l, View v, int position, long id) { + } + + /** + * Set the currently selected list item to the specified + * position with the adapter's data + * + * @param position + */ + public void setSelection(int position) { + ensureList(); + mListView.setSelection(position); + } + + /** + * Get the position of the currently selected list item. + */ + public int getSelectedItemPosition() { + ensureList(); + return mListView.getSelectedItemPosition(); + } + + /** + * Get the cursor row ID of the currently selected list item. + */ + public long getSelectedItemId() { + ensureList(); + return mListView.getSelectedItemId(); + } + + /** + * Get the activity's list view widget. + */ + public ListView getListView() { + ensureList(); + return mListView; + } + + /** + * The default content for a ProgressListFragment has a TextView that can + * be shown when the list is empty. If you would like to have it + * shown, call this method to supply the text it should use. + * + * @param resId Identification of string from a resources + * @see #setEmptyText(CharSequence) + */ + public void setEmptyText(int resId) { + setEmptyText(getString(resId)); + } + + /** + * The default content for a ProgressListFragment has a TextView that can + * be shown when the list is empty. If you would like to have it + * shown, call this method to supply the text it should use. + * + * @param text Text for empty view + * @see #setEmptyText(int) + */ + public void setEmptyText(CharSequence text) { + ensureList(); + if (mStandardEmptyView == null) { + throw new IllegalStateException("Can't be used with a custom content view"); + } + mStandardEmptyView.setText(text); + if (mEmptyText == null) { + mListView.setEmptyView(mStandardEmptyView); + } + mEmptyText = text; + } + + /** + * Control whether the list is being displayed. You can make it not + * displayed if you are waiting for the initial data to show in it. During + * this time an indeterminant progress indicator will be shown instead. + *

+ *

Applications do not normally need to use this themselves. The default + * behavior of ProgressListFragment is to start with the list not being shown, only + * showing it once an adapter is given with {@link #setListAdapter(ListAdapter)}. + * If the list at that point had not been shown, when it does get shown + * it will be do without the user ever seeing the hidden state. + * + * @param shown If true, the list view is shown; if false, the progress + * indicator. The initial value is true. + */ + public void setListShown(boolean shown) { + setListShown(shown, true); + } + + /** + * Like {@link #setListShown(boolean)}, but no animation is used when + * transitioning from the previous state. + */ + public void setListShownNoAnimation(boolean shown) { + setListShown(shown, false); + } + + /** + * Control whether the list is being displayed. You can make it not + * displayed if you are waiting for the initial data to show in it. During + * this time an indeterminant progress indicator will be shown instead. + * + * @param shown If true, the list view is shown; if false, the progress + * indicator. The initial value is true. + * @param animate If true, an animation will be used to transition to the + * new state. + */ + private void setListShown(boolean shown, boolean animate) { + ensureList(); + if (mProgressContainer == null) { + throw new IllegalStateException("Can't be used with a custom content view"); + } + if (mListShown == shown) { + return; + } + mListShown = shown; + if (shown) { + if (animate) { + mProgressContainer.startAnimation(AnimationUtils.loadAnimation( + getActivity(), android.R.anim.fade_out)); + mListContainer.startAnimation(AnimationUtils.loadAnimation( + getActivity(), android.R.anim.fade_in)); + } else { + mProgressContainer.clearAnimation(); + mListContainer.clearAnimation(); + } + mProgressContainer.setVisibility(View.GONE); + mListContainer.setVisibility(View.VISIBLE); + } else { + if (animate) { + mProgressContainer.startAnimation(AnimationUtils.loadAnimation( + getActivity(), android.R.anim.fade_in)); + mListContainer.startAnimation(AnimationUtils.loadAnimation( + getActivity(), android.R.anim.fade_out)); + } else { + mProgressContainer.clearAnimation(); + mListContainer.clearAnimation(); + } + mProgressContainer.setVisibility(View.VISIBLE); + mListContainer.setVisibility(View.GONE); + } + } + + /** + * Get the ListAdapter associated with this activity's ListView. + */ + public ListAdapter getListAdapter() { + return mAdapter; + } + + /** + * Provide the cursor for the list view. + */ + public void setListAdapter(ListAdapter adapter) { + boolean hadAdapter = mAdapter != null; + mAdapter = adapter; + if (mListView != null) { + mListView.setAdapter(adapter); + if (!mListShown && !hadAdapter) { + // The list was hidden, and previously didn't have an + // adapter. It is now time to show it. + setListShown(true, getView().getWindowToken() != null); + } + } + } + + private void ensureList() { + if (mListView != null) { + return; + } + View root = getView(); + if (root == null) { + throw new IllegalStateException("Content view not yet created"); + } + if (root instanceof ListView) { + mListView = (ListView) root; + } else { + View emptyView = root.findViewById(android.R.id.empty); + if (emptyView != null) { + if (emptyView instanceof TextView) { + mStandardEmptyView = (TextView) emptyView; + } else { + mEmptyView = emptyView; + } + } else { + mStandardEmptyView.setVisibility(View.GONE); + } + mProgressContainer = root.findViewById(R.id.progress_container); + mListContainer = root.findViewById(R.id.list_container); + View rawListView = root.findViewById(android.R.id.list); + if (!(rawListView instanceof ListView)) { + throw new RuntimeException( + "Content has view with id attribute 'android.R.id.list' " + + "that is not a ListView class" + ); + } + mListView = (ListView) rawListView; + if (mListView == null) { + throw new RuntimeException( + "Your content must have a ListView whose id attribute is " + + "'android.R.id.list'" + ); + } + if (mEmptyView != null) { + mListView.setEmptyView(mEmptyView); + } else if (mEmptyText != null) { + mStandardEmptyView.setText(mEmptyText); + mListView.setEmptyView(mStandardEmptyView); + } + } + mListShown = true; + mListView.setOnItemClickListener(mOnClickListener); + if (mAdapter != null) { + ListAdapter adapter = mAdapter; + mAdapter = null; + setListAdapter(adapter); + } else { + // We are starting without an adapter, so assume we won't + // have our data right away and start with the progress indicator. + if (mProgressContainer != null) { + setListShown(false, false); + } + } + mHandler.post(mRequestFocus); + } + +} diff --git a/settings.gradle b/settings.gradle index 921e318..2464442 100644 --- a/settings.gradle +++ b/settings.gradle @@ -2,3 +2,5 @@ include ':progressfragment' include ':progressfragment-sample' include ':sherlockprogressfragment' include ':sherlockprogressfragment-sample' +include ':progressfragment-native' +include ':progressfragment-native-sample'