Enterprise Edition
Version: 4.xx.xx
Swizzle Ready
This field is used to display email values. It uses the <Link>
component of Chakra UI.
Good to know:
You can swizzle this component to customize it with the Refine CLI
Usage
Let's see how we can use <EmailField>
with the example in the user list.
localhost:3000/users
import {
List,
EmailField,
} from "@refinedev/chakra-ui";
import {
TableContainer,
Table,
Thead,
Tr,
Th,
Tbody,
Td,
} from "@chakra-ui/react";
import { useTable } from "@refinedev/react-table";
import { ColumnDef, flexRender } from "@tanstack/react-table";
const UserList: React.FC = () => {
const columns = React.useMemo<ColumnDef<IUser>[]>(
() => [
{
id: "id",
header: "ID",
accessorKey: "id",
},
{
id: "firstName",
header: "First Name",
accessorKey: "firstName",
},
{
id: "lastName",
header: "Last Name",
accessorKey: "lastName",
},
{
id: "email",
header: "Email",
accessorKey: "email",
cell: function render({ getValue }) {
return (
<EmailField value={getValue()} />
);
},
},
],
[],
);
const { getHeaderGroups, getRowModel } = useTable({
columns,
});
return (
<List>
<TableContainer>
<Table variant="simple" whiteSpace="pre-line">
<Thead>
{getHeaderGroups().map((headerGroup) => (
<Tr key={headerGroup.id}>
{headerGroup.headers.map((header) => {
return (
<Th key={header.id}>
{!header.isPlaceholder &&
flexRender(
header.column.columnDef.header,
header.getContext(),
)}
</Th>
);
})}
</Tr>
))}
</Thead>
<Tbody>
{getRowModel().rows.map((row) => {
return (
<Tr key={row.id}>
{row.getVisibleCells().map((cell) => {
return (
<Td key={cell.id}>
{flexRender(
cell.column.columnDef.cell,
cell.getContext(),
)}
</Td>
);
})}
</Tr>
);
})}
</Tbody>
</Table>
</TableContainer>
</List>
);
};
interface IUser {
id: number;
firstName: string;
lastName: string;
email: string;
}
TIP
<EmailField>
uses "mailto:" in the href prop of the <Link>
component. For this reason, clicking <EmailField>
opens your device's default mail application.
Was this helpful?
API Reference
Properties
Property | Type | Description |
---|---|---|
value ﹡ |
| The value of the field. |
For the rest of Anchor properties, refer to the Chakra UI documentation →
Was this helpful?