文档首页 / HareAdmin 开发手册

前端介绍

基础介绍

  • AdminLTE 4 + Bootstrap 5:布局与组件
  • jQuery:表格、表单事件
  • RequireJS:按需加载 table / form 等
  • bootstrap-table:列表
  • Layer:弹层;Toastr:提示(优先经 Fast.api.ajax)

静态资源:public/assets(含 vendor)。

目录结构

public/assets
├── css/          # yetu-admin-content.css 等
├── js/
│   ├── backend/  # 可选控制器同名模块
│   ├── frontend/
│   └── yetuadmin.js
├── libs/
└── vendor/       # BS5 / AdminLTE4 / Font Awesome …

Admin 列表/表单页:优先在当前视图内联脚本,避免新增零散 backend/** 专用文件。

标准 JS 模块(可选)

define(['jquery', 'bootstrap', 'backend', 'table', 'form'], function ($, undefined, Backend, Table, Form) {
    var Controller = {
        index: function () {
            Table.api.init({
                extend: {
                    index_url: 'category/index',
                    add_url: 'category/add',
                    edit_url: 'category/edit',
                    del_url: 'category/del',
                    table: 'category'
                }
            });
            var table = $('#table');
            table.bootstrapTable({
                url: $.fn.bootstrapTable.defaults.extend.index_url,
                columns: [[
                    {checkbox: true},
                    {field: 'name', title: lang('Name')},
                    {field: 'operate', title: lang('Operate'), table: table,
                        events: Table.api.events.operate, formatter: Table.api.formatter.operate}
                ]]
            });
            Table.api.bindevent(table);
        },
        add: function () { Controller.api.bindevent(); },
        edit: function () { Controller.api.bindevent(); },
        api: { bindevent: function () { Form.api.bindevent($('form[role=form]')); } }
    };
    return Controller;
});

列标题等用 lang('…')。

AJAX 与反馈

Fast.api.confirm(lang('Are you sure?'), function (index) {
    Layer.close(index);
    Fast.api.ajax({ url: '…', data: { /* … */ } }, function () {
        table.bootstrapTable('refresh');
    });
});
  • 后端 $this->success() / $this->error(lang('…'));默认成功 Operate success
  • 成功回调不要再 Toastr.success
  • 弹层表单用 Fast.api.contentDialog,不要用绝对定位的旧 .form-layer 结构

表单 / 上传 / 表格

自定义表单需 Form.api.bindevent(form) 才会绑定上传、编辑器、校验。表格初始化见上例;组件细节见「系统组件」。