@fluentui-react-native/focus-zone 0.18.0 → 0.19.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.json +16 -1
- package/CHANGELOG.md +10 -2
- package/lib/FocusZone.types.d.ts +18 -5
- package/lib/FocusZone.types.d.ts.map +1 -1
- package/lib-commonjs/FocusZone.types.d.ts +18 -5
- package/lib-commonjs/FocusZone.types.d.ts.map +1 -1
- package/macos/RCTFocusZone.h +1 -0
- package/macos/RCTFocusZone.m +11 -0
- package/macos/RCTFocusZoneManager.m +6 -0
- package/package.json +2 -1
- package/src/FocusZone.types.ts +18 -5
package/CHANGELOG.json
CHANGED
|
@@ -2,7 +2,22 @@
|
|
|
2
2
|
"name": "@fluentui-react-native/focus-zone",
|
|
3
3
|
"entries": [
|
|
4
4
|
{
|
|
5
|
-
"date": "
|
|
5
|
+
"date": "Wed, 24 Jul 2024 16:31:50 GMT",
|
|
6
|
+
"version": "0.19.0",
|
|
7
|
+
"tag": "@fluentui-react-native/focus-zone_v0.19.0",
|
|
8
|
+
"comments": {
|
|
9
|
+
"minor": [
|
|
10
|
+
{
|
|
11
|
+
"author": "patboyd@microsoft.com",
|
|
12
|
+
"package": "@fluentui-react-native/focus-zone",
|
|
13
|
+
"commit": "94f1248b7cc169c26b9c685704965a275be6e5d8",
|
|
14
|
+
"comment": "Implementation of FocusZone navigationOrderInRenderOrder for MacOS"
|
|
15
|
+
}
|
|
16
|
+
]
|
|
17
|
+
}
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
"date": "Tue, 23 Jul 2024 16:56:54 GMT",
|
|
6
21
|
"version": "0.18.0",
|
|
7
22
|
"tag": "@fluentui-react-native/focus-zone_v0.18.0",
|
|
8
23
|
"comments": {
|
package/CHANGELOG.md
CHANGED
|
@@ -1,12 +1,20 @@
|
|
|
1
1
|
# Change Log - @fluentui-react-native/focus-zone
|
|
2
2
|
|
|
3
|
-
This log was last generated on
|
|
3
|
+
This log was last generated on Wed, 24 Jul 2024 16:31:50 GMT and should not be manually modified.
|
|
4
4
|
|
|
5
5
|
<!-- Start content -->
|
|
6
6
|
|
|
7
|
+
## 0.19.0
|
|
8
|
+
|
|
9
|
+
Wed, 24 Jul 2024 16:31:50 GMT
|
|
10
|
+
|
|
11
|
+
### Minor changes
|
|
12
|
+
|
|
13
|
+
- Implementation of FocusZone navigationOrderInRenderOrder for MacOS (patboyd@microsoft.com)
|
|
14
|
+
|
|
7
15
|
## 0.18.0
|
|
8
16
|
|
|
9
|
-
Tue, 23 Jul 2024 16:
|
|
17
|
+
Tue, 23 Jul 2024 16:56:54 GMT
|
|
10
18
|
|
|
11
19
|
### Minor changes
|
|
12
20
|
|
package/lib/FocusZone.types.d.ts
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
import type * as React from 'react';
|
|
2
|
-
import type {
|
|
2
|
+
import type { IViewProps } from '@fluentui-react-native/adapters';
|
|
3
3
|
import type { IFocusable } from '@fluentui-react-native/interactive-hooks';
|
|
4
4
|
import type { IRenderData } from '@uifabricshared/foundation-composable';
|
|
5
5
|
export declare const focusZoneName = "FocusZone";
|
|
6
6
|
export interface FocusZoneState {
|
|
7
7
|
}
|
|
8
|
-
export type FocusZoneProps =
|
|
8
|
+
export type FocusZoneProps = IViewProps & {
|
|
9
9
|
/**
|
|
10
10
|
* A RefObject to access the IFocusable interface. Use this to access the public methods and properties of the component.
|
|
11
11
|
*/
|
|
@@ -53,10 +53,23 @@ export type FocusZoneProps = React.PropsWithChildren<{
|
|
|
53
53
|
*/
|
|
54
54
|
onFocus?: (e?: any) => void;
|
|
55
55
|
/**
|
|
56
|
-
*
|
|
56
|
+
* @platform macos
|
|
57
|
+
* By default, the Apple KeyView loop is calculated based on the UI tree hierarchy, accessibility properties,
|
|
58
|
+
* custom element overrides of navigation order, and positions in layout.
|
|
59
|
+
*
|
|
60
|
+
* Normally this produces the appropriate accessible experience for users, but occasionally we may need to
|
|
61
|
+
* clarify the intended order of navigation. The navigationOrderInRenderOrder prop will have the FocusZone
|
|
62
|
+
* establish the navigation order of its children according to their order in the UI tree
|
|
63
|
+
* (i.e. as returned by accessibilityChildren).
|
|
64
|
+
*
|
|
65
|
+
* Note that to participate in the KeyView loop calculation, the FocusZone itself must be part of the
|
|
66
|
+
* accessibility tree (i.e. 'accessible') with an appropriate role, e.g. 'group'.
|
|
67
|
+
*
|
|
68
|
+
* Extra note: This property is unlikely to perform well if changed from its initial value due to finer details
|
|
69
|
+
* of the MacOS KeyView loop mechanics.
|
|
57
70
|
*/
|
|
58
|
-
|
|
59
|
-
}
|
|
71
|
+
navigationOrderInRenderOrder?: boolean;
|
|
72
|
+
};
|
|
60
73
|
export interface NativeProps extends Omit<FocusZoneProps, 'isCircularNavigation'> {
|
|
61
74
|
navigateAtEnd?: NavigateAtEnd;
|
|
62
75
|
tabKeyNavigation?: FocusZoneTabNavigation;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"FocusZone.types.d.ts","sourceRoot":"","sources":["../src/FocusZone.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;
|
|
1
|
+
{"version":3,"file":"FocusZone.types.d.ts","sourceRoot":"","sources":["../src/FocusZone.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEzE,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC,MAAM,WAAW,cAAc;CAAG;AAElC,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG;IACxC;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAE3C;;OAEG;IACH,sBAAsB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAE1D;;OAEG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAGnB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;;;;;;;;;;;;;;;;OAkBG;IACH,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAE1C;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAE5B;;;;;;;;;;;;;;;OAeG;IACH,4BAA4B,CAAC,EAAE,OAAO,CAAC;CACxC,CAAC;AAEF,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,cAAc,EAAE,sBAAsB,CAAC;IAC/E,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C;AAED,MAAM,MAAM,kBAAkB,GAC1B,eAAe,CAAC,2BAA2B,GAC3C,UAAU,CAAC,oCAAoC,GAC/C,YAAY,CAAC,uCAAuC,GACpD,MAAM,CAAC,CAAC,yCAAyC;AAErD,MAAM,MAAM,aAAa,GACrB,oBAAoB,GACpB,cAAc,GACd,kBAAkB,CAAC;AAEvB,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,cAAc,GACd,oBAAoB,GACpB,QAAQ,CAAC;AAEb,MAAM,WAAW,eAAe;CAAG;AAEnC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAC;AAElF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,KAAK,EAAE,cAAc,CAAC;CACvB"}
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
import type * as React from 'react';
|
|
2
|
-
import type {
|
|
2
|
+
import type { IViewProps } from '@fluentui-react-native/adapters';
|
|
3
3
|
import type { IFocusable } from '@fluentui-react-native/interactive-hooks';
|
|
4
4
|
import type { IRenderData } from '@uifabricshared/foundation-composable';
|
|
5
5
|
export declare const focusZoneName = "FocusZone";
|
|
6
6
|
export interface FocusZoneState {
|
|
7
7
|
}
|
|
8
|
-
export type FocusZoneProps =
|
|
8
|
+
export type FocusZoneProps = IViewProps & {
|
|
9
9
|
/**
|
|
10
10
|
* A RefObject to access the IFocusable interface. Use this to access the public methods and properties of the component.
|
|
11
11
|
*/
|
|
@@ -53,10 +53,23 @@ export type FocusZoneProps = React.PropsWithChildren<{
|
|
|
53
53
|
*/
|
|
54
54
|
onFocus?: (e?: any) => void;
|
|
55
55
|
/**
|
|
56
|
-
*
|
|
56
|
+
* @platform macos
|
|
57
|
+
* By default, the Apple KeyView loop is calculated based on the UI tree hierarchy, accessibility properties,
|
|
58
|
+
* custom element overrides of navigation order, and positions in layout.
|
|
59
|
+
*
|
|
60
|
+
* Normally this produces the appropriate accessible experience for users, but occasionally we may need to
|
|
61
|
+
* clarify the intended order of navigation. The navigationOrderInRenderOrder prop will have the FocusZone
|
|
62
|
+
* establish the navigation order of its children according to their order in the UI tree
|
|
63
|
+
* (i.e. as returned by accessibilityChildren).
|
|
64
|
+
*
|
|
65
|
+
* Note that to participate in the KeyView loop calculation, the FocusZone itself must be part of the
|
|
66
|
+
* accessibility tree (i.e. 'accessible') with an appropriate role, e.g. 'group'.
|
|
67
|
+
*
|
|
68
|
+
* Extra note: This property is unlikely to perform well if changed from its initial value due to finer details
|
|
69
|
+
* of the MacOS KeyView loop mechanics.
|
|
57
70
|
*/
|
|
58
|
-
|
|
59
|
-
}
|
|
71
|
+
navigationOrderInRenderOrder?: boolean;
|
|
72
|
+
};
|
|
60
73
|
export interface NativeProps extends Omit<FocusZoneProps, 'isCircularNavigation'> {
|
|
61
74
|
navigateAtEnd?: NavigateAtEnd;
|
|
62
75
|
tabKeyNavigation?: FocusZoneTabNavigation;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"FocusZone.types.d.ts","sourceRoot":"","sources":["../src/FocusZone.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;
|
|
1
|
+
{"version":3,"file":"FocusZone.types.d.ts","sourceRoot":"","sources":["../src/FocusZone.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEzE,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC,MAAM,WAAW,cAAc;CAAG;AAElC,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG;IACxC;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAE3C;;OAEG;IACH,sBAAsB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAE1D;;OAEG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAGnB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;;;;;;;;;;;;;;;;OAkBG;IACH,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAE1C;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAE5B;;;;;;;;;;;;;;;OAeG;IACH,4BAA4B,CAAC,EAAE,OAAO,CAAC;CACxC,CAAC;AAEF,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,cAAc,EAAE,sBAAsB,CAAC;IAC/E,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C;AAED,MAAM,MAAM,kBAAkB,GAC1B,eAAe,CAAC,2BAA2B,GAC3C,UAAU,CAAC,oCAAoC,GAC/C,YAAY,CAAC,uCAAuC,GACpD,MAAM,CAAC,CAAC,yCAAyC;AAErD,MAAM,MAAM,aAAa,GACrB,oBAAoB,GACpB,cAAc,GACd,kBAAkB,CAAC;AAEvB,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,cAAc,GACd,oBAAoB,GACpB,QAAQ,CAAC;AAEb,MAAM,WAAW,eAAe;CAAG;AAEnC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAC;AAElF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,KAAK,EAAE,cAAc,CAAC;CACvB"}
|
package/macos/RCTFocusZone.h
CHANGED
|
@@ -13,6 +13,7 @@ typedef NS_ENUM(NSInteger, FocusZoneDirection) {
|
|
|
13
13
|
@interface RCTFocusZone : RCTView
|
|
14
14
|
|
|
15
15
|
@property(nonatomic) BOOL disabled;
|
|
16
|
+
@property(nonatomic) BOOL navigationOrderInRenderOrder;
|
|
16
17
|
@property(nonatomic) FocusZoneDirection focusZoneDirection;
|
|
17
18
|
@property(nonatomic) NSString *navigateAtEnd;
|
|
18
19
|
@property(nonatomic) NSString *tabKeyNavigation;
|
package/macos/RCTFocusZone.m
CHANGED
|
@@ -186,6 +186,17 @@ static BOOL ShouldSkipFocusZone(NSView *view)
|
|
|
186
186
|
return NO;
|
|
187
187
|
}
|
|
188
188
|
|
|
189
|
+
/// FocusZone bases its return to accessibilityChildrenInNavigationOrder on the navigationOrderInRenderOrder property.
|
|
190
|
+
/// If navigationOrderInRenderOrder is set to YES, the accessible children are returned in the same order as returned by [(NSView) accessibilityChildren].
|
|
191
|
+
/// If navigationOrderInRenderOrder is set to NO, the accessible children are returned in the order determined by [(NSView) accessibilityChildrenInNavigationOrder].
|
|
192
|
+
- (NSArray *)accessibilityChildrenInNavigationOrder {
|
|
193
|
+
if ([self navigationOrderInRenderOrder]) {
|
|
194
|
+
return [self accessibilityChildren];
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
return [super accessibilityChildrenInNavigationOrder];
|
|
198
|
+
}
|
|
199
|
+
|
|
189
200
|
/// Accept firstResponder on FocusZone itself in order to reassign it within the FocusZone.
|
|
190
201
|
- (BOOL)acceptsFirstResponder
|
|
191
202
|
{
|
|
@@ -9,6 +9,12 @@ RCT_EXPORT_MODULE()
|
|
|
9
9
|
|
|
10
10
|
RCT_EXPORT_VIEW_PROPERTY(disabled, BOOL)
|
|
11
11
|
|
|
12
|
+
RCT_CUSTOM_VIEW_PROPERTY(navigationOrderInRenderOrder, BOOL, RCTFocusZone)
|
|
13
|
+
{
|
|
14
|
+
[view setNavigationOrderInRenderOrder:[json boolValue]];
|
|
15
|
+
[[view window] recalculateKeyViewLoop];
|
|
16
|
+
}
|
|
17
|
+
|
|
12
18
|
RCT_CUSTOM_VIEW_PROPERTY(focusZoneDirection, NSString, RCTFocusZone)
|
|
13
19
|
{
|
|
14
20
|
if ([json isEqualToString:@"bidirectional"])
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fluentui-react-native/focus-zone",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.19.0",
|
|
4
4
|
"description": "A cross-platform FocusZone component using the Fluent Design System",
|
|
5
5
|
"main": "lib-commonjs/index.js",
|
|
6
6
|
"module": "lib/index.js",
|
|
@@ -22,6 +22,7 @@
|
|
|
22
22
|
"directory": "packages/components/FocusZone"
|
|
23
23
|
},
|
|
24
24
|
"dependencies": {
|
|
25
|
+
"@fluentui-react-native/adapters": "0.13.0",
|
|
25
26
|
"@fluentui-react-native/interactive-hooks": "0.27.0",
|
|
26
27
|
"@uifabricshared/foundation-composable": "0.13.0",
|
|
27
28
|
"@uifabricshared/foundation-settings": "0.15.0"
|
package/src/FocusZone.types.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type * as React from 'react';
|
|
2
|
-
import type { ViewStyle } from 'react-native';
|
|
3
2
|
|
|
3
|
+
import type { IViewProps } from '@fluentui-react-native/adapters';
|
|
4
4
|
import type { IFocusable } from '@fluentui-react-native/interactive-hooks';
|
|
5
5
|
import type { IRenderData } from '@uifabricshared/foundation-composable';
|
|
6
6
|
|
|
@@ -8,7 +8,7 @@ export const focusZoneName = 'FocusZone';
|
|
|
8
8
|
|
|
9
9
|
export interface FocusZoneState {}
|
|
10
10
|
|
|
11
|
-
export type FocusZoneProps =
|
|
11
|
+
export type FocusZoneProps = IViewProps & {
|
|
12
12
|
/**
|
|
13
13
|
* A RefObject to access the IFocusable interface. Use this to access the public methods and properties of the component.
|
|
14
14
|
*/
|
|
@@ -65,10 +65,23 @@ export type FocusZoneProps = React.PropsWithChildren<{
|
|
|
65
65
|
onFocus?: (e?: any) => void;
|
|
66
66
|
|
|
67
67
|
/**
|
|
68
|
-
*
|
|
68
|
+
* @platform macos
|
|
69
|
+
* By default, the Apple KeyView loop is calculated based on the UI tree hierarchy, accessibility properties,
|
|
70
|
+
* custom element overrides of navigation order, and positions in layout.
|
|
71
|
+
*
|
|
72
|
+
* Normally this produces the appropriate accessible experience for users, but occasionally we may need to
|
|
73
|
+
* clarify the intended order of navigation. The navigationOrderInRenderOrder prop will have the FocusZone
|
|
74
|
+
* establish the navigation order of its children according to their order in the UI tree
|
|
75
|
+
* (i.e. as returned by accessibilityChildren).
|
|
76
|
+
*
|
|
77
|
+
* Note that to participate in the KeyView loop calculation, the FocusZone itself must be part of the
|
|
78
|
+
* accessibility tree (i.e. 'accessible') with an appropriate role, e.g. 'group'.
|
|
79
|
+
*
|
|
80
|
+
* Extra note: This property is unlikely to perform well if changed from its initial value due to finer details
|
|
81
|
+
* of the MacOS KeyView loop mechanics.
|
|
69
82
|
*/
|
|
70
|
-
|
|
71
|
-
}
|
|
83
|
+
navigationOrderInRenderOrder?: boolean;
|
|
84
|
+
};
|
|
72
85
|
|
|
73
86
|
export interface NativeProps extends Omit<FocusZoneProps, 'isCircularNavigation'> {
|
|
74
87
|
navigateAtEnd?: NavigateAtEnd;
|