Loving Tina? us on GitHub0.0k

文档

学习

v.Latest
Documentation
扩展Tina
目录

Tina具有许多高级功能,可以自定义整个CMS编辑体验。

自定义字段

Tina允许通过ui属性自定义任何字段。这使得可以为编辑者创建定制化的体验。主要的自定义功能包括:

示例

export default defineConfig({
//...
schema: {
collections: [
{
name: 'posts',
label: '博客文章',
path: 'content/posts',
format: 'mdx',
fields: [
{
type: 'string',
label: '标题',
name: 'title',
ui: {
validate: (value) => {
if (value?.length > 40) {
return '标题不能超过40个字符'
}
},
},
},
// ... 其他字段
],
},
],
},
})
// ...

自定义CMS实例

tina/config.{ts,js,tsx}配置文件中有一个可选的cmsCallback参数,可以添加用于自定义CMS实例。

// ...
export default defineConfig({
// ...
+ cmsCallback: (cms) => {
+ cms.sidebar.position = 'overlay'
+ return cms
+ }
})

cmsCallback钩子主要用于注册自定义字段插件。它还可以用于修改Tina的UI、在特定页面动态隐藏侧边栏、接入CMS事件总线等。

上次编辑: May 1, 2025