頂部 ViewFlipper 承載多頁內容 (圖片/佈局),用戶左右滑動切換,底部圓點指示器同步高亮,支持「進入程序」按鈕跳轉。
ViewFlipper:繼承 ViewAnimator,內建 showNext()/showPrevious()、進出動畫設置GestureDetector + OnGestureListener:攔截觸摸事件,識別 onFling 滑動手勢AnimationUtils.loadAnimation:加載 XML 定義的進出動畫<FrameLayout xmlns:android="https://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent">
<ViewFlipper
android:id="@+id/viewFlipper"
android:layout_width="match_parent"
android:layout_height="match_parent" />
<!-- 底部指示器 -->
<LinearLayout
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="bottom|center_horizontal"
android:layout_marginBottom="30dp"
android:orientation="horizontal"
android:id="@+id/ll_indicators">
<ImageView android:id="@+id/iv_dot0" android:layout_width="12dp" android:layout_height="12dp" android:layout_margin="4dp" android:src="@drawable/dot_selected" />
<ImageView android:id="@+id/iv_dot1" android:layout_width="12dp" android:layout_height="12dp" android:layout_margin="4dp" android:src="@drawable/dot_normal" />
<ImageView android:id="@+id/iv_dot2" android:layout_width="12dp" android:layout_height="12dp" android:layout_margin="4dp" android:src="@drawable/dot_normal" />
<ImageView android:id="@+id/iv_dot3" android:layout_width="12dp" android:layout_height="12dp" android:layout_margin="4dp" android:src="@drawable/dot_normal" />
</LinearLayout>
</FrameLayout>
public class MainActivity extends AppCompatActivity implements GestureDetector.OnGestureListener {
private ViewFlipper viewFlipper;
private GestureDetector gestureDetector;
private ImageView[] dots = new ImageView[4];
private int currentIndex = 0;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
viewFlipper = findViewById(R.id.viewFlipper);
gestureDetector = new GestureDetector(this, this);
// 1. 添加頁面 (3 張圖片 + 1 個帶按鈕的佈局)
viewFlipper.addView(createImageView(R.drawable.page1));
viewFlipper.addView(createImageView(R.drawable.page2));
viewFlipper.addView(createImageView(R.drawable.page3));
viewFlipper.addView(LayoutInflater.from(this).inflate(R.layout.page_enter, null));
// 2. 綁定指示器
dots[0] = findViewById(R.id.iv_dot0);
dots[1] = findViewById(R.id.iv_dot1);
dots[2] = findViewById(R.id.iv_dot2);
dots[3] = findViewById(R.id.iv_dot3);
updateDots(0);
// 3. 進入按鈕點擊
View enterPage = viewFlipper.getChildAt(3);
enterPage.findViewById(R.id.btn_enter).setOnClickListener(v -> {
startActivity(new Intent(this, HomeActivity.class));
finish();
});
}
private ImageView createImageView(@DrawableRes int resId) {
ImageView iv = new ImageView(this);
iv.setScaleType(ImageView.ScaleType.CENTER_CROP);
iv.setImageResource(resId);
return iv;
}
// 觸摸事件分發給 GestureDetector
@Override
public boolean onTouchEvent(MotionEvent event) {
return gestureDetector.onTouchEvent(event);
}
// 滑動手勢判斷
@Override
public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {
float diffX = e1.getX() - e2.getX();
if (Math.abs(diffX) > 120 && Math.abs(velocityX) > 200) { // 閾值:距離 120px、速度 200px/s
if (diffX > 0) { // 左滑 → 下一頁
if (currentIndex < 3) {
currentIndex++;
switchPage(true);
}
} else { // 右滑 → 上一頁
if (currentIndex > 0) {
currentIndex--;
switchPage(false);
}
}
return true;
}
return false;
}
private void switchPage(boolean forward) {
if (forward) {
viewFlipper.setInAnimation(this, R.anim.slide_in_right);
viewFlipper.setOutAnimation(this, R.anim.slide_out_left);
viewFlipper.showNext();
} else {
viewFlipper.setInAnimation(this, R.anim.slide_in_left);
viewFlipper.setOutAnimation(this, R.anim.slide_out_right);
viewFlipper.showPrevious();
}
updateDots(currentIndex);
}
private void updateDots(int selected) {
for (int i = 0; i < dots.length; i++) {
dots[i].setImageResource(i == selected ? R.drawable.dot_selected : R.drawable.dot_normal);
}
}
// 其他 GestureDetector 方法空實現
@Override public boolean onDown(MotionEvent e) { return true; }
@Override public void onShowPress(MotionEvent e) {}
@Override public boolean onSingleTapUp(MotionEvent e) { return false; }
@Override public void onLongPress(MotionEvent e) {}
@Override public boolean onScroll(MotionEvent e1, MotionEvent e2, float dX, float dY) { return false; }
}
<!-- slide_in_right.xml -->
<set xmlns:android="https://schemas.android.com/apk/res/android">
<translate android:fromXDelta="100%" android:toXDelta="0%" android:duration="300" />
</set>
<!-- slide_out_left.xml -->
<set xmlns:android="https://schemas.android.com/apk/res/android">
<translate android:fromXDelta="0%" android:toXDelta="-100%" android:duration="300" />
</set>
<!-- slide_in_left.xml -->
<set xmlns:android="https://schemas.android.com/apk/res/android">
<translate android:fromXDelta="-100%" android:toXDelta="0%" android:duration="300" />
</set>
<!-- slide_out_right.xml -->
<set xmlns:android="https://schemas.android.com/apk/res/android">
<translate android:fromXDelta="0%" android:toXDelta="100%" android:duration="300" />
</set>
<!-- dot_selected.xml -->
<shape xmlns:android="https://schemas.android.com/apk/res/android" android:shape="oval">
<solid android:color="#FF3366" />
<size android:width="12dp" android:height="12dp" />
</shape>
<!-- dot_normal.xml -->
<shape xmlns:android="https://schemas.android.com/apk/res/android" android:shape="oval">
<solid android:color="#CCCCCC" />
<size android:width="12dp" android:height="12dp" />
</shape>
ViewFlipper 適合簡單線性切換,但缺乏:
新項目建議使用 ViewPager2:
// ViewPager2 + FragmentStateAdapter
viewPager2.setAdapter(new FragmentStateAdapter(this) {
@NonNull @Override public Fragment createFragment(int position) {
return GuidePageFragment.newInstance(position);
}
@Override public int getItemCount() { return 4; }
});
// 指示器聯動
viewPager2.registerOnPageChangeCallback(new ViewPager2.OnPageChangeCallback() {
@Override public void onPageSelected(int position) { updateDots(position); }
});
// 頁面轉場動畫 (縮放+淡入)
viewPager2.setPageTransformer((page, position) -> {
float scale = 1 - Math.abs(position) * 0.2f;
page.setScaleX(scale);
page.setScaleY(scale);
page.setAlpha(1 - Math.abs(position) * 0.5f);
});
ViewFlipper + GestureDetector 以極少代碼實現經典引導頁滑動切換,適合輕量級、無 Fragment 需求的場景。核心邏輯:onFling 判斷方向 → showNext/Previous 切換 + 設置進出動畫 → 更新指示器。現代項目推薦遷移至 ViewPager2 + FragmentStateAdapter,獲得完整生命周期管理、內存優化、豐富轉場動畫與無障礙支持。