feat: structural accessibility for data table

docs/6.x/docs/guides/migration.md

@@ -428,6 +428,116 @@ const theme = {
 />
 ```
 
+### DataTable
+
+The Paper 6.x `DataTable` adds table semantics. The structure it produces and the accessible names it exposes have both changed. Existing tables should still be working.
+
+#### Touch handling
+
+Rows, cells and titles with no touch handler render a plain `View` instead of a disabled touchable
+
+```tsx
+// Before (v5): announced as a disabled control
+<DataTable.Row>
+  <DataTable.Cell>{item.name}</DataTable.Cell>
+</DataTable.Row>
+
+// After (v6): pass a handler if the row is meant to be pressable
+<DataTable.Row onPress={() => select(item)}>
+  <DataTable.Cell>{item.name}</DataTable.Cell>
+</DataTable.Row>
+```
+
+#### Screen reader announcements
+
+- new `rowCount`, `firstRowIndex` needed for correct row positions when paginating
+- `nativeFocusMode="cell"` gives one stop per cell instead of one per row
+- `accessible={false}` on a row opts that row out
+- `formatRowPosition` replaces the wording, or removes it with `null`
+- rows are numbered by their position among the table's rows. A component of your own counts as the one row. A row inside a `View` or a wrapper of your own is counted but not numbered: pass `index` on such a row.
+
+```tsx
+// Before (v5)
+<DataTable>
+  {items.slice(from, to).map((item) => (
+    <DataTable.Row key={item.key}>{/* ... */}</DataTable.Row>
+  ))}
+</DataTable>
+
+// After (v6)
+<DataTable aria-label="Nutrition" rowCount={items.length} firstRowIndex={from}>
+  {items.slice(from, to).map((item) => (
+    <DataTable.Row key={item.key}>{/* ... */}</DataTable.Row>
+  ))}
+</DataTable>
+```
+
+#### Pagination labels
+
+- `labels` is new, and localizes every control
+- `aria-label="pagination-container"` and `aria-label="Options Select"` were removed: reach the controls by role or text, e.g. `getByRole('button', { name: 'Rows per page, 2' })`
+
+```tsx
+// After (v6)
+<DataTable.Pagination
+  labels={{
+    container: 'Paginacja',
+    previousPage: 'Poprzednia strona',
+    nextPage: 'Następna strona',
+    pageStatus: ({ page, numberOfPages }) =>
+      `Strona ${page} z ${numberOfPages}`,
+  }}
+  /* ... */
+/>
+```
+
+#### Alignment
+
+- `numeric` is unchanged, and now also applies tabular figures
+- `align` is new, accepts `'start'`, `'center'`, `'end'`
+
+```tsx
+// Before (v5): right-aligned
+<DataTable.Cell numeric>{item.calories}</DataTable.Cell>
+
+// After (v6): right-aligned, plus lined-up digits
+<DataTable.Cell numeric>{item.calories}</DataTable.Cell>
+
+// Centred, still with lined-up digits
+<DataTable.Cell numeric align="center">{item.calories}</DataTable.Cell>
+
+// Right-aligned text that is not numeric
+<DataTable.Cell align="end">{item.status}</DataTable.Cell>
+```
+
+`align` defaults to `'end'` for numeric columns and `'start'` otherwise.
+
+#### Text wrapping
+
+- **single line, always** → single line at the default font scale, unclamped above it
+- `numberOfLines` is honoured exactly at every font scale; pass `0` to never clamp
+
+#### Column definitions
+
+- `columns` on `DataTable` is new and optional
+- `column` on a title or cell selects one by key, and is only needed where position is unreliable
+
+```tsx
+// Before (v5)
+const styles = StyleSheet.create({ first: { flex: 2 } });
+
+<DataTable.Title style={styles.first}>Dessert</DataTable.Title>
+<DataTable.Cell style={styles.first}>{item.name}</DataTable.Cell>
+
+// After (v6)
+const columns = [{ key: 'name', flex: 2 }, { key: 'calories', numeric: true }];
+
+<DataTable columns={columns}>
+  <DataTable.Title>Dessert</DataTable.Title>
+  <DataTable.Cell>{item.name}</DataTable.Cell>
+</DataTable>
+```
+
 ### Card
 
 #### `Card` layout

example/src/Examples/DataTableExample.tsx

@@ -2,6 +2,7 @@ import * as React from 'react';
 import { StyleSheet } from 'react-native';
 
 import { DataTable, Card } from 'react-native-paper';
+import type { DataTableColumn } from 'react-native-paper';
 
 import ScreenWrapper from '../ScreenWrapper';
 
@@ -12,6 +13,14 @@ type ItemsState = Array<{
   fat: number;
 }>;
 
+// Declared once, outside the component: every title and cell reads its width
+// and alignment from here, and the reference has to stay stable.
+const columns: readonly DataTableColumn[] = [
+  { key: 'name', flex: 2 },
+  { key: 'calories', numeric: true },
+  { key: 'fat', numeric: true },
+];
+
 const DataTableExample = () => {
   const [sortAscending, setSortAscending] = React.useState<boolean>(true);
   const [page, setPage] = React.useState<number>(0);
@@ -74,26 +83,30 @@ const DataTableExample = () => {
   return (
     <ScreenWrapper contentContainerStyle={styles.content}>
       <Card>
-        <DataTable>
+        <DataTable
+          aria-label="Nutrition"
+          columns={columns}
+          rowCount={sortedItems.length}
+          firstRowIndex={from}
+        >
           <DataTable.Header>
             <DataTable.Title
               sortDirection={sortAscending ? 'ascending' : 'descending'}
               onPress={() => setSortAscending(!sortAscending)}
-              style={styles.first}
             >
               Dessert
             </DataTable.Title>
-            <DataTable.Title numberOfLines={2} numeric>
+            <DataTable.Title numberOfLines={2}>
               Calories per piece
             </DataTable.Title>
-            <DataTable.Title numeric>Fat (g)</DataTable.Title>
+            <DataTable.Title>Fat (g)</DataTable.Title>
           </DataTable.Header>
 
           {sortedItems.slice(from, to).map((item) => (
             <DataTable.Row key={item.key}>
-              <DataTable.Cell style={styles.first}>{item.name}</DataTable.Cell>
-              <DataTable.Cell numeric>{item.calories}</DataTable.Cell>
-              <DataTable.Cell numeric>{item.fat}</DataTable.Cell>
+              <DataTable.Cell>{item.name}</DataTable.Cell>
+              <DataTable.Cell>{item.calories}</DataTable.Cell>
+              <DataTable.Cell>{item.fat}</DataTable.Cell>
             </DataTable.Row>
           ))}
 
@@ -120,9 +133,6 @@ const styles = StyleSheet.create({
   content: {
     padding: 8,
   },
-  first: {
-    flex: 2,
-  },
 });
 
 export default DataTableExample;

src/components/Button/Button.tsx

@@ -90,6 +90,11 @@ export type Props = Omit<ViewProps, 'style'> & {
    * Accessibility role for the button. The "button" role is set by default.
    */
   role?: Role;
+  /**
+   * Whether the control the button opens is currently expanded. Set this when
+   * the button anchors a menu or another disclosure.
+   */
+  'aria-expanded'?: boolean;
   /**
    * Function to execute on press.
    */
@@ -171,6 +176,7 @@ const Button = ({
   textColor: customTextColor,
   children,
   'aria-label': ariaLabel,
+  'aria-expanded': ariaExpanded,
   accessibilityHint,
   role = 'button',
   hitSlop,
@@ -330,6 +336,7 @@ const Button = ({
         aria-label={ariaLabel}
         accessibilityHint={accessibilityHint}
         role={role}
+        aria-expanded={ariaExpanded}
         aria-disabled={disabled}
         accessible={accessible}
         hitSlop={hitSlop}