React Native Stack Navigator：统一设置所有屏幕的样式

本文旨在介绍如何在 React Native 中使用 react-navigation 库的 Stack.Navigator 组件时，统一设置所有屏幕的头部样式。通过使用 screenOptions 属性，可以避免在每个 Stack.Screen 组件中重复定义相同的样式，从而提高代码的可维护性和简洁性。本文将提供详细的代码示例，帮助开发者轻松实现全局样式配置。

在 React Native 应用开发中，react-navigation 库的 Stack.Navigator 组件被广泛用于实现页面间的导航。当多个屏幕需要共享相同的头部样式时，为每个 Stack.Screen 组件单独设置 options 属性会显得冗余且难以维护。Stack.Navigator 提供的 screenOptions 属性可以有效地解决这个问题，允许开发者一次性定义所有屏幕的默认样式。

使用 screenOptions 统一设置头部样式

screenOptions 属性允许你定义应用于 Stack.Navigator 中所有屏幕的默认选项。这包括头部样式（headerStyle）、标题样式（headerTitleStyle）、头部左侧组件（headerLeft）以及标题对齐方式（headerTitleAlign）等。

以下是一个示例，展示了如何使用 screenOptions 来统一设置所有屏幕的头部样式：

import { NavigationContainer } from '@react-navigation/native';
import { createNativeStackNavigator } from '@react-navigation/native-stack';
import MagicScreen from './screens/MagicScreen';
import FightingStyleScreen from './screens/FightingStyleScreen';
import WeaponScreen from './screens/WeaponScreen';

const Stack = createNativeStackNavigator();

const MainNavigator = () => {
  return (
    <NavigationContainer>
      <Stack.Navigator
        initialRouteName="MainScreen"
        screenOptions={{
          headerStyle: {
            backgroundColor: '#0074C4',
          },
          headerTitleStyle: {
            color: 'white',
            fontSize: 24,
          },
          headerLeft: null,
          headerTitleAlign: 'center',
        }}
      >
        <Stack.Screen
          name="MagicScreen"
          component={MagicScreen}
          options={{
            title: 'Magic',
          }}
        />

        <Stack.Screen
          name="FightingStyleScreen"
          component={FightingStyleScreen}
          options={{
            title: 'Fighting Style',
          }}
        />

        <Stack.Screen
          name="WeaponScreen"
          component={WeaponScreen}
          options={{
            title: 'Weapons',
          }}
        />
      </Stack.Navigator>
    </NavigationContainer>
  );
};

export default MainNavigator;

在这个示例中，screenOptions 对象定义了默认的头部样式，包括背景颜色、标题颜色、字体大小、头部左侧组件以及标题对齐方式。这些样式将应用于 Stack.Navigator 中的所有屏幕。

个性化屏幕样式

虽然 screenOptions 允许统一设置默认样式，但有时我们需要为特定屏幕定制样式。可以通过在 Stack.Screen 组件的 options 属性中覆盖默认值来实现。

例如，如果希望 MagicScreen 的标题颜色为红色，可以这样修改：

<Stack.Screen
  name="MagicScreen"
  component={MagicScreen}
  options={{
    title: 'Magic',
    headerTitleStyle: {
      color: 'red', // 覆盖默认的标题颜色
    },
  }}
/>

这样，MagicScreen 的标题颜色将变为红色，而其他屏幕仍然使用 screenOptions 中定义的默认样式。

总结

使用 screenOptions 属性可以有效地统一设置 React Native Stack.Navigator 中所有屏幕的头部样式，提高代码的可维护性和简洁性。同时，通过在 Stack.Screen 组件的 options 属性中覆盖默认值，可以为特定屏幕定制样式，满足不同的设计需求。在实际开发中，灵活运用 screenOptions 属性，可以有效地提高开发效率和代码质量。