This is documentation for the next SDK version. For up-to-date documentation, see the latest version (SDK 56).

DisclosureGroup

A SwiftUI DisclosureGroup component for displaying expandable content.

iOS

Included in Expo Go

GitHub

npm

Changelog

Expo UI DisclosureGroup matches the official SwiftUI DisclosureGroup API and displays a disclosure indicator that reveals or hides content.

Installation

Terminal

- npx expo install @expo/ui

If you are installing this in an existing React Native app, make sure to install expo in your project.

Usage

Basic disclosure group

DisclosureGroup is most commonly used inside a Form so it picks up the standard iOS list styling with a chevron indicator.

BasicDisclosureGroupExample.tsx

import { useState } from 'react';
import { DisclosureGroup, Form, Host, Section, Text } from '@expo/ui/swift-ui';

export default function BasicDisclosureGroupExample() {
  const [isExpanded, setIsExpanded] = useState(true);
  return (
    <Host style={{ flex: 1 }}>
      <Form>
        <Section>
          <DisclosureGroup
            label="Advanced settings"
            isExpanded={isExpanded}
            onIsExpandedChange={setIsExpanded}>
            <Text>Auto-update apps</Text>
            <Text>App downloads</Text>
            <Text>Offload unused apps</Text>
          </DisclosureGroup>
        </Section>
      </Form>
    </Host>
  );
}

Initially expanded

Set isExpanded to true initially to show the content by default.

InitiallyExpandedExample.tsx

import { useState } from 'react';
import { Host, DisclosureGroup, Text } from '@expo/ui/swift-ui';

export default function InitiallyExpandedExample() {
  const [isExpanded, setIsExpanded] = useState(true);

  return (
    <Host matchContents>
      <DisclosureGroup label="Details" isExpanded={isExpanded} onIsExpandedChange={setIsExpanded}>
        <Text>This content is visible by default.</Text>
      </DisclosureGroup>
    </Host>
  );
}

API

import { DisclosureGroup } from '@expo/ui/swift-ui';

Component

`DisclosureGroup`

iOS

Type: React.Element<DisclosureGroupProps>

DisclosureGroupProps

`children`

iOS

Type: ReactNode

`isExpanded`

iOS

Optional • Type: boolean

Controls whether the disclosure group is expanded.

`label`

iOS

Type: string

`onIsExpandedChange`

iOS

Optional • Type: (isExpanded: boolean) => void

A callback that is called when the expansion state changes.

Inherited Props

CommonViewModifierProps