@wordpress/editor/src/components/editor-help/index.native.js

Enhanced block editor for WordPress posts.

/**
 * External dependencies
 */
import { SafeAreaView, ScrollView, StyleSheet, View } from 'react-native';
import { TransitionPresets } from '@react-navigation/stack';

/**
 * WordPress dependencies
 */
import {
	BottomSheet,
	BottomSheetConsumer,
	PanelBody,
} from '@wordpress/components';
import { __ } from '@wordpress/i18n';
import { helpFilled, plusCircleFilled, trash, cog } from '@wordpress/icons';
import { useSelect } from '@wordpress/data';
import { store as editorStore } from '@wordpress/editor';
import {
	requestContactCustomerSupport,
	requestGotoCustomerSupportOptions,
} from '@wordpress/react-native-bridge';

/**
 * Internal dependencies
 */
import styles from './style.scss';
import HelpDetailNavigationScreen from './help-detail-navigation-screen';
import HelpTopicRow from './help-topic-row';
import HelpGetSupportButton from './help-get-support-button';
import IntroToBlocks from './intro-to-blocks';
import AddBlocks from './add-blocks';
import MoveBlocks from './move-blocks';
import RemoveBlocks from './remove-blocks';
import CustomizeBlocks from './customize-blocks';
import moveBlocksIcon from './icon-move-blocks';
import HelpSectionTitle from './help-section-title';

const HELP_TOPICS = [
	{
		label: __( 'What is a block?' ),
		slug: 'what-is-a-block',
		icon: helpFilled,
		view: <IntroToBlocks />,
	},
	{
		label: __( 'Add blocks' ),
		slug: 'add-blocks',
		icon: plusCircleFilled,
		view: <AddBlocks />,
	},
	{
		label: __( 'Move blocks' ),
		slug: 'move-blocks',
		icon: moveBlocksIcon,
		view: <MoveBlocks />,
	},
	{
		label: __( 'Remove blocks' ),
		slug: 'remove-blocks',
		icon: trash,
		view: <RemoveBlocks />,
	},
	{
		label: __( 'Customize blocks' ),
		slug: 'customize-blocks',
		icon: cog,
		view: <CustomizeBlocks />,
	},
];

function EditorHelpTopics( { close, isVisible, onClose, showSupport } ) {
	const { postType } = useSelect( ( select ) => ( {
		postType: select( editorStore ).getEditedPostAttribute( 'type' ),
	} ) );

	const title =
		postType === 'page'
			? __( 'How to edit your page' )
			: __( 'How to edit your post' );

	const supportSection = (
		<>
			<HelpSectionTitle>{ __( 'Get support' ) }</HelpSectionTitle>
			<HelpGetSupportButton
				title={ __( 'Contact support' ) }
				onPress={ requestContactCustomerSupport }
			/>
			<HelpGetSupportButton
				title={ __( 'More support options' ) }
				onPress={ requestGotoCustomerSupportOptions }
			/>
		</>
	);

	return (
		<BottomSheet
			isVisible={ isVisible }
			onClose={ onClose }
			hideHeader
			hasNavigation
			contentStyle={ styles.contentContainer }
			testID="editor-help-modal"
		>
			<SafeAreaView style={ styles.safeAreaContainer }>
				<BottomSheet.NavigationContainer
					animate
					main
					style={ styles.navigationContainer }
				>
					<BottomSheet.NavigationScreen
						isScrollable
						fullScreen
						name="help-topics"
					>
						<View style={ styles.container }>
							<BottomSheet.NavBar>
								<BottomSheet.NavBar.DismissButton
									onPress={ close }
									iosText={ __( 'Close' ) }
								/>
								<BottomSheet.NavBar.Heading>
									{ title }
								</BottomSheet.NavBar.Heading>
							</BottomSheet.NavBar>
							<BottomSheetConsumer>
								{ ( { listProps } ) => {
									const contentContainerStyle =
										StyleSheet.flatten(
											listProps.contentContainerStyle
										);
									return (
										<ScrollView
											{ ...listProps }
											contentContainerStyle={ {
												...contentContainerStyle,
												paddingBottom: Math.max(
													listProps.safeAreaBottomInset,
													contentContainerStyle.paddingBottom
												),
												/**
												 * Remove margin set via `hideHeader`. Combining a header
												 * and navigation in this bottom sheet is at odds with the
												 * current `BottomSheet` implementation.
												 */
												marginTop: 0,
											} }
										>
											<PanelBody>
												<HelpSectionTitle>
													{ __( 'The basics' ) }
												</HelpSectionTitle>
												{ /* Print out help topics. */ }
												{ HELP_TOPICS.map(
													(
														{ label, icon, slug },
														index
													) => {
														const isLastItem =
															index ===
															HELP_TOPICS.length -
																1;
														return (
															<HelpTopicRow
																key={ slug }
																label={ label }
																icon={ icon }
																screenName={
																	slug
																}
																isLastItem={
																	isLastItem
																}
															/>
														);
													}
												) }
												{ showSupport &&
													supportSection }
											</PanelBody>
										</ScrollView>
									);
								} }
							</BottomSheetConsumer>
						</View>
					</BottomSheet.NavigationScreen>
					{ /* Print out help detail screens. */ }
					{ HELP_TOPICS.map( ( { view, label, slug } ) => {
						return (
							<HelpDetailNavigationScreen
								key={ slug }
								name={ slug }
								content={ view }
								label={ label }
								options={ {
									gestureEnabled: false,
									...TransitionPresets.DefaultTransition,
								} }
							/>
						);
					} ) }
				</BottomSheet.NavigationContainer>
			</SafeAreaView>
		</BottomSheet>
	);
}

export default EditorHelpTopics;