# useCursor

**Kind:** Function

A hook for connecting a React component to your base's cursor. This returns a `Cursor`
instance and will re-render your component whenever the active Table or active View changes.
It excludes any change to the selected Records or selected Fields.

`useCursor` should meet most of your needs for working with base cursors. If you need more granular
control of when your component updates or want to do anything other than re-render, the lower
level `useWatchable` hook might help.

Returns the current cursor.

```js
import {useBase, useCursor} from '@airtable/blocks/ui';

// renders a list of tables and automatically updates
function TableList() {
     const base = useBase();
     const cursor = useCursor();

     const table = base.getTableById(cursor.activeTableId);

     return <p>The table named "{table.name}" is active!</p>;
}
```

**Returns:** `Cursor`