• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2010 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 package android.webkit;
18 
19 import android.app.Fragment;
20 import android.os.Bundle;
21 import android.view.LayoutInflater;
22 import android.view.View;
23 import android.view.ViewGroup;
24 import android.webkit.WebView;
25 
26 /**
27  * A fragment that displays a WebView.
28  * <p>
29  * The WebView is automically paused or resumed when the Fragment is paused or resumed.
30  */
31 public class WebViewFragment extends Fragment {
32     private WebView mWebView;
33     private boolean mIsWebViewAvailable;
34 
WebViewFragment()35     public WebViewFragment() {
36     }
37 
38     /**
39      * Called to instantiate the view. Creates and returns the WebView.
40      */
41     @Override
onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)42     public View onCreateView(LayoutInflater inflater, ViewGroup container,
43             Bundle savedInstanceState) {
44         if (mWebView != null) {
45             mWebView.destroy();
46         }
47         mWebView = new WebView(getContext());
48         mIsWebViewAvailable = true;
49         return mWebView;
50     }
51 
52     /**
53      * Called when the fragment is visible to the user and actively running. Resumes the WebView.
54      */
55     @Override
onPause()56     public void onPause() {
57         super.onPause();
58         mWebView.onPause();
59     }
60 
61     /**
62      * Called when the fragment is no longer resumed. Pauses the WebView.
63      */
64     @Override
onResume()65     public void onResume() {
66         mWebView.onResume();
67         super.onResume();
68     }
69 
70     /**
71      * Called when the WebView has been detached from the fragment.
72      * The WebView is no longer available after this time.
73      */
74     @Override
onDestroyView()75     public void onDestroyView() {
76         mIsWebViewAvailable = false;
77         super.onDestroyView();
78     }
79 
80     /**
81      * Called when the fragment is no longer in use. Destroys the internal state of the WebView.
82      */
83     @Override
onDestroy()84     public void onDestroy() {
85         if (mWebView != null) {
86             mWebView.destroy();
87             mWebView = null;
88         }
89         super.onDestroy();
90     }
91 
92     /**
93      * Gets the WebView.
94      */
getWebView()95     public WebView getWebView() {
96         return mIsWebViewAvailable ? mWebView : null;
97     }
98 }
99