从2010年开始保持干爽
towel-bootstrap的Python项目详细描述
注意
您必须将towel_bootstrap添加到INSTALLED_APPS,最好是 在django.contrib.admin之前,因为否则bootstrapified 登录、注销和密码模板将不会被选取。
包括糖果
基本模板
towel_bootstrap/base.html:
所有内容的基本模板。css在顶部,javascript在底部。 定义两个可能需要注意的javascript数组:
- onReady:将在其上运行的函数的列表 $(document).ready()作为第一个且仅作为第一个接收jquery实例 争论。
- onForm:初始化窗体的函数列表。可能被称为 在同一组元素上多次。收到两个参数,a jquery对象包装document或dom的某个子集 以及jquery实例。
towel_bootstrap/full.html:
全宽页模板。
towel_bootstrap/modal.html:
ajax加载模式的模板。
towel_bootstrap/plain.html:
模板宽度较小,最适合登录/注销页面和 如此。清空主导航。
除了towel_bootstrap/base.html扩展之外的所有基模板 base.html。这意味着如果您提供自己的base.html,那么 覆盖区域的最小值,可以正确使用所有其他模板 走开。
默认情况下,以下块可用:
- title:浏览器标题
- css:css声明。
- body:除了templates和js之外,<body/>中的所有内容。
- navigation:导航栏的内容。
- main:主容器,即除了导航之外的所有内容 还有页脚。
- search:边栏中嵌入的搜索表单。
- sidebar:侧边栏本身。
- messages:页眉和内容上方的消息容器。
- page-header:页眉,在 <div class="page-header"/>在里面。
- content:内容。
- footer:页脚。
- templates:可用于javascript模板,主要用于 <script type="text/template"/>标记。
- js:所有javascript文件和代码。
模型视图模板
towel_bootstrap附带了一系列模板,这些模板对于 模型视图。看看里面的文件 towel_bootstrap/templates/modelview/。
毛巾模板
towel_bootstrap重写表单项、表单错误和 对列表页中的链接排序和分页的警告。
django.contrib.auth
的模板还包括登录、注销、密码更改和重置模板。
javascript助手
- onReady和onForm已经在上面描述过了。
- $.fn.flash:在 将它们淡入以再次完成不透明度。
- $.fn.autogrow:当应用于文本区域时,将导致文本区域 添加新内容时自动展开高度,以便没有滚动条 出现。默认情况下应用于所有匹配的元素 textarea.autogrow。
- initForms([elem]):运行onForm中的所有处理程序。默认为处理 如果没有传递对象,document中的所有内容。
- modalLoad(url):从远程url加载引导模式。这是 为所有匹配的元素自动激活 a[data-toggle=ajaxmodal]。
- 所有ajax请求都被修补,以配合django的csrf保护。
第三方库
- jQuery。
- Harvest chosen。
- Bootstrap datepicker
- 不包括引导程序本身。模板希望找到 在{{ STATIC_URL }}bootstrap/启动。