前言

xadmin的详情页面默认是一行展示一个字段，可以使用form_layout对详情页面的布局重新设计。

可以设置必填和非必填字段，也可以设置不显示，不可以编辑的字段。

models模块

先在models.py建2张表

class ArticleClassify(models.Model):

    '''文章分类'''

    n = models.CharField(max_length=30, verbose_name="分类", default="")

    def __str__(self):

        return self.__doc__ + "->" + self.n

    class Meta:

        verbose_name = "文章分类"

        verbose_name_plural = verbose_name

class ArticleDetail(models.Model):

    '''文章'''

    title = models.CharField(max_length=30, verbose_name="标题", default="输入你的标题")  # 标题

    classify = models.ForeignKey(ArticleClassify,

                                on_delete=models.CASCADE,

                                related_name="classify_name",

                                verbose_name="文章分类",

                                )

    body = models.TextField(verbose_name="正文", default="输入正文")                # 正文

    auth = models.CharField(max_length=10, verbose_name="作者", default="admin")   # 作者

    detail = models.TextField(verbose_name="备注", default="添加备注")

    # 创建时间

    create_time = models.DateTimeField(auto_now_add=True, verbose_name="创建时间")

    # 最后更新时间

    update_time = models.DateTimeField(auto_now=True, verbose_name="最后更新时间")

    def __str__(self):

        return self.__doc__ + "title->" + self.title

    class Meta:

        verbose_name = "文章列表"

        verbose_name_plural = '文章列表'

adminx.py注册表信息

class ControlActicl(object):

    list_display = ['title', 'body', 'auth']

xadmin.site.register(ArticleDetail, ControlActicl)

之后执行 makemigrations 和migrate，同步数据

python manage.py makemigrations

python manage.py migrate

xadmin页面优化

打开xadmin后台编辑页面，默认显示如下

使用form_layout重新布局,修改adminx.py注册表内容

先从xadmin.layout导入需要用到的类如：Fieldset，Row
form_layout 里面传元组参数
Fieldse是设置一个块的标题名称，默认是第一个参数
Row是设置一行的显示内容，可以多个参数显示在一行

from xadmin.layout import Main, TabHolder, Tab, Fieldset, Row, Col, AppendedText, Side, Field

class MoreActicl(object):

    list_display = ['title', 'body', 'auth']

    form_layout =  (

    Fieldset(u'',

             Row('title', 'auth'),  # Row 表示将里面的字段作为一行显示

             Row('classify'),

             ),

    Fieldset(('正文内容'), #Fieldset第一个参数表示区块名称

             'body',

              ),

    Fieldset(('备注'),

             Row('detail'),

              ),

    )

显示效果如下

添加默认输入值

也可以给编辑页面设置默认参数，在models里面设置表字段的时候，加上参数default="输入框内默认输入的参数"

设置非必填

如何想设置非必填字段，在models里面设置表字段的时候，加上参数： blank=True。也可以同时加上blank=True, null=True

    auth = models.CharField(max_length=10,

                            verbose_name="作者",

                            default="admin",

                            blank=True, null=True)   # 作者

这样auth参数就是非必填的了，前面没红色*号了

设置只读字段

也可以设置只读字段，加个readonly_fields=['xxx']

from xadmin.layout import Main, TabHolder, Tab, Fieldset, Row, Col, AppendedText, Side, Field

class MoreActicl(object):

    list_display = ['title', 'body', 'auth']

    readonly_fields = ['detail'] # 只读字段

    form_layout = (

                Fieldset(u'',

                         Row('title', 'auth'),  # Row 表示将里面的字段作为一行显示

                         Row('classify'),

                         ),

                Fieldset(('正文内容'), #Fieldset第一个参数表示区块名称

                         'body',

                          ),

                Fieldset(('备注'),

                         Row('detail'),

                          ),

                )

xadmin.site.register(ArticleDetail, MoreActicl)

隐藏字段

不显示某个字段，可以用exclude = ['auth']

class MoreActicl(object):

    list_display = ['title', 'body', 'auth']

    readonly_fields = ['detail']  # 只读字段

    exclude = ['auth']    # 不显示某个字段

区块不可以拖动

上面的几个区块，按住鼠标后是可以上下拖动位置的，如何不让拖动可以加个餐：css_class = 'unsort no_title'

 form_layout = (

                Fieldset(u'',

                         Row('title', 'auth'),  # Row 表示将里面的字段作为一行显示

                         Row('classify'),

                         css_class = 'unsort'            # 不让区块拖动

                         ),

                Fieldset(('正文内容'), #Fieldset第一个参数表示区块名称

                         'body',

                         css_class = 'unsort'

                          ),

                Fieldset(('备注'),

                         Row('detail'),

                         css_class = 'unsort no_title'    # no_title是不显示区块的title名称

                          ),

                )

unsort是不允许拖动 no_title是不显示区块的title名称

巴特西

python测试开发django-39.xadmin详情页面布局form_layout

前言