ITreeAlpha Interface
ITree extended with some alpha APIs.
To use, import via @fluidframework/tree/alpha.
For more information about our API support guarantees, see here.
This type is "sealed," meaning that code outside of the library defining it should not implement or extend it. Future versions of this type may add members or make typing of readonly members more specific.
Signature
/** @sealed */
export interface ITreeAlpha extends ITree
Extends: ITree
Methods
| Method | Alerts | Return Type | Description |
|---|---|---|---|
| createSharedBranch(name) | Alpha | string | Creates a fork of the current state of the main branch. This new branch will be shared with and editable by all clients. |
| exportSimpleSchema() | Alpha | SimpleTreeSchema | Exports the SimpleTreeSchema that is stored in the tree, using stored keys for object fields. |
| exportVerbose() | Alpha | VerboseTree | undefined | Exports root in the same format as exportVerbose(node, options) using stored keys. |
| getSharedBranchIds() | Alpha | string[] | Returns a list of all shared branches that currently exist on this tree. Any one of them can be checked out using viewSharedBranchWith(branchId, config). |
| getSharedBranchName(branchId) | Alpha | string | undefined | Retrieves the name, if any, of the shared branch with the given ID. |
| viewSharedBranchWith(branchId, config) | Alpha | TreeView<TRoot> | Returns a view of the tree on the specified shared branch, using the provided schema. See viewWith(config). |
Method Details
createSharedBranch
Creates a fork of the current state of the main branch. This new branch will be shared with and editable by all clients.
For more information about our API support guarantees, see here.
Signature
createSharedBranch(name?: string): string;
Parameters
| Parameter | Modifiers | Type | Description |
|---|---|---|---|
| name | optional | string | Optional name for the new branch. This name is not guaranteed to be unique. (Maximum length: 1024) |
Returns
The ID of the new branch, which can be used to view the branch.
Return type: string
exportSimpleSchema
Exports the SimpleTreeSchema that is stored in the tree, using stored keys for object fields.
For more information about our API support guarantees, see here.
Signature
exportSimpleSchema(): SimpleTreeSchema;
Remarks
To get the schema using property keys, use getSimpleSchema(schema) on the view schema.
Returns
Return type: SimpleTreeSchema
exportVerbose
Exports root in the same format as exportVerbose(node, options) using stored keys.
For more information about our API support guarantees, see here.
Signature
exportVerbose(): VerboseTree | undefined;
Remarks
This is undefined if and only if the root field is empty (this can only happen if the root field is optional).
Returns
Return type: VerboseTree | undefined
getSharedBranchIds
Returns a list of all shared branches that currently exist on this tree. Any one of them can be checked out using viewSharedBranchWith(branchId, config).
For more information about our API support guarantees, see here.
Signature
getSharedBranchIds(): string[];
Returns
Return type: string[]
getSharedBranchName
Retrieves the name, if any, of the shared branch with the given ID.
For more information about our API support guarantees, see here.
Signature
getSharedBranchName(branchId: string): string | undefined;
Parameters
| Parameter | Type | Description |
|---|---|---|
| branchId | string | The ID of the shared branch to retrieve the name of. |
Returns
The name of the shared branch, or undefined if the branch has no assigned name.
Return type: string | undefined
Error Handling
if the branch with the given ID does not exist.
viewSharedBranchWith
Returns a view of the tree on the specified shared branch, using the provided schema. See viewWith(config).
For more information about our API support guarantees, see here.
Signature
viewSharedBranchWith<TRoot extends ImplicitFieldSchema>(branchId: string, config: TreeViewConfiguration<TRoot>): TreeView<TRoot>;
Type Parameters
| Parameter | Constraint | Description |
|---|---|---|
| TRoot | ImplicitFieldSchema |
Parameters
| Parameter | Type | Description |
|---|---|---|
| branchId | string | |
| config | TreeViewConfiguration<TRoot> |
Returns
Return type: TreeView<TRoot>